Histórico da Página
Está integração consiste em movimentar o cadastro de Depósitodepósito, Unidade Receptora unidade receptora e Ponto ponto de Abastecimento abastecimento no sentido ERP para o PIMS, ou seja, será realizado no ERP e enviado para o PIMS através do PIMSConnector. Devido está integração possuir três tipos de depósitos, ela pode ser realizada em três tabelas distintas, utilizando a classificação do armazém que determina para qual tabela do PIMS serão enviadas as informações.
...
- Identificador da Mensagem: WareHouse
- Versão: 1.001
- Módulo PIMS Multicultivos: Depósito / Unidade Receptora / Ponto de Abastecimento Tabelas > Insumos > Depósito
- Tipo de Envio: Assíncrona / Síncrona
Tipo de Evento: Upsert / Delete
Campos Obrigatórios
- Código do depósito;
- DescriçãoDescrição do depósito;
- ClassificaçãoClassificação do depósito;
- Empresa;
- Filial.
Segue abaixo exemplos de mensagens XML e JSON de integração de Depósito:
...
Exemplos de Mensagens
Mensagem XML
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <TOTVSMessage> <MessageInformation version="1.001"> <BranchId>D MG 01 </BranchId> <CompanyId>T1</CompanyId> <DeliveryType>Sync</DeliveryType> <GeneratedOn>2018-04-12T18:22:11Z</GeneratedOn> <Product name="PROTHEUSERP" version="12"/> <SourceApplication>P12_DEV_SERVERT1</SourceApplication> <StandardVersion>1.000</StandardVersion> <Transaction>WAREHOUSE</Transaction> <Type>BusinessMessage</Type> <UUID>44cfa927-e17f-8e85-1470-d1e4df8e084c</UUID> </MessageInformation> <BusinessMessage> <BusinessEvent> <Entity>Warehouse</Entity> <Event>upsert</Event> <Identification> <key name="InternalID">T1|D MG 01|67</key> </Identification> </BusinessEvent> <BusinessContent> <CompanyId>T1</CompanyId> <BranchId>D MG 01 </BranchId> <CompanyInternalId>T1|D MG 01 </CompanyInternalId> <Code>67</Code> <InternalId>T1|D MG 01|67</InternalId> <Description>TESTE ABASTECE</Description> <Active>true</Active> <WarehouseClassification>4</WarehouseClassification> <WorkCenterCode><<WorkCenterCode/WorkCenterCode>> <Type>1</Type> <IsFinalItem/> <IsQualityControl/> <IsProcess/> <IsWaste/> <IsRecycled/> <IsBalanceAvailable/> </BusinessContent> </BusinessMessage> </TOTVSMessage> |
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <TOTVSMessage> <MessageInformation version="1.001"> <BranchId>D MG 01 </BranchId> <CompanyId>T1</CompanyId> <DeliveryType>Sync</DeliveryType> <GeneratedOn>2018-04-12T15:18:12</GeneratedOn> <Product name="PIMS" version="12.1.21"/> <SourceApplication>PIMSCONNECTOR</SourceApplication> <StandardVersion>1.000</StandardVersion> <Transaction>WAREHOUSE</Transaction> <Type>Response</Type> <UUID>9011cd5d-358c-41e7-a6c0-88f209f5f1d9</UUID> </MessageInformation> <ResponseMessage> <ProcessingInformation> <ProcessedOn>2018-04-12T15:18:12</ProcessedOn> <Status>OK</Status> </ProcessingInformation> <ReceivedMessage> <MessageContent/> <SentBy>PROTHEUS</SentBy> <UUID>44cfa927-e17f-8e85-1470-d1e4df8e084c</UUID> </ReceivedMessage> <ReturnContent> <ListOfInternalId> <InternalId> <Destination>||4602662624698171414</Destination> <Name>WAREHOUSE</Name> <Origin>T1|D MG 01|67</Origin> </InternalId> <InternalId> <Destination>||5171572756468636673</Destination> <Name>WAREHOUSE</Name> <Origin>T1|D MG 01|67</Origin> </InternalId> <InternalId> <Destination>||5619309123229626031</Destination> <Name>WAREHOUSE</Name> <Origin>T1|D MG 01|67</Origin> </TOTVSMessage> |
...
InternalId>
<InternalId>
<Destination>||7253796814333016398</Destination>
<Name>WAREHOUSE</Name>
<Origin>T1|D MG 01|67</Origin>
</InternalId>
<InternalId>
<Destination>||7431944729412884967</Destination>
<Name>WAREHOUSE</Name>
<Origin>T1|D MG 01|67</Origin>
</InternalId>
</ListOfInternalId>
</ReturnContent>
</ResponseMessage>
</TOTVSMessage> |
Mensagem JSON
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "TOTVSMessage" : { "MessageInformation" : { "@version" : "1.001", "BranchId" : "D MG 01 ", "CompanyId" : "T1", "DeliveryType" : "Sync", "GeneratedOn" : "2018-04-12T18:22:11Z", "Product" : { "@name" : "PROTHEUSERP", "@version" : "12" }, "SourceApplication" : "P12_DEV_SERVERT1", "StandardVersion" : "1.000", "Transaction" : "WAREHOUSE", "Type" : "BusinessMessage", "UUID" : "44cfa927-e17f-8e85-1470-d1e4df8e084c" }, "BusinessMessage" : { "BusinessEvent" : { "Entity" : "Warehouse", "Event" : "upsert", "Identification" : { "key" : { "@name" : "InternalID", "$" : "T1|D MG 01|67" } } }, "BusinessContent" : { "CompanyId" : "T1", "BranchId" : "D MG 01 ", "CompanyInternalId" : "T1|D MG 01 ", "Code" : "67", "InternalId" : "T1|D MG 01|67", "Description" : "TESTE ABASTECE", "Active" : "true", "WarehouseClassification" : "4", "WorkCenterCode" : null, "Type" : "1", "IsFinalItem" : null, "IsQualityControl" : null, "IsProcess" : null, "IsWaste" : null, "IsRecycled" : null, "IsBalanceAvailable" : null } } } } |
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "1.001",
"BranchId" : "D MG 01 ",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-04-12T15:18:12",
"Product" : {
"@name" : "PIMS",
"@version" : "12.1.21"
},
"SourceApplication" : "PIMSCONNECTOR",
"StandardVersion" : "1.000",
"Transaction" : "WAREHOUSE",
"Type" : "Response",
"UUID" : "9011cd5d-358c-41e7-a6c0-88f209f5f1d9"
},
"ResponseMessage" : {
"ProcessingInformation" : {
"ProcessedOn" : "2018-04-12T15:18:12",
"Status" : "OK"
},
"ReceivedMessage" : {
"MessageContent" : null,
"SentBy" : "PROTHEUS",
"UUID" : "44cfa927-e17f-8e85-1470-d1e4df8e084c"
},
"ReturnContent" : {
"ListOfInternalId" : {
"InternalId" : [ {
"Destination" : "||4602662624698171414",
"Name" : "WAREHOUSE",
"Origin" : "T1|D MG 01|67"
}, {
"Destination" : "||5171572756468636673",
"Name" : "WAREHOUSE",
"Origin" : "T1|D MG 01|67"
}, {
"Destination" : "||5619309123229626031",
"Name" : "WAREHOUSE",
"Origin" : "T1|D MG 01|67"
}, {
"Destination" : "||7253796814333016398",
"Name" : "WAREHOUSE",
"Origin" : "T1|D MG 01|67"
}, {
"Destination" : "||7431944729412884967",
"Name" : "WAREHOUSE",
"Origin" : "T1|D MG 01|67"
} ]
}
}
}
}
} |
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 | CompanyId | String | 20 | Código da Empresaempresa |
BranchId | String | 10 | Código da Filialfilial | |
Code | Number | 10 | Código do Local local de Estoqueestoque | |
Description | String | 30 | Descrição do Local local de Estoqueestoque | |
Active | String | 1 | Local de Estoque Ativoestoque ativo? S = Sim N = Não | |
WarehouseClassification | Number | 1 | Classificação do Armazémarmazém 1 - Depósito 2 - Unidade Receptorareceptora 3 - Não Enviaenvia 4 - Depósito de Abastecimento abastecimento / Lubrificaçãolubrificação |
Limitações e Restrições
- Esta integração está disponível a partir da versão 12.1.14 do PIMS Multicultivos e PIMSConnector;
- Caso já exista o cadastro de depósito 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;
- Definir a classificação do armazém, essa classificação determinará qual entidade do PIMS receberá o cadastro;
- Nesta integração é possível incluir, alterar e excluir um Depósitodepósito. A exclusão somente será realizada, caso não haja relacionamento com outras entidades tanto no PIMS quanto no ERP;
- A integração de Depósitodepósito, Unidade Receptora unidade receptora e Ponto ponto de Abastecimento abastecimento poder ser utilizada em modo totalmente exclusivo ou compartilhada entre as Unidade Administrativasunidades administrativas;
- A integração de Depósitodepósito, Unidade Receptora unidade receptora e Ponto ponto de Abastecimento abastecimento permite que seja realizada a preambulação do código, onde será adicionado o código da Unidade Administrativa unidade administrativa junto ao código do deposito.