Histórico da Página
...
draw.io Diagram | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
O campo tipo de peça ou serviço "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
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?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
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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 |
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
| |
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
| |
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
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "ListOfInternalId" : { "InternalId" : { "Destination" : "T1|D MG 01|000001|02", "Name" : "RequestInternalId", "Origin" : "T1|D MG 01|7672781010605401745" } } } |
Descrição Detalhadas das Tags
SEGMENTO | TAGS | DESCRITIVO 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 |
Name | Deverá ser preenchida com "RequestInternalId" | |
Origin | Retornar 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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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 } } } } } } |
...