A integração de fornecedor ou prestadores de serviço 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.
- Identificador da Mensagem: CustomerVendor
- Versão: 2.002
- Módulo PIMS Multicultivos: Tabelas > Administrativo > Prestador de Serviço
- Tipo de Envio: Assíncrona / Síncrona
- Tipo de Evento: Upsert / Delete
Campos Obrigatórios
- Código do fornecedor;
- Descrição do fornecedor;
- Empresa;
- Filial.
Exemplos de Mensagens
Mensagem XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="2.002">
<BranchId>T1</BranchId>
<CompanyId>D MG 01</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-05-09T12:00:05-03:00</GeneratedOn>
<Product name="ERP" version="11"/>
<SourceApplication>P12_DEV_SERVERT1</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>CUSTOMERVENDOR</Transaction>
<Type>BusinessMessage</Type>
<UUID>386350dc-e8f7-44b8-9f23-e23c86ba9746</UUID>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>CustomerVendor</Entity>
<Event>upsert</Event>
<Identification>
<key name="InternalID">T1|D MG|TOTVS</key>
</Identification>
</BusinessEvent>
<BusinessContent>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<Code>6731</Code>
<ShortName>TOTVS</ShortName>
<Name>TOTVS ASSIS</Name>
<Type>Vendor</Type>
<EntityType>Company</EntityType>
<RegisterSituation>Active</RegisterSituation>
<Address>
<Address>RUA SEBASTIÃO DA SILVA LEITE, 1.333</Address>
<City>
<CityDescription>ASSIS</CityDescription>
</City>
<State>
<StateCode>SP</StateCode>
<StateDescription>SÃO PAULO</StateDescription>
</State>
<ZIPCode>19800-200</ZIPCode>
</Address>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
<MessageInformation version="2.002">
<BranchId>T1</BranchId>
<CompanyId>D MG 01</CompanyId>
<DeliveryType>Sync</DeliveryType>
<GeneratedOn>2018-05-09T12:01:23</GeneratedOn>
<Product name="PIMS" version="12.1.20.1"/>
<SourceApplication>PIMSCONNECTOR</SourceApplication>
<StandardVersion>1.000</StandardVersion>
<Transaction>CUSTOMERVENDOR</Transaction>
<Type>Response</Type>
<UUID>64c74dc7-c89c-4e41-87b6-b513efa80d2b</UUID>
</MessageInformation>
<ResponseMessage>
<ProcessingInformation>
<ProcessedOn>2018-05-09T12:01:23</ProcessedOn>
<Status>OK</Status>
</ProcessingInformation>
<ReceivedMessage>
<MessageContent/>
<SentBy>ERP</SentBy>
<UUID>386350dc-e8f7-44b8-9f23-e23c86ba9746</UUID>
</ReceivedMessage>
<ReturnContent>
<ListOfInternalId>
<InternalId>
<Destination>04|04|1808041034693099076</Destination>
<Name>CUSTOMERVENDOR</Name>
<Origin>0</Origin>
</InternalId>
</ListOfInternalId>
</ReturnContent>
</ResponseMessage>
</TOTVSMessage>
Mensagem JSON
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "2.002",
"BranchId" : "T1",
"CompanyId" : "D MG 01",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-05-09T12:00:05-03:00",
"Product" : {
"@name" : "ERP",
"@version" : "11"
},
"SourceApplication" : "P12_DEV_SERVERT1",
"StandardVersion" : "1.000",
"Transaction" : "CUSTOMERVENDOR",
"Type" : "BusinessMessage",
"UUID" : "386350dc-e8f7-44b8-9f23-e23c86ba9746"
},
"BusinessMessage" : {
"BusinessEvent" : {
"Entity" : "CustomerVendor",
"Event" : "upsert",
"Identification" : {
"key" : {
"@name" : "InternalID",
"$" : "T1|D MG|TOTVS"
}
}
},
"BusinessContent" : {
"CompanyId" : "T1",
"BranchId" : "D MG 01",
"Code" : "6731",
"ShortName" : "TOTVS",
"Name" : "TOTVS ASSIS",
"Type" : "Vendor",
"EntityType" : "Company",
"RegisterSituation" : "Active",
"Address" : {
"Address" : "RUA SEBASTIÃO DA SILVA LEITE, 1.333",
"City" : {
"CityDescription" : "ASSIS"
},
"State" : {
"StateCode" : "SP",
"StateDescription" : "SÃO PAULO"
},
"ZIPCode" : "19800-200"
}
}
}
}
}
{
"TOTVSMessage" : {
"MessageInformation" : {
"@version" : "2.002",
"BranchId" : "T1",
"CompanyId" : "D MG 01",
"DeliveryType" : "Sync",
"GeneratedOn" : "2018-05-09T12:01:23",
"Product" : {
"@name" : "PIMS",
"@version" : "12.1.20.1"
},
"SourceApplication" : "PIMSCONNECTOR",
"StandardVersion" : "1.000",
"Transaction" : "CUSTOMERVENDOR",
"Type" : "Response",
"UUID" : "64c74dc7-c89c-4e41-87b6-b513efa80d2b"
},
"ResponseMessage" : {
"ProcessingInformation" : {
"ProcessedOn" : "2018-05-09T12:01:23",
"Status" : "OK"
},
"ReceivedMessage" : {
"MessageContent" : null,
"SentBy" : "ERP",
"UUID" : "386350dc-e8f7-44b8-9f23-e23c86ba9746"
},
"ReturnContent" : {
"ListOfInternalId" : {
"InternalId" : {
"Destination" : "04|04|1808041034693099076",
"Name" : "CUSTOMERVENDOR",
"Origin" : "0"
}
}
}
}
}
}
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 empresa |
BranchId | String | 10 | Código da filial |
Code | Number | 20 | Código do cliente ou fornecedor |
ShortName | String | 20 | Nome reduzido |
Name | String | 40 | Nome do cliente ou fornecedor |
Type |
String | 10 | Tipo de registro - Customer - Cliente
- Vendor - Fornecedor
- Both - Ambos
|
EntityType |
String |
10 | Tipo de pessoa - Person - Física
- Company - Jurídica
|
RegisterSituation |
String |
10 | Situação - Active - Ativo
- Inactive - Inativo
- Canceled - Cancelado
- Pending - Pendente
- Suspended - Suspenso
|
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 fornecedor 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;
- A integração de fornecedor pode ser utilizada em modo totalmente exclusivo ou compartilhada entre as unidades administrativas.