Histórico da Página
Esta integração consiste na movimentação do cadastro de Unidade unidade de Medida medida do ERP para o PIMS, ou seja, será realizado no ERP e enviado para o PIMS através do PIMSConnector.
Informações da Mensagem
- Identificador da Mensagem: Unidade de Medidas UnitOfMeasure
- Versão: 2.000
- Módulo <PIMS Multicultivos>: < PIMS Multicultivos: Tabelas > Básicos > Unidade de Medidas>Medida
- Tipo de Envio: <Assíncrona Assíncrona / Síncrona>Síncrona
- Tipo de Evento: Upsert / Delete
Campos Obrigatórios
...
- Código da unidade de medida;
Descriçã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 Unidade de Medidas 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;
- Nesta integração é possível incluir, alterar e excluir uma Unidade de Medida. A exclusão somente será realizada, caso não haja relacionamento com outras entidades tanto no PIMS quanto no ERP.
da unidade de medida.
Exemplos de Mensagens
...
Mensagem XML
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <TOTVSMessage> <MessageInformation version="2.002"> <BranchId>L<BranchId>D MG 01<01 </BranchId> <CompanyId>T2<<CompanyId>T1</CompanyId> <DeliveryType>Sync</DeliveryType> <GeneratedOn>2018-0304-20T1212T18:4957:39Z<48Z</GeneratedOn> <Product name="PROTHEUSERP" version="12"/> <SourceApplication>P12_DEV_SERVERT2<SERVERT1</SourceApplication> <StandardVersion>1.000</StandardVersion> <Transaction>UNITOFMEASURE</Transaction> <Type>BusinessMessage</Type> <UUID>69f90943<UUID>d2343590-9cfce52b-b5e9377b-b485db58-500f17604e38<b4fe08ca2fb8</UUID> </MessageInformation> <BusinessMessage> <BusinessEvent> <Entity>UnitOfMeasure</Entity> <Event>upsert</Event> <Identification> <key name="InternalID">T2>T1|LD MG|AR<UN</key> </Identification> </BusinessEvent> <BusinessContent> <Code>AR<<Code>UN</Code> <InternalId>T2<InternalId>T1|LD MG|AR<UN</InternalId> <Description>ARROBA<<Description>UNIDADE</Description> <ShortName>ARROBA_<<ShortName>UNIDADE</ShortName> </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-04-12T15:53:50</GeneratedOn>
<Product name="PIMS" version="12.1.21"/>
<SourceApplication>PIMSCONNECTOR</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>UNITOFMEASURE</Transaction>
<Type>Response</Type>
<UUID>25f969ec-3803-4c61-b42f-4a710161692b</UUID>
</MessageInformation>
<ResponseMessage>
<ProcessingInformation>
<ProcessedOn>2018-04-12T15:53:50</ProcessedOn>
<Status>OK</Status>
</ProcessingInformation>
<ReceivedMessage>
<MessageContent/>
<SentBy>ERP</SentBy>
<UUID>d2343590-e52b-377b-db58-b4fe08ca2fb8</UUID>
</ReceivedMessage>
<ReturnContent>
<ListOfInternalId>
<InternalId>
<Destination>||1645600824977155300</Destination>
<Name>UNITOFMEASURE</Name>
<Origin>T1|D MG|UN</Origin>
</InternalId>
</ListOfInternalId>
</ReturnContent>
</ResponseMessage>
</TOTVSMessage> |
Mensagem JSON
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "TOTVSMessage" : { "MessageInformation" : { "@version" : "2.002", "BranchId" : "LD MG 01 ", "CompanyId" : "T2T1", "DeliveryType" : "Sync", "GeneratedOn" : "2018-0304-20T1212T18:4957:39Z48Z", "Product" : { "@name" : "PROTHEUSERP", "@version" : "12" }, "SourceApplication" : "P12_DEV_SERVERT2SERVERT1", "StandardVersion" : "1.000", "Transaction" : "UNITOFMEASURE", "Type" : "BusinessMessage", "UUID" : "69f90943d2343590-9cfce52b-b5e9377b-b485db58-500f17604e38b4fe08ca2fb8" }, "BusinessMessage" : { "BusinessEvent" : { "Entity" : "UnitOfMeasure", "Event" : "upsert", "Identification" : { "key" : { "@name" : "InternalID", "$" : "T2T1|LD MG|ARUN" } } }, "BusinessContent" : { "Code" : "ARUN", "InternalId" : "T2T1|LD MG|ARUN", "Description" : "ARROBAUNIDADE", "ShortName" : "ARROBA_UNIDADE" } } } } |
...
DeliveryType
String
5
Forma de entrega da mensagem que foi gerada. Será definida por quem entrega a mensagem
...
Identifica o tipo de Mensagem:
- BusinessMessage
- Response
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "2.002",
"BranchId" : "D MG 01 ",
"CompanyId" : "T1",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-04-12T15:53:50",
"Product" : {
"@name" : "PIMS",
"@version" : "12.1.21"
},
"SourceApplication" : "PIMSCONNECTOR",
"StandardVersion" : "1.000",
"Transaction" : "UNITOFMEASURE",
"Type" : "Response",
"UUID" : "25f969ec-3803-4c61-b42f-4a710161692b"
},
"ResponseMessage" : {
"ProcessingInformation" : {
"ProcessedOn" : "2018-04-12T15:53:50",
"Status" : "OK"
},
"ReceivedMessage" : {
"MessageContent" : null,
"SentBy" : "ERP",
"UUID" : "d2343590-e52b-377b-db58-b4fe08ca2fb8"
},
"ReturnContent" : {
"ListOfInternalId" : {
"InternalId" : {
"Destination" : "||1645600824977155300",
"Name" : "UNITOFMEASURE",
"Origin" : "T1|D MG|UN"
}
}
}
}
}
} |
Descrição Detalhada das Tags
...
Definição das Tags Utilizadas no Processo de Integração
...
TOTVSMessage
...
MessageInformation
...
TAG
...
Tipo
...
Tamanho
...
Descritivo
...
BranchId
...
String
...
10
...
Representa o id do estabelecimento do usuário que enviou a mensagem.
...
CompanyId
...
String
...
20
...
Representa o id da empresa do usuário que enviou a mensagem.
...
DeliveryType
...
String
...
5
...
Forma de entrega da mensagem que foi gerada. Será definida por quem entrega a mensagem.
· Sync
· Async
...
GeneratedOn
...
DateTime
...
-
...
Registra a data e hora em que a mensagem foi gerada. Observe que este campo é do tipo datetime e que é sugerido que se acrescente a identificação do fuso horário. Caso a informação de fuso não esteja presente, os sistemas entenderão o horário como GMT-0.
...
Product
...
String
...
60
...
Define qual o produto que originou esta mensagem.
...
SourceApplication
...
String
...
60
...
Define qual o Aplicativo que originou esta mensagem.
...
StandardVersion
...
String
...
20
...
Versão da Mensagem
...
Transaction
...
String
...
50
...
Identifica o nome da transação que esta mensagem contém. Exemplo: Branch.
...
Types
...
String
...
20
...
Identifica o tipo de mensagem
· BusinessMessage
· Response
· Receipt
...
UUID
...
String
...
36
...
Define um identificador universal para esta mensagem. Duas mensagens não podem ter o mesmo UUID e este valor permanece sempre o mesmo, seja no aplicativo que gera a mensagem, seja no que recebe.
...
BusinessMessage
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 | String | 4 | Código da |
...
unidade de |
...
medida | |||
Description | String | 30 | Descrição da |
...
unidade de |
...
medida | |||
ShortName | String | 10 | Descrição |
...
abreviada da |
...
unidade de medida |
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 unidade de medida 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", 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;
- Nesta integração é possível incluir, alterar e excluir uma unidade de medida. A exclusão somente será realizada, caso não haja relacionamento com outras entidades tanto no PIMS quanto no ERP.
...