Páginas filhas
  • DI Solicitação de Material para Serviços de Oficina - Request / StockTurnover

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Tem como objetivo registrar os serviços e materiais utilizados pelos mecânicos nas manutenções dos equipamentos, sendo que a inclusão é realizada através da Ordem ordem de Serviço serviço (OS) de Oficina Mecânicaoficina mecânica.

O PIMS Multicultivos é responsável por gerar a OS e apontar os materiais que serão solicitados ao ERP, identificando para cada material qual o procedimento para sua obtenção, se é aquisição ou consumo de estoque. O ERP por sua vez iniciará o processo de compra, para os casos de aquisição, e o processo de solicitação ao armazém, para os casos de consumo de estoque.

...

  • Interna: Peças que movimentarão o estoque, caso não existam em estoque, será gerado processo de compras; 
  • Externa: Peças que realizarão processo de compras;
  • Mão de Obra Externa: Mão de Obra que serão executadas por terceiros.

A opção "Tipo de Peça / Serviço", informada no cadastro de solicitação de materiais do PIMS, influencia diretamente no comportamento da integração, pois essa opção determina qual processo será criado, seja uma Solicitação de Armazém ou Solicitação de Comprassolicitação de armazém (estoque) ou solicitação de compras.  Ao definir Tipo de Peça / Serviço o tipo de peça ou serviço como externa ou mão de obra externa, será gerada uma Solicitação solicitação de Compracompra, caso selecione "Interna", será gerada uma Solicitação de Armazémsolicitação de armazém (estoque).

draw.io Diagram
bordertrue
viewerToolbartrue
fitWindowfalse
diagramNameFluxoSolicitacoMaterial
simpleViewerfalse
width
diagramWidth981
revision1


O campo "Tipo de Peça ou / Serviço" será representado na mensagem Request pelas tags Type e ItemType. A identificação de Solicitação solicitação de Compra compra ou Solicitação solicitação de Armazéns armazém pelo ERP, deverá ser realizada através da tag Type. O preenchimento da tag Type, será realizado pelo PIMS , quando o usuário definir o "Tipo de Peça / Serviço", segue abaixo os valores válidos para a tag Type:

  • 000 - Solicitação de Compracompra;
  • 001 - Solicitação de Estoqueestoque.

Informações da Mensagem

  • Identificador da Mensagem: Request
  • Versão: 1.009
  • Módulo PIMS Multicultivos: Apontamentos > Manutenção > Serviços de Oficina
  • Tipo de Envio: Assíncrona / Síncrona
  • Tipo de Evento: Upsert / Delete

Campos Obrigatórios

  • Descrever os campos obrigatórios

Exemplos de Mensagens

Mensagem XML

Campos Enviados na Integração

  • Código da movimentação;
  • Origem do apontamento;
  • Tipo de movimento;
  • Código da empresa;
  • Identificador único da requisição;
  • Usuário requisitante;
  • Data da requisição;
  • Número do boletim PIMS;
  • Código do item;
  • Código da referencia;
  • Código do item;
  • Quantidade solicitada;
  • Unidade de medida;
  • Depósito;
  • Centro de custo;
  • Conta contábil;
  • Observação.

Exemplos de Mensagens

Mensagem XML

Bloco de código
languagexml
titleRequest_Envio
linenumberstrue
collapsetrue
Bloco de código
languagexml
titleRequest_Envio
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="1.009">
		<BranchId>D MG 01</BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-04-12T15:56:20</GeneratedOn>
		<Product name="PIMS" version="12.1.21"/>
		<SourceApplication>PIMSCONNECTOR</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>Request</Transaction>
		<Type>BusinessMessage</Type>
		<UUID>c109c32f-0bdc-4889-a826-05bf70b39613</UUID>
	</MessageInformation>
	<BusinessMessage>
		<BusinessEvent>
			<Entity>Request</Entity>
			<Event>upsert</Event>
		</BusinessEvent>
		<BusinessContent>
			<Code>28434</Code>
			<InternalId>T1|D MG 01|1111188197030017682</InternalId>
			<Origin>OS-PED</Origin>
			<Number>28434</Number>
			<Type>001</Type>
			<CompanyId>T1</CompanyId>
			<RequestNumberUniqueId>94979208</RequestNumberUniqueId>
			<BranchId>D MG 01</BranchId>
			<UserRequesterCode>Filipe</UserRequesterCode>
			<UserRequesterName>Filipe</UserRequesterName>
			<Series>PMSS</Series>
			<RegisterDateTime>2018-04-12</RegisterDateTime>
			<NumberPIMS>28434</NumberPIMS>
			<ListOfRequestItem>
				<RequestItem>
					<Code>2</Code>
					<InternalId>T1|D MG 01|7672781010605401745</InternalId>
					<ItemCode>75841</ItemCode>
					<ItemInternalId>||585537277071829039</ItemInternalId>
					<ItemReferenceCode/>
					<ItemType>000</ItemType>
					<UnitPrice>0</UnitPrice>
					<TotalPrice>0</TotalPrice>
					<Quantity>100.0000</Quantity>
					<UnitOfMeasureCode>UN</UnitOfMeasureCode>
					<UnitOfMeasureInternalId>||1645600824977155300</UnitOfMeasureInternalId>
					<WarehouseCode>77</WarehouseCode>
					<WarehouseInternalId>||8778181452619063920</WarehouseInternalId>
					<DeliveryDateTime>2018-04-12</DeliveryDateTime>
					<CostCenterCode>98854</CostCenterCode>
					<CostCenterInternalId>||5297406413088842707</CostCenterInternalId>
					<Observation/>
					<ListOfApportionRequestItem>
						<ApportionRequestItem/>
					</ListOfApportionRequestItem>
				</RequestItem>
			</ListOfRequestItem>
		</BusinessContent>
	</BusinessMessage>
</TOTVSMessage>
Bloco de código
languagexml
titleRequest_Retorno
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="1.009">
		<BranchId>D MG 01 </BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-04-12T19:02:17Z</GeneratedOn>
		<Product name="ERP" version="12"/>
		<SourceApplication>P12_DEV_WST1</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>REQUEST</Transaction>
		<Type>Response</Type>
		<UUID>3970962b-8b46-7515-9f07-bee154049fb3</UUID>
	</MessageInformation>
	<ResponseMessage>
		<ProcessingInformation>
			<ProcessedOn>2018-04-12T19:02:17Z</ProcessedOn>
			<Status>ok</Status>
		</ProcessingInformation>
		<ReceivedMessage>
			<SentBy>PIMS</SentBy>
			<UUID>c109c32f-0bdc-4889-a826-05bf70b39613</UUID>
		</ReceivedMessage>
		<ReturnContent>
			<ListOfInternalId>
				<InternalId>
					<Destination>T1|D MG 01|000001</Destination>
					<Name>Request</Name>
					<Origin>T1|D MG 01|1111188197030017682</Origin>
				</InternalId>
				<InternalId>
					<Destination>T1|D MG 01|000001|02|12/04/2018</Destination>
					<Name>RequestItem<<Name>RequestInternalId</Name>
					<Origin>T1|D MG 01|7672781010605401745</Origin>
				</InternalId>
			</ListOfInternalId>
		</ReturnContent>
	</ResponseMessage>
</TOTVSMessage>

Mensagem JSON

Bloco de código
languagejs
titleRequest_Envio
linenumberstrue
collapsetrue
{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "1.009",
			"BranchId" : "D MG 01",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-04-12T15:56:20",
			"Product" : {
				"@name" : "PIMS",
				"@version" : "12.1.21"
			},
			"SourceApplication" : "PIMSCONNECTOR",
			"StandardVersion" : "1.000",
			"Transaction" : "Request",
			"Type" : "BusinessMessage",
			"UUID" : "c109c32f-0bdc-4889-a826-05bf70b39613"
		},
		"BusinessMessage" : {
			"BusinessEvent" : {
				"Entity" : "Request",
				"Event" : "upsert"
			},
			"BusinessContent" : {
				"Code" : "28434",
				"InternalId" : "T1|D MG 01|1111188197030017682",
				"Origin" : "OS-PED",
				"Number" : "28434",
				"Type" : "001",
				"CompanyId" : "T1",
				"RequestNumberUniqueId" : "94979208",
				"BranchId" : "D MG 01",
				"UserRequesterCode" : "Filipe",
				"UserRequesterName" : "Filipe",
				"Series" : "PMSS",
				"RegisterDateTime" : "2018-04-12",
				"NumberPIMS" : "28434",
				"ListOfRequestItem" : {
					"RequestItem" : {
						"Code" : "2",
						"InternalId" : "T1|D MG 01|7672781010605401745",
						"ItemCode" : "75841",
						"ItemInternalId" : "||585537277071829039",
						"ItemReferenceCode" : null,
						"ItemType" : "000",
						"UnitPrice" : "0",
						"TotalPrice" : "0",
						"Quantity" : "100.0000",
						"UnitOfMeasureCode" : "UN",
						"UnitOfMeasureInternalId" : "||1645600824977155300",
						"WarehouseCode" : "77",
						"WarehouseInternalId" : "||8778181452619063920",
						"DeliveryDateTime" : "2018-04-12",
						"CostCenterCode" : "98854",
						"CostCenterInternalId" : "||5297406413088842707",
						"Observation" : null,
						"ListOfApportionRequestItem" : {
							"ApportionRequestItem" : null
						}
					}
				}
			}
		}
	}
}
Bloco de código
languagejs
titleRequest_Retorno
linenumberstrue
collapsetrue
{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "1.009",
			"BranchId" : "D MG 01 ",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-04-12T19:02:17Z",
			"Product" : {
				"@name" : "ERP",
				"@version" : "12"
			},
			"SourceApplication" : "P12_DEV_WST1",
			"StandardVersion" : "1.000",
			"Transaction" : "REQUEST",
			"Type" : "Response",
			"UUID" : "3970962b-8b46-7515-9f07-bee154049fb3"
		},
		"ResponseMessage" : {
			"ProcessingInformation" : {
				"ProcessedOn" : "2018-04-12T19:02:17Z",
				"Status" : "ok"
			},
			"ReceivedMessage" : {
				"SentBy" : "PIMS",
				"UUID" : "c109c32f-0bdc-4889-a826-05bf70b39613"
			},
			"ReturnContent" : {
				"ListOfInternalId" : {
					"InternalId" : [ {
						"Destination" : "T1|D MG 01|000001",
						"Name" : "Request",
						"Origin" : "T1|D MG 01|1111188197030017682"
					}, {
						"Destination" : "T1|D MG 01|000001|02|12/04/2018",
						"Name" : "RequestItemRequestInternalId",
						"Origin" : "T1|D MG 01|7672781010605401745"
					} ]
				}
			}
		}
	}
}

Descrição Detalhada das Tags

SEGMENTOTAGSTIPOTAMANHODESCRITIVO DA TAG

BusinessEvent

EntityString50Nome da entidade que gerou o evento
EventString10Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração ou delete – eliminação)













BusinessContent

CodeString25Código da solicitação
NumberString25Número da solicitação


Type


String


3

Tipo da solicitação

  • 000 - Solicitação de Compra
  • 001 - Solicitação de Estoque
CompanyIdString20Código da Emrpesaempresa
BranchIdString10Código da Filialfilial
UserRequesterCodeString25Código do usuário requisitante
UserRequesterNameString25Nome do usário requisitante
RegisterDateTimeDateTime-Data de emissão da solicitação
NumberPIMSString22Número da solicitação no PIMS
RequestItem--Lista de itens da requisição
CodeString25Código do item da solicitação
ItemCodeString20Código do Itemitem


ItemType


Number


3

Tipo da solicitação

  • 000 - Solicitação de Compracompra
  • 001 - Solicitação de Estoqueestoque
UnitPriceNumber16,6Preço Unitáriounitário
TotalPriceNumber16,6Preço Totaltotal
QuantityNumber16,6Quantidade
UnitOfMeasureCodeString20Código da Unidade unidade de Medidamedida
WarehouseCodeString20Código do Local local de Estoque estoque (Armazémarmazém)
DeliveryDateTimeDateTime-Data de entrega ou previsão de entrega do item
CostCenterCodeString20Código do Centro centro de Custocusto
ObservationString500Observação

Resposta da Solicitação Compras e Armazém (Estoque)

Na resposta da integração de solicitação de compra e de armazém,  o ERP ao enviar a mensagem com o status de processamento das solicitações (sucesso ou erro), deverá preencher a estrutura da tag ListOfInternalId, conforme ilustrado abaixo, pois essas informações serão essenciais para o atendimento dos materiais solicitados.

Exemplo da Estrutura da Tag - ListOfInternalId no formatado XML

Bloco de código
languagexml
titleListOfInternalId_XML
linenumberstrue
collapsetrue
<ListOfInternalId>
	<InternalId>
		<Destination>T1|D MG 01|000001|02</Destination>
		<Name>RequestInternalId</Name>
		<Origin>T1|D MG 01|7672781010605401745</Origin>
	</InternalId>
</ListOfInternalId>

Exemplo da estrutura da Tag – ListOfInternalId no formatado Json

Bloco de código
languagejs
titleListOfInternalId_JSON
linenumberstrue
collapsetrue
{
	"ListOfInternalId" : {
		"InternalId" : {
			"Destination" : "T1|D MG 01|000001|02",
			"Name" : "RequestInternalId",
			"Origin" : "T1|D MG 01|7672781010605401745"
		}
	}
}

Descrição Detalhadas das Tags

SEGMENTOTAGSDESCRITIVO DA TAG



ListOfInternalId


Destination

Tag composta pelas seguintes informações:

Empresa|Filial|Código da movimentação ERP|Sequencia

Exemplo: T1|D MG 01|000001|02

NameDeverá ser preenchida com "RequestInternalId"
OriginRetornar o conteúdo enviado pelo PIMSConnector

Atendimento da Solicitação de Compras e Solicitação de Armazém (Estoque)

Tem como objetivo atender os materiais requisitados na solicitação de materiais da ordem de oficina, seja Solicitação de Compra ou Solicitação de Armazém. O atendimento da solicitação de materiais da ordem de oficina utiliza a mensagem StockTurnOver.

Exemplos de Mensagens

Mensagem XML

Bloco de código
languagexml
titleStockTurnOver_Envio
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="1.005">
		<BranchId>D MG 01</BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-04-27T17:48:07</GeneratedOn>
		<Product name="PIMS" version="12.1.21"/>
		<SourceApplication>PIMSCONNECTOR</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>StockTurnOver</Transaction>
		<Type>BusinessMessage</Type>
		<UUID>f71bc5a1-907b-4e92-bba6-523648f6d358</UUID>
	</MessageInformation>
	<BusinessMessage>
		<BusinessEvent>
			<Entity>StockTurnOver</Entity>
			<Event>upsert</Event>
		</BusinessEvent>
		<BusinessContent>
			<Code>46546546</Code>
			<InternalId>T1|D MG 01|1235464582823451998</InternalId>
			<Number>46546546</Number>
			<Type>S</Type>
			<MovementTypeCode>510</MovementTypeCode>
			<DocumentType>28</DocumentType>
			<CompanyId>T1</CompanyId>
			<BranchId>D MG 01</BranchId>
			<Series/>
			<RegisterDateTime>2018-04-27 00:00:00.0</RegisterDateTime>
			<ListOfStockTurnoverItem>
				<StockTurnoverItem>
					<Code>200</Code>
					<InternalId>T1|D MG 01|I4151082686999853407</InternalId>
					<EmissionDate>2018-04-27 00:00:00.0</EmissionDate>
					<ItemCode>200</ItemCode>
					<ItemInternalId>||3188980518467137755</ItemInternalId>
					<UnitPrice>0</UnitPrice>
					<TotalPrice>0</TotalPrice>
					<Quantity>1.0000</Quantity>
					<UnitOfMeasureCode>UN</UnitOfMeasureCode>
					<UnitOfMeasureInternalId>||1645600824977155300</UnitOfMeasureInternalId>
					<WarehouseCode>12</WarehouseCode>
					<WarehouseInternalId>||1243787465212347649</WarehouseInternalId>
					<BinLocation/>
					<NumberSeries/>
					<LotOrSerialNumber/>
					<LotExpirationDate/>
					<CostCenterCode>10023</CostCenterCode>
					<CostCenterInternalId>||7314408448087859654</CostCenterInternalId>
					<AccountantAcountCode/>
					<Observation/>
					<MainOrderCode/>
					<FieldWorkOrderCode>0</FieldWorkOrderCode>
					<FieldWorkOrderInternalId/>
				</StockTurnoverItem>
			</ListOfStockTurnoverItem>
		</BusinessContent>
	</BusinessMessage>
</TOTVSMessage>
Bloco de código
languagexml
titleStockTurnOver_Retorno
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="1.005">
		<BranchId>D MG 01 </BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-04-27T20:52:11Z</GeneratedOn>
		<Product name="ERP" version="12"/>
		<SourceApplication>P12_DEV_WST1</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>STOCKTURNOVER</Transaction>
		<Type>Response</Type>
		<UUID>532a0999-e0b6-dea9-d7d4-69ae500fc8cf</UUID>
	</MessageInformation>
	<ResponseMessage>
		<ProcessingInformation>
			<ProcessedOn>2018-04-27T20:52:11Z</ProcessedOn>
			<Status>ok</Status>
		</ProcessingInformation>
		<ReceivedMessage>
			<SentBy>PIMS</SentBy>
			<UUID>f71bc5a1-907b-4e92-bba6-523648f6d358</UUID>
		</ReceivedMessage>
		<ReturnContent>
			<ListOfInternalId>
				<InternalId>
					<Destination>T1|D MG 01|000000013|000790</Destination>
					<Name>StockTurnover</Name>
					<Origin>T1|D MG 01|1235464582823451998</Origin>
				</InternalId>
			</ListOfInternalId>
		</ReturnContent>
	</ResponseMessage>
</TOTVSMessage>

Mensagem JSON

Bloco de código
languagejs
titleStockTurnOver_Envio
linenumberstrue
collapsetrue
{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "1.005",
			"BranchId" : "D MG 01",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-04-27T17:48:07",
			"Product" : {
				"@name" : "PIMS",
				"@version" : "12.1.21"
			},
			"SourceApplication" : "PIMSCONNECTOR",
			"StandardVersion" : "1.000",
			"Transaction" : "StockTurnOver",
			"Type" : "BusinessMessage",
			"UUID" : "f71bc5a1-907b-4e92-bba6-523648f6d358"
		},
		"BusinessMessage" : {
			"BusinessEvent" : {
				"Entity" : "StockTurnOver",
				"Event" : "upsert"
			},
			"BusinessContent" : {
				"Code" : "46546546",
				"InternalId" : "T1|D MG 01|1235464582823451998",
				"Number" : "46546546",
				"Type" : "S",
				"MovementTypeCode" : "510",
				"DocumentType" : "28",
				"CompanyId" : "T1",
				"BranchId" : "D MG 01",
				"Series" : null,
				"RegisterDateTime" : "2018-04-27 00:00:00.0",
				"ListOfStockTurnoverItem" : {
					"StockTurnoverItem" : {
						"Code" : "200",
						"InternalId" : "T1|D MG 01|I4151082686999853407",
						"EmissionDate" : "2018-04-27 00:00:00.0",
						"ItemCode" : "200",
						"ItemInternalId" : "||3188980518467137755",
						"UnitPrice" : "0",
						"TotalPrice" : "0",
						"Quantity" : "1.0000",
						"UnitOfMeasureCode" : "UN",
						"UnitOfMeasureInternalId" : "||1645600824977155300",
						"WarehouseCode" : "12",
						"WarehouseInternalId" : "||1243787465212347649",
						"BinLocation" : null,
						"NumberSeries" : null,
						"LotOrSerialNumber" : null,
						"LotExpirationDate" : null,
						"CostCenterCode" : "10023",
						"CostCenterInternalId" : "||7314408448087859654",
						"AccountantAcountCode" : null,
						"Observation" : null,
						"MainOrderCode" : null,
						"FieldWorkOrderCode" : "0",
						"FieldWorkOrderInternalId" : null
					}
				}
			}
		}
	}
}
Bloco de código
languagejs
titleStockTurnOver_Retorno
linenumberstrue
collapsetrue
{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "1.005",
			"BranchId" : "D MG 01 ",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-04-27T20:52:11Z",
			"Product" : {
				"@name" : "ERP",
				"@version" : "12"
			},
			"SourceApplication" : "P12_DEV_WST1",
			"StandardVersion" : "1.000",
			"Transaction" : "STOCKTURNOVER",
			"Type" : "Response",
			"UUID" : "532a0999-e0b6-dea9-d7d4-69ae500fc8cf"
		},
		"ResponseMessage" : {
			"ProcessingInformation" : {
				"ProcessedOn" : "2018-04-27T20:52:11Z",
				"Status" : "ok"
			},
			"ReceivedMessage" : {
				"SentBy" : "PIMS",
				"UUID" : "f71bc5a1-907b-4e92-bba6-523648f6d358"
			},
			"ReturnContent" : {
				"ListOfInternalId" : {
					"InternalId" : {
						"Destination" : "T1|D MG 01|000000013|000790",
						"Name" : "StockTurnover",
						"Origin" : "T1|D MG 01|1235464582823451998"
					}
				}
			}
		}
	}
}


Para o funcionamento do atendimento dos materiais solicitados, é necessário que o ERP preencha a tag RequestItemInternalId. Está tag será a junção das informações empresa, filial, número da solicitação do armazém e número da sequência do item, com estas informações será possível identificar no PIMS em qual solicitação o atendimento foi realizado.

É importante ressaltar que as informações presentes na tag RequestItemInternalId deverão ser as mesmas retornadas na resposta de solicitação de compras / armazém (Request), caso contrário o PIMSConnector não conseguirá atualizar o status da solicitação no PIMS.

O atendimento no PIMS, iniciará com as atualizações de algumas informações das solicitações de materiais, bem como:

  • Situação da Solicitação: Identifica se o atendimento foi de forma parcial ou total;
  • Valor Unitário Previsto: Valor unitário enviado pelo ERP no momento do atendimento;
  • Número da Solicitação: Número da solicitação gerada no ERP;
  • Status: Situação de processamento da integração.

Após atualizar as informações da solicitação de materiais, é iniciado o preenchimento da aba materiais aplicados. Os materiais aplicados têm como responsabilidade demonstrar o histórico dos materiais atendidos e os valores dos materiais a serem utilizados para o processamento de custo. A inclusão das informações na aba de materiais aplicados, finaliza o fluxo da integração de solicitações de materiais da ordem de serviço de oficina.