Histórico da Página
A integração de Grupo de Insumos e 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 de Insumo ou Grupo de Material Automotivo.
Informações da Mensagem
- Identificador da Mensagem: Family
- Versão: 2.002
- Módulo PIMS Multicultivos:Grupo Insumo / Grupo Materiais
- Tipo de Envio: Assíncrona / Síncrona
- Tipo de Evento: Upsert / Delete
Campo Obrigatórios
- Código;
- Descrição da Família;
- Classificação da Família.
Segue abaixo exemplos de mensagens XML e JSON de integração de Família de Material:
Exemplo de 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> |
Exemplo de 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"
}
}
}
} |
A seguir é apresentado um descritivo de cada tag da mensagem de Família de Material:
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ília |
Description | String | 30 | Descrição da Família | |
FamilyClassificationCode | String | 10 | Classificação da Família de Materiais 1 - Material Automotivo 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 de Materiais em ambos os sistemas, e precisa ser habilitado o processo de integração, será necessário ajustar o cadastro no 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 nas informações trafegadas entre os aplicativos.