DI Solicitação de Material para Serviços de Oficina - Request / StockTurnover

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 de serviço (OS) de oficina 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.

Na inclusão das solicitações de materiais, será determinado o tipo de peça ou serviço, conforme mostrado a seguir:

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 (estoque) ou solicitação de compras. Ao definir o tipo de peça ou serviço como externa ou mão de obra externa, será gerada uma solicitação de compra, caso selecione "Interna", será gerada uma solicitação de armazém (estoque).

O campo "Tipo de Peça / Serviço" será representado na mensagem Request pelas tags Type e ItemType. A identificação de solicitação de compra ou solicitação de 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 compra;
001 - Solicitação de estoque.

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

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

Request_Envio

<?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>

Request_Retorno

<?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>RequestInternalId</Name>
					<Origin>T1|D MG 01|7672781010605401745</Origin>
				</InternalId>
			</ListOfInternalId>
		</ReturnContent>
	</ResponseMessage>
</TOTVSMessage>

Mensagem JSON

Request_Envio

{
	"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
						}
					}
				}
			}
		}
	}
}

Request_Retorno

{
	"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" : "RequestInternalId",
						"Origin" : "T1|D MG 01|7672781010605401745"
					} ]
				}
			}
		}
	}
}

Descrição Detalhada das Tags

SEGMENTO	TAGS	TIPO	TAMANHO	DESCRITIVO DA TAG
BusinessEvent	Entity	String	50	Nome da entidade que gerou o evento
BusinessEvent	Event	String	10	Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração ou delete – eliminação)
BusinessContent	Code	String	25	Código da solicitação
	Number	String	25	Número da solicitação
	Type	String	3	Tipo da solicitação 000 - Solicitação de Compra 001 - Solicitação de Estoque
	CompanyId	String	20	Código da empresa
	BranchId	String	10	Código da filial
	UserRequesterCode	String	25	Código do usuário requisitante
	UserRequesterName	String	25	Nome do usário requisitante
	RegisterDateTime	DateTime	-	Data de emissão da solicitação
	NumberPIMS	String	22	Número da solicitação no PIMS
	RequestItem	-	-	Lista de itens da requisição
	Code	String	25	Código do item da solicitação
	ItemCode	String	20	Código do item
	ItemType	Number	3	Tipo da solicitação 000 - Solicitação de compra 001 - Solicitação de estoque
	UnitPrice	Number	16,6	Preço unitário
	TotalPrice	Number	16,6	Preço total
	Quantity	Number	16,6	Quantidade
	UnitOfMeasureCode	String	20	Código da unidade de medida
	WarehouseCode	String	20	Código do local de estoque (armazém)
	DeliveryDateTime	DateTime	-	Data de entrega ou previsão de entrega do item
	CostCenterCode	String	20	Código do centro de custo
	Observation	String	500	Observaçã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

ListOfInternalId_XML

<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

ListOfInternalId_JSON

{
	"ListOfInternalId" : {
		"InternalId" : {
			"Destination" : "T1|D MG 01|000001|02",
			"Name" : "RequestInternalId",
			"Origin" : "T1|D MG 01|7672781010605401745"
		}
	}
}

Descrição Detalhadas das Tags

SEGMENTO

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

StockTurnOver_Envio

<?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>

StockTurnOver_Retorno

<?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

StockTurnOver_Envio

{
	"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
					}
				}
			}
		}
	}
}

StockTurnOver_Retorno

{
	"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.

Páginas filhas

DI Solicitação de Material para Serviços de Oficina - Request / StockTurnover

Informações da Mensagem

Campos Enviados na Integração

Exemplos de Mensagens

Mensagem XML

Mensagem JSON

Descrição Detalhada das Tags

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

Exemplo da Estrutura da Tag - ListOfInternalId no formatado XML

Exemplo da estrutura da Tag – ListOfInternalId no formatado Json

Descrição Detalhadas das Tags

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

Exemplos de Mensagens

Mensagem XML

Mensagem JSON