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: Prestador de Serviços
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.

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

Exemplo de Mensagem XML

Bloco de código

language	xml
title	CustomerVendor_XML
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="2.002">
		<BranchId>D MG 01</BranchId>
		<CompanyId>T1</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.002</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 01|6731</key>
			</Identification>
		</BusinessEvent>
		<BusinessContent>
			<CompanyId>T1</CompanyId>
			<BranchId>D MG 01</BranchId>
			<Code>6731</Code>
			<ShortName>TOTVS</ShortName>
			<Name>TOTVS S.A.</Name>
			<Type>Vendor</Type>
			<EntityType>Company</EntityType>
			<RegisterSituation>Active</RegisterSituation>
			<Address>
				<Address>Av. PAULISTA, 1.023</Address>
				<City>
					<CityDescription>SÃO PAULO</CityDescription>
				</City>
				<State>
					<StateCode>SP</StateCode>
					<StateDescription>SÃO PAULO</StateDescription>
				</State>
				<ZIPCode>87703-020</ZIPCode>
			</Address>
		</BusinessContent>
	</BusinessMessage>
</TOTVSMessage>

Exemplo de Mensagem JSON

Bloco de código

language	js
title	CustomerVendor_JSON
linenumbers	true
collapse	true

{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "2.002",
			"BranchId" : "D MG 01",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-05-09T12:00:05-03:00",
			"Product" : {
				"@name" : "ERP",
				"@version" : "11"
			},
			"SourceApplication" : "P12_DEV_SERVERT1",
			"StandardVersion" : "2.002",
			"Transaction" : "CUSTOMERVENDOR",
			"Type" : "BusinessMessage",
			"UUID" : "386350dc-e8f7-44b8-9f23-e23c86ba9746"
		},
		"BusinessMessage" : {
			"BusinessEvent" : {
				"Entity" : "CustomerVendor",
				"Event" : "upsert",
				"Identification" : {
					"key" : {
						"@name" : "InternalId",
						"$" : "T1|D MG 01|6731"
					}
				}
			},
			"BusinessContent" : {
				"CompanyId" : "T1",
				"BranchId" : "D MG 01",
				"Code" : "6731",
				"ShortName" : "TOTVS",
				"Name" : "TOTVS S.A.",
				"Type" : "Vendor",
				"EntityType" : "Company",
				"RegisterSituation" : "Active",
				"Address" : {
					"Address" : "Av. PAULISTA, 1.023",
					"City" : {
						"CityDescription" : "SÃO PAULO"
					},
					"State" : {
						"StateCode" : "SP",
						"StateDescription" : "SÃO PAULO"
					},
					"ZIPCode" : "87703-020"
				}
			}
		}
	}
}

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

Páginas filhas

Versões comparadas

Versão antiga 4

Nova versão 5

Chave