Item Detail and Item Hierarchy Determination

External Approval API for Sourcing and Supplier Management clients can use information from item details to determine item hierarchies.

Details for items (items arrays) in sourcing events are returned in /RFXDocument/{entity_id} queries with the $select=items parameter.

Each entry in an items array contains information about a lot or item in an event, including all term values for the item.

Item Hierarchies

Each event includes a top-level or root item that acts as a container for all the lots and items in the event. This root item is not numbered, so the value of displayNumber for the root item is an empty string (""). The root item can have rolled up term values for all items in the event.

The following example shows the first 3 entries in an items array.

  • The first entry contains the root item ("displayNumber": ""). This entry does not contain a parentItem element.

  • The second entry is for the first section in the event ("displayNumber": "1").

  • The third entry is for the first line item in the first section ("displayNumber": "1.1")

"items": [
        {
            "itemId": "3500",
            "title": "Totals",
            "displayNumber": "",
            "itemType": "Section",
            ...
        },
        {
            "itemId": "3507",
            "title": "My first section",
            "displayNumber": "1",
            "itemType": "Section",
            "parentItem": "3500",
            ...
        },
        {
            "itemId": "3508",
            "title": "My first line item",
            "displayNumber": "1.1",
            "itemType": "Line Item",
            "parentItem": "3507",
            ...
        },
        ...
   ]

Additional Item Details

Entries for supplier-added items in an event have values for the displayNumber element in the following format:

[supplierName] n

Where:

  • supplierName is the name of the supplier (supplier organization) that added the lot or line item.

  • n is an index number indicating the order relative to other supplier-added lots or line items, beginning with 1. The index is independent of items added by the buyer and only indicates the item's order of appearance relative to other items added by this supplier.

For example, the second item in the event added by the supplier AAA Supplier Company is shown as:

					"items": [
					{
					...
					"itemId": "1234",
					"title": "Another Item added by AAA Supplier Company",
					"displayNumber": "[AAA Supplier Company] 2",
					...