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: 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.

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 Empresaempresa
BranchIdString10

Código da Filialfilial

Code

Number

20

Código do Cliente cliente ou Fornecedorfornecedor

ShortNameString

20

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