Product information (PI)

Add product information to build the product register. You can update existing products, add new products, enter product dimensions, and add a product image by providing an image ID or URL.

To update products that are already in the database, send new messages with the same ExtProductId to eManager at any time. eManager scans the changes regularly and updates the product register.

Data structure

The following data structure is used to import product information into eManager:

Field name	Type	Length	Mandatory	Description
TransactionId	Integer	32-bit	No	Unique id for transaction
ExtProductId	String	50	Yes	Product identification from main system
ProductName	String	100	Yes	Product name
InitialSalesUnit	String	50	Yes	Default sales unit
ProductDesc	String	100	No	Product description
EanId	String	50	No	EAN number
ProducerProductId	String	50	No	Producers product identification
VendorProductId	String	50	No	Vendors product identification
DisplayExtProductId	String	50	No	Alternative product identification
SalesUnitWeight	Decimal	18,6	No	Weight per salesunit in kg
SalesUnitWidth	Integer	32-bit	No	Width per salesunit in millimeters
SalesUnitDepth	Integer	32-bit	No	Depth per salesunit in millimeters
SalesUnitHeight	Integer	32-bit	No	Height per salesunit in millimeters
SalesUnitsPerStockUnit	Integer	32-bit	No	Salesunits per stockunit (D-Pack)
ImageId	String	250	No	Url to image
MandatoryScan	Bool	1	No	When true will enforce scan of sku during outbound. This can be combined with global scanning rules.

Transport

The API reference contains more details about how to send a PI using HTTP transport: ProductImport.

Examples

XML

<?xml version="1.0" encoding="UTF-8"?>
<ImportOperation>
  <Lines>
    <ProductLine>
      <TransactionId>1506189</TransactionId>
      <ExtProductId>214522</ExtProductId>
      <ProductName>Rab Torque Capris Whale/ Quince 30</ProductName>
      <InitialSalesUnit>PCE</InitialSalesUnit>
      <ProductDesc>Small</ProductDesc>
      <EanId>123456789</EanId>
      <ProducerProductId>QFT-13-WH-S</ProducerProductId>
      <VendorProductId>257468157</VendorProductId>
      <DisplayExtProductId>Capris-214522</DisplayExtProductId>
      <SalesUnitWeight>0.500</SalesUnitWeight>
      <SalesUnitWidth>141</SalesUnitWidth>
      <SalesUnitDepth>101</SalesUnitDepth>
      <SalesUnitHeight>17</SalesUnitHeight>
      <SalesUnitsPerStockUnit>10</SalesUnitsPerStockUnit>
      <ImageId>ProductImageId</ImageId>
      <MandatoryScan>true</MandatoryScan>
    </ProductLine>
    <ProductLine>
      <TransactionId>1506190</TransactionId>
      <ExtProductId>214523</ExtProductId>
      <ProductName>Rab Torque Capris Whale/ Quince 30</ProductName>
      <InitialSalesUnit>PCE</InitialSalesUnit>
      <EanId>987654321</EanId>
      <ProducerProductId>QFT-13-WH-M</ProducerProductId>
      <SalesUnitWeight>0.500</SalesUnitWeight>
      <SalesUnitWidth>1</SalesUnitWidth>
      <SalesUnitDepth>1</SalesUnitDepth>
      <SalesUnitHeight>1</SalesUnitHeight>
      <SalesUnitsPerStockUnit>1</SalesUnitsPerStockUnit>
      <ImageId>ProductImageId</ImageId>
      <MandatoryScan>false</MandatoryScan>
    </ProductLine>
    <ProductLine>
      <TransactionId>1506191</TransactionId>
      <ExtProductId>214524</ExtProductId>
      <ProductName>Rab Torque Capris Whale/ Quince 32</ProductName>
      <InitialSalesUnit>PCE</InitialSalesUnit>
      <EanId>549871236</EanId>
      <ProducerProductId>QFT-13-WH-L</ProducerProductId>
      <SalesUnitWeight>0.500</SalesUnitWeight>
      <SalesUnitWidth>10</SalesUnitWidth>
      <SalesUnitDepth>12</SalesUnitDepth>
      <SalesUnitHeight>34</SalesUnitHeight>
      <SalesUnitsPerStockUnit>1</SalesUnitsPerStockUnit>
      <ImageId>ProductImageId</ImageId>
      <MandatoryScan>true</MandatoryScan>
    </ProductLine>
  </Lines>
</ImportOperation>