Histórico da Página
A integração de Grupo grupo de Insumos insumos e Materiais grupo de materiais consiste na movimentação do cadastro no sentido ERP para PIMS Multicultivos, ou seja, será realizado no ERP e enviado para o PIMS Multicultivos através do PIMSConnector. O objetivo é permitir o controle do consumo dos insumos e materiais automotivos pelo seu respectivo grupo. Esta integração no PIMS Multicultivos é cadastrada em duas tabelas distintas, sendo assim é necessário existir no ERP, uma classificação que determina o tipo de item, se é Grupo grupo de Insumo insumo ou Grupo grupo de Material Automotivomaterial automotivo.
Informações da Mensagem
- Identificador da Mensagem: Family
- Versão: 2.002
- Módulo PIMS Multicultivos: Tabelas > Insumos > Grupo de Insumo / Grupo MateriaisTabelas > Manutenção > Grupo de Material
- Tipo de Envio: Assíncrona / Síncrona
- Tipo de Evento: Upsert / Delete
Campo Obrigatórios
- Código;
- Descrição da Famíliafamília;
- Classificação da Famíliafamília.
Segue abaixo exemplos de mensagens XML e JSON de integração de Família de Material:
...
Exemplos de Mensagens
Mensagem XML
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <TOTVSMessage> <MessageInformation version="2.002"> <BranchId>D MG 01 </BranchId> <CompanyId>T1</CompanyId> <DeliveryType>Sync</DeliveryType> <GeneratedOn>2018-03-21T19:27:54Z</GeneratedOn> <Product name="ERP" version="12"/> <SourceApplication>P12_DEV_SERVERT1</SourceApplication> <StandardVersion>1.000</StandardVersion> <Transaction>FAMILY</Transaction> <Type>BusinessMessage</Type> <UUID>01da1810-a305-6677-bdaf-cda337c8a412</UUID> </MessageInformation> <BusinessMessage> <BusinessEvent> <Entity>FAMILY</Entity> <Event>upsert</Event> <Identification> <key name="InternalId">T1|D MG 01|456</key> </Identification> </BusinessEvent> <BusinessContent> <CompanyId>T1</CompanyId> <BranchId>D MG 01 </BranchId> <CompanyInternalId>T1|D MG 01 </CompanyInternalId> <Code>456 </Code> <InternalId>T1|D MG 01|456</InternalId> <Description>Peças Automotivas</Description> <FamilyClassificationCode>2</FamilyClassificationCode> </BusinessContent> </BusinessMessage> </TOTVSMessage> |
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="2.002">
<BranchId>D MG 01 </BranchId>
<CompanyId>T1</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-03-21T16:24:02</GeneratedOn>
<Product name="PIMS" version="12.1.20"/>
<SourceApplication>PIMSCONNECTOR</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>FAMILY</Transaction>
<Type>Response</Type>
<UUID>aee6b73a-3d4d-4cac-bd20-85d9bc95fd0c</UUID>
</MessageInformation>
<ResponseMessage>
<ProcessingInformation>
<ProcessedOn>2018-03-21T16:24:02</ProcessedOn>
<Status>OK</Status>
</ProcessingInformation>
<ReceivedMessage>
<MessageContent/>
<SentBy>ERP</SentBy>
<UUID>01da1810-a305-6677-bdaf-cda337c8a412</UUID>
</ReceivedMessage>
<ReturnContent>
<ListOfInternalId>
<InternalId>
<Destination>||959851251781955913</Destination>
<Name>FAMILY</Name>
<Origin>T1|D MG 01|456</Origin>
</InternalId>
</ListOfInternalId>
</ReturnContent>
</ResponseMessage>
</TOTVSMessage> |
Mensagem JSON
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "2.002",
"BranchId" : "D MG 01 ",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-03-21T19:27:54Z",
"Product" : {
"@name" : "ERP",
"@version" : "12"
},
"SourceApplication" : "P12_DEV_SERVERT1",
"StandardVersion" : "1.000",
"Transaction" : "FAMILY",
"Type" : "BusinessMessage",
"UUID" : "01da1810-a305-6677-bdaf-cda337c8a412"
},
"BusinessMessage" : {
"BusinessEvent" : {
"Entity" : "FAMILY",
"Event" : "upsert",
"Identification" : {
"key" : {
"@name" : "InternalId",
"$" : "T1|D MG 01|456"
}
}
},
"BusinessContent" : {
"CompanyId" : "T1",
"BranchId" : "D MG 01 ",
"CompanyInternalId" : "T1|D MG 01 ",
"Code" : "456 ",
"InternalId" : "T1|D MG 01|456",
"Description" : "Peças Automotivas",
"FamilyClassificationCode" : "2"
}
}
}
} |
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "TOTVSMessage" : { "MessageInformation" : { "@version" : "2.002", "BranchId" : "D MG 01 ", "CompanyId" : "T1", "DeliveryType" : "Sync", "GeneratedOn" : "2018-03-21T16:24:02", "Product" : { "@name" : "PIMS", "@version" : "12.1.20" }, "SourceApplication" : "PIMSCONNECTOR", "StandardVersion" : "1.000", "Transaction" : "FAMILY", "Type" : "Response", "UUID" : "aee6b73a-3d4d-4cac-bd20-85d9bc95fd0c" }, "ResponseMessage" : { "ProcessingInformation" : { "ProcessedOn" : "2018-03-21T16:24:02", "Status" : "OK" }, "ReceivedMessage" : { "MessageContent" : null, "SentBy" : "ERP", "UUID" : "01da1810-a305-6677-bdaf-cda337c8a412" }, "ReturnContent" : { "ListOfInternalId" : { "InternalId" : { "Destination" : "||959851251781955913", "Name" : "FAMILY", "Origin" : "T1|D MG 01|456" } } } } } } |
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) | |
Identification | String | - | Campos da chave primária da transação. Atributo "Name" define o nome do campo, enquanto que o conteúdo do elemento representa o valor do campo | |
BusinessContent | Code | Number | 10 | Código da Famíliafamília |
Description | String | 30 | Descrição da Famíliafamília | |
FamilyClassificationCode | String | 10 | Classificação da Família família de Materiaismateriais 1 - Material Automotivoautomotivo 2 - Insumo |
Limitações e Restrições
- Esta integração está disponível a partir da versão 12.1.14 do PIMS Multicultivos e PIMS Connector;
- Caso já exista o cadastro de Família família de Material em ambos os sistemas, será necessário habilitar o processo de integração através do ajuste do cadastro do PIMS Multicultivos, informando o código do ERP no campo "Código ERP", para depois realizar a integração. Caso isto não seja feito, o processo de integração não funcionará corretamente, gerando inconsistências nas informações trafegadas entre os aplicativos.