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

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éns (Resquest), 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.

Exemplos de Mensagens

Mensagem XML

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>
			
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<	<Series/CompanyId>>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018<RegisterDateTime>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

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
Bloco de código
languagejs
titleStockTurnOver_Envio
linenumberstrue
collapsetrue
{
	"TOTVSMessage" : {
		"MessageInformation" : {
				"@versionEntity" : "1.005StockTurnOver",
				"BranchIdEvent" : "D MG 01",
upsert"
			},
			"BusinessContent" : {
				"CompanyIdCode" : "T146546546",
				"DeliveryTypeInternalId" : "SyncT1|D MG 01|1235464582823451998",
				"GeneratedOnNumber" : "2018-04-27T17:48:0746546546",
				"ProductType" : {"S",
				"@nameMovementTypeCode" : "PIMS510",
				"@versionDocumentType" : "12.1.2128",
			},
			"SourceApplicationCompanyId" : "PIMSCONNECTORT1",
				"StandardVersionBranchId" : "1.000D MG 01",
				"TransactionSeries" : "StockTurnOver"null,
				"TypeRegisterDateTime" : "BusinessMessage2018-04-27 00:00:00.0",
				"UUIDListOfStockTurnoverItem" : "f71bc5a1-907b-4e92-bba6-523648f6d358"{
		},
			"BusinessMessageStockTurnoverItem" : {
						"BusinessEventCode" : {
"200",
						"EntityInternalId" : "StockTurnOverT1|D MG 01|I4151082686999853407",
						"EventEmissionDate" : "upsert"
			}2018-04-27 00:00:00.0",
			"BusinessContent" : {
				"CodeItemCode" : "46546546200",
						"InternalIdItemInternalId" : "T1|D MG 01|12354645828234519983188980518467137755",
						"NumberUnitPrice" : "465465460",
						"TypeTotalPrice" : "S0",
						"MovementTypeCodeQuantity" : "5101.0000",
						"DocumentTypeUnitOfMeasureCode" : "28UN",
						"CompanyIdUnitOfMeasureInternalId" : "T1||1645600824977155300",
						"BranchIdWarehouseCode" : "D MG 0112",
						"SeriesWarehouseInternalId" : null"||1243787465212347649",
						"RegisterDateTimeBinLocation" : "2018-04-27 00:00:00.0"null,
						"ListOfStockTurnoverItemNumberSeries" : {null,
						"StockTurnoverItemLotOrSerialNumber" : {null,
						"CodeLotExpirationDate" : "200"null,
						"InternalIdCostCenterCode" : "T1|D MG 01|I415108268699985340710023",
						"EmissionDateCostCenterInternalId" : "2018-04-27 00:00:00.0||7314408448087859654",
						"ItemCodeAccountantAcountCode" : "200"null,
						"ItemInternalIdObservation" : "||3188980518467137755"null,
						"UnitPriceMainOrderCode" : "0"null,
						"TotalPriceFieldWorkOrderCode" : "0",
						"QuantityFieldWorkOrderInternalId" : "1.0000",
null
					}
							"UnitOfMeasureCode" : "UN",
						"UnitOfMeasureInternalId" : "||1645600824977155300",
						"WarehouseCode" : "12",
						"WarehouseInternalId" : "||1243787465212347649}
			}
		}
	}
}
Bloco de código
languagejs
titleStockTurnOver_Retorno
linenumberstrue
collapsetrue
{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "1.005",
						"BinLocationBranchId" : null,
						"NumberSeries" : null"D MG 01 ",
						"LotOrSerialNumberCompanyId" : null,
						"LotExpirationDate" : null"T1",
						"CostCenterCodeDeliveryType" : "10023Sync",
						"CostCenterInternalIdGeneratedOn" : "||73144084480878596542018-04-27T20:52:11Z",
						"AccountantAcountCodeProduct" : null,{
						"Observation@name" : null"ERP",
						"MainOrderCode@version" : null,"12"
			},
			"FieldWorkOrderCodeSourceApplication" : "0P12_DEV_WST1",
						"FieldWorkOrderInternalIdStandardVersion" : null
					}
				}"1.000",
			}"Transaction" : "STOCKTURNOVER",
		}
	}
}
Bloco de código
languagejs
titleStockTurnOver_Retorno
linenumberstrue
collapsetrue
{
	"TOTVSMessage"Type" : {"Response",
			"MessageInformationUUID" : {"532a0999-e0b6-dea9-d7d4-69ae500fc8cf"
		},
		"@versionResponseMessage" : "1.005", {
			"BranchIdProcessingInformation" : "D MG 01 ",{
				"CompanyIdProcessedOn" : "T12018-04-27T20:52:11Z",
				"DeliveryTypeStatus" : "Syncok"
			},
			"GeneratedOnReceivedMessage" : "2018-04-27T20:52:11Z",
{
				"ProductSentBy" : {"PIMS",
				"@nameUUID" : "ERP"f71bc5a1-907b-4e92-bba6-523648f6d358"
			},
				"@versionReturnContent" : "12"{
			},
			"SourceApplicationListOfInternalId" : "P12_DEV_WST1",
{
					"StandardVersionInternalId" : "1.000",
{
						"TransactionDestination" : "STOCKTURNOVERT1|D MG 01|000000013|000790",
						"TypeName" : "ResponseStockTurnover",
						"UUIDOrigin" : "532a0999-e0b6-dea9-d7d4-69ae500fc8cf"
T1|D MG 01|1235464582823451998"
					},
		"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éns (Resquest), 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.