Páginas filhas
  • DI Fornecedor - CustomerVendor

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

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

CustomerVendor_Envio
{
	"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"
				}
			}
		}
	}
}
CustomerVendor_Retorno
{
	"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
BranchIdString10

Código da filial

Code

Number

20

Código do cliente ou fornecedor

ShortNameString

20

Nome reduzido
NameString40Nome 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.