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 Materiais Material em ambos os sistemas, e precisa ser habilitado será necessário habilitar o processo de integração , será necessário ajustar o cadastro no através do ajuste do cadastro do PIMS Multicultivos, informando o código do ERP no campo "Código ERP", para depois realizar a movimentação da integração. Caso isto não seja feito, o processo de integração não funcionará corretamente, gerando inconsistência inconsistências nas informações trafegadas entre os aplicativos.