Histórico da Página

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:

...

Exemplos de Mensagens

Mensagem XML

Bloco de código

language	xml
title	CustomerVendor_XMLEnvio
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="2.002">
		<BranchId>D MG 01<<BranchId>T1</BranchId>
		<CompanyId>T1<<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>2<StandardVersion>1.002<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="InternalIdInternalID">T1|D MG 01|6731<TOTVS</key>
			</Identification>
		</BusinessEvent>
		<BusinessContent>
			<CompanyId>T1</CompanyId>
			<BranchId>D MG 01</BranchId>
			<Code>6731</Code>
			<ShortName>TOTVS</ShortName>
			<Name>TOTVS S.A.<ASSIS</Name>
			<Type>Vendor</Type>
			<EntityType>Company</EntityType>
			<RegisterSituation>Active</RegisterSituation>
			<Address>
				<Address>Av. PAULISTA<Address>RUA SEBASTIÃO DA SILVA LEITE, 1.023<333</Address>
				<City>
					<CityDescription>SÃO PAULO<<CityDescription>ASSIS</CityDescription>
				</City>
				<State>
					<StateCode>SP</StateCode>
					<StateDescription>SÃO PAULO</StateDescription>
				</State>
				<ZIPCode>87703<ZIPCode>19800-020<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_JSONEnvio
linenumbers	true
collapse	true

{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "2.002",
			"BranchId" : "D MG 01T1",
			"CompanyId" : "T1D MG 01",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-05-09T12:00:05-03:00",
			"Product" : {
				"@name" : "ERP",
				"@version" : "11"
			},
			"SourceApplication" : "P12_DEV_SERVERT1",
			"StandardVersion" : "21.002000",
			"Transaction" : "CUSTOMERVENDOR",
			"Type" : "BusinessMessage",
			"UUID" : "386350dc-e8f7-44b8-9f23-e23c86ba9746"
		},
		"BusinessMessage" : {
			"BusinessEvent" : {
				"Entity" : "CustomerVendor",
				"Event" : "upsert",
				"Identification" : {
					"key" : {
						"@name" : "InternalIdInternalID",
						"$" : "T1|D MG 01|6731TOTVS"
					}
				}
			},
			"BusinessContent" : {
				"CompanyId" : "T1",
				"BranchId" : "D MG 01",
				"Code" : "6731",
				"ShortName" : "TOTVS",
				"Name" : "TOTVS S.A.ASSIS",
				"Type" : "Vendor",
				"EntityType" : "Company",
				"RegisterSituation" : "Active",
				"Address" : {
					"Address" : "Av. PAULISTARUA SEBASTIÃO DA SILVA LEITE, 1.023333",
					"City" : {
						"CityDescription" : "SÃO PAULOASSIS"
					},
					"State" : {
						"StateCode" : "SP",
						"StateDescription" : "SÃO PAULO"
					},
					"ZIPCode" : "87703-020"" : "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 Empresaempresa
	BranchId	String	10	Código da Filialfilial
	Code	Number	20	Código do Cliente cliente ou Fornecedorfornecedor
	ShortName	String	20	Nome reduzido
	Name	String	40	Nome do Cliente cliente ou Fornecedorfornecedor
	Type	String	10	Tipo de Registroregistro Customer - Cliente Vendor - Fornecedor Both - Ambos
	EntityType	String	10	Tipo de Pessoapessoa 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.

Páginas filhas

Versões comparadas

Versão antiga 4

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