Field | Corresponding customer information | Corresponding vendor information |
---|---|---|
External item number | The customer's item number | The vendor's item number |
Description | The name that the customer associates with the item | The name that the vendor associates with the item |
External item text | The customer's item description | The vendor's item description |
Entity name | Import identifiers | Export identifiers | Comments |
---|---|---|---|
Products V2 | Product number, product search name, product name, product description | Product number, product search name, product name, product description | Depending on the settings of the entity and the number sequence for the product number, the product number can be automatically created at the time of import. |
Product variants | Product number, product search name, product name, product description | Product number, product search name, product name, product description | Depending on the product nomenclature template, the product number can be automatically created at the time of import. However, you can import any unique product number, and that product number doesn't have to follow the structure of the product nomenclature templates. |
Product translations | Product name, product description | Product name, product description | This entity overwrites any language. Note that when the name or description of a legal entity's primary language is overwritten, the name and description of the product itself is changed. |
Released product creation V2 | Item number, product number, item search name | Item number, product number, item search name, product search name, product name | This entity can be a challenge when number sequences are used during the creation of new released products. Both the Item number number sequence and the Product number number sequence have an influence. However, the Item number number sequence is per legal entity, whereas the Product number number sequence is global. Therefore, we don't recommend that you use the Item number number sequence when you deploy new released products. Obviously, when the entity is used to release an existing product, the product number must be given in the entity. For more information, see the 'Product and item number sequences' section in this topic. |
Released product variants | Item number, product dimensions, product number | Product number, product search name, product name, product description, product dimensions | Like the Product variants entity, this entity can be used to create new products that either follow the product nomenclature template or use their own product numbers for the variant. |
External item description for customers | Customer item number, customer item name, customer description, customer account | Customer item number, customer item name, customer description, customer account | A group of customers (for example, a buyer association) can be aggregated into one group by using the External item description customer groups entity. |
External item description for vendors | Vendor item number, vendor item name, vendor description, vendor account | Vendor item number, vendor item name, vendor description, vendor account | A group of vendors (for example, a sales association or industry organization) can be aggregated into one group by using the External item description vendor groups entity. |
Item Barcode | Bar code | Bar code | Note that, at the time of import, you must refer to a bar code setup that is defined in the target system. The imported bar code references are validated against that bar code setup and are rejected if the bar codes don't match the requirements that are defined in that bar code setup. |
External codes for released products | External code | External code, external code classes, item number | External codes are by legal entity. For import, you must refer to a defined code class. Import the code classes by using the External code classes for released products entity. |
External codes for released product variants | External code | External code, external code classes, item number, product dimensions | External codes are by legal entity. For import, you must refer to a defined code class. Import the code classes by using the External code classes for released products entity. This entity refers to product variants by the item number and product dimensions. |
External codes for released product variants by product number identifier | External code | External code, external code classes, product number | External codes are by legal entity. For import, you must refer to a defined code class. Import the code classes by using the External code classes for released products entity. This entity refers to product variants by the product number of the variant. (From the next major release) |
GTIN | Not applicable | Not applicable | Currently, there is no specific entity that is used to import and export GTIN codes. We recommend that you use the Item Barcode entity instead. |
Product entity common data service identifier entity | Not applicable | Item number, item search name, product search name, vendor item number, customer item number, external codes, GTIN codes, bar codes | This entity consolidates all identifiers into one data model, so that one interface can be used to easily export all identifiers and their related types. Use the Product entity identifier code entity to export the identifier codes and descriptions. Use the Product entity identifier scope entity to export additional scope information to an identifier, such as the party, legal entity, quantity, or unit. |
Product number number sequence | Item number number sequence | Mapping of the item number | Mapping of the product number | Result of entity import | Result of manual creation | Conclusion |
---|---|---|---|---|---|---|
Manual = No | Manual = No | No mapping | No mapping | Product numbers use the Product number number sequence. Item numbers use the Item number number sequence. | Product numbers use the Product number number sequence. Item numbers use the Item number number sequence. | With this configuration, product numbers will follow the product number sequence and item numbers will follow the item number sequence. However, this configuration won't work if there is more than one item (row) to be imported. |
Manual = No | Manual = Yes | Auto generate | No mapping | Both product numbers and item numbers use the Item number number sequence. | Both product numbers and item numbers use the Product number number sequence. | Both product numbers and item numbers will follow the product number sequence. This is the recommended approach to import bulk products with the Released product creation V2 data entity. |
Manual = No | Manual = Yes | No mapping | No mapping | Both product numbers and item numbers use the Product number number sequence. | Both product numbers and item numbers use the Product number number sequence. | Both product numbers and item numbers will use the product number sequence. However, this configuration won't work if there is more than one item (row) to be imported. |
Manual = Yes | Not applicable | Not applicable | Auto generate | You receive the following error message: 'Number sequence can't be detected.' | According to the Item number number sequence | This setting isn't supported for import. |