Páginas filhas
  • DI Fornecedor - CustomerVendor

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

A integração de Fornecedor fornecedor ou Prestadores prestadores de Serviço 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. 

Informações da Mensagem

  • Identificador da Mensagem: CustomerVendor
  • Versão: 2.002
  • Módulo PIMS Multicultivos: Prestador de Serviços Tabelas > Administrativo > Prestador de Serviço
  • Tipo de Envio: Assíncrona / Síncrona
  • Tipo de Evento: Upsert / Delete

Campos Obrigatórios

  • Código do Fornecedorfornecedor;
  • Descrição do Fornecedorfornecedor;
  • Empresa;
  • Filial.

Segue abaixo exemplos de mensagens XML e JSON de integração de Família de Material:

Exemplo de Mensagem XML

...

Exemplos de Mensagens

Mensagem XML

Bloco de código
languagexml
titleCustomerVendor_Envio
linenumberstrue
collapsetrue
<?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>
Bloco de código
languagexml
titleCustomerVendor_Retorno
linenumberstrue
collapsetrue
<?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

Bloco de código
languagejs
titleCustomerVendor_Envio
linenumberstrue
collapsetrue
{
	"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"
				}
			}
		}
	}
}
Bloco de código
languagejs
titleCustomerVendor_Retorno
linenumberstrue
collapsetrue
{
	"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"
					}
				}
			}
		}
	}
}

Descrição Detalhada das Tags

SEGMENTOTAGSTIPOTAMANHODESCRITIVO DA TAG


BusinessEvent

EntityString50Nome da entidade que gerou o evento
EventString10Qual foi o evento associado à mensagem (pode ser upsert – inclusão/alteração ou delete – eliminação)
IdentificationString-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

CompanyIdString20Código da
Empresa
empresa
BranchIdString10

Código da

Filial

filial

Code

Number

20

Código do

Cliente

cliente ou

Fornecedor

fornecedor

ShortNameString

20

Nome reduzido
NameString40Nome do
Cliente
cliente ou
Fornecedor
fornecedor


Type


String

10

Tipo de

Registro

registro

  • Customer - Cliente
  • Vendor - Fornecedor
  • Both - Ambos


EntityType


String


10

Tipo de

Pessoa

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 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 Prestador de Serviços fornecedor pode ser utilizada em modo totalmente exclusivo ou compartilhada entre as Unidades Administrativasunidades administrativas.