Páginas filhas
  • DI Produto - Item

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

A integração de de Produtos 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 grupo de Insumo insumo ou Grupo grupo de Material Automotivomaterial 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 Itemitem;
  • Descrição do Itemitem;
  • Tipo (16 - Insumo Agrícola / 17 - Material Automotivo);
  • Unidade de Medidamedida;
  • Grupo do Produtoproduto.

Exemplos de Mensagens

Mensagem XML

Bloco de código
languagexml
titleItem_Envio
linenumberstrue
collapsetrue
<?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
languagexml
titleItem_Retorno
linenumberstrue
collapsetrue
<?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
languagejs
titleItem_Envio
linenumberstrue
collapsetrue
{
	"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
languagejs
titleItem_Retorno
linenumberstrue
collapsetrue
{
	"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

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

CodeString10Código do Itemitem
NameString60Descrição do Itemitem
ShortNameString20Descrição curta do Itemitem


Active


Number


1

Situação do item

  • 0 - Inativo
  • 1 - Ativo
Item Ativo?
StockGroupCodeString20Código do Grupo grupo de Estoqueestoque
UnitOfMeasureCodeString20Código da Unidade unidade de Medidamedida


ProductType


Number


2

Tipo de de produto

  • 16 - Insumo Agrícolaagrícola
  • 17 - Material Automotivoautomotivo


Trail


String


1

Rastro por lote ou sublote, sem rastro

  • S - SubLoteSub lote
  • L - Lote
  • N - Não utiliza rastrobit
BinControlString6Campo 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 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 grupo de Produtosprodutos;
  • É necessário que o Grupo Produtos grupo produtos informado esteja devidamente cadastrado no PIMS, caso contrário a integração não será realizada;
  • É necessário que a Unidade unidade de Medida medida informada esteja devidamente cadastrada no PIMS, caso contrário a integração não será realizada.