itemDataNotification Intended Usage Guide

Product / Brand Owners

Publishing Product Data

Buying Organisations

Obtaining Product Data for systems use

Configuration for sales units

Selling quantity as a picking qty

Circumstances may arise in which buyer behaviours across customers may vary, in that each barcodes can be quoted on an order along with a pack size or a case barcode may be ordered.

Standardisation of internal process will often require the normalisation of the ordering quantity to a common unit for picking within the warehouse management (WMS) processes and systems.

In order to achieve consistent and repeatable processes, across buying behaviours, a standard picking quantity will be required to normalise the WMS process at pick. The message structure allows for this custom component to be defined for your particular configuration within the additionalTradeItemIdentification section of the EA section. This will cater for special packaging including display carton configurations.

In example, lip balm is sold in 7g tins, with 36 tins within a display carton. The unit to be sold into the trade is the display carton (7g tins can't be sold into trade separately). The 7g tin is in fact a retail customer selling unit and so a complication arises in the product master data for EA as the each for trade is a display carton but an each for consumer is the 7g tin.

by setting the SELL_OUT_QUANTITY to 36, a differentiation can be made with a repeatable and predictable conversion rule. If the buying behaviour is to utilise the each barcode (7g), it will be clear that the quantity of eaches will be the smallest pack of 36, which is the display carton.

The display carton will also exist in it's own right within the master data.

Attribute Path	Mandatory	Value
itemDataNotificationLineItem.additionalTradeItemIdentification code	M	SELL_OUT_QUANTITY
itemDataNotificationLineItem.additionalTradeItemIdentification value	M	36

                "tradeItemUnitDescriptorCode": "EA",
                "ItemDataTradingPartnerDependent": [],
                "additionalTradeItemIdentification": [
                    {
                      "code": "SELL_OUT_QUANTITY",
                      "value": 36
                    }
                 ],
                "gtin": "6009835560516"

Data Source

Attribute Path	Mandatory	Value
dataSource.gln	M	6001363000007
dataSource.contact	O
dataSource.communicationChannel	O
dataSource.additionalPartyIdentification	O
itemDataNotificationIdentification	M	Supplier assigne Stock Keeping Unit (sku)

        "dataSource": {
            "gln": "6001363000007",
            "contact": [],
            "communicationChannel": [],
            "additionalPartyIdentification": []
        },

Item - Single item (each)

Attribute Path	Mandatory	Value
itemDataNotificationLineItem.brandName	O
itemDataNotificationLineItem.gpcCategoryCode	O	GS1 GPC Browser
itemDataNotificationLineItem.lineItemNumber	M
itemDataNotificationLineItem.quantityOfItemUnits	M	Quantity of units in this pack configuration
itemDataNotificationLineItem.tradeItemDescription	M	Description
itemDataNotificationLineItem.tradeItemUnitDescriptorCode	M	The designated unit "EA" denotes each
itemDataNotificationLineItem.ItemDataTradingPartnerDependent	O	Requires Link Definition
itemDataNotificationLineItem.additionalTradeItemIdentification	O
itemDataNotificationLineItem.gtin	M	GS1 assigned product Barcode

        "itemDataNotificationLineItem": [
            {
                "brandName": "",
                "gpcCategoryCode": "",
                "lineItemNumber": 1,
                "quantityOfItemUnits": 1,
                "tradeItemDescription": [
                    "Dynaroot No 2"
                ],
                "tradeItemUnitDescriptorCode": "EA",
                "ItemDataTradingPartnerDependent": [],
                "additionalTradeItemIdentification": [
                    {
                      "code": "SELL_OUT_QUANTITY",
                      "value": 36
                    }
                 ],
                "gtin": "6009835560516"
            },
        ]

Item - Case configuration

Attribute Path	Mandatory	Value
itemDataNotificationLineItem.tradeItemUnitDescriptorCode	M	The designated unit "CS" denotes case
itemDataNotificationLineItem.lowerLevelTradeItem.quantityOfLowerLevelTradeItem	M	how many eaches in this case
itemDataNotificationLineItem.lowerLevelTradeItem.gtin	M	GS1 assigned barcode for the eaches (inners)
itemDataNotificationLineItem.gtin	M	Gs1 assigned barcode for the case (outer)

                "tradeItemUnitDescriptorCode": "CS",
                "ItemDataTradingPartnerDependent": [],
                "lowerLevelTradeItem": [
                    {
                        "quantityOfLowerLevelTradeItem": 6,
                        "additionalTradeItemIdentification": [],
                        "gtin": "6009835560516"
                    }
                ],
                "additionalTradeItemIdentification": [],
                "gtin": "6009835560554"

Full structure example

[
  {
    "dataSource": {
      "gln": "6001363000007",
      "contact": [],
      "communicationChannel": [],
      "additionalPartyIdentification": []
    },
    "itemDataNotificationIdentification": "T470-30GUTNS",
    "itemDataNotificationLineItem": [
      {
        "brandName": "",
        "gpcCategoryCode": "",
        "lineItemNumber": 1,
        "quantityOfItemUnits": 1,
        "tradeItemDescription": ["Dynaroot No 2"],
        "tradeItemUnitDescriptorCode": "EA",
        "ItemDataTradingPartnerDependent": [],
        "additionalTradeItemIdentification": [
          {
            "code": "SELL_OUT_QUANTITY",
            "value": 36
          }
        ],
        "gtin": "6009835560516"
      },
      {
        "brandName": "",
        "gpcCategoryCode": "",
        "lineItemNumber": 2,
        "quantityOfItemUnits": 1,
        "tradeItemDescription": ["Dynaroot No 2"],
        "tradeItemUnitDescriptorCode": "CS",
        "ItemDataTradingPartnerDependent": [],
        "lowerLevelTradeItem": [
          {
            "quantityOfLowerLevelTradeItem": 6,
            "additionalTradeItemIdentification": [],
            "gtin": "6009835560516"
          }
        ],
        "additionalTradeItemIdentification": [],
        "gtin": "6009835560554"
      }
    ],
    "creationDateTime": "2021-12-08T11:11:57.454+02:00",
    "documentActionCode": 0,
    "documentStatusCode": 0,
    "avpList": []
  }
]