Histórico da Página

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.

Informações da Mensagem

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

Bloco de código

language	xml
title	CustomerVendor_Envio
linenumbers	true
collapse	true

<?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

language	xml
title	CustomerVendor_Retorno
linenumbers	true
collapse	true

<?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

language	js
title	CustomerVendor_Envio
linenumbers	true
collapse	true

{
	"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

language	js
title	CustomerVendor_Retorno
linenumbers	true
collapse	true

{
	"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

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.

Páginas filhas

Versões comparadas

Versão antiga 10

Nova versão Atual

Chave

Informações da Mensagem

Campos Obrigatórios

Exemplos de Mensagens

Mensagem XML

Mensagem JSON

Descrição Detalhada das Tags

Limitações e Restrições