Histórico da Página

A integração de de Produtos (Insumos/Materiais) 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. Esta integração no PIMS Multicultivos é cadastrada em duas tabelas distintas, sendo assim é necessário existir no ERP, uma classificação que determina o tipo de item, se é Grupo de Insumo ou Grupo de Material Automotivo.

Informações da Mensagem

Identificador da Mensagem: Item
Versão: 3.001
Módulo PIMS Multicultivos: Tabelas > Insumos > Insumos / Tabelas > Manutenção > Material
Tipo de Envio: Assíncrona / Síncrona
Tipo de Evento: Upsert / Delete

Campos Obrigatórios

Código do Item;
Descrição do Item;
Tipo (16 - Insumo Agrícola / 17 - Material Automotivo);
Unidade de Medida;
Grupo do Produto.

Exemplos de Mensagens

Mensagem XML

Bloco de código

language	xml
title	Item_Envio
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="3.003">
		<BranchId>D MG 01 </BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-04-27T20:50:45Z</GeneratedOn>
		<Product name="ERP" version="12"/>
		<SourceApplication>P12_DEV_SERVERT1</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>ITEM</Transaction>
		<Type>BusinessMessage</Type>
		<UUID>209c8882-b7ca-89b5-9795-a54b3011f8d0</UUID>
	</MessageInformation>
	<BusinessMessage>
		<BusinessEvent>
			<Entity>Item</Entity>
			<Event>upsert</Event>
			<Identification>
				<key name="InternalID">T1|D MG 01|200</key>
			</Identification>
		</BusinessEvent>
		<BusinessContent>
			<CompanyId>T1</CompanyId>
			<BranchId>D MG 01</BranchId>
			<CompanyInternalId>T1|D MG 01</CompanyInternalId>
			<Code>200</Code>
			<InternalId>T1|D MG 01|200</InternalId>
			<Name>ITEM 200</Name>
			<ShortName>ITEM 200</ShortName>
			<Active>1</Active>
			<StockGroupCode>321</StockGroupCode>
			<StockGroupInternalId>T1|D MG 01|321</StockGroupInternalId>
			<StockGroupDescription>Fertilizantes</StockGroupDescription>
			<UnitOfMeasureCode>UN</UnitOfMeasureCode>
			<UnitOfMeasureInternalId>T1|D MG|UN</UnitOfMeasureInternalId>
			<StandardWarehouseCode>12</StandardWarehouseCode>
			<StandardWarehouseInternalId>T1|D MG 01|12</StandardWarehouseInternalId>
			<StandardWarehouseDescription>DEPOSITO COM INSUMOS</StandardWarehouseDescription>
			<EconomicLot>0</EconomicLot>
			<MinimumLot>0</MinimumLot>
			<StockControlType/>
			<NetWeight>0</NetWeight>
			<GrossWeight>0</GrossWeight>
			<Origin/>
			<FamilyCode/>
			<FamilyInternalId/>
			<FamilyDescription/>
			<ManufacturerCode/>
			<FiscalInformation>
				<PisRetaining>false</PisRetaining>
				<PisAliquot>0</PisAliquot>
				<CofinsRetaining>false </CofinsRetaining>
				<CofinsAliquot>0</CofinsAliquot>
				<CsllRetaining>false</CsllRetaining>
				<CsllAliquot>0</CsllAliquot>
				<IrrfIncidence>false</IrrfIncidence>
				<IssAliquot>0</IssAliquot>
				<IssServiceCode/>
				<MunicipalTaxCode/>
			</FiscalInformation>
			<ProductType>16</ProductType>
			<Trail>N</Trail>
			<BinControl>False</BinControl>
			<SecondUnitOfMeasureCode/>
			<SecondUnitOfMeasureInternalId/>
			<MultiplicationFactorValue>0</MultiplicationFactorValue>
			<Values>
				<CostPrice>0</CostPrice>
				<SalesPrice>0</SalesPrice>
				<AverageCostPrice>0</AverageCostPrice>
				<StandardCostPrice>0</StandardCostPrice>
			</Values>
			<EcommerceItemInformation>
				<ItemTitle/>
				<ItemDescription/>
				<ItemFeaturesTechnical/>
				<ItemHeight>0</ItemHeight>
				<ItemWidth>0</ItemWidth>
				<ItemLenght>0</ItemLenght>
				<ItemDimensions>0</ItemDimensions>
				<ItemStatus> </ItemStatus>
			</EcommerceItemInformation>
		</BusinessContent>
	</BusinessMessage>
</TOTVSMessage>

Bloco de código

language	xml
title	Item_Retorno
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TOTVSMessage>
	<MessageInformation version="3.003">
		<BranchId>D MG 01 </BranchId>
		<CompanyId>T1</CompanyId>
		<DeliveryType>Sync</DeliveryType>
		<GeneratedOn>2018-04-27T17:46:45</GeneratedOn>
		<Product name="PIMS" version="12.1.21"/>
		<SourceApplication>PIMSCONNECTOR</SourceApplication>
		<StandardVersion>1.000</StandardVersion>
		<Transaction>ITEM</Transaction>
		<Type>Response</Type>
		<UUID>fe60245c-dd2a-4f78-9e67-d6c0558c045a</UUID>
	</MessageInformation>
	<ResponseMessage>
		<ProcessingInformation>
			<ProcessedOn>2018-04-27T17:46:45</ProcessedOn>
			<Status>OK</Status>
		</ProcessingInformation>
		<ReceivedMessage>
			<MessageContent/>
			<SentBy>ERP</SentBy>
			<UUID>209c8882-b7ca-89b5-9795-a54b3011f8d0</UUID>
		</ReceivedMessage>
		<ReturnContent>
			<ListOfInternalId>
				<InternalId>
					<Destination>||3188980518467137755</Destination>
					<Name>ITEM</Name>
					<Origin>T1|D MG 01|200</Origin>
				</InternalId>
			</ListOfInternalId>
		</ReturnContent>
	</ResponseMessage>
</TOTVSMessage>

Mensagem JSON

Bloco de código

language	js
title	Item_Envio
linenumbers	true
collapse	true

{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "3.003",
			"BranchId" : "D MG 01 ",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-04-27T20:50:45Z",
			"Product" : {
				"@name" : "ERP",
				"@version" : "12"
			},
			"SourceApplication" : "P12_DEV_SERVERT1",
			"StandardVersion" : "1.000",
			"Transaction" : "ITEM",
			"Type" : "BusinessMessage",
			"UUID" : "209c8882-b7ca-89b5-9795-a54b3011f8d0"
		},
		"BusinessMessage" : {
			"BusinessEvent" : {
				"Entity" : "Item",
				"Event" : "upsert",
				"Identification" : {
					"key" : {
						"@name" : "InternalID",
						"$" : "T1|D MG 01|200"
					}
				}
			},
			"BusinessContent" : {
				"CompanyId" : "T1",
				"BranchId" : "D MG 01",
				"CompanyInternalId" : "T1|D MG 01",
				"Code" : "200",
				"InternalId" : "T1|D MG 01|200",
				"Name" : "ITEM 200",
				"ShortName" : "ITEM 200",
				"Active" : "1",
				"StockGroupCode" : "321",
				"StockGroupInternalId" : "T1|D MG 01|321",
				"StockGroupDescription" : "Fertilizantes",
				"UnitOfMeasureCode" : "UN",
				"UnitOfMeasureInternalId" : "T1|D MG|UN",
				"StandardWarehouseCode" : "12",
				"StandardWarehouseInternalId" : "T1|D MG 01|12",
				"StandardWarehouseDescription" : "DEPOSITO COM INSUMOS",
				"EconomicLot" : "0",
				"MinimumLot" : "0",
				"StockControlType" : null,
				"NetWeight" : "0",
				"GrossWeight" : "0",
				"Origin" : null,
				"FamilyCode" : null,
				"FamilyInternalId" : null,
				"FamilyDescription" : null,
				"ManufacturerCode" : null,
				"FiscalInformation" : {
					"PisRetaining" : "false",
					"PisAliquot" : "0",
					"CofinsRetaining" : "false ",
					"CofinsAliquot" : "0",
					"CsllRetaining" : "false",
					"CsllAliquot" : "0",
					"IrrfIncidence" : "false",
					"IssAliquot" : "0",
					"IssServiceCode" : null,
					"MunicipalTaxCode" : null
				},
				"ProductType" : "16",
				"Trail" : "N",
				"BinControl" : "False",
				"SecondUnitOfMeasureCode" : null,
				"SecondUnitOfMeasureInternalId" : null,
				"MultiplicationFactorValue" : "0",
				"Values" : {
					"CostPrice" : "0",
					"SalesPrice" : "0",
					"AverageCostPrice" : "0",
					"StandardCostPrice" : "0"
				},
				"EcommerceItemInformation" : {
					"ItemTitle" : null,
					"ItemDescription" : null,
					"ItemFeaturesTechnical" : null,
					"ItemHeight" : "0",
					"ItemWidth" : "0",
					"ItemLenght" : "0",
					"ItemDimensions" : "0",
					"ItemStatus" : " "
				}
			}
		}
	}
}

Bloco de código

language	js
title	Item_Retorno
linenumbers	true
collapse	true

{
	"TOTVSMessage" : {
		"MessageInformation" : {
			"@version" : "3.003",
			"BranchId" : "D MG 01 ",
			"CompanyId" : "T1",
			"DeliveryType" : "Sync",
			"GeneratedOn" : "2018-04-27T17:46:45",
			"Product" : {
				"@name" : "PIMS",
				"@version" : "12.1.21"
			},
			"SourceApplication" : "PIMSCONNECTOR",
			"StandardVersion" : "1.000",
			"Transaction" : "ITEM",
			"Type" : "Response",
			"UUID" : "fe60245c-dd2a-4f78-9e67-d6c0558c045a"
		},
		"ResponseMessage" : {
			"ProcessingInformation" : {
				"ProcessedOn" : "2018-04-27T17:46:45",
				"Status" : "OK"
			},
			"ReceivedMessage" : {
				"MessageContent" : null,
				"SentBy" : "ERP",
				"UUID" : "209c8882-b7ca-89b5-9795-a54b3011f8d0"
			},
			"ReturnContent" : {
				"ListOfInternalId" : {
					"InternalId" : {
						"Destination" : "||3188980518467137755",
						"Name" : "ITEM",
						"Origin" : "T1|D MG 01|200"
					}
				}
			}
		}
	}
}

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	Code	String	10	Código do Item
	Name	String	60	Descrição do Item
	ShortName	String	20	Descrição curta do Item
	Active	Number	1	Item Ativo?
	StockGroupCode	String	20	Código do Grupo de Estoque
	UnitOfMeasureCode	String	20	Código da Unidade de Medida
	ProductType	Number	2	Tipo de de produto 16 - Insumo Agrícola 17 - Material Automotivo
	Trail	String	1	Rastro por lote ou sublote, sem rastro S - SubLote L - Lote N - Não utiliza rastrobit
	BinControl	String	6	Campo que identifica se o produto possui localização - Fa

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 Item 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;
Para a integração de Insumo é obrigatório informar o Grupo de Produtos;
É necessário que o Grupo Produtos informado esteja devidamente cadastrado no PIMS, caso contrário a integração não será realizada;
É necessário que a Unidade de Medida informada esteja devidamente cadastrada no PIMS, caso contrário a integração não será realizada.

Páginas filhas

Versões comparadas

Versão antiga 3

Nova versão 4

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