Items

The Item object represents a “product item” as a transactable element of a product that, for example, in a created order, is represented as a “line item” of that order.

This object contains the following properties:

Field	Type	Description
id	string	Identifier for the item. Example: ITM-0690-0539-0001
href	string	The resource URI of the Item. Example: /product-items/ITM-0690-0539-0001
name	string	Name of the item. Example: Microsoft 365 Apps for Business
description	string	Item description. Example: Best for businesses that need Office apps across devices and cloud file storage. For businesses with up to 300 employees.
externalIds	externalIds	Example: { "vendor": "ven-1233-3222", "operations": "op-322-322", }
terms	terms	Terms for the Items, as defined in the Terms object. Example: { "period": "1m", "commitment": "1y" }
quantityNotApplicable	boolean	Indicates if the quantity is not applicable or relevant to the product item being sold. Example: true
status	Item States	The status of the item. Example: Draft
parameters	parameterValue	Captures any additional information required for a product item and is defined by item configuration parameters. Only item configuration parameters are available on this list. Example: { "id": "PRM-1234-1234-1234", "externalId": "SKU", "value": "65272478BB01A12" }
group	itemGroup	The item group to which the item has been assigned.
unit	unitOfMeasure	The unit of measure assigned to item.
product	product	The product to which item is assigned.
audit	audit	The audit object with possible entries: Created, Updated, Activated, Terminated. Example: { "created": { "at": "...", "by": { } }, "updated": { "at": "...", "by": { } } }

Parameter

The parameter object contains the given parameter's value and additional information, like Constraints.

Field	Parameter	Description
id	string	The identifier of the parameter definition this value refers to. Example: PDF-1234-1234-1234
externalId	string	The ID of the parameter in the external system. Example: SKU
name	string	The display name for the parameter. Example: Stock keeping unit
value	string	The value of the parameter. Example: 65272478BB01A12

ExternalIds

Field	Type	Description
vendor	string	An item identifier that is recognizable by the vendor to ensure that when an order is placed, they'll understand which item needs to be provided.

Example

ITEM OBJECT

{
    "id": "ITM-0690-0539-0001",
    "name": "Microsoft 365 Online Services for Charity",
    "description": "mashaTestTajfunTeam",
    "state": "Draft",
    "parameters": [
      {
        "id": "PRM-0690-0539-0001",
        "externalId": "SKU",
        "name": "Stock keeping unit",
        "value": "65272478BB01A12"
      },
      {
        "id": "PRM-0690-0539-0004",
        "externalId": "countries",
        "name": "Countries (checkboxes)",
        "value": [
          "us",
          "eu",
          "jp"
        ]
      },
      {
        "id": "PRM-0690-0539-0004",
        "externalId": "countries",
        "name": "Countries (checkboxes)",
        "value": {
          "addressLine1": "123 Main Street",
          "addressLine2": "Apt 4B",
          "postCode": "12345",
          "city": "Cityville",
          "state": "S",
          "country": "ST"
        }
      },            
      {
        "id": "PRM-0690-0539-0002",
        "externalId": "JSON_data",
        "name": "Information stored by vendor integration",      
        "value": { ...data... }
      }    
    ],
    "group": {
        "id": "IGR-0690-0539-0001",
    },
    "unit": {
        "id": "UNT-7362",
    },
    "product": {
        "id": "PRD-0690-0539",
    },
    "audit": {
        "created": { "at": "...", "by": { } },
        "updated": { "at": "...", "by": { } }
    }
}