{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":561,"path":"api-reference/rest-apis/tmf622_product_ordering-api.md","title":"Product Order Open API","bundle":null,"doc_type":null,"release":"australia","body":"\n# Product Order Open API\n\nThe Product Order Open API provides endpoints that enable a standardized mechanism for placing product orders.\n\nA product order is created based on a product offering that is defined and published in a product catalog. The product offering identifies the product or set of products that are available to a customer and includes the relevant product characteristics that capture the unique options of a product, and other relevant attributes such as pricing, contract terms, and availability.\n\nTo access this API, the Order Management for Telecommunications \\(sn\\_ind\\_tmt\\_orm\\) plugin must be activated. For more information, see [Install Order Management](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/order-mgt-install-providers.md). For information about Order Management tables and roles, see [Components installed with Order Management](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/components-installed-with-order-management.md).\n\nThis API is provided within the `sn_ind_tmt_orm` namespace.\n\nThe calling user must have the sn\\_ind\\_tmt\\_orm.order\\_integrator role.\n\nThis API can be extended to make customizations around required parameters, request body validation, additional REST operations, and field mappings. For more information, see the [Product Order Open API Developer Guide](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/developer-guides/product-order_dev-guide.md).\n\nThe Product Order Open API is a ServiceNow® implementation of the TM Forum Product Ordering Management API Specification. This implementation is based on the [TMF622 Product Ordering Management API User Guide v5.0.0](https://www.tmforum.org/resources/specifications/tmf622-product-ordering-management-api-user-guide-v5-0-0/), September 2024. The Product Order Open API is conformance certified by TM Forum.\n\n\\[Omitted image \"tmf-conformance.png\"\\] Alt text: TMF conformance logo\n\n**Parent Topic:**[REST API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/api-rest.md)\n\n## Product Order Open API - GET /sn\\_ind\\_tmt\\_orm/order/productOrder\n\nRetrieves all product orders.\n\nThis endpoint retrieves order information from the following tables:\n\n-   Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n-   Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n-   Order Characteristic \\[sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\\]\n-   Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\]\n-   Order Line Related Items \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_related\\_items\\]\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/order/productOrder`\n\n### Supported request parameters\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n<table id=\"table_pfr_vgy_fsb\" class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nfields\n\n</td><td>\n\nList of fields to return in the response. Invalid fields are ignored. Data type: String\n\nDefault: All fields returned.\n\n</td></tr><tr><td>\n\nlimit\n\n</td><td>\n\nMaximum number of records to return. For requests that exceed this number of records, use the **offset** parameter to paginate record retrieval. Data type: Number\n\nDefault: 20\n\nMaximum: 100\n\n</td></tr><tr><td>\n\noffset\n\n</td><td>\n\nStarting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks.Data type: Number\n\nDefault: 0\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nFilter orders by state. Only orders with a state matching the value of this parameter are returned in the response.Data type: String\n\nDefault: Don't order by state.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|None| |\n\n<table id=\"table_h4r_fxr_nsb\" class=\"rest_api_response_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"content-range-row\"><td>\n\nContent-Range\n\n</td><td>\n\nRange of content returned in a paginated call. For example, if `offset=2` and `limit=3`, the value of the **Content-Range** header is `items 3-5`.\n\n</td></tr><tr id=\"content-type-row\"><td>\n\nContent-Type\n\n</td><td>\n\nData format of the response body. Only supports **application/json**.\n\n</td></tr><tr id=\"links-pagination-row\"><td>\n\nLink\n\n</td><td>\n\nContains the following links to navigate through query results.-   first\n-   last\n-   next\n-   previous\n\n</td></tr><tr id=\"x-total-count-row\"><td id=\"x-total-count\">\n\nX-Total-Count\n\n</td><td>\n\nFor paginated queries, this header specifies the total number of records available on the server.\n\n</td></tr></tbody>\n</table>### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table id=\"table_wdl_3xr_nsb\"><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"tmf-get-status-200-entry\">\n\nRequest successfully processed. Full resource returned in response \\(no pagination\\).\n\n</td></tr><tr><td>\n\n206\n\n</td><td id=\"tmf-get-status-206-entry\">\n\nPartial resource returned in response \\(with pagination\\).\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"tmf-get-status-400-entry\">\n\nBad request. Possible reasons:\n\n-   Invalid path parameter\n-   Invalid URI\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"tmf-get-status-404-entry\">\n\nRecord not found. No records matching the query parameters are found in the table.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"table_inf_kxr_nsb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td>\n\nDate and time when the action must be performed on the order.\n\nThis value must be the same as or later than the **committedDueDate** values for each order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nexpectedCompletionDate\n\n</td><td>\n\nDate on which the order will be completed.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal system identifier that links the product order to your source system or third-party application.Data type: String\n\n</td></tr><tr><td>\n\nhref\n\n</td><td>\n\nRelative link to the product order record.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the product order. Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"author\": \"String\",\n    \"date\": \"String\",\n    \"text\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nnote.author\n\n</td><td>\n\nUser name of the person that authored the associated note.Data type: String\n\n</td></tr><tr><td>\n\nnote.date\n\n</td><td>\n\nDate that the note was created.Data type: String\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items.Data type: String\n\n</td></tr><tr><td>\n\nponr\n\n</td><td>\n\nFlag that indicates whether the point of no return for the order has been reached.Possible values:\n\n-   true: The point of no return for the order has been reached.\n-   false: The point of no return for the order hasn't been reached.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td>\n\nOptional. Date and time when the action must be performed on the order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProdInv-resp-descr\">\n\nConditional. List of external IDs mapped to the product inventories created for the order. If supplied, each entry requires **externalProductInventoryId**.Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-resp-descr\">\n\nExternal ID mapped to the product inventory.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n ```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n ```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n ```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.ponr\n\n</td><td>\n\nFlag that indicates whether the point of no return for the order has been reached.Possible values:\n\n-   true: The point of no return for the order has been reached.\n-   false: The point of no return for the order hasn't been reached.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n ```\n\"product:\" {\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productRelationship\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n ```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Only product characteristics whose **value** are different than the **previousValue** are returned.\n\nData type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Possible values:\n\n-   Array.Date\n-   Array.Datetime\n-   Array.Decimal\n-   Array.Integer\n-   Array.Object\n-   Array.Single Line Test\n-   Checkbox\n-   Choice\n-   Date,Address\n-   Email\n-   Integer,Date/time\n-   Object\n-   Single Line Text\n-   Yes/No\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productRelationship\n\n</td><td>\n\nList of product relationship details for an order line item.Data type: Array of Objects\n\n```\n\"productRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productRelationship.id\n\n</td><td>\n\nSys\\_id or sn\\_prd\\_invt\\_external\\_id of the product inventory.Data type: String\n\nTable: In the sys\\_id or sn\\_prd\\_invt\\_external\\_id field of the Product Inventory \\[sn\\_prd\\_invt\\_product\\_inventory\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productRelationship.relationshipType\n\n</td><td>\n\nType of relationship between the order line item and the product inventory.Possible value: Requires\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n```\n\"productSpecification:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalId\n\n</td><td>\n\nInitial version of the product specification. The initial version is the sys\\_id of the first version of the specification.Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nVersion of the product specification.Data type: String\n\nTable: In the version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification.Data type: String\n\nTable: In the external\\_version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty:\" [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalId\n\n</td><td>\n\nInitial version of the product offering. The initial version is the sys\\_id of the first version of the offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table, field version.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal version of the product offering.Data type: String\n\nTable: In the external\\_version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of product items purchased.Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nState of the order of the associated product item.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.version\n\n</td><td>\n\nOrder version.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty:\" [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order. Data type: String\n\n</td></tr><tr><td>\n\nversion\n\n</td><td>\n\nOrder version.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example retrieves all product orders.\n\n```\ncurl --location --request GET 'https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder' \\\n--user 'username':'password'\n```\n\nResponse body.\n\n```\n[\n   {\n      \"id\": \"8d75939453126010a795ddeeff7b126a\",\n      \"href\": \"/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a\",\n      \"ponr\": \"false\",\n      \"orderCurrency\": \"USD\",\n      \"expectedCompletionDate\": \"2021-05-02T08:13:59.000Z\", \n      \"externalId\": \"PO-456\",\n      \"requestedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n      \"requestedStartDate\": \"2020-05-03T08:13:59.000Z\",\n      \"channel\": [\n         {\n            \"id\": \"1\",\n            \"name\": \"Agent Assist\"\n         }\n      ],\n      \"note\": [\n         {\n            \"author\": \"System Administrator\",\n            \"date\": \"2021-02-25T14:22:07.000Z\",\n            \"text\": \"This is a TMF product order illustration no 2\"\n         },\n         {\n            \"author\": \"System Administrator\",\n            \"date\": \"2021-02-25T14:22:06.000Z\",\n            \"text\": \"This is a TMF product order illustration\"\n         }\n      ],\n      \"productOrderItem\": [\n         {\n            \"id\": \"POI130\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"actionReason\": \"adding service package OLI\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"USD\",\n                        \"value\": 20\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productCharacteristic\": [\n                  {\n                     \"name\": \"Security Type\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Base\",\n                     \"previousValue\": \"\"\n                  }\n               ],\n               \"productSpecification\": {\n                  \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n                  \"name\": \"SD-WAN Security\",\n                  \"version\": \"v1\",\n                  \"internalVersion\": \"1\",\n                  \"internalId\": \"a6514bd3534560102f18ddeeff7b1247\",\n                  \"@type\": \"ProductSpecificationRef\"\n               },\n               \"relatedParty\": [\n                  {\n                     \"id\": \"4175939453126010a795ddeeff7b127d\",\n                     \"name\": \"John Smith\",\n                     \"email\": \"abc2@example.com\",\n                     \"phone\": \"32456768\",\n                     \"@type\": \"RelatedParty\",\n                     \"@referredType\": \"OrderLineItemContact\"\n                  },\n                  {\n                     \"id\": \"c175939453126010a795ddeeff7b127c\",\n                     \"name\": \"Joe Doe\",\n                     \"email\": \"abc@example.com\",\n                     \"phone\": \"1234567890\",\n                     \"@type\": \"RelatedParty\",\n                     \"@referredType\": \"OrderLineItemContact\"\n                  }\n               ]\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\",\n               \"version\": \"v1\",\n               \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"internalVersion\": \"1\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI100\",\n                  \"relationshipType\": \"HasParent\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         },\n         {\n            \"id\": \"POI100\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productSpecification\": {\n                  \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n                  \"name\": \"SD-WAN Service Package\",\n                  \"version\": \"v1\",\n                  \"internalVersion\": \"1\",\n                  \"internalId\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n                  \"@type\": \"ProductSpecificationRef\"\n               }\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\",\n               \"version\": \"v1\",\n               \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"internalVersion\": \"1\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI130\",\n                  \"relationshipType\": \"HasChild\"\n               },\n               {\n                  \"id\": \"POI120\",\n                  \"relationshipType\": \"HasChild\"\n               },\n               {\n                  \"id\": \"POI110\",\n                  \"relationshipType\": \"HasChild\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         },\n         {\n            \"id\": \"POI120\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"USD\",\n                        \"value\": 20\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productCharacteristic\": [\n                  {\n                     \"name\": \"CPE Type\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Physical\",\n                     \"previousValue\": \"\"\n                  },\n                  {\n                     \"name\": \"WAN Optimization\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Advance\",\n                     \"previousValue\": \"\"\n                  },\n                  {\n                     \"name\": \"Routing\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Premium\",\n                     \"previousValue\": \"\"\n                  },\n                  {\n                     \"name\": \"CPE Model\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"ASR\",\n                     \"previousValue\": \"\"\n                  }\n               ],\n               \"productSpecification\": {\n                  \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n                  \"name\": \"SD-WAN Edge Device\",\n                  \"version\": \"v1\",\n                  \"internalVersion\": \"1\",\n                  \"internalId\": \"39b627aa53702010cd6dddeeff7b1202\",\n                  \"@type\": \"ProductSpecificationRef\"\n               },\n               \"productRelationship\": [\n                  {\n                     \"id\": \"326d13f45b5620102dff5e92dc81c785\",\n                     \"relationshipType\": \"Requires\"\n                  }\n               ]\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"69017a0f536520103b6bddeeff7b127d\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI100\",\n                  \"relationshipType\": \"HasParent\"\n               },\n               {\n                  \"id\": \"POI110\",\n                  \"relationshipType\": \"Requires\"\n               }       \n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         },\n         {\n            \"id\": \"POI110\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"USD\",\n                        \"value\": 5\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productCharacteristic\": [\n                  {\n                     \"name\": \"Tenancy\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Base (10 site)\",\n                     \"previousValue\": \"\"\n                  }\n               ],\n               \"productSpecification\": {\n                  \"id\": \"216663aa53702010cd6dddeeff7b12b5\",\n                  \"name\": \"SD-WAN Controller\",\n                  \"version\": \"v1\",\n                  \"internalVersion\": \"1\",\n                  \"internalId\": \"216663aa53702010cd6dddeeff7b12b5\",\n                  \"@type\": \"ProductSpecificationRef\"\n               },\n               \"place\": {\n                  \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                  \"@type\": \"Place\"\n               }\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\",\n               \"version\": \"v1\",\n               \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"internalVersion\": \"1\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI100\",\n                  \"relationshipType\": \"HasParent\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         }\n      ],\n      \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n      \"state\": \"in_progress\",\n      \"version\": \"1\",\n      \"@type\": \"ProductOrder\"\n   }\n]\n```\n\n## Product Order Open API - GET /sn\\_ind\\_tmt\\_orm/productorder\n\nRetrieves all product orders.\n\n**Important:** Starting with the Tokyo release, this endpoint is deprecated. The new version of this endpoint is [Product Order Open API - GET /sn\\_ind\\_tmt\\_orm/order/productOrder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/tmf622_product_ordering-api.md).\n\nThis endpoint retrieves order information from the following tables:\n\n-   Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n-   Order Characteristic \\[sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\\]\n-   Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n-   Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\]\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/productorder`\n\n### Supported request parameters\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n<table id=\"table_pfr_vgy_fsb\" class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nfields\n\n</td><td>\n\nList of fields to return in the response. Invalid fields are ignored. Data type: String\n\nDefault: All fields returned.\n\n</td></tr><tr><td>\n\nlimit\n\n</td><td>\n\nMaximum number of records to return. For requests that exceed this number of records, use the **offset** parameter to paginate record retrieval. Data type: Number\n\nDefault: 20\n\nMaximum: 100\n\n</td></tr><tr><td>\n\noffset\n\n</td><td>\n\nStarting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks.Data type: Number\n\nDefault: 0\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nFilter orders by state. Only orders with a state matching the value of this parameter are returned in the response.Data type: String\n\nDefault: All states returned.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|None| |\n\n<table id=\"table_h4r_fxr_nsb\" class=\"rest_api_response_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"content-range-row\"><td>\n\nContent-Range\n\n</td><td>\n\nRange of content returned in a paginated call. For example, if `offset=2` and `limit=3`, the value of the **Content-Range** header is `items 3-5`.\n\n</td></tr><tr id=\"content-type-row\"><td>\n\nContent-Type\n\n</td><td>\n\nData format of the response body. Only supports **application/json**.\n\n</td></tr><tr id=\"links-pagination-row\"><td>\n\nLink\n\n</td><td>\n\nContains the following links to navigate through query results.-   first\n-   last\n-   next\n-   previous\n\n</td></tr><tr id=\"x-total-count-row\"><td id=\"x-total-count\">\n\nX-Total-Count\n\n</td><td>\n\nFor paginated queries, this header specifies the total number of records available on the server.\n\n</td></tr></tbody>\n</table>### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table id=\"table_wdl_3xr_nsb\"><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"tmf-get-status-200-entry\">\n\nRequest successfully processed. Full resource returned in response \\(no pagination\\).\n\n</td></tr><tr><td>\n\n206\n\n</td><td id=\"tmf-get-status-206-entry\">\n\nPartial resource returned in response \\(with pagination\\).\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"tmf-get-status-400-entry\">\n\nBad request. Possible reasons:\n\n-   Invalid path parameter\n-   Invalid URI\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"tmf-get-status-404-entry\">\n\nRecord not found. No records matching the query parameters are found in the table.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"table_inf_kxr_nsb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nexpectedCompletionDate\n\n</td><td>\n\nDate on which the order will be completed.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal system identifier that links the product order to your source system or third-party application.Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": {\n  \"author\": \"String\",\n  \"date\": \"String\",\n  \"text\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nnote.author\n\n</td><td>\n\nUser name of the person that authored the associated note.Data type: String\n\n</td></tr><tr><td>\n\nnote.date\n\n</td><td>\n\nDate that the note was created.Data type: String\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\nponr\n\n</td><td>\n\nFlag that indicates whether the point of no return for the order has been reached.Possible values:\n\n-   true: The point of no return for the order has been reached.\n-   false: The point of no return for the order hasn't been reached.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.ponr\n\n</td><td>\n\nFlag that indicates whether the point of no return for the order has been reached.Possible values:\n\n-   true: The point of no return for the order has been reached.\n-   false: The point of no return for the order hasn't been reached.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product:\" {\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Only product characteristics whose **value** are different than the **previousValue** are returned.\n\nData type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Possible values:\n\n-   Array.Date\n-   Array.Datetime\n-   Array.Decimal\n-   Array.Integer\n-   Array.Object\n-   Array.Single Line Test\n-   Checkbox\n-   Choice\n-   Date,Address\n-   Email\n-   Integer,Date/time\n-   Object\n-   Single Line Text\n-   Yes/No\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n```\n\"productSpecification:\" {\n  \"id\": \"String\",\n  \"name\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty:\" {\n  \"email\": \"String\",\n  \"firstName\": \"String\",\n  \"id\": \"String\",\n  \"lastName\": \"String\",\n  \"phone\": \"String\",\n  \"@referredType\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of product items purchased.Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nState of the order of the associated product item.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.version\n\n</td><td>\n\nOrder version.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty:\" [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order. Data type: String\n\n</td></tr><tr><td>\n\nversion\n\n</td><td>\n\nOrder version.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example retrieves all product orders.\n\n```\ncurl --location --request GET 'https://instance.servicenow.com/api/sn_ind_tmt_orm/productorder' \\\n--user 'username':'password'\n\n\n```\n\nResponse body.\n\n```\n[\n   {\n      \"id\": \"8d75939453126010a795ddeeff7b126a\",\n      \"ponr\": \"false\",\n      \"expectedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n      \"externalId\": \"PO-456\",\n      \"requestedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n      \"requestedStartDate\": \"2020-05-03T08:13:59.000Z\",\n      \"channel\": [\n         {\n            \"id\": \"1\",\n            \"name\": \"Agent Assist\"\n         }\n      ],\n      \"note\": [\n         {\n            \"author\": \"System Administrator\",\n            \"date\": \"2021-02-25T14:22:07.000Z\",\n            \"text\": \"This is a TMF product order illustration no 2\"\n         },\n         {\n            \"author\": \"System Administrator\",\n            \"date\": \"2021-02-25T14:22:06.000Z\",\n            \"text\": \"This is a TMF product order illustration\"\n         }\n      ],\n      \"productOrderItem\": [\n         {\n            \"id\": \"POI130\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"actionReason\": \"adding service package OLI\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"USD\",\n                        \"value\": 20\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productCharacteristic\": [\n                  {\n                     \"name\": \"Security Type\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Base\",\n                     \"previousValue\": \"\"\n                  }\n               ],\n               \"productSpecification\": {\n                  \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n                  \"name\": \"SD-WAN Security\",\n                  \"@type\": \"ProductSpecificationRef\"\n               },\n               \"relatedParty\": [\n                  {\n                     \"id\": \"4175939453126010a795ddeeff7b127d\",\n                     \"name\": \"John Smith\",\n                     \"email\": \"abc2@example.com\",\n                     \"phone\": \"32456768\",\n                     \"@type\": \"RelatedParty\",\n                     \"@referredType\": \"OrderLineItemContact\"\n                  },\n                  {\n                     \"id\": \"c175939453126010a795ddeeff7b127c\",\n                     \"name\": \"Joe Doe\",\n                     \"email\": \"abc@example.com\",\n                     \"phone\": \"1234567890\",\n                     \"@type\": \"RelatedParty\",\n                     \"@referredType\": \"OrderLineItemContact\"\n                  }\n               ]\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI100\",\n                  \"relationshipType\": \"HasParent\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         },\n         {\n            \"id\": \"POI100\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productSpecification\": {\n                  \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n                  \"name\": \"SD-WAN Service Package\",\n                  \"@type\": \"ProductSpecificationRef\"\n               }\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI130\",\n                  \"relationshipType\": \"HasChild\"\n               },\n               {\n                  \"id\": \"POI120\",\n                  \"relationshipType\": \"HasChild\"\n               },\n               {\n                  \"id\": \"POI110\",\n                  \"relationshipType\": \"HasChild\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         },\n         {\n            \"id\": \"POI120\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"actionReason\":\"adding service package OLI\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"USD\",\n                        \"value\": 20\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productCharacteristic\": [\n                  {\n                     \"name\": \"CPE Type\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Physical\",\n                     \"previousValue\": \"\"\n                  },\n                  {\n                     \"name\": \"WAN Optimization\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Advance\",\n                     \"previousValue\": \"\"\n                  },\n                  {\n                     \"name\": \"Routing\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Premium\",\n                     \"previousValue\": \"\"\n                  },\n                  {\n                     \"name\": \"CPE Model\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"ASR\",\n                     \"previousValue\": \"\"\n                  }\n               ],\n               \"productSpecification\": {\n                  \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n                  \"name\": \"SD-WAN Edge Device\",\n                  \"@type\": \"ProductSpecificationRef\"\n               }\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI100\",\n                  \"relationshipType\": \"HasParent\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         },\n         {\n            \"id\": \"POI110\",\n            \"ponr\": \"false\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"actionReason\": \"adding service package OLI\",\n            \"itemPrice\": [\n               {\n                  \"priceType\": \"recurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"INR\",\n                        \"value\": 0\n                     }\n                  }\n               },\n               {\n                  \"priceType\": \"nonRecurring\",\n                  \"price\": {\n                     \"taxIncludedAmount\": {\n                        \"unit\": \"USD\",\n                        \"value\": 5\n                     }\n                  }\n               }\n            ],\n            \"product\": {\n               \"@type\": \"Product\",\n               \"productCharacteristic\": [\n                  {\n                     \"name\": \"Tenancy\",\n                     \"valueType\": \"Choice\",\n                     \"value\": \"Base (10 site)\",\n                     \"previousValue\": \"\"\n                  }\n               ],\n               \"productSpecification\": {\n                  \"id\": \"216663aa53702010cd6dddeeff7b12b5\",\n                  \"name\": \"SD-WAN Controller\",\n                  \"@type\": \"ProductSpecificationRef\"\n               },\n               \"place\": {\n                  \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                  \"@type\": \"Place\"\n               }\n            },\n            \"productOffering\": {\n               \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n               \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n               {\n                  \"id\": \"POI100\",\n                  \"relationshipType\": \"HasParent\"\n               }\n            ],\n            \"state\": \"in_progress\",\n            \"version\": \"1\",\n            \"@type\": \"ProductOrderItem\"\n         }\n      ],\n      \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n      \"state\": \"in_progress\",\n      \"version\": \"1\",\n      \"@type\": \"ProductOrder\"\n   }\n]\n```\n\n## Product Order Open API - GET /sn\\_ind\\_tmt\\_orm/productorder/\\{id\\}\n\nRetrieves the specified product order.\n\n**Important:** Starting with the Tokyo release, this endpoint is deprecated. The new version of this endpoint is [Product Order Open API - GET /sn\\_ind\\_tmt\\_orm/productorder/\\{id\\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/tmf622_product_ordering-api.md).\n\nThis endpoint retrieves order information from the following tables:\n\n-   Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n-   Order Characteristic \\[sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\\]\n-   Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n-   Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\]\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/productorder/{id}`\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id or external\\_id of the customer order to retrieve.Data type: String\n\nTable: Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|None| |\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Can be for any of the following reasons:-   Missing query parameter\n-   Invalid URI\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nexpectedCompletionDate\n\n</td><td>\n\nDate on which the order will be completed.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal system identifier that links the product order to your source system or third-party application.Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Object\n\n```\n\"note\": {\n  \"author\": \"String\",\n  \"date\": \"String\",\n  \"text\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nnote.author\n\n</td><td>\n\nUser name of the person that authored the associated note.Data type: String\n\n</td></tr><tr><td>\n\nnote.date\n\n</td><td>\n\nDate that the note was created.Data type: String\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\nponr\n\n</td><td>\n\nFlag that indicates whether the point of no return for the order has been reached.Possible values:\n\n-   true: The point of no return for the order has been reached.\n-   false: The point of no return for the order hasn't been reached.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.ponr\n\n</td><td>\n\nFlag that indicates whether the point of no return for the order has been reached.Possible values:\n\n-   true: The point of no return for the order has been reached.\n-   false: The point of no return for the order hasn't been reached.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product:\" {\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Only product characteristics whose **value** are different than the **previousValue** are returned.\n\nData type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Possible values:\n\n-   Array.Date\n-   Array.Datetime\n-   Array.Decimal\n-   Array.Integer\n-   Array.Object\n-   Array.Single Line Test\n-   Checkbox\n-   Choice\n-   Date,Address\n-   Email\n-   Integer,Date/time\n-   Object\n-   Single Line Text\n-   Yes/No\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n```\n\"productSpecification:\" {\n  \"id\": \"String\",\n  \"name\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Object\n\n```\n\"relatedParty:\" {\n  \"email\": \"String\",\n  \"firstName\": \"String\",\n  \"id\": \"String\",\n  \"lastName\": \"String\",\n  \"phone\": \"String\",\n  \"@referredType\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of product items purchased.Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nState of the order of the associated product item.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.version\n\n</td><td>\n\nOrder version.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty:\" [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order. Data type: String\n\n</td></tr><tr><td>\n\nversion\n\n</td><td>\n\nOrder version.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following code example requests an existing customer order.\n\n```\ncurl -X GET \"https://servicenow-instance/api/sn_ind_tmt_orm/productorder/8d75939453126010a795ddeeff7b126a\" \\\n-u \"username\":\"password\" \n\n\n```\n\nResponse body.\n\n```\n{\n  \"id\": \"8d75939453126010a795ddeeff7b126a\",\n  \"ponr\": \"false\",\n  \"expectedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n  \"externalId\": \"PO-456\",\n  \"requestedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n  \"requestedStartDate\": \"2020-05-03T08:13:59.000Z\",\n  \"channel\": [\n    {\n      \"id\": \"1\",\n      \"name\": \"Agent Assist\"\n    }\n  ],\n  \"note\": [\n    {\n      \"author\": \"System Administrator\",\n      \"date\": \"2021-02-25T14:22:07.000Z\",\n      \"text\": \"This is a TMF product order illustration no 2\"\n    },\n    {\n      \"author\": \"System Administrator\",\n      \"date\": \"2021-02-25T14:22:06.000Z\",\n      \"text\": \"This is a TMF product order illustration\"\n    }\n  ],\n\n  \"productOrderItem\": [\n    {\n      \"id\": \"POI130\",\n      \"ponr\": \"false\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        },\n        {\n          \"priceType\": \"nonRecurring\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"INR\",\n              \"value\": 0\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"Security Type\",\n            \"valueType\": \"Choice\",\n            \"value\": \"Base\",\n            \"previousValue\": \"\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n          \"name\": \"SD-WAN Security\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"relatedParty\": [\n          {\n            \"id\": \"4175939453126010a795ddeeff7b127d\",\n            \"name\": \"John Smith\",\n            \"email\": \"abc2@example.com\",\n            \"phone\": \"32456768\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          },\n          {\n            \"id\": \"c175939453126010a795ddeeff7b127c\",\n            \"name\": \"Joe Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ]\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"state\": \"in_progress\",\n      \"version\": \"1\",\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n    \"id\": \"POI100\",\n    \"ponr\": \"false\",\n    \"quantity\": 1,\n    \"action\": \"add\",\n    \"itemPrice\": [\n      {\n        \"priceType\": \"recurring\",\n        \"price\": {\n          \"taxIncludedAmount\": {\n            \"unit\": \"INR\",\n            \"value\": 0\n          }\n        }\n      },\n      {\n        \"priceType\": \"nonRecurring\",\n        \"price\": {\n          \"taxIncludedAmount\": {\n            \"unit\": \"INR\",\n            \"value\": 0\n          }\n        }\n      }\n    ],\n    \"product\": {\n      \"@type\": \"Product\",\n      \"productSpecification\": {\n        \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n        \"name\": \"SD-WAN Service Package\",\n        \"@type\": \"ProductSpecificationRef\"\n      }\n    },\n    \"productOffering\": {\n      \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n      \"name\": \"Premium SD-WAN Offering\"\n    },\n    \"productOrderItemRelationship\": [\n      {\n        \"id\": \"POI130\",\n        \"relationshipType\": \"HasChild\"\n      },\n      {\n        \"id\": \"POI120\",\n        \"relationshipType\": \"HasChild\"\n      },\n      {\n        \"id\": \"POI110\",\n        \"relationshipType\": \"HasChild\"\n      }\n    ],\n    \"state\": \"in_progress\",\n    \"version\": \"1\",\n    \"@type\": \"ProductOrderItem\"\n  },\n  {\n    \"id\": \"POI120\",\n    \"ponr\": \"false\",\n    \"quantity\": 1,\n    \"action\": \"add\",\n    \"itemPrice\": [\n      {\n        \"priceType\": \"recurring\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        },\n        {\n          \"priceType\": \"nonRecurring\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"INR\",\n              \"value\": 0\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"CPE Type\",\n            \"valueType\": \"Choice\",\n            \"value\": \"Physical\",\n            \"previousValue\": \"\"\n          },\n          {\n            \"name\": \"WAN Optimization\",\n            \"valueType\": \"Choice\",\n            \"value\": \"Advance\",\n            \"previousValue\": \"\"\n          },\n          {\n            \"name\": \"Routing\",\n            \"valueType\": \"Choice\",\n            \"value\": \"Premium\",\n            \"previousValue\": \"\"\n          },\n          {\n            \"name\": \"CPE Model\",\n            \"valueType\": \"Choice\",\n            \"value\": \"ASR\",\n            \"previousValue\": \"\"\n           }\n        ],\n        \"productSpecification\": {\n          \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n          \"name\": \"SD-WAN Edge Device\",\n          \"@type\": \"ProductSpecificationRef\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"state\": \"in_progress\",\n      \"version\": \"1\",\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"POI110\",\n      \"ponr\": \"false\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n            \"price\": {\n              \"taxIncludedAmount\": {\n                \"unit\": \"INR\",\n                \"value\": 0\n              }\n            }\n          },\n          {\n          \"priceType\": \"nonRecurring\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 5\n            }\n          }\n        }\n      ],\n      \"product\": {\n      \"@type\": \"Product\",\n      \"productCharacteristic\": [\n        {\n          \"name\": \"Tenancy\",\n          \"valueType\": \"Choice\",\n          \"value\": \"Base (10 site)\",\n          \"previousValue\": \"\"\n        }\n      ],\n      \"productSpecification\": {\n        \"id\": \"216663aa53702010cd6dddeeff7b12b5\",\n        \"name\": \"SD-WAN Controller\",\n        \"@type\": \"ProductSpecificationRef\"\n      },\n      \"place\": {\n        \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n        \"@type\": \"Place\"\n      }\n    },\n    \"productOffering\": {\n      \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n      \"name\": \"Premium SD-WAN Offering\"\n    },\n    \"productOrderItemRelationship\": [\n      {\n        \"id\": \"POI100\",\n        \"relationshipType\": \"HasParent\"\n      }\n    ],\n    \"state\": \"in_progress\",\n    \"version\": \"1\",\n    \"@type\": \"ProductOrderItem\"\n  }\n],\n\"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n\"state\": \"in_progress\",\n\"version\": \"1\",\n\"@type\": \"ProductOrder\"\n}\n```\n\n## Product Order Open API - GET /sn\\_ind\\_tmt\\_orm/order/productOrder/\\{id\\}\n\nUpdates the specified customer order.\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/order/productOrder/{id}`\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order to update.Data type: String\n\nTable: Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n<table id=\"id_vk2_p5n_t4b\" class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n@type\n\n</td><td id=\"type-entry-tmf622\">\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr><tr id=\"channel-row-tmf622\"><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr id=\"channel_id-row-tmf622\"><td>\n\nchannel.id\n\n</td><td>\n\nRequired if the **channel** parameter is used. Unique identifier of the channel to use to sell the associated products. Data type: String\n\nTable: In the external\\_id field of the Distribution Channel \\[sn\\_prd\\_pm\\_distribution\\_channel\\] table.\n\nStored in: The channel field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"channel_name-row-tmf622\"><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Possible channel names are defined on the Choice List tab in the Channel Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order table.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td id=\"due-date-PATCH\">\n\nDate and time when the action must be performed on the order.This value must be the same as or later than the **committedDueDate** values for each order line item.\n\nIf the action for order line items is `suspend` or `resume`, this parameter can't be updated.\n\nData type: String\n\nStored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\n</td></tr><tr id=\"externalId-row-tmf622\"><td>\n\nexternalId\n\n</td><td>\n\nUnique identifier for the customer order. This value is determined by an external system. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nexternalSystem\n\n</td><td id=\"tmf622-response-externalSystem\">\n\nExternal system of the service order, appended with `TMF622`. For example, if the external system is ABC then enter the value in **externalSystem** as `ABC-TMF622`.\n\nData Type: String\n\n</td></tr><tr id=\"note-row-tmf622\"><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr id=\"note_text-row-tmf622\"><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\nStored in: The comments field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items. Updating the currency code of an existing order is not supported. Providing any value other than the currency code already associated with the order causes the update to be rejected.Data type: String\n\n</td></tr><tr id=\"productOrderItem-row-tmf622\"><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem\": [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemRelationship\": [Array],\n    \"quantity\": Number,\n    \"revisionOperation\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td id=\"prodOrdItem_type-entry-tmf622\">\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr id=\"productOrderItem_action-row-tmf622\"><td>\n\nproductOrderItem.action\n\n</td><td>\n\nRequired if the **productOrderItem** parameter is used. Action to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Possible values:\n\n-   add\n-   change\n\n**Note:** Submitting a change payload that includes a new service location via **productOrderItem.product.place.id** is processed as a move order.\n\n-   delete\n-   no-change\n-   resume\n-   suspend\n\nData type: String\n\nStored in: The action field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: add\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td id=\"prodOrdItem_actionReason-response-tmf622\">\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td id=\"due-date-item-PATCH\">\n\nDate and time when the action must be performed on the order line item.If the action for the item is `suspend` or `resume`, this parameter can't be updated.\n\nData type: String\n\nStored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"externalProdInvId\"><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-decsr\">\n\nExternal ID to map to the product inventory.Data type: String\n\nStored in: The external\\_inventory\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table and the sn\\_prd\\_invt\\_external\\_id field of the sn\\_prd\\_invt\\_product\\_inventory table.\n\n</td></tr><tr id=\"externalProdInv-PATCH\"><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProdInv-descr-PATCH\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. List of external IDs to map to the product inventories created for the order. Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n**Note:** Previously, when creating a PATCH order with an external product inventory ID that already existed, the operation was aborted and returned an error. With the Xanadu release, this parameter is simply ignored when an existing external product inventory ID is supplied and an error is not thrown.\n\n</td></tr><tr id=\"productOrderItem_id-row-tmf622\"><td>\n\nproductOrderItem.id\n\n</td><td>\n\nRequired if the **productOrderItem** parameter is used. Unique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nMaximum length: 40\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice-row-tmf622\"><td>\n\nproductOrderItem.itemPrice\n\n</td><td id=\"itemPrice-entry-tmf622\">\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice_price-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td id=\"itemPrice_price-entry-tmf622\">\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td id=\"itemPrice_price_taxIncludedAmt-entry-tmf622\">\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt_unit-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td id=\"itemPrice_price_taxIncludedAmt_unit-entry-tmf622\">\n\nCurrency code in which the price is depicted. Data type: String\n\nStored in: The mrc or nrc field in the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt_value-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td id=\"itemPrice_price_taxIncludedAmt_value-entry-tmf622\">\n\nPrice of product, including any tax. Data type: Number\n\nStored in: The mrc or nrc field in the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"itemPrice_priceType-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td id=\"itemPrice_priceType-entry-tmf622\">\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr id=\"itemPrice_recurringChargePeriod-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td id=\"itemPrice_recurringChargePeriod-entry-tmf622\">\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr id=\"product-row-tmf622\"><td>\n\nproductOrderItem.product\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Description of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_type-row-tmf622\"><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_id-row-tmf622\"><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Unique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. Data type: String\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_place-row-tmf622\"><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_place_type-row-tmf622\"><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_place_id-row-tmf622\"><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nRequired if the **productOrderItem.product.place** parameter is used. Sys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\nStored in: The location field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\n\n</td></tr><tr id=\"prod_prodChar_name-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\nStored in: The characteristics field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar_previousValue-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The previous\\_characteristic\\_option\\_value of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar_value-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Data type: String\n\nPossible values:\n\n-   array.date\n-   array.datetime\n-   array.decimal\n-   array.integer\n-   array.object\n-   array.single line test\n-   checkbox\n-   choice\n-   date,address\n-   email\n-   integer,date/time\n-   object\n-   single line text\n-   yes/no\n\n</td></tr><tr id=\"product_productSpecification-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. **Note:** Change orders \\(**productOrderItem.action** is `change`\\) are processed differently based on the value of the **sn\\_ind\\_tmt\\_orm.allowSpecVersionUpdateInChangeOrder** system property. The value of this system property determines how the order is processed if the product inventory is a different version than indicated in the order.\n\n-   When this system property is set to true \\(default\\), the product inventory is automatically upgraded to the version in the order by changing the referenced product specification. This allows the order to be successfully processed.\n-   When this system property is set to false, if the product inventory is a different version than indicated in the order, the order fails due to the version mismatch.\n\nData type: Object\n\n```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_productSpecification_type-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_productSpecification_id-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nRequired if the **productOrderItem.product.productSpecification** parameter is used. Initial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td id=\"tmf622-response-internalVersion\">\n\nInternal version of the product specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr id=\"product_productSpecification_name-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td id=\"tmf622-response-version\">\n\nExternal version of the product specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr id=\"product_relatedParty-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\n\n</td></tr><tr id=\"product_relatedParty_referredType-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr id=\"product_relatedParty_type-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_relatedParty_email-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\nStored in: The email field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_firstName-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\nStored in: The first\\_name field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_id-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\nStored in: The sys\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_lastName-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nStored in: The lastName field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_phone-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\nStored in: The business\\_phone field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"productOffering-row-tmf622\"><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"productOffering_id-row-tmf622\"><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nRequired if the **productOrderItem.productOffering** parameter is used. Initial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr id=\"productOffering_name-row-tmf622\"><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal\\_version of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr id=\"productOrdItem_quantity-row-tmf622\"><td>\n\nproductOrderItem.productOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order.\n\nDefault: null\n\n</td></tr><tr id=\"productOrderItemRelationship-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"productOrderItemRelationship_id-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nRequired if the **productOrderItem.productOrderItemRelationship** parameter is used. Unique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\nStored in: The parent\\_line\\_item field of thebsn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"productOrderItemRelationship_relType-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of items ordered.Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.revisionOperation\n\n</td><td>\n\nType of update to perform on the line item. If this value is empty, the existing line item is updated, or a new line item is added if it does not already exist. If this value is `cancel`, the line item is canceled.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr id=\"relatedParty-row-tmf622\"><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"relatedParty_referredType-row-tmf622\"><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr id=\"relatedParty_type-row-tmf622\"><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"relatedParty_id-row-tmf622\"><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr id=\"relatedParty_name-row-tmf622\"><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr id=\"requestedCompletionDate-row-tmf622\"><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\nStored in: The expected\\_end\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"requestedStartDate-row-tmf622\"><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\nStored in: The expected\\_start\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table id=\"table_xfv_2vk_5rb\"><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. If there are any issues with the characteristics or characteristics option information, the endpoint stores the following comments in the work notes fields of the associated Customer Order Line Item record:\n\n-   `The following Order Item characteristics does not exist: Review specification <**characteristic.name**> and correct the characteristic and characteristic option in the order line item prior to approving the order.`\n-   `Order Item characteristic: <**characteristic.name**> with characteristic value: <**characteristic.value**>is invalid. Correct the characteristic values before approving the order.`\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Could be any of the following reasons:-   `Invalid payload: Request body missing` - Payload was not passed in the request body.\n-   `Invalid payload: productOrderItem is missing` - Product order line item object or JSON is missing.\n-   `Invalid payload: productOrderItem id is missing` - The **id** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem action is missing` - The **action** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem productOffering is missing` - The product offering object or JSON is missing from the product order line item in the payload.\n-   `Invalid payload: productOffering id is missing` - The **id** parameter is missing in the product order line item of the product offering object in the payload.\n-   `Invalid payload: Product offering does not exist` - The product offering in the product order line item is not valid.\n-   `Invalid payload: productOrderItem product is missing` - The product object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: product productSpecification is missing` - The product specification object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: productSpecification id is missing` - The **id** parameter in the product order line item of the product specification object is missing from the payload.\n-   `Invalid payload: Product specification does not exist` - The product specification in the product order line item is not valid.\n-   `Invalid payload: Product Inventory does not exist` - In a change order \\(action = change\\), the quantity of an item is greater than what is in stock.\n-   `Invalid payload: Product inventory ID is missing` - In a change order, the **product.id** is missing in the payload.\n-   `Invalid payload: Sold Product is inactive` - In a change order, a product specified in the payload is inactive.\n-   `Invalid payload: relatedParty is missing` - The related party object is missing from the payload.\n-   `Customer Account or Consumer is missing` - The related party customer or consumer object is missing from the payload.\n-   `Invalid payload: Consumer does not exist` - The specified related party consumer does not exist in the ServiceNow instance.\n-   `Invalid payload: Customer Account does not exist` - The specified related party customer does not exist in the ServiceNow instance.\n-   `Invalid payload: Order creation failed` - Not able to create the requested order.\n-   `In-flight revision to order currency not supported` - The **orderCurrency** parameter can't be updated after the order is created.\n-   `This order is yet to be created in customer order table. Please check in inbound queue for more details.` – The order ID provided is not in the customer order table.\n-   `Patch request cannot be made as the order's fulfillment type is not 'deliver.` – The patch request was made on an order which has a fulfillment type other than deliver.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"table_c1v_xpk_5rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td>\n\nDate and time when the action must be performed on the order.\n\nThis value must be the same as or later than the **committedDueDate** values for each order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal identifier for the customer order, such as a purchase order number.Data type: String\n\n</td></tr><tr><td>\n\nhref\n\n</td><td>\n\nRelative link to the product order record.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order updated for this request. Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td>\n\nOptional. Date and time when the action must be performed on the order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"d3138e1801\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. List of external IDs to map to the product inventories created for the order. Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n**Note:** Previously, when creating a PATCH order with an external product inventory ID that already existed, the operation was aborted and returned an error. With the Xanadu release, this parameter is simply ignored when an existing external product inventory ID is supplied and an error is not thrown.\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-resp-descr\">\n\nExternal ID mapped to the product inventory.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nUnique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n```\n\"productSpecification:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalId\n\n</td><td>\n\nInitial version of the product specification. The initial version is the sys\\_id of the first version of the specification.Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nVersion of the product specification.Data type: String\n\nTable: In the version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification.Data type: String\n\nTable: In the external\\_version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalId\n\n</td><td>\n\nInitial version of the product offering. The initial version is the sys\\_id of the first version of the offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table, field version.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal version of the product offering.Data type: String\n\nTable: In the external\\_version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nCurrent state of the product order item.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.type\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example retrieves the given product order associated with the ID 8d75939453126010a795ddeeff7b126a.\n\n```\ncurl -X GET \"https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a\" \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d {\n  \"channel\": [\n    {\n      \"id\": \"1\",\n      \"name\": \"Agent Assist\"\n    }\n  ]\n}\n```\n\nResponse body.\n\n```\n{\n   \"id\": \"8d75939453126010a795ddeeff7b126a\",\n   \"href\": \"/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a\",\n   \"expectedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n   \"requestedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n   \"requestedStartDate\": \"2020-05-03T08:13:59.000Z\",\n   \"externalId\": \"PO-456\",\n   \"orderCurrency\": \"USD\",\n   \"channel\": [\n      {\n         \"id\": \"1\",\n         \"name\": \"Agent Assist\"\n      }\n   ],\n   \"note\": [\n      {\n         \"author\": \"System Administrator\",\n         \"date\": \"2021-02-25T14:22:07.000Z\",\n         \"text\": \"This is a TMF product order illustration no 2\"\n      },\n      {\n         \"author\": \"System Administrator\",\n         \"date\": \"2021-02-25T14:22:06.000Z\",\n         \"text\": \"This is a TMF product order illustration\"\n      }\n   ],\n   \"productOrderItem\": [\n      {\n         \"id\": \"POI130\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"actionReason\": \"adding service package OLI\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"USD\",\n                     \"value\": 20\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productCharacteristic\": [\n               {\n                  \"name\": \"Security Type\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Base\",\n                  \"previousValue\": \"\"\n               }\n            ],\n            \"productSpecification\": {\n               \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n               \"name\": \"SD-WAN Security\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"a6514bd3534560102f18ddeeff7b1247\",\n               \"@type\": \"ProductSpecificationRef\"\n            },\n            \"relatedParty\": [\n               {\n                  \"id\": \"4175939453126010a795ddeeff7b127d\",\n                  \"name\": \"John Smith\",\n                  \"email\": \"abc2@example.com\",\n                  \"phone\": \"32456768\",\n                  \"@type\": \"RelatedParty\",\n                  \"@referredType\": \"OrderLineItemContact\"\n               },\n               {\n                  \"id\": \"c175939453126010a795ddeeff7b127c\",\n                  \"name\": \"Joe Doe\",\n                  \"email\": \"abc@example.com\",\n                  \"phone\": \"1234567890\",\n                  \"@type\": \"RelatedParty\",\n                  \"@referredType\": \"OrderLineItemContact\"\n               }\n            ]\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"internalVersion\": \"1\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI100\",\n               \"relationshipType\": \"HasParent\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      },\n      {\n         \"id\": \"POI100\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productSpecification\": {\n               \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n               \"name\": \"SD-WAN Service Package\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n               \"@type\": \"ProductSpecificationRef\"\n            }\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"internalVersion\": \"1\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI130\",\n               \"relationshipType\": \"HasChild\"\n            },\n            {\n               \"id\": \"POI120\",\n               \"relationshipType\": \"HasChild\"\n            },\n            {\n               \"id\": \"POI110\",\n               \"relationshipType\": \"HasChild\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      },\n      {\n         \"id\": \"POI120\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"actionReason\": \"adding service package OLI\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"USD\",\n                     \"value\": 20\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productCharacteristic\": [\n               {\n                  \"name\": \"CPE Type\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Physical\",\n                  \"previousValue\": \"\"\n               },\n               {\n                  \"name\": \"WAN Optimization\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Advance\",\n                  \"previousValue\": \"\"\n               },\n               {\n                  \"name\": \"Routing\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Premium\",\n                  \"previousValue\": \"\"\n               },\n               {\n                  \"name\": \"CPE Model\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"ASR\",\n                  \"previousValue\": \"\"\n               }\n            ],\n            \"productSpecification\": {\n               \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n               \"name\": \"SD-WAN Edge Device\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"39b627aa53702010cd6dddeeff7b1202\",\n               \"@type\": \"ProductSpecificationRef\"\n            }\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalVersion\": \"1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI100\",\n               \"relationshipType\": \"HasParent\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      },\n      {\n         \"id\": \"POI110\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"actionReason\":\"adding service package OLI\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"USD\",\n                     \"value\": 5\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productCharacteristic\": [\n               {\n                  \"name\": \"Tenancy\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Base (10 site)\",\n                  \"previousValue\": \"\"\n               }\n            ],\n            \"productSpecification\": {\n               \"id\": \"216663aa53702010cd6dddeeff7b12b5\",\n               \"name\": \"SD-WAN Controller\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"216663aa53702010cd6dddeeff7b12b5\",\n               \"@type\": \"ProductSpecificationRef\"\n            },\n            \"place\": {\n               \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n               \"@type\": \"Place\"\n            }\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"internalVersion\": \"1\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI100\",\n               \"relationshipType\": \"HasParent\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      }\n   ],\n   \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n   \"state\": \"in_progress\",\n   \"@type\": \"ProductOrder\"\n}\n```\n\n## Product Order Open API - PATCH /sn\\_ind\\_tmt\\_orm/order/productOrder/\\{id\\}\n\nUpdates the specified customer order.\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/order/productOrder/{id}`\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order to update.Data type: String\n\nTable: Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n<table id=\"id_vk2_p5n_t4b\" class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n@type\n\n</td><td id=\"type-entry-tmf622\">\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr><tr id=\"channel-row-tmf622\"><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr id=\"channel_id-row-tmf622\"><td>\n\nchannel.id\n\n</td><td>\n\nRequired if the **channel** parameter is used. Unique identifier of the channel to use to sell the associated products. Data type: String\n\nTable: In the external\\_id field of the Distribution Channel \\[sn\\_prd\\_pm\\_distribution\\_channel\\] table.\n\nStored in: The channel field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"channel_name-row-tmf622\"><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Possible channel names are defined on the Choice List tab in the Channel Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order table.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td id=\"due-date-PATCH\">\n\nDate and time when the action must be performed on the order.This value must be the same as or later than the **committedDueDate** values for each order line item.\n\nIf the action for order line items is `suspend` or `resume`, this parameter can't be updated.\n\nData type: String\n\nStored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\n</td></tr><tr id=\"externalId-row-tmf622\"><td>\n\nexternalId\n\n</td><td>\n\nUnique identifier for the customer order. This value is determined by an external system. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nexternalSystem\n\n</td><td id=\"tmf622-response-externalSystem\">\n\nExternal system of the service order, appended with `TMF622`. For example, if the external system is ABC then enter the value in **externalSystem** as `ABC-TMF622`.\n\nData Type: String\n\n</td></tr><tr id=\"note-row-tmf622\"><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr id=\"note_text-row-tmf622\"><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\nStored in: The comments field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items. Updating the currency code of an existing order is not supported. Providing any value other than the currency code already associated with the order causes the update to be rejected.Data type: String\n\n</td></tr><tr id=\"productOrderItem-row-tmf622\"><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem\": [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemRelationship\": [Array],\n    \"quantity\": Number,\n    \"revisionOperation\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td id=\"prodOrdItem_type-entry-tmf622\">\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr id=\"productOrderItem_action-row-tmf622\"><td>\n\nproductOrderItem.action\n\n</td><td>\n\nRequired if the **productOrderItem** parameter is used. Action to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Possible values:\n\n-   add\n-   change\n\n**Note:** Submitting a change payload that includes a new service location via **productOrderItem.product.place.id** is processed as a move order.\n\n-   delete\n-   no-change\n-   resume\n-   suspend\n\nData type: String\n\nStored in: The action field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: add\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td id=\"prodOrdItem_actionReason-response-tmf622\">\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td id=\"due-date-item-PATCH\">\n\nDate and time when the action must be performed on the order line item.If the action for the item is `suspend` or `resume`, this parameter can't be updated.\n\nData type: String\n\nStored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"externalProdInvId\"><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-decsr\">\n\nExternal ID to map to the product inventory.Data type: String\n\nStored in: The external\\_inventory\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table and the sn\\_prd\\_invt\\_external\\_id field of the sn\\_prd\\_invt\\_product\\_inventory table.\n\n</td></tr><tr id=\"externalProdInv-PATCH\"><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProdInv-descr-PATCH\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. List of external IDs to map to the product inventories created for the order. Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n**Note:** Previously, when creating a PATCH order with an external product inventory ID that already existed, the operation was aborted and returned an error. With the Xanadu release, this parameter is simply ignored when an existing external product inventory ID is supplied and an error is not thrown.\n\n</td></tr><tr id=\"productOrderItem_id-row-tmf622\"><td>\n\nproductOrderItem.id\n\n</td><td>\n\nRequired if the **productOrderItem** parameter is used. Unique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nMaximum length: 40\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice-row-tmf622\"><td>\n\nproductOrderItem.itemPrice\n\n</td><td id=\"itemPrice-entry-tmf622\">\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice_price-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td id=\"itemPrice_price-entry-tmf622\">\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td id=\"itemPrice_price_taxIncludedAmt-entry-tmf622\">\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt_unit-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td id=\"itemPrice_price_taxIncludedAmt_unit-entry-tmf622\">\n\nCurrency code in which the price is depicted. Data type: String\n\nStored in: The mrc or nrc field in the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt_value-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td id=\"itemPrice_price_taxIncludedAmt_value-entry-tmf622\">\n\nPrice of product, including any tax. Data type: Number\n\nStored in: The mrc or nrc field in the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"itemPrice_priceType-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td id=\"itemPrice_priceType-entry-tmf622\">\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr id=\"itemPrice_recurringChargePeriod-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td id=\"itemPrice_recurringChargePeriod-entry-tmf622\">\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr id=\"product-row-tmf622\"><td>\n\nproductOrderItem.product\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Description of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_type-row-tmf622\"><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_id-row-tmf622\"><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Unique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. Data type: String\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_place-row-tmf622\"><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_place_type-row-tmf622\"><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_place_id-row-tmf622\"><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nRequired if the **productOrderItem.product.place** parameter is used. Sys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\nStored in: The location field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\n\n</td></tr><tr id=\"prod_prodChar_name-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\nStored in: The characteristics field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar_previousValue-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The previous\\_characteristic\\_option\\_value of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar_value-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Data type: String\n\nPossible values:\n\n-   array.date\n-   array.datetime\n-   array.decimal\n-   array.integer\n-   array.object\n-   array.single line test\n-   checkbox\n-   choice\n-   date,address\n-   email\n-   integer,date/time\n-   object\n-   single line text\n-   yes/no\n\n</td></tr><tr id=\"product_productSpecification-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. **Note:** Change orders \\(**productOrderItem.action** is `change`\\) are processed differently based on the value of the **sn\\_ind\\_tmt\\_orm.allowSpecVersionUpdateInChangeOrder** system property. The value of this system property determines how the order is processed if the product inventory is a different version than indicated in the order.\n\n-   When this system property is set to true \\(default\\), the product inventory is automatically upgraded to the version in the order by changing the referenced product specification. This allows the order to be successfully processed.\n-   When this system property is set to false, if the product inventory is a different version than indicated in the order, the order fails due to the version mismatch.\n\nData type: Object\n\n```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_productSpecification_type-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_productSpecification_id-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nRequired if the **productOrderItem.product.productSpecification** parameter is used. Initial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td id=\"tmf622-response-internalVersion\">\n\nInternal version of the product specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr id=\"product_productSpecification_name-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td id=\"tmf622-response-version\">\n\nExternal version of the product specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr id=\"product_relatedParty-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\n\n</td></tr><tr id=\"product_relatedParty_referredType-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr id=\"product_relatedParty_type-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_relatedParty_email-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\nStored in: The email field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_firstName-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\nStored in: The first\\_name field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_id-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\nStored in: The sys\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_lastName-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nStored in: The lastName field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_phone-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\nStored in: The business\\_phone field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"productOffering-row-tmf622\"><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"productOffering_id-row-tmf622\"><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nRequired if the **productOrderItem.productOffering** parameter is used. Initial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr id=\"productOffering_name-row-tmf622\"><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal\\_version of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr id=\"productOrdItem_quantity-row-tmf622\"><td>\n\nproductOrderItem.productOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order.\n\nDefault: null\n\n</td></tr><tr id=\"productOrderItemRelationship-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"productOrderItemRelationship_id-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nRequired if the **productOrderItem.productOrderItemRelationship** parameter is used. Unique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\nStored in: The parent\\_line\\_item field of thebsn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"productOrderItemRelationship_relType-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of items ordered.Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.revisionOperation\n\n</td><td>\n\nType of update to perform on the line item. If this value is empty, the existing line item is updated, or a new line item is added if it does not already exist. If this value is `cancel`, the line item is canceled.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr id=\"relatedParty-row-tmf622\"><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"relatedParty_referredType-row-tmf622\"><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr id=\"relatedParty_type-row-tmf622\"><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"relatedParty_id-row-tmf622\"><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr id=\"relatedParty_name-row-tmf622\"><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr id=\"requestedCompletionDate-row-tmf622\"><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\nStored in: The expected\\_end\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"requestedStartDate-row-tmf622\"><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\nStored in: The expected\\_start\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table id=\"table_xfv_2vk_5rb\"><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. If there are any issues with the characteristics or characteristics option information, the endpoint stores the following comments in the work notes fields of the associated Customer Order Line Item record:\n\n-   `The following Order Item characteristics does not exist: Review specification <**characteristic.name**> and correct the characteristic and characteristic option in the order line item prior to approving the order.`\n-   `Order Item characteristic: <**characteristic.name**> with characteristic value: <**characteristic.value**>is invalid. Correct the characteristic values before approving the order.`\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Could be any of the following reasons:-   `Invalid payload: Request body missing` - Payload was not passed in the request body.\n-   `Invalid payload: productOrderItem is missing` - Product order line item object or JSON is missing.\n-   `Invalid payload: productOrderItem id is missing` - The **id** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem action is missing` - The **action** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem productOffering is missing` - The product offering object or JSON is missing from the product order line item in the payload.\n-   `Invalid payload: productOffering id is missing` - The **id** parameter is missing in the product order line item of the product offering object in the payload.\n-   `Invalid payload: Product offering does not exist` - The product offering in the product order line item is not valid.\n-   `Invalid payload: productOrderItem product is missing` - The product object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: product productSpecification is missing` - The product specification object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: productSpecification id is missing` - The **id** parameter in the product order line item of the product specification object is missing from the payload.\n-   `Invalid payload: Product specification does not exist` - The product specification in the product order line item is not valid.\n-   `Invalid payload: Product Inventory does not exist` - In a change order \\(action = change\\), the quantity of an item is greater than what is in stock.\n-   `Invalid payload: Product inventory ID is missing` - In a change order, the **product.id** is missing in the payload.\n-   `Invalid payload: Sold Product is inactive` - In a change order, a product specified in the payload is inactive.\n-   `Invalid payload: relatedParty is missing` - The related party object is missing from the payload.\n-   `Customer Account or Consumer is missing` - The related party customer or consumer object is missing from the payload.\n-   `Invalid payload: Consumer does not exist` - The specified related party consumer does not exist in the ServiceNow instance.\n-   `Invalid payload: Customer Account does not exist` - The specified related party customer does not exist in the ServiceNow instance.\n-   `Invalid payload: Order creation failed` - Not able to create the requested order.\n-   `In-flight revision to order currency not supported` - The **orderCurrency** parameter can't be updated after the order is created.\n-   `This order is yet to be created in customer order table. Please check in inbound queue for more details.` – The order ID provided is not in the customer order table.\n-   `Patch request cannot be made as the order's fulfillment type is not 'deliver.` – The patch request was made on an order which has a fulfillment type other than deliver.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"table_c1v_xpk_5rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td>\n\nDate and time when the action must be performed on the order.\n\nThis value must be the same as or later than the **committedDueDate** values for each order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal identifier for the customer order, such as a purchase order number.Data type: String\n\n</td></tr><tr><td>\n\nhref\n\n</td><td>\n\nRelative link to the product order record.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order updated for this request. Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td>\n\nOptional. Date and time when the action must be performed on the order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"d3138e1801\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. List of external IDs to map to the product inventories created for the order. Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n**Note:** Previously, when creating a PATCH order with an external product inventory ID that already existed, the operation was aborted and returned an error. With the Xanadu release, this parameter is simply ignored when an existing external product inventory ID is supplied and an error is not thrown.\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-resp-descr\">\n\nExternal ID mapped to the product inventory.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nUnique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n```\n\"productSpecification:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalId\n\n</td><td>\n\nInitial version of the product specification. The initial version is the sys\\_id of the first version of the specification.Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nVersion of the product specification.Data type: String\n\nTable: In the version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification.Data type: String\n\nTable: In the external\\_version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalId\n\n</td><td>\n\nInitial version of the product offering. The initial version is the sys\\_id of the first version of the offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table, field version.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal version of the product offering.Data type: String\n\nTable: In the external\\_version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nCurrent state of the product order item.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.type\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example updates the channel for a product order.\n\n```\ncurl -X PATCH \"https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a\" \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d {\n  \"channel\": [\n    {\n      \"id\": \"1\",\n      \"name\": \"Agent Assist\"\n    }\n  ]\n}\n```\n\nResponse body.\n\n```\n{\n   \"id\": \"8d75939453126010a795ddeeff7b126a\",\n   \"href\": \"/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a\",\n   \"expectedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n   \"requestedCompletionDate\": \"2021-05-02T08:13:59.000Z\",\n   \"requestedStartDate\": \"2020-05-03T08:13:59.000Z\",\n   \"externalId\": \"PO-456\",\n   \"orderCurrency\": \"USD\",\n   \"channel\": [\n      {\n         \"id\": \"1\",\n         \"name\": \"Agent Assist\"\n      }\n   ],\n   \"note\": [\n      {\n         \"author\": \"System Administrator\",\n         \"date\": \"2021-02-25T14:22:07.000Z\",\n         \"text\": \"This is a TMF product order illustration no 2\"\n      },\n      {\n         \"author\": \"System Administrator\",\n         \"date\": \"2021-02-25T14:22:06.000Z\",\n         \"text\": \"This is a TMF product order illustration\"\n      }\n   ],\n   \"productOrderItem\": [\n      {\n         \"id\": \"POI130\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"actionReason\": \"adding service package OLI\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"USD\",\n                     \"value\": 20\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productCharacteristic\": [\n               {\n                  \"name\": \"Security Type\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Base\",\n                  \"previousValue\": \"\"\n               }\n            ],\n            \"productSpecification\": {\n               \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n               \"name\": \"SD-WAN Security\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"a6514bd3534560102f18ddeeff7b1247\",\n               \"@type\": \"ProductSpecificationRef\"\n            },\n            \"relatedParty\": [\n               {\n                  \"id\": \"4175939453126010a795ddeeff7b127d\",\n                  \"name\": \"John Smith\",\n                  \"email\": \"abc2@example.com\",\n                  \"phone\": \"32456768\",\n                  \"@type\": \"RelatedParty\",\n                  \"@referredType\": \"OrderLineItemContact\"\n               },\n               {\n                  \"id\": \"c175939453126010a795ddeeff7b127c\",\n                  \"name\": \"Joe Doe\",\n                  \"email\": \"abc@example.com\",\n                  \"phone\": \"1234567890\",\n                  \"@type\": \"RelatedParty\",\n                  \"@referredType\": \"OrderLineItemContact\"\n               }\n            ]\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"internalVersion\": \"1\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI100\",\n               \"relationshipType\": \"HasParent\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      },\n      {\n         \"id\": \"POI100\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productSpecification\": {\n               \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n               \"name\": \"SD-WAN Service Package\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n               \"@type\": \"ProductSpecificationRef\"\n            }\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"internalVersion\": \"1\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI130\",\n               \"relationshipType\": \"HasChild\"\n            },\n            {\n               \"id\": \"POI120\",\n               \"relationshipType\": \"HasChild\"\n            },\n            {\n               \"id\": \"POI110\",\n               \"relationshipType\": \"HasChild\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      },\n      {\n         \"id\": \"POI120\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"actionReason\": \"adding service package OLI\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"USD\",\n                     \"value\": 20\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productCharacteristic\": [\n               {\n                  \"name\": \"CPE Type\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Physical\",\n                  \"previousValue\": \"\"\n               },\n               {\n                  \"name\": \"WAN Optimization\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Advance\",\n                  \"previousValue\": \"\"\n               },\n               {\n                  \"name\": \"Routing\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Premium\",\n                  \"previousValue\": \"\"\n               },\n               {\n                  \"name\": \"CPE Model\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"ASR\",\n                  \"previousValue\": \"\"\n               }\n            ],\n            \"productSpecification\": {\n               \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n               \"name\": \"SD-WAN Edge Device\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"39b627aa53702010cd6dddeeff7b1202\",\n               \"@type\": \"ProductSpecificationRef\"\n            }\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalVersion\": \"1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI100\",\n               \"relationshipType\": \"HasParent\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      },\n      {\n         \"id\": \"POI110\",\n         \"ponr\": \"false\",\n         \"quantity\": 1,\n         \"action\": \"add\",\n         \"actionReason\":\"adding service package OLI\",\n         \"itemPrice\": [\n            {\n               \"priceType\": \"recurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"INR\",\n                     \"value\": 0\n                  }\n               }\n            },\n            {\n               \"priceType\": \"nonRecurring\",\n               \"price\": {\n                  \"taxIncludedAmount\": {\n                     \"unit\": \"USD\",\n                     \"value\": 5\n                  }\n               }\n            }\n         ],\n         \"product\": {\n            \"@type\": \"Product\",\n            \"productCharacteristic\": [\n               {\n                  \"name\": \"Tenancy\",\n                  \"valueType\": \"Choice\",\n                  \"value\": \"Base (10 site)\",\n                  \"previousValue\": \"\"\n               }\n            ],\n            \"productSpecification\": {\n               \"id\": \"216663aa53702010cd6dddeeff7b12b5\",\n               \"name\": \"SD-WAN Controller\",\n               \"version\": \"v1\",\n               \"internalVersion\": \"1\",\n               \"internalId\": \"216663aa53702010cd6dddeeff7b12b5\",\n               \"@type\": \"ProductSpecificationRef\"\n            },\n            \"place\": {\n               \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n               \"@type\": \"Place\"\n            }\n         },\n         \"productOffering\": {\n            \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"name\": \"Premium SD-WAN Offering\",\n            \"version\": \"v1\",\n            \"internalId\": \"69017a0f536520103b6bddeeff7b127d\",\n            \"internalVersion\": \"1\"\n         },\n         \"productOrderItemRelationship\": [\n            {\n               \"id\": \"POI100\",\n               \"relationshipType\": \"HasParent\"\n            }\n         ],\n         \"state\": \"in_progress\",\n         \"version\": \"1\",\n         \"@type\": \"ProductOrderItem\"\n      }\n   ],\n   \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n   \"state\": \"in_progress\",\n   \"@type\": \"ProductOrder\"\n}\n```\n\n## Product Order Open API - PATCH /sn\\_ind\\_tmt\\_orm/productorder/\\{id\\}\n\nUpdates the specified customer order.\n\n**Important:** Starting with the Tokyo release, this endpoint is deprecated. The new version of this endpoint is [Product Order Open API - PATCH /sn\\_ind\\_tmt\\_orm/order/productOrder/\\{id\\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/tmf622_product_ordering-api.md).\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/productorder/{id}`\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order to update.Data type: String\n\nTable: Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n<table id=\"id_vk2_p5n_t4b\" class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n@type\n\n</td><td id=\"type-entry-tmf622\">\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr><tr id=\"channel-row-tmf622\"><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr id=\"channel_id-row-tmf622\"><td>\n\nchannel.id\n\n</td><td>\n\nRequired if the **channel** parameter is used. Unique identifier of the channel to use to sell the associated products. Data type: String\n\nTable: In the external\\_id field of the Distribution Channel \\[sn\\_prd\\_pm\\_distribution\\_channel\\] table.\n\nStored in: The channel field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"channel_name-row-tmf622\"><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Possible channel names are defined on the Choice List tab in the Channel Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order table.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td id=\"due-date-PATCH\">\n\nDate and time when the action must be performed on the order.This value must be the same as or later than the **committedDueDate** values for each order line item.\n\nIf the action for order line items is `suspend` or `resume`, this parameter can't be updated.\n\nData type: String\n\nStored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\n</td></tr><tr id=\"externalId-row-tmf622\"><td>\n\nexternalId\n\n</td><td>\n\nUnique identifier for the customer order. This value is determined by an external system. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nexternalSystem\n\n</td><td id=\"tmf622-response-externalSystem\">\n\nExternal system of the service order, appended with `TMF622`. For example, if the external system is ABC then enter the value in **externalSystem** as `ABC-TMF622`.\n\nData Type: String\n\n</td></tr><tr id=\"note-row-tmf622\"><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr id=\"note_text-row-tmf622\"><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\nStored in: The comments field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items. Updating the currency code of an existing order is not supported. Providing any value other than the currency code already associated with the order causes the update to be rejected.Data type: String\n\n</td></tr><tr id=\"productOrderItem-row-tmf622\"><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem\": [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemRelationship\": [Array],\n    \"quantity\": Number,\n    \"revisionOperation\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td id=\"prodOrdItem_type-entry-tmf622\">\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr id=\"productOrderItem_action-row-tmf622\"><td>\n\nproductOrderItem.action\n\n</td><td>\n\nRequired if the **productOrderItem** parameter is used. Action to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Possible values:\n\n-   add\n-   change\n\n**Note:** Submitting a change payload that includes a new service location via **productOrderItem.product.place.id** is processed as a move order.\n\n-   delete\n-   no-change\n-   resume\n-   suspend\n\nData type: String\n\nStored in: The action field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: add\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td id=\"prodOrdItem_actionReason-response-tmf622\">\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td id=\"due-date-item-PATCH\">\n\nDate and time when the action must be performed on the order line item.If the action for the item is `suspend` or `resume`, this parameter can't be updated.\n\nData type: String\n\nStored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"externalProdInvId\"><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-decsr\">\n\nExternal ID to map to the product inventory.Data type: String\n\nStored in: The external\\_inventory\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table and the sn\\_prd\\_invt\\_external\\_id field of the sn\\_prd\\_invt\\_product\\_inventory table.\n\n</td></tr><tr id=\"externalProdInv-PATCH\"><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProdInv-descr-PATCH\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. List of external IDs to map to the product inventories created for the order. Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n**Note:** Previously, when creating a PATCH order with an external product inventory ID that already existed, the operation was aborted and returned an error. With the Xanadu release, this parameter is simply ignored when an existing external product inventory ID is supplied and an error is not thrown.\n\n</td></tr><tr id=\"productOrderItem_id-row-tmf622\"><td>\n\nproductOrderItem.id\n\n</td><td>\n\nRequired if the **productOrderItem** parameter is used. Unique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nMaximum length: 40\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice-row-tmf622\"><td>\n\nproductOrderItem.itemPrice\n\n</td><td id=\"itemPrice-entry-tmf622\">\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice_price-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td id=\"itemPrice_price-entry-tmf622\">\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\nDefault: Blank string\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td id=\"itemPrice_price_taxIncludedAmt-entry-tmf622\">\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt_unit-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td id=\"itemPrice_price_taxIncludedAmt_unit-entry-tmf622\">\n\nCurrency code in which the price is depicted. Data type: String\n\nStored in: The mrc or nrc field in the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"itemPrice_price_taxIncludedAmt_value-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td id=\"itemPrice_price_taxIncludedAmt_value-entry-tmf622\">\n\nPrice of product, including any tax. Data type: Number\n\nStored in: The mrc or nrc field in the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr id=\"itemPrice_priceType-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td id=\"itemPrice_priceType-entry-tmf622\">\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr id=\"itemPrice_recurringChargePeriod-row-tmf622\"><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td id=\"itemPrice_recurringChargePeriod-entry-tmf622\">\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr id=\"product-row-tmf622\"><td>\n\nproductOrderItem.product\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Description of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_type-row-tmf622\"><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_id-row-tmf622\"><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Unique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. Data type: String\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_place-row-tmf622\"><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_place_type-row-tmf622\"><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_place_id-row-tmf622\"><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nRequired if the **productOrderItem.product.place** parameter is used. Sys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\nStored in: The location field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\n\n</td></tr><tr id=\"prod_prodChar_name-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\nStored in: The characteristics field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar_previousValue-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The previous\\_characteristic\\_option\\_value of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"prod_prodChar_value-row-tmf622\"><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Data type: String\n\nPossible values:\n\n-   array.date\n-   array.datetime\n-   array.decimal\n-   array.integer\n-   array.object\n-   array.single line test\n-   checkbox\n-   choice\n-   date,address\n-   email\n-   integer,date/time\n-   object\n-   single line text\n-   yes/no\n\n</td></tr><tr id=\"product_productSpecification-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. **Note:** Change orders \\(**productOrderItem.action** is `change`\\) are processed differently based on the value of the **sn\\_ind\\_tmt\\_orm.allowSpecVersionUpdateInChangeOrder** system property. The value of this system property determines how the order is processed if the product inventory is a different version than indicated in the order.\n\n-   When this system property is set to true \\(default\\), the product inventory is automatically upgraded to the version in the order by changing the referenced product specification. This allows the order to be successfully processed.\n-   When this system property is set to false, if the product inventory is a different version than indicated in the order, the order fails due to the version mismatch.\n\nData type: Object\n\n```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"product_productSpecification_type-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_productSpecification_id-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nRequired if the **productOrderItem.product.productSpecification** parameter is used. Initial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td id=\"tmf622-response-internalVersion\">\n\nInternal version of the product specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr id=\"product_productSpecification_name-row-tmf622\"><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td id=\"tmf622-response-version\">\n\nExternal version of the product specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr id=\"product_relatedParty-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\n\n</td></tr><tr id=\"product_relatedParty_referredType-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr id=\"product_relatedParty_type-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"product_relatedParty_email-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\nStored in: The email field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_firstName-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\nStored in: The first\\_name field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_id-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\nStored in: The sys\\_id field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_lastName-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nStored in: The lastName field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"product_relatedParty_phone-row-tmf622\"><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\nStored in: The business\\_phone field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"productOffering-row-tmf622\"><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"productOffering_id-row-tmf622\"><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nRequired if the **productOrderItem.productOffering** parameter is used. Initial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr id=\"productOffering_name-row-tmf622\"><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal\\_version of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr id=\"productOrdItem_quantity-row-tmf622\"><td>\n\nproductOrderItem.productOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order.\n\nDefault: null\n\n</td></tr><tr id=\"productOrderItemRelationship-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr id=\"productOrderItemRelationship_id-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nRequired if the **productOrderItem.productOrderItemRelationship** parameter is used. Unique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\nStored in: The parent\\_line\\_item field of thebsn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"productOrderItemRelationship_relType-row-tmf622\"><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of items ordered.Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.revisionOperation\n\n</td><td>\n\nType of update to perform on the line item. If this value is empty, the existing line item is updated, or a new line item is added if it does not already exist. If this value is `cancel`, the line item is canceled.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr id=\"relatedParty-row-tmf622\"><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"relatedParty_referredType-row-tmf622\"><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr id=\"relatedParty_type-row-tmf622\"><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr id=\"relatedParty_id-row-tmf622\"><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr id=\"relatedParty_name-row-tmf622\"><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr id=\"requestedCompletionDate-row-tmf622\"><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\nStored in: The expected\\_end\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"requestedStartDate-row-tmf622\"><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\nStored in: The expected\\_start\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table id=\"table_xfv_2vk_5rb\"><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. If there are any issues with the characteristics or characteristics option information, the endpoint stores the following comments in the work notes fields of the associated Customer Order Line Item record:\n\n-   `The following Order Item characteristics does not exist: Review specification <**characteristic.name**> and correct the characteristic and characteristic option in the order line item prior to approving the order.`\n-   `Order Item characteristic: <**characteristic.name**> with characteristic value: <**characteristic.value**>is invalid. Correct the characteristic values before approving the order.`\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Could be any of the following reasons:-   `Invalid payload: Request body missing` - Payload was not passed in the request body.\n-   `Invalid payload: productOrderItem is missing` - Product order line item object or JSON is missing.\n-   `Invalid payload: productOrderItem id is missing` - The **id** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem action is missing` - The **action** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem productOffering is missing` - The product offering object or JSON is missing from the product order line item in the payload.\n-   `Invalid payload: productOffering id is missing` - The **id** parameter is missing in the product order line item of the product offering object in the payload.\n-   `Invalid payload: Product offering does not exist` - The product offering in the product order line item is not valid.\n-   `Invalid payload: productOrderItem product is missing` - The product object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: product productSpecification is missing` - The product specification object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: productSpecification id is missing` - The **id** parameter in the product order line item of the product specification object is missing from the payload.\n-   `Invalid payload: Product specification does not exist` - The product specification in the product order line item is not valid.\n-   `Invalid payload: Product Inventory does not exist` - In a change order \\(action = change\\), the quantity of an item is greater than what is in stock.\n-   `Invalid payload: Product inventory ID is missing` - In a change order, the **product.id** is missing in the payload.\n-   `Invalid payload: Sold Product is inactive` - In a change order, a product specified in the payload is inactive.\n-   `Invalid payload: relatedParty is missing` - The related party object is missing from the payload.\n-   `Invalid payload: Customer Account or Consumer is missing` - The related party customer or consumer object is missing from the payload.\n-   `Invalid payload: Consumer does not exist` - The specified related party consumer does not exist in the ServiceNow instance.\n-   `Invalid payload: Customer Account does not exist` - The specified related party customer does not exist in the ServiceNow instance.\n-   `Invalid payload: Order creation failed` - Not able to create the requested order.\n-   `Invalid payload: This order is yet to be created in customer order table. Please check in inbound queue for more details.` - The patch request was made for an order that is not in the customer order table yet. The order is in the Inbound Queue \\[sn\\_tmt\\_core\\_inbound\\_queue\\] table waiting for the scheduler to pick the record to be processed.\n-   `Invalid payload: Patch request cannot be made as the order's fulfillment type is not 'deliver'.` - The patch request was made for an order which has a fulfillment type other than**deliver**.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"table_c1v_xpk_5rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n ```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order updated for this request. Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal identifier for the customer order, such as a purchase order number.Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n ```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n ```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n ```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n ```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n ```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n ```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nUnique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n ```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n ```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n ```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nInternal version of the product specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n ```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"id\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.id\n\n</td><td>\n\nRequired. Sys\\_id of the line item contact associated with the order line item. Located in the Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\n Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\n Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n ```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n ```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nCurrent state of the product order item.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n ```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.type\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\n Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following code example updates the channel for a customer order.\n\n```\ncurl -X PATCH \"https://instance.servicenow.com/api/sn_ind_tmt_orm/productorder/6be0a925c3a220103e2e73ce3640ddfe\" \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d {\n  \"channel\": [\n    {\n      \"id\": \"1\",\n      \"name\": \"Agent Assist\"\n    }\n  ]\n}\n```\n\nResponse body.\n\n```\n{\n    \"requestedCompletionDate\": \"2021-05-02T08:13:59.506Z\",\n    \"requestedStartDate\": \"2020-05-03T08:13:59.506Z\",\n    \"externalId\": \"PO-456\",\n    \"externalSystem\": \"Salesforce – TMF 641\",\n    \"channel\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Agent Assist\"\n        }\n    ],\n    \"note\": [\n        {\n            \"text\": \"This is a TMF product order illustration\"\n        },\n        {\n            \"text\": \"This is a TMF product order illustration no 2\"\n        }\n    ],\n    \"productOrderItem\": [\n        {\n            \"id\": \"POI100\",\n            \"quantity\": 1,\n            \"action\": \"change\",\n            \"actionReason\":\"adding service package OLI\",\n            \"product\": {\n                \"id\": \"fa6d13f45b5620102dff5e92dc81c77f\",\n                \"@type\": \"Product\",\n                \"productSpecification\": {\n                    \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n                    \"name\": \"SD-WAN Service Package\",\n                    \"@type\": \"ProductSpecificationRef\"\n                },\n                \"place\": {\n                    \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                    \"@type\": \"Place\"\n                }\n            },\n            \"productOffering\": {\n                \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n                \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n                {\n                    \"id\": \"POI120\",\n                    \"relationshipType\": \"HasChild\"\n                },\n                {\n                    \"id\": \"POI130\",\n                    \"relationshipType\": \"HasChild\"\n                }\n            ],\n            \"@type\": \"ProductOrderItem\",\n            \"state\": \"new\"\n        },\n        {\n            \"id\": \"POI120\",\n            \"quantity\": 1,\n            \"action\": \"change\",\n            \"actionReason\":\"adding service package OLI\",\n            \"itemPrice\": [\n                {\n                    \"priceType\": \"recurring\",\n                    \"recurringChargePeriod\": \"month\",\n                    \"price\": {\n                        \"taxIncludedAmount\": {\n                            \"unit\": \"USD\",\n                            \"value\": 20\n                        }\n                    }\n                }\n            ],\n            \"product\": {\n                \"id\": \"766d13f45b5620102dff5e92dc81c78a\",\n                \"@type\": \"Product\",\n                \"productCharacteristic\": [\n                    {\n                        \"name\": \"WAN Optimization\"\n                        \"valueType\": \"Choice\",\n                        \"value\": \"Base\",\n                        \"previousValue\": \"Advance\"\n                    }\n                ],\n                \"productSpecification\": {\n                    \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n                    \"name\": \"SD-WAN Edge Device\",\n                    \"@type\": \"ProductSpecificationRef\",\n                    \"externalVersion\": \"1\",\n                    \"@version\": \"v1\"\n                },\n                \"relatedParty\": [\n                    {\n                        \"id\": \"51670151c35420105252716b7d40ddfe\",\n                        \"firstName\": \"Joe\",\n                        \"lastName\": \"Doe\",\n                        \"email\": \"abc@example.com\",\n                        \"phone\": \"1234567890\",\n                        \"@type\": \"RelatedParty\",\n                        \"@referredType\": \"OrderLineItemContact\"\n                    }\n                ],\n                \"place\": {\n                    \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                    \"@type\": \"Place\"\n                }\n            },\n            \"productOffering\": {\n                \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n                \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n                {\n                    \"id\": \"POI100\",\n                    \"relationshipType\": \"HasParent\"\n                }\n            ],\n            \"@type\": \"ProductOrderItem\",\n            \"state\": \"new\"\n        },\n        {\n            \"id\": \"POI130\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"actionReason\":\"adding service package OLI\",\n            \"itemPrice\": [\n                {\n                    \"priceType\": \"recurring\",\n                    \"recurringChargePeriod\": \"month\",\n                    \"price\": {\n                        \"taxIncludedAmount\": {\n                            \"unit\": \"USD\",\n                            \"value\": 20\n                        }\n                    }\n                }\n            ],\n            \"product\": {\n                \"@type\": \"Product\",\n                \"productCharacteristic\": [\n                    {\n                        \"name\": \"Security Type\",\n                        \"valueType\": \"Choice\",\n                        \"value\": \"Base\",\n                        \"previousValue\": \"Advance\"\n                    }\n                ],\n                \"productSpecification\": {\n                    \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n                    \"name\": \"SD-WAN Security\",\n                    \"@type\": \"ProductSpecificationRef\"\n                    \"externalVersion\": \"1\",\n                    \"@version\": \"v1\"\n                },\n                \"relatedParty\": [\n                    {\n                        \"id\": \"51670151c35420105252716b7d40ddfe\",\n                        \"firstName\": \"Joe\",\n                        \"lastName\": \"Doe\",\n                        \"email\": \"abc@example.com\",\n                        \"phone\": \"1234567890\",\n                        \"@type\": \"RelatedParty\",\n                        \"@referredType\": \"OrderLineItemContact\"\n                    }\n                ],\n                \"place\": {\n                    \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                    \"@type\": \"Place\"\n                }\n            },\n            \"productOffering\": {\n                \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n                \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n                {\n                    \"id\": \"POI100\",\n                    \"relationshipType\": \"HasParent\"\n                }\n            ],\n            \"@type\": \"ProductOrderItem\",\n            \"state\": \"new\"\n        }\n    ],\n    \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n    \"@type\": \"ProductOrder\",\n    \"id\": \"6be0a925c3a220103e2e73ce3640ddfe\",\n    \"state\": \"in_progress\"\n}\n```\n\n## Product Order Open API - POST /sn\\_ind\\_tmt\\_orm/cancelproductorder\n\nCancels the specified customer order.\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/cancelproductorder`\n\n### Supported request parameters\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n<table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ncancellationReason\n\n</td><td>\n\nReason for cancellation.Data type: String\n\n Default: Blank string\n\n</td></tr><tr><td>\n\nproductOrder\n\n</td><td>\n\nContains data about the product order.Data type: Object\n\n ```\n\"productOrder\": {\n  \"id\": \"String\",\n  \"href\": \"String\",\n  \"@referredType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrder.id\n\n</td><td>\n\nRequired. Sys\\_id of the customer order to cancel.Data type: String\n\nTable: Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n\n</td></tr><tr><td>\n\nproductOrder.href\n\n</td><td>\n\nURL of the customer order to cancel.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrder.@referredType\n\n</td><td>\n\nValue for this parameter should be `ProductOrder`.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nrequestedCancellationDate\n\n</td><td>\n\nDate to cancel the order.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nValue for this parameter should be `CancelProductOrder`.Data type: String\n\nDefault: Blank string\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td>\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Could be any of the following reasons:-   Empty payload.\n-   Invalid payload. Mandatory field missing: &lt;field name&gt;.\n-   Invalid order ID.\n-   Invalid order ID: `This order is yet to be created in customer order table`. The cancel request was made for an order that has not been created yet. The order is in the Inbound Queue \\[sn\\_tmt\\_core\\_inbound\\_queue\\] table waiting for the scheduler to pick up the record.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ncancellationReason\n\n</td><td>\n\nReason for cancellation.Data type: String\n\n</td></tr><tr><td>\n\nhref\n\n</td><td>\n\nURL of the cancelled order.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the cancelled order.Data type: String\n\n</td></tr><tr><td>\n\nproductOrder\n\n</td><td>\n\nData about the product order.Data type: Object\n\n```\n\"productOrder\": {\n  \"id\": \"String\",\n  \"href\": \"String\",\n  \"@referredType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrder.id\n\n</td><td>\n\nSys\\_id of the cancelled order.Data type: String\n\n</td></tr><tr><td>\n\nproductOrder.href\n\n</td><td>\n\nURL of the cancelled order.Data type: String\n\n</td></tr><tr><td>\n\nproductOrder.@referredType\n\n</td><td>\n\nValue for this parameter is `ProductOrder`.Data type: String\n\n</td></tr><tr><td>\n\nproductOrder.@referredType\n\n</td><td>\n\nValue for this parameter is `ProductOrderRef`.Data type: String\n\n</td></tr><tr><td>\n\nrequestedCancellationDate\n\n</td><td>\n\nDate to cancel the order.Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nState of the cancellation. If the cancellation request was successfully processed \\(201 status code\\), the value for this parameter is `done`.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nValue for this parameter is `CancelProductOrder`.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following code example cancels a customer order.\n\n```\ncurl -X POST \"https://instance.servicenow.com/api/sn_ind_tmt_orm/cancelproductorder\" \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d {\n    \"cancellationReason\": \"Duplicate order\",\n    \"requestedCancellationDate\": \"2019-04-30T12:56:21.931Z\",\n    \"productOrder\": {\n        \"id\": \"163ee2805358811032a4ddeeff7b122d\",\n        \"href\": \"https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b\",\n        \"@referredType\": \"ProductOrder\"\n    },\n    \"@type\": \"CancelProductorder\"\n}\n```\n\n```\n{\n    \"id\": \"163ee2805358811032a4ddeeff7b122d\",\n    \"href\": \"https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b\",\n    \"cancellationReason\": \"Duplicate order\",\n    \"requestedCancellationDate\": \"2019-04-30T12:56:21.931Z\",\n    \"@type\": \"CancelProductorder\",\n    \"productOrder\": {\n        \"id\": \"163ee2805358811032a4ddeeff7b122d\",\n        \"href\": \"https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b\",\n        \"@referredType\": \"ProductOrder\"\n    },\n    \"state\": \"done\"\n}\n```\n\n## Product Order Open API - POST /sn\\_ind\\_tmt\\_orm/order/productOrder\n\nCreates the specified customer order and customer order line items.\n\nOnce processed, records are created in the following tables:\n\n-   Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n-   Order Characteristic \\[sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\\]\n-   Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n-   Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\]\n-   Order Line Related Items \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_related\\_items\\]\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/order/productOrder`\n\n### Supported request parameters\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n<table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nmode\n\n</td><td>\n\nEnables asynchronous order processing.​ That is, the order is added to the Inbound Queue \\[sn\\_tmt\\_core\\_inbound\\_queue\\] table to be created. If not included, the order is processed synchronously.Valid value: async\n\nData type: String\n\n</td></tr></tbody>\n</table><table id=\"id_vk2_p5n_t4b\" class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nRequired. Unique identifier of the channel to use to sell the associated products. Channel ID values are located in the external\\_id field of the Distribution Channel \\[sn\\_prd\\_pm\\_distribution\\_channel\\] table. Data type: String\n\nStored in: The channel field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Possible channel names are defined on the Choice List tab in the Channel Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order table.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td id=\"due-date-entry\">\n\nDate and time when the action must be performed on the order.\n\nThis value must be the same as or later than the **committedDueDate** values for each order line item.\n\nData type: String\n\n Stored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\n</td></tr><tr><td>\n\ndisableCharValueValidation\n\n</td><td>\n\nFlag that indicates how to control characteristic value validation behavior for choice-type characteristics.Valid values:\n\n-   true: Validation is disabled and `characteristic_option_value` is set directly from the request payload without generating work notes.\n-   false: Validates characteristic values against allowed choices and adds a work note to the record for any invalid value.\n\nDefault: false\n\nTo disable validation, create a system property named `sn_ind_tmt_orm.disableCharValueValidation` and set the value to `true`. When disabled, the value is set directly from the request payload and no work notes are generated. The property isn't shipped by default.\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nUnique identifier for the customer order. This value is determined by an external system. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nexternalSystem\n\n</td><td>\n\nExternal system of the product order, appended with `TMF622`. For example, if the external system is ABC then enter the value in **externalSystem** as `ABC-TMF622`.\n\nData Type: String\n\n</td></tr><tr id=\"productOrder-href-request\"><td>\n\nhref\n\n</td><td>\n\nRelative link to the resource record.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nAdditional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nRequired. Additional notes/comments made by the customer while ordering. Data type: String\n\nStored in: The comments field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nRequired. Currency code for the order and order line items. The currency must be the same for all elements of the order and order line items, otherwise an error is returned and the order isn't created. Once an order is created, its currency code can't be changed. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nRequired. Items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem\": [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemRelationship\": [Array],\n    \"quantity\": Number,\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nRequired. Action to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Possible values:\n\n-   add\n-   change\n\n**Note:** Submitting a change payload that includes a new service location via **productOrderItem.product.place.id** is processed as a move order.\n\n-   delete\n-   no-change\n-   resume\n-   suspend\n\nData type: String\n\nStored in: The action field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td id=\"productOrder-addReason-request\">\n\nOptional. Description of the reason for the order line item.Data type: String\n\nStored in: The action\\_reason field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td id=\"due-date-item-entry\">\n\nOptional. Date and time when the action must be performed on the order line item.\n\nData type: String\n\n Stored in: The committed\\_due\\_date field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProductInventoryId-desc\">\n\nExternal ID to map to the product inventory.Data type: String\n\nStored in: The external\\_inventory\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table and the sn\\_prd\\_invt\\_external\\_id field of the sn\\_prd\\_invt\\_product\\_inventory table.\n\n</td></tr><tr id=\"externalProductInventory-GET-request\"><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProductInventory-GET-desc-request\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. External IDs to map to the product inventories created for the order.Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nRequired. Unique identifier of the line item. Data type: String\n\nStored in: The external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\nMaximum length: 40\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nPrice associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td>\n\nCurrency code in which the price is expressed. Data type: String\n\nStored in: The mrc or nrc field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\nStored in: The mrc or nrc field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nSpecifies whether the price of the item is recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Unique identifier of the product sold. Data type: String\n\nDefault: Blank string\n\nTable: In the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nRequired. Sys\\_id of the associated location record. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location.\n\nData type: String\n\nTable: Location \\[cmn\\_location\\]\n\nStored in: The location field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nCharacteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associated with the product.Data type: String\n\nTable: Characteristic \\[sn\\_prd\\_pm\\_characteristic\\]\n\nStored in: The characteristics field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The previous\\_characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"tmf-prod-order_prodChar.valueType\"><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Possible values:\n\n-   Array.Date\n-   Array.Datetime\n-   Array.Decimal\n-   Array.Integer\n-   Array.Object\n-   Array.Single Line Test\n-   Checkbox\n-   Choice\n-   Date,Address\n-   Email\n-   Integer,Date/time\n-   Object\n-   Single Line Text\n-   Yes/No\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nOptional. Description of the product specification associated with the product. **Note:** Change orders \\(**productOrderItem.action** is `change`\\) are processed differently based on the value of the **sn\\_ind\\_tmt\\_orm.allowSpecVersionUpdateInChangeOrder** system property. The value of this system property determines how the order is processed if the product inventory is a different version than indicated in the order.\n\n-   When this system property is set to true \\(default\\), the product inventory is automatically upgraded to the version in the order by changing the referenced product specification. This allows the order to be successfully processed.\n-   When this system property is set to false, if the product inventory is a different version than indicated in the order, the order fails due to the version mismatch.\n\nData type: Object\n\n```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nRequired. Initial version or external ID of the product specification. The initial version is the sys\\_id of the first version of the specification.Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nVersion of the product specification.Data type: String\n\nTable: In the version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nInternal version of the service specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification.Data type: String\n\nTable: In the external\\_version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the service specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nList of party roles linked to an OrderLineItemContact. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nRequired. Type of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\nStored in: The email field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\nStored in: The first\\_name field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nStored in: The lastName field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\nStored in: The business\\_phone field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nRequired. Description of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nRequired. Initial version or external ID of the product offering. The initial version is the sys\\_id of the first version of the offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: In the version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal version of the product offering.Data type: String\n\nTable: In the external\\_version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: null\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nRequired. List that describes the parent/child relationship between order items. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nRequired. Same as the **productOrderItem.id** value. Used for parent/child relationship Data type: String\n\nStored in: The parent\\_line\\_item field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of items ordered.Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nRequired. Type of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account or customer contact associated with the order.Data type: String\n\nTable: Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\]\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\nStored in: The expected\\_end\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOrder start date requested by the customer. Data type: String\n\nStored in: The expected\\_start\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. If there are any issues with the characteristics or characteristics option information, the endpoint stores the following comments in the work notes fields of the associated Customer Order Line Item record:\n\n-   `The following Order Item characteristics does not exist: Review specification <**characteristic.name**> and correct the characteristic and characteristic option in the order line item prior to approving the order.`\n-   `Order Item characteristic: <**characteristic.name**> with characteristic value: <**characteristic.value**>is invalid. Correct the characteristic values before approving the order.`\n\n</td></tr><tr><td>\n\n202\n\n</td><td>\n\nAccepted. Successful request for an order in asynchronous mode. That is, the request was made with the **mode** parameter set to `async` and the record is scheduled to be processed in the Inbound Queue \\[sn\\_tmt\\_core\\_inbound\\_queue\\] table.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Could be any of the following reasons:-   `Invalid payload: Request body missing` - Payload was not passed in the request body.\n-   `Invalid payload: productOrderItem is missing` - Product order line item object or JSON is missing.\n-   `Invalid payload: productOrderItem id is missing` - The **id** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem action is missing` - The **action** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem productOffering is missing` - The product offering object or JSON is missing from the product order line item in the payload.\n-   `Invalid payload: productOffering id is missing` - The **id** parameter is missing in the product order line item of the product offering object in the payload.\n-   `Invalid payload: Product offering does not exist` - The product offering in the product order line item is not valid.\n-   `Invalid payload: productOrderItem product is missing` - The product object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: product productSpecification is missing` - The product specification object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: productSpecification id is missing` - The **id** parameter in the product order line item of the product specification object is missing from the payload.\n-   `Invalid payload: Product specification does not exist` - The product specification in the product order line item is not valid.\n-   `Invalid payload: Product Inventory does not exist` - In a change order \\(action = change\\), the quantity of an item is greater than what is in stock.\n-   `Invalid payload: Product inventory ID is missing` - In change order, the **product.id** is missing in the payload.\n-   `Invalid payload: Sold Product is inactive` - In a change order, a product specified in the payload is inactive.\n-   `Invalid payload: relatedParty is missing` - The related party object is missing from the payload.\n-   `Invalid payload: Customer Account or Consumer is missing` - The related party customer or consumer object is missing from the payload.\n-   `Invalid payload: Consumer does not exist` - The specified related party consumer does not exist in the ServiceNow instance.\n-   `Invalid payload: Customer Account does not exist` - The specified related party customer does not exist in the ServiceNow instance.\n-   `Invalid payload: Order creation failed` - Not able to create the requested order.\n-   `Invalid payload: orderCurrency is required` - The **orderCurrency** parameter is missing from the payload.\n-   `Inactive Currency Code: <currency>` - The provided currency is inactive in the ServiceNow instance.\n-   `One or more line items has a different currency code than the order currency` - All line items do not have the same currency code as the order currency.\n-   `In-flight revision to order currency not supported` - The **orderCurrency** parameter can't be updated after the order is created.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td>\n\nDate and time when the action must be performed on the order.\n\nThis value must be the same as or later than the **committedDueDate** values for each order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal identifier for the customer order, such as a purchase order number.Data type: String\n\n</td></tr><tr><td>\n\nhref\n\n</td><td>\n\nRelative link to the product order record.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order created for this request. Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nCurrency code for the order and order line items.Data type: String\n\n</td></tr><tr><td>\n\norderId\n\n</td><td>\n\nSys\\_id of the order to be created. Upon succussful request, the order is added to the Inbound Queue \\[sn\\_tmt\\_core\\_inbound\\_queue\\] table on a schedule to be processed.**Note:** This value is the only result if the order is created asynchronously using the **mode** query parameter.\n\n```\n{\n \"orderId\": \"b0fc877ac3ab5110856d73ce3640dde0\"\n}\n```\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td>\n\nOptional. Date and time when the action must be performed on the order line item.\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProdInv-resp-descr\">\n\nConditional. List of external IDs mapped to the product inventories created for the order. If supplied, each entry requires **externalProductInventoryId**.Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProdInvId-resp-descr\">\n\nExternal ID mapped to the product inventory.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n ```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nUnique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. This parameter is only returned if **productOrderItem.action** is `change` or `delete`. If both sys\\_id and external\\_id are present, the external\\_id is returned. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productRelationship\n\n</td><td>\n\nList of product relationship details for an order line item.Data type: Array\n\n```\n\"productRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productRelationship.id\n\n</td><td>\n\nSys\\_id or sn\\_prd\\_invt\\_external\\_id of the product inventory.Data type: String\n\nTable: Sys\\_id or sn\\_prd\\_invt\\_external\\_id field of the Product Inventory \\[sn\\_prd\\_invt\\_product\\_inventory\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productRelationship.relationshipType\n\n</td><td>\n\nType of relationship between the order line item and the product inventory.Possible value: Requires\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n```\n\"productSpecification:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. If both sys\\_id and external\\_id are present, the external\\_id is returned.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalId\n\n</td><td>\n\nInitial version of the product specification. The initial version is the sys\\_id of the first version of the specification.Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nVersion of the product specification.Data type: String\n\nTable: In the version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification.Data type: String\n\nTable: In the external\\_version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n```\n\"relatedParty:\" [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n ```\n\"productOffering:\" {\n  \"id\": \"String\",\n  \"internalId\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. If both sys\\_id and external\\_id are present, the external\\_id is returned.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalId\n\n</td><td>\n\nInitial version of the product offering. The initial version is the sys\\_id of the first version of the offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table, field version.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal version of the product offering.Data type: String\n\nTable: In the external\\_version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n-   Requires\n\n`HasChild` and `HasParent` are used for parent/child relationships. `Requires` is used for horizontal relationships \\(a line item requires another line item\\).\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nCurrent state of the product order item. This value is always `new`.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.type\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order. For this endpoint, this value is always `new`.Data type: String\n\n</td></tr><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr></tbody>\n</table>### Processing asynchronously\n\nThis example shows how to use the **mode** query parameter to create an order asynchronously. The order is added to the Inbound Queue \\[sn\\_tmt\\_core\\_inbound\\_queue\\] table on a schedule to be created.\n\n```\ncurl -X POST 'https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder?mode=async' \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d '{\n  \"requestedCompletionDate\": \"2021-05-02T08:13:59.506Z\",\n  \"requestedStartDate\": \"2020-05-03T08:13:59.506Z\",\n  \"orderDate\": \"2020-05-03T08:13:59.506Z\",\n  \"externalId\": \"PO-4ddd56\",\n  \"orderCurrency\": \"USD\",\n  \"note\": [\n    {\n      \"id\": \"1\",\n      \"author\": \"Jean Pontus\",\n      \"date\": \"2019-04-30T08:13:59.509Z\",\n      \"text\": \"This is a TMF product order illustration\"\n    },\n    {\n      \"id\": \"2\",\n      \"author\": \"Jean Pontus1\",\n      \"date\": \"2019-04-30T08:13:59.509Z\",\n      \"text\": \"This is a TMF product order illustration no 2\"\n    }\n  ],\n  \"productOrderItem\": [\n    {\n      \"id\": \"100\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"product\": {\n        \"isBundle\": false,\n        \"@type\": \"Product\",\n        \"productSpecification\": {\n          \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n          \"name\": \"SD-WAN Service Package\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"relatedParty\": [\n          {\n            \"firstName\": \"John\",\n            \"lastName\": \"Smith\",\n            \"email\": \"abc2@example.com\",\n            \"phone\": \"32456768\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"productRelationship\": [\n          {\n            \"id\": \"be6d13f45b5620102dff5e92dc81c781\",\n            \"relationshipType\": \"Requires\"\n          }\n        ]\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"110\",\n          \"relationshipType\": \"HasChild\"\n        },\n        {\n          \"id\": \"120\",\n          \"relationshipType\": \"HasChild\"\n        },\n        {\n          \"id\": \"130\",\n          \"relationshipType\": \"HasChild\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"110\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"itemPrice\": [\n        {\n          \"description\": \"Access Fee\",\n          \"name\": \"Access Fee\",\n          \"priceType\": \"nonRecurring\",\n          \"price\": {\n            \"taxRate\": 0,\n            \"dutyFreeAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 100\n            },\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 220\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"isBundle\": false,\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"Tenancy\",\n            \"valueType\": \"string\",\n            \"value\": \"Premium (>50 sites)\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"216663aa53702010cd6dddeeff7b12b5\",\n          \"name\": \"SD-WAN Controller\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"place\": {\n          \"@type\": \"Place\",\n          \"id\": \"5671dd2ec3a53010188473ce3640dd81\"\n        },\n        \"relatedParty\": [\n          {\n            \"firstName\": \"John\",\n            \"lastName\": \"Smith\",\n            \"email\": \"abc2@example.com\",\n            \"phone\": \"32456768\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"productRelationship\": [\n          {\n            \"id\": \"be6d13f45b5620102dff5e92dc81c781\",\n            \"relationshipType\": \"Requires\"\n          }\n        ]\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"120\",\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"quantity\": 1,\n      \"itemPrice\": [\n        {\n          \"description\": \"Tariff plan monthly fee\",\n          \"name\": \"MonthlyFee\",\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxRate\": 0,\n            \"dutyFreeAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 300\n            },\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 349\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"isBundle\": false,\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"CPE Model\",\n            \"valueType\": \"string\",\n            \"value\": \"ASR\"\n          },\n          {\n            \"name\": \"WAN Optimization\",\n            \"valueType\": \"string\",\n            \"value\": \"Advance\"\n          },\n          {\n            \"name\": \"CPE Type\",\n            \"valueType\": \"string\",\n            \"value\": \"Physical\"\n          },\n          {\n            \"name\": \"Routing\",\n            \"valueType\": \"string\",\n            \"value\": \"Premium\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n          \"name\": \"SD-WAN Edge Device\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"place\": {\n          \"@type\": \"Place\",\n          \"id\": \"5671dd2ec3a53010188473ce3640dd81\"\n        },\n        \"relatedParty\": [\n          {\n            \"firstName\": \"John\",\n            \"lastName\": \"Smith\",\n            \"email\": \"abc2@example.com\",\n            \"phone\": \"32456768\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"productRelationship\": [\n          {\n            \"id\": \"be6d13f45b5620102dff5e92dc81c781\",\n            \"relationshipType\": \"Requires\"\n          }\n        ]\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"130\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"description\": \"Tariff plan monthly security\",\n          \"name\": \"MonthlySecurity\",\n          \"priceType\": \"nonRecurring\",\n          \"price\": {\n            \"taxRate\": 0,\n            \"dutyFreeAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 30\n            },\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 30\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"isBundle\": false,\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"Security Type\",\n            \"valueType\": \"string\",\n            \"value\": \"Premium\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n          \"name\": \"SD-WAN Security\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"place\": {\n          \"@type\": \"Place\",\n          \"id\": \"5671dd2ec3a53010188473ce3640dd81\"\n        },\n        \"relatedParty\": [\n          {\n            \"firstName\": \"John\",\n            \"lastName\": \"Smith\",\n            \"email\": \"abc2@example.com\",\n            \"phone\": \"32456768\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"productRelationship\": [\n          {\n            \"id\": \"be6d13f45b5620102dff5e92dc81c781\",\n            \"relationshipType\": \"Requires\"\n          }\n        ]\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    }\n  ],\n  \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n  \"@type\": \"ProductOrder\"\n}'\n```\n\nResponse body.\n\n```\n{\n  \"orderId\": \"304e877ac3ab5110856d73ce3640dde5\"\n}\n```\n\n### Processing synchronously \\(default\\)\n\nThe following example shows how to create a product order.\n\n```\ncurl -X POST \"https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder\" \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d {\n  \"requestedCompletionDate\": \"2021-05-02T08:13:59.506Z\",\n  \"requestedStartDate\": \"2020-05-03T08:13:59.506Z\",\n  \"externalId\": \"PO-456\",\n  \"currencyCode\": \"USD\",\n  \"channel\": [\n    {\n      \"id\": \"2\",\n      \"name\": \"Online channel\"\n    }\n  ],\n  \"note\": [\n    {\n      \"text\": \"This is a TMF product order illustration\"\n    },\n    {\n      \"text\": \"This is a TMF product order illustration no 2\"\n    }\n  ],\n  \"productOrderItem\": [\n    {\n      \"id\": \"POI100\",\n      \"quantity\": 1,\n      \"action\": \"change\",\n      \"product\": {\n        \"id\": \"fa6d13f45b5620102dff5e92dc81c77f\",\n        \"@type\": \"Product\",\n        \"productSpecification\": {\n          \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n          \"name\": \"SD-WAN Service Package\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI120\",\n          \"relationshipType\": \"HasChild\"\n        },\n        {\n          \"id\": \"POI130\",\n          \"relationshipType\": \"HasChild\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"POI120\",\n      \"quantity\": 1,\n      \"action\": \"change\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"id\": \"766d13f45b5620102dff5e92dc81c78a\",\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"WAN Optimization\",\n            \"value\": \"Base\",\n            \"previousValue\": \"Advance\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n          \"name\": \"SD-WAN Edge Device\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"productRelationship\": [\n           {\n              \"id\": \"326d13f45b5620102dff5e92dc81c785\",\n              \"relationshipType\": \"Requires\"\n           }\n        ],\n        \"relatedParty\": [\n          {\n            \"id\": \"51670151c35420105252716b7d40ddfe\",\n            \"firstName\": \"Joe\",\n            \"lastName\": \"Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        },\n        {\n          \"id\": \"POI130\",\n          \"relationshipType\": \"Requires\"\n        }  \n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"POI130\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"Security Type\",\n            \"value\": \"Base\",\n            \"previousValue\": \"Advance\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n          \"name\": \"SD-WAN Security\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"relatedParty\": [\n          {\n            \"id\": \"51670151c35420105252716b7d40ddfe\",\n            \"firstName\": \"Joe\",\n            \"lastName\": \"Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    }\n  ],\n  \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n  \"@type\": \"ProductOrder\"\n}\n```\n\nResponse body.\n\n```\n{\n  \"requestedCompletionDate\": \"2021-05-02T08:13:59.506Z\",\n  \"requestedStartDate\": \"2020-05-03T08:13:59.506Z\",\n  \"externalId\": \"PO-456\",\n  \"currencyCode\": \"USD\",\n  \"channel\": [\n    {\n      \"id\": \"2\",\n      \"name\": \"Online chanel\"\n    }\n  ],\n  \"note\": [\n    {\n      \"text\": \"This is a TMF product order illustration\"\n    },\n    {\n      \"text\": \"This is a TMF product order illustration no 2\"\n    }\n  ],\n  \"productOrderItem\": [\n    {\n      \"id\": \"POI100\",\n      \"quantity\": 1,\n      \"action\": \"change\",\n      \"actionReason\":\"adding service package OLI\",\n      \"product\": {\n        \"id\": \"fa6d13f45b5620102dff5e92dc81c77f\",\n        \"@type\": \"Product\",\n        \"productSpecification\": {\n          \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n          \"name\": \"SD-WAN Service Package\",\n          \"internalVersion\": \"1\",\n          \"version\": \"v1\",\n          \"internalId\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\",\n        \"internalVersion\": \"1\",\n        \"version\": \"v1\",\n        \"internalId\": \"69017a0f536520103b6bddeeff7b127d\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI120\",\n          \"relationshipType\": \"HasChild\"\n        },\n        {\n          \"id\": \"POI130\",\n          \"relationshipType\": \"HasChild\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\",\n      \"state\": \"new\"\n    },\n    {\n      \"id\": \"POI120\",\n      \"quantity\": 1,\n      \"action\": \"change\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"id\": \"766d13f45b5620102dff5e92dc81c78a\",\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"WAN Optimization\",\n            \"value\": \"Base\",\n            \"previousValue\": \"Advance\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n          \"name\": \"SD-WAN Edge Device\",\n          \"internalVersion\": \"1\",\n          \"version\": \"v1\",\n          \"internalId\": \"39b627aa53702010cd6dddeeff7b1202\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"productRelationship\": [\n          {\n            \"id\": \"326d13f45b5620102dff5e92dc81c785\",\n            \"relationshipType\": \"Requires\"\n          }\n        ],\n        \"relatedParty\": [\n          {\n            \"id\": \"51670151c35420105252716b7d40ddfe\",\n            \"firstName\": \"Joe\",\n            \"lastName\": \"Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\",\n        \"internalVersion\": \"1\",\n        \"version\": \"v1\",\n        \"internalId\": \"69017a0f536520103b6bddeeff7b127d\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        },\n        {\n          \"id\": \"POI130\",\n          \"relationshipType\": \"Requires\"\n        }  \n      ],\n      \"@type\": \"ProductOrderItem\",\n      \"state\": \"new\"\n    },\n    {\n      \"id\": \"POI130\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"actionReason\":\"adding service package OLI\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"Security Type\",\n            \"value\": \"Base\",\n            \"previousValue\": \"Advance\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n          \"name\": \"SD-WAN Security\",\n          \"internalVersion\": \"1\",\n          \"version\": \"v1\",\n          \"internalId\": \"a6514bd3534560102f18ddeeff7b1247\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"relatedParty\": [\n          {\n            \"id\": \"51670151c35420105252716b7d40ddfe\",\n            \"firstName\": \"Joe\",\n            \"lastName\": \"Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\",\n        \"internalVersion\": \"1\",\n        \"version\": \"v1\",\n        \"internalId\": \"69017a0f536520103b6bddeeff7b127d\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\",\n      \"state\": \"new\"\n    }\n  ],\n  \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n  \"@type\": \"ProductOrder\",\n  \"id\": \"8d75939453126010a795ddeeff7b126a\",\n  \"href\": \"/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a\",\n  \"state\": \"new\"\n}\n```\n\n## Product Order Open API - POST /sn\\_ind\\_tmt\\_orm/productorder\n\nCreates the specified customer order and customer order line items.\n\n**Important:** Starting with the Tokyo release, this endpoint is deprecated. The new version of this endpoint is [Product Order Open API - POST /sn\\_ind\\_tmt\\_orm/order/productOrder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/tmf622_product_ordering-api.md).\n\nOnce processed, new records are created in the following tables:\n\n-   Customer Order \\[sn\\_ind\\_tmt\\_orm\\_order\\]\n-   Order Characteristic \\[sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\\]\n-   Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n-   Order Line Item Contact \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\\]\n\n### URL format\n\nDefault URL: `/api/sn_ind_tmt_orm/productorder`\n\n### Supported request parameters\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n<table id=\"id_vk2_p5n_t4b\" class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nRequired. Unique identifier of the channel to use to sell the associated products. Channel ID values are located in the external\\_id field of the Distribution Channel \\[sn\\_prd\\_pm\\_distribution\\_channel\\] table. Data type: String\n\nStored in: The channel field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Possible channel names are defined on the Choice List tab in the Channel Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order table.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\ncommittedDueDate\n\n</td><td id=\"due-date-entry\">\n\nDate and time when the action must be performed on the order.\n\nThis value must be the same as or later than the **committedDueDate** values for each order line item.\n\nData type: String\n\n Stored in: The committed\\_due\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\n</td></tr><tr><td>\n\ndisableCharValueValidation\n\n</td><td>\n\nFlag that indicates how to control characteristic value validation behavior for choice-type characteristics.Valid values:\n\n-   true: Validation is disabled and `characteristic_option_value` is set directly from the request payload without generating work notes.\n-   false: Validates characteristic values against allowed choices and adds a work note to the record for any invalid value.\n\nDefault: false\n\nTo disable validation, create a system property named `sn_ind_tmt_orm.disableCharValueValidation` and set the value to `true`. When disabled, the value is set directly from the request payload and no work notes are generated. The property isn't shipped by default.\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nUnique identifier for the customer order. This value is determined by an external system. Data type: String\n\nStored in: The external\\_id field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nexternalSystem\n\n</td><td>\n\nExternal system of the product order, appended with `TMF622`. For example, if the external system is ABC then enter the value in **externalSystem** as `ABC-TMF622`.\n\nData Type: String\n\n</td></tr><tr id=\"productOrder-href-request\"><td>\n\nhref\n\n</td><td>\n\nRelative link to the resource record.Data type: String\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nAdditional notes made by the customer when ordering. Data type: Array of Objects\n\n```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nRequired. Additional notes/comments made by the customer while ordering. Data type: String\n\nStored in: The comments field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\norderCurrency\n\n</td><td>\n\nRequired. Currency code for the order and order line items. The currency must be the same for all elements of the order and order line items, otherwise an error is returned and the order isn't created. Once an order is created, its currency code can't be changed. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nRequired. Items associated with the product order and their associated action. Data type: Array of Objects\n\n```\n\"productOrderItem\": [\n  {\n    \"action\": \"String\",\n    \"actionReason\": \"String\",\n    \"committedDueDate\": \"String\",\n    \"externalProductInventory\": [Array],\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemRelationship\": [Array],\n    \"quantity\": Number,\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nRequired. Action to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Possible values:\n\n-   add\n-   change\n\n**Note:** Submitting a change payload that includes a new service location via **productOrderItem.product.place.id** is processed as a move order.\n\n-   delete\n-   no-change\n-   resume\n-   suspend\n\nData type: String\n\nStored in: The action field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.actionReason\n\n</td><td id=\"productOrder-addReason-request\">\n\nOptional. Description of the reason for the order line item.Data type: String\n\nStored in: The action\\_reason field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.committedDueDate\n\n</td><td id=\"due-date-item-entry\">\n\nOptional. Date and time when the action must be performed on the order line item.\n\nData type: String\n\n Stored in: The committed\\_due\\_date field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.externalProductInventory.externalProductInventoryId\n\n</td><td id=\"externalProductInventoryId-desc\">\n\nExternal ID to map to the product inventory.Data type: String\n\nStored in: The external\\_inventory\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table and the sn\\_prd\\_invt\\_external\\_id field of the sn\\_prd\\_invt\\_product\\_inventory table.\n\n</td></tr><tr id=\"externalProductInventory-GET-request\"><td>\n\nproductOrderItem.externalProductInventory\n\n</td><td id=\"externalProductInventory-GET-desc-request\">\n\nConditional. If supplied, each entry requires **externalProductInventoryId**. External IDs to map to the product inventories created for the order.Data type: Array of Objects\n\n```\n\"externalProductInventory\": [\n  {\n    \"externalProductInventoryId\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nRequired. Unique identifier of the line item. Data type: String\n\nStored in: The external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\nMaximum length: 40\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nPrice associated with the product. Data type: Array of Objects\n\n```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.unit\n\n</td><td>\n\nCurrency code in which the price is expressed. Data type: String\n\nStored in: The mrc or nrc field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludedAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\nStored in: The mrc or nrc field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nSpecifies whether the price of the item is recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Instance details of the product purchased by the customer. Data type: Object\n\n```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nRequired if **productOrderItem.action** is change or delete. Unique identifier of the product sold. Data type: String\n\nDefault: Blank string\n\nTable: In the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `Place`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nRequired. Sys\\_id of the associated location record. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location.\n\nData type: String\n\nTable: Location \\[cmn\\_location\\]\n\nStored in: The location field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nCharacteristics of the associated product. Data type: Array of Objects\n\n```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associated with the product.Data type: String\n\nTable: Characteristic \\[sn\\_prd\\_pm\\_characteristic\\]\n\nStored in: The characteristics field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The previous\\_characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\nStored in: The characteristic\\_option\\_value field of the sn\\_ind\\_tmt\\_orm\\_order\\_characteristic\\_value table.\n\nDefault: Blank string\n\n</td></tr><tr id=\"tmf-prod-order_prodChar.valueType\"><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Possible values:\n\n-   Array.Date\n-   Array.Datetime\n-   Array.Decimal\n-   Array.Integer\n-   Array.Object\n-   Array.Single Line Test\n-   Checkbox\n-   Choice\n-   Date,Address\n-   Email\n-   Integer,Date/time\n-   Object\n-   Single Line Text\n-   Yes/No\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nOptional. Description of the product specification associated with the product. **Note:** Change orders \\(**productOrderItem.action** is `change`\\) are processed differently based on the value of the **sn\\_ind\\_tmt\\_orm.allowSpecVersionUpdateInChangeOrder** system property. The value of this system property determines how the order is processed if the product inventory is a different version than indicated in the order.\n\n-   When this system property is set to true \\(default\\), the product inventory is automatically upgraded to the version in the order by changing the referenced product specification. This allows the order to be successfully processed.\n-   When this system property is set to false, if the product inventory is a different version than indicated in the order, the order fails due to the version mismatch.\n\nData type: Object\n\n```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nRequired. Initial version or external ID of the product specification. The initial version is the sys\\_id of the first version of the specification.Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nVersion of the product specification.Data type: String\n\nTable: In the version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nInternal version of the service specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Data type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification.Data type: String\n\nTable: In the external\\_version field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the service specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nList of party roles linked to an OrderLineItemContact. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nRequired. Type of customer. Possible value: OrderLineItemContact\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\nStored in: The email field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\nStored in: The first\\_name field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\nStored in: The lastName field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\nStored in: The business\\_phone field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\_contact table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nRequired. Description of the product offering associated with the product. Data type: Object\n\n```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nRequired. Initial version or external ID of the product offering. The initial version is the sys\\_id of the first version of the offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.internalVersion\n\n</td><td>\n\nVersion of the product offering.Data type: String\n\nTable: In the version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering.Data type: String\n\nTable: Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.version\n\n</td><td>\n\nExternal version of the product offering.Data type: String\n\nTable: In the external\\_version field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table.\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: null\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nRequired. List that describes the parent/child relationship between order items. Data type: Array of Objects\n\n```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\nStored in: sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nRequired. Same as the **productOrderItem.id** value. Used for parent/child relationship Data type: String\n\nStored in: The parent\\_line\\_item field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify relationship hierarchy. Possible values:\n\n-   HasChild\n-   HasParent\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of items ordered.Data type: Number\n\nStored in: The quantity field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.@referredType\n\n</td><td>\n\nRequired. Type of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\nData type: String\n\n</td></tr><tr><td>\n\nrelatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account or customer contact associated with the order.Data type: String\n\nTable: Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\]\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\nStored in: The expected\\_end\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOrder start date requested by the customer. Data type: String\n\nStored in: The expected\\_start\\_date field of the sn\\_ind\\_tmt\\_orm\\_order table.\n\nDefault: Blank string\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Header|Description|\n|------|-----------|\n|Accept|Data format of the response body. Only supports **application/json**.|\n|Content-Type|Data format of the request body. Only supports **application/json**.|\n\n|Header|Description|\n|------|-----------|\n|Content-Type|Data format of the response body. Only supports **application/json**.|\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. If there are any issues with the characteristics or characteristics option information, the endpoint stores the following comments in the work notes fields of the associated Customer Order Line Item record:\n\n-   `The following Order Item characteristics does not exist: Review specification <**characteristic.name**> and correct the characteristic and characteristic option in the order line item prior to approving the order.`\n-   `Order Item characteristic: <**characteristic.name**> with characteristic value: <**characteristic.value**>is invalid. Correct the characteristic values before approving the order.`\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. Could be any of the following reasons:-   `Invalid payload: Request body missing` - Payload was not passed in the request body.\n-   `Invalid payload: productOrderItem is missing` - Product order line item object or JSON is missing.\n-   `Invalid payload: productOrderItem id is missing` - The **id** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem action is missing` - The **action** parameter is missing in the product order line item of the payload.\n-   `Invalid payload: productOrderItem productOffering is missing` - The product offering object or JSON is missing from the product order line item in the payload.\n-   `Invalid payload: productOffering id is missing` - The **id** parameter is missing in the product order line item of the product offering object in the payload.\n-   `Invalid payload: Product offering does not exist` - The product offering in the product order line item is not valid.\n-   `Invalid payload: productOrderItem product is missing` - The product object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: product productSpecification is missing` - The product specification object or JSON in the product order line item is missing from the payload.\n-   `Invalid payload: productSpecification id is missing` - The **id** parameter in the product order line item of the product specification object is missing from the payload.\n-   `Invalid payload: Product specification does not exist` - The product specification in the product order line item is not valid.\n-   `Invalid payload: Product Inventory does not exist` - In a change order \\(action = change\\), the quantity of an item is greater than what is in stock.\n-   `Invalid payload: Product inventory ID is missing` - In change order, the **product.id** is missing in the payload.\n-   `Invalid payload: Sold Product is inactive` - In a change order, a product specified in the payload is inactive.\n-   `Invalid payload: relatedParty is missing` - The related party object is missing from the payload.\n-   `Invalid payload: Customer Account or Consumer is missing` - The related party customer or consumer object is missing from the payload.\n-   `Invalid payload: Consumer does not exist` - The specified related party consumer does not exist in the ServiceNow instance.\n-   `Invalid payload: Customer Account does not exist` - The specified related party customer does not exist in the ServiceNow instance.\n-   `Invalid payload: Order creation failed` - Not able to create the requested order.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrder`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nchannel\n\n</td><td>\n\nList of channels to use for selling the products. Data type: Array of Objects\n\n ```\n\"channel\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nchannel.id\n\n</td><td>\n\nUnique identifier of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nchannel.name\n\n</td><td>\n\nName of the channel to use to sell the associated products. Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td>\n\nExternal identifier for the customer order, such as a purchase order number.Data type: String\n\n</td></tr><tr><td>\n\nexternalSystem\n\n</td><td>\n\nExternal system of the product order, appended with `TMF622`. For example, if the external system is ABC then enter the value in **externalSystem** as `ABC-TMF622`.\n\nData Type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nSys\\_id of the customer order created for this request. Data type: String\n\n</td></tr><tr><td>\n\nnote\n\n</td><td>\n\nOptional. List of additional notes made by the customer when ordering. Data type: Array of Objects\n\n ```\n\"note\": [\n  {\n    \"text\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nnote.text\n\n</td><td>\n\nAdditional notes/comments made by the customer while ordering. Data type: String\n\n</td></tr><tr><td>\n\nproductOderItem.actionReason\n\n</td><td>\n\nReason for adding the order line item.Data type: String\n\nStored in: The action\\_reason field of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table.\n\n</td></tr><tr><td>\n\nproductOrderItem\n\n</td><td>\n\nList that describes items associated with the product order and their associated action. Data type: Array of Objects\n\n ```\n\"productOrderItem:\" [\n  {\n    \"action\": \"String\",\n    \"id\": \"String\",\n    \"itemPrice\": [Array],\n    \"product\": {Object},\n    \"productOffering\": {Object},\n    \"productOrderItemReleationship\": [Array],\n    \"quantity\": Number,\n    \"state\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `ProductOrderItem`. This information is not stored.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.action\n\n</td><td>\n\nAction to carry out on the product. Possible actions are defined on the Choice List tab in the Action Dictionary Entry of the sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.id\n\n</td><td>\n\nUnique identifier of the line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice\n\n</td><td>\n\nList that describes the price associated with the product. Data type: Array of Objects\n\n ```\n\"itemPrice\": [\n  {\n    \"price\": {Object},\n    \"priceType\": \"String\",\n    \"recurringChargePeriod\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price\n\n</td><td>\n\nDescription of the price of the associated product. Data type: Object\n\n ```\n\"price\": {\n  \"taxIncludedAmount\": {Object}\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount\n\n</td><td>\n\nDescription of the price of the associated product, including the tax. Data type: Object\n\n ```\n\"taxIncludedAmount\": {\n  \"unit\": \"String\",\n  \"value\": Number\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.unit\n\n</td><td>\n\nCurrency code in which the price is depicted. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.price.taxIncludeAmount.value\n\n</td><td>\n\nPrice of product, including any tax. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.priceType\n\n</td><td>\n\nType of item price, recurring or non-recurring. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.itemPrice.recurringChargePeriod\n\n</td><td>\n\nIf the price is recurring, the recurring period, such as `month`. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product\n\n</td><td>\n\nDescription of the instance details of the product purchased by the customer. Data type: Object\n\n ```\n\"product\": {\n  \"id\": \"String\",\n  \"place\": {Object},\n  \"productCharacteristic\": [Array],\n  \"productSpecification\": {Object},\n  \"relatedParty\": {Object},\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for the product. This value is always `Product`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.id\n\n</td><td>\n\nUnique identifier of the product sold. Located in the sys\\_id or sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Product Inventory \\[sn\\_ind\\_tmt\\_orm\\_product\\_inventory\\] table. This parameter is only returned if **productOrderItem.action** is `change` or `delete`. If both sys\\_id and external\\_id are present, the external\\_id is returned. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place\n\n</td><td>\n\nMaps of the locations on which to install the product. Data type: Object\n\n ```\n\"place\": {\n  \"id\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.place.id\n\n</td><td>\n\nSys\\_id of the associated location record in the Location \\[cmn\\_location\\] table. When employing the change action on a product order item \\(via the**productOrderItem.action** parameter\\), updating the request with a new place sys\\_id creates a move order, where the order is not changed but is fulfilled in a new location. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic\n\n</td><td>\n\nList of characteristics of the associated product. Data type: Array of Objects\n\n ```\n\"productCharacteristic\": [ \n {\n  \"name\": \"String\",\n  \"previousValue\": \"String\",\n  \"value\": \"String\",\n  \"valueType\": \"String\"\n }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.name\n\n</td><td>\n\nName of the characteristic record to associate with the product. Located in the Characteristic \\[sn\\_prd\\_pm\\_characteristic\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.previousValue\n\n</td><td>\n\nPrevious characteristic option values if the update is for a change order. The request is a change order if the **productOrderItem.action** parameter is other than `add`. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.value\n\n</td><td>\n\nCharacteristic option values associated with the product. For additional information on characteristic option values, see [Create product characteristics and characteristic options](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/order-management/som-product-config-add-characteristics.md). Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productCharacteristic.valueType\n\n</td><td>\n\nType of characteristic value.Possible values:\n\n-   Array.Date\n-   Array.Datetime\n-   Array.Decimal\n-   Array.Integer\n-   Array.Object\n-   Array.Single Line Test\n-   Checkbox\n-   Choice\n-   Date,Address\n-   Email\n-   Integer,Date/time\n-   Object\n-   Single Line Text\n-   Yes/No\n\nData type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification\n\n</td><td>\n\nDescription of the product specification associated with the product. Data type: Object\n\n ```\n\"productSpecification\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\",\n  \"@type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.@type\n\n</td><td>\n\nPart of the TMF Open API standard. This value is always `ProductSpecificationRef`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product specification. The initial\\_version is the sys\\_id of the first version of the specification. Located in the sys\\_id or external\\_id field of the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. If both sys\\_id and external\\_id are present, the external\\_id is returned.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.internalVersion\n\n</td><td>\n\nInternal version of the product specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.name\n\n</td><td>\n\nName of the product specification. Located in the Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.productSpecification.version\n\n</td><td>\n\nExternal version of the product specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\nTable: Product Specification \\[sn\\_prd\\_pm\\_product\\_specification\\]\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty\n\n</td><td>\n\nOptional. List of contacts for line items. Data type: Array of Objects\n\n ```\n\"relatedParty:\" [\n  {\n    \"email\": \"String\",\n    \"firstName\": \"String\",\n    \"lastName\": \"String\",\n    \"phone\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@referredType\n\n</td><td>\n\nType of customer. Possible value: OrderLineItemContact\n\n Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.@type\n\n</td><td>\n\nPart of TMF Open API standard. Annotation for order line item contact. This value is always `RelatedParty`. This information is not stored. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.email\n\n</td><td>\n\nEmail address of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.firstName\n\n</td><td>\n\nFirst name of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.lastName\n\n</td><td>\n\nLast name of the contact. Data type: String\n\n Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.product.relatedParty.phone\n\n</td><td>\n\nBusiness phone number of the contact. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering\n\n</td><td>\n\nDescription of the product offering associated with the product. Data type: Object\n\n ```\n\"productOffering\": {\n  \"id\": \"String\",\n  \"internalVersion\": \"String\",\n  \"name\": \"String\",\n  \"version\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.id\n\n</td><td>\n\nInitial\\_version or external\\_id of the product offering. The initial\\_version is the sys\\_id of the first version of the offering. Located in the sys\\_id or external\\_id field of the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. If both sys\\_id and external\\_id are present, the external\\_id is returned.Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOffering.name\n\n</td><td>\n\nName of the product offering. Located in the Product Offering \\[sn\\_prd\\_pm\\_product\\_offering\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship\n\n</td><td>\n\nConditional. Item-level relationships. If supplied, each entry requires an **id** and **relationshipType**. Data type: Array of Objects\n\n ```\n\"productOrderItemRelationship\": [\n  {\n    \"id\": \"String\",\n    \"relationshipType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.id\n\n</td><td>\n\nUnique identifier of the related line item. Located in the sn\\_ind\\_tmt\\_orm\\_external\\_id field of the Order Line Item \\[sn\\_ind\\_tmt\\_orm\\_order\\_line\\_item\\] table. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.productOrderItemRelationship.relationshipType\n\n</td><td>\n\nRequired. Type of relationship between the two line items. This information is used to identify the relationship hierarchy. Data type: String\n\n</td></tr><tr><td>\n\nproductOrderItem.quantity\n\n</td><td>\n\nNumber of the associated items to order. Data type: Number\n\n</td></tr><tr><td>\n\nproductOrderItem.state\n\n</td><td>\n\nCurrent state of the product order item. This value is always `new`.Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty\n\n</td><td>\n\nList of contacts for the order. Each contact is an object in the array. Must list at least one item which contains customer account or consumer account information. Data type: Array of Objects\n\n ```\n\"relatedParty\": [\n  {\n    \"id\": \"String\",\n    \"name\": \"String\",\n    \"@referredType\": \"String\",\n    \"@type\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nrelatedParty.id\n\n</td><td>\n\nSys\\_id or external\\_id of the account, customer contact, or consumer associated with the order. Located in the Account \\[customer\\_account\\], Contact \\[customer\\_contact\\] table, or Consumer \\[csm\\_consumer\\] table. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.name\n\n</td><td>\n\nName of the account, customer, or consumer. Data type: String\n\n</td></tr><tr><td>\n\nrelatedParty.type\n\n</td><td>\n\nType of customer. Possible values:\n\n-   Consumer\n-   Customer\n-   CustomerContact\n\n Data type: String\n\n</td></tr><tr><td>\n\nrequestedCompletionDate\n\n</td><td>\n\nOptional. Delivery date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nrequestedStartDate\n\n</td><td>\n\nOptional. Order start date requested by the customer. Data type: String\n\n</td></tr><tr><td>\n\nserviceOrderItem.service.serviceSpecification.internalVersion\n\n</td><td>\n\nInternal version of the service specification. Must match the value of **version** otherwise an error is thrown.Data Type: String\n\n</td></tr><tr><td>\n\nserviceOrderItem.service.serviceSpecification.version\n\n</td><td>\n\nExternal version of the service specification. Must match the value of **internalVersion** otherwise an error is thrown.Data Type: String\n\n</td></tr><tr><td>\n\nstate\n\n</td><td>\n\nCurrent state of the order. For this endpoint, this value is always `new`.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following code example creates a customer order.\n\n```\ncurl -X POST \"https://servicenow-instance/api/sn_ind_tmt_orm/productorder\" \\\n-H \"Accept: application/json\" \\\n-H \"Content-Type: application/json\" \\\n-u \"username\":\"password\" \\\n-d {\n  \"requestedCompletionDate\": \"2021-05-02T08:13:59.506Z\",\n  \"requestedStartDate\": \"2020-05-03T08:13:59.506Z\",\n  \"externalId\": \"PO-456\",\n  \"externalSystem\": \"Salesforce – TMF 622\",\n  \"channel\": [\n    {\n      \"id\": \"2\",\n      \"name\": \"Online channel\"\n    }\n  ],\n  \"note\": [\n    {\n      \"text\": \"This is a TMF product order illustration\"\n    },\n    {\n      \"text\": \"This is a TMF product order illustration no 2\"\n    }\n  ],\n  \"productOrderItem\": [\n    {\n      \"id\": \"POI100\",\n      \"quantity\": 1,\n      \"action\": \"change\",\n      \"product\": {\n        \"id\": \"fa6d13f45b5620102dff5e92dc81c77f\",\n        \"@type\": \"Product\",\n        \"productSpecification\": {\n          \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n          \"name\": \"SD-WAN Service Package\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI120\",\n          \"relationshipType\": \"HasChild\"\n        },\n        {\n          \"id\": \"POI130\",\n          \"relationshipType\": \"HasChild\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"POI120\",\n      \"quantity\": 1,\n      \"action\": \"change\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"id\": \"766d13f45b5620102dff5e92dc81c78a\",\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"WAN Optimization\",\n            \"valueType\": \"Object\",\n            \"value\": \"Base\",\n            \"previousValue\": \"Advance\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n          \"name\": \"SD-WAN Edge Device\",\n          \"@type\": \"ProductSpecificationRef\",\n          \"externalVersion\": \"1\",\n          \"@version\": \"v1\"\n        },\n        \"relatedParty\": [\n          {\n            \"id\": \"51670151c35420105252716b7d40ddfe\",\n            \"firstName\": \"Joe\",\n            \"lastName\": \"Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    },\n    {\n      \"id\": \"POI130\",\n      \"quantity\": 1,\n      \"action\": \"add\",\n      \"itemPrice\": [\n        {\n          \"priceType\": \"recurring\",\n          \"recurringChargePeriod\": \"month\",\n          \"price\": {\n            \"taxIncludedAmount\": {\n              \"unit\": \"USD\",\n              \"value\": 20\n            }\n          }\n        }\n      ],\n      \"product\": {\n        \"@type\": \"Product\",\n        \"productCharacteristic\": [\n          {\n            \"name\": \"Security Type\",\n            \"valueType\": \"Object\",\n            \"value\": \"Base\",\n            \"previousValue\": \"Advance\"\n          }\n        ],\n        \"productSpecification\": {\n          \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n          \"name\": \"SD-WAN Security\",\n          \"@type\": \"ProductSpecificationRef\"\n        },\n        \"relatedParty\": [\n          {\n            \"id\": \"51670151c35420105252716b7d40ddfe\",\n            \"firstName\": \"Joe\",\n            \"lastName\": \"Doe\",\n            \"email\": \"abc@example.com\",\n            \"phone\": \"1234567890\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"OrderLineItemContact\"\n          }\n        ],\n        \"place\": {\n          \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n          \"@type\": \"Place\"\n        }\n      },\n      \"productOffering\": {\n        \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n        \"name\": \"Premium SD-WAN Offering\"\n      },\n      \"productOrderItemRelationship\": [\n        {\n          \"id\": \"POI100\",\n          \"relationshipType\": \"HasParent\"\n        }\n      ],\n      \"@type\": \"ProductOrderItem\"\n    }\n  ],\n  \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n  \"@type\": \"ProductOrder\"\n}\n```\n\nResponse body.\n\n```\n{\n    \"requestedCompletionDate\": \"2021-05-02T08:13:59.506Z\",\n    \"requestedStartDate\": \"2020-05-03T08:13:59.506Z\",\n    \"externalId\": \"PO-456\",\n    \"externalSystem\": \"Salesforce – TMF 622\",\n    \"channel\": [\n        {\n            \"id\": \"2\",\n            \"name\": \"Online chanel\"\n        }\n    ],\n    \"note\": [\n        {\n            \"text\": \"This is a TMF product order illustration\"\n        },\n        {\n            \"text\": \"This is a TMF product order illustration no 2\"\n        }\n    ],\n    \"productOrderItem\": [\n        {\n            \"id\": \"POI100\",\n            \"quantity\": 1,\n            \"action\": \"change\",\n            \"product\": {\n                \"id\": \"fa6d13f45b5620102dff5e92dc81c77f\",\n                \"@type\": \"Product\",\n                \"productSpecification\": {\n                    \"id\": \"cfe5ef6a53702010cd6dddeeff7b12f6\",\n                    \"name\": \"SD-WAN Service Package\",\n                    \"@type\": \"ProductSpecificationRef\"\n                },\n                \"place\": {\n                    \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                    \"@type\": \"Place\"\n                }\n            },\n            \"productOffering\": {\n                \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n                \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n                {\n                    \"id\": \"POI120\",\n                    \"relationshipType\": \"HasChild\"\n                },\n                {\n                    \"id\": \"POI130\",\n                    \"relationshipType\": \"HasChild\"\n                }\n            ],\n            \"@type\": \"ProductOrderItem\",\n            \"state\": \"new\"\n        },\n        {\n            \"id\": \"POI120\",\n            \"quantity\": 1,\n            \"action\": \"change\",\n            \"itemPrice\": [\n                {\n                    \"priceType\": \"recurring\",\n                    \"recurringChargePeriod\": \"month\",\n                    \"price\": {\n                        \"taxIncludedAmount\": {\n                            \"unit\": \"USD\",\n                            \"value\": 20\n                        }\n                    }\n                }\n            ],\n            \"product\": {\n                \"id\": \"766d13f45b5620102dff5e92dc81c78a\",\n                \"@type\": \"Product\",\n                \"productCharacteristic\": [\n                    {\n                        \"name\": \"WAN Optimization\",\n                        \"valueType\": \"Object\",\n                        \"value\": \"Base\",\n                        \"previousValue\": \"Advance\"\n                    }\n                ],\n                \"productSpecification\": {\n                    \"id\": \"39b627aa53702010cd6dddeeff7b1202\",\n                    \"name\": \"SD-WAN Edge Device\",\n                    \"@type\": \"ProductSpecificationRef\",\n                    \"externalVersion\": \"1\",\n                    \"@version\": \"v1\"\n                \"relatedParty\": [\n                    {\n                        \"id\": \"51670151c35420105252716b7d40ddfe\",\n                        \"firstName\": \"Joe\",\n                        \"lastName\": \"Doe\",\n                        \"email\": \"abc@example.com\",\n                        \"phone\": \"1234567890\",\n                        \"@type\": \"RelatedParty\",\n                        \"@referredType\": \"OrderLineItemContact\"\n                    }\n                ],\n                \"place\": {\n                    \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                    \"@type\": \"Place\"\n                }\n            },\n            \"productOffering\": {\n                \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n                \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n                {\n                    \"id\": \"POI100\",\n                    \"relationshipType\": \"HasParent\"\n                }\n            ],\n            \"@type\": \"ProductOrderItem\",\n            \"state\": \"new\"\n        },\n        {\n            \"id\": \"POI130\",\n            \"quantity\": 1,\n            \"action\": \"add\",\n            \"itemPrice\": [\n                {\n                    \"priceType\": \"recurring\",\n                    \"recurringChargePeriod\": \"month\",\n                    \"price\": {\n                        \"taxIncludedAmount\": {\n                            \"unit\": \"USD\",\n                            \"value\": 20\n                        }\n                    }\n                }\n            ],\n            \"product\": {\n                \"@type\": \"Product\",\n                \"productCharacteristic\": [\n                    {\n                        \"name\": \"Security Type\",\n                        \"valueType\": \"Object\",\n                        \"value\": \"Base\",\n                        \"previousValue\": \"Advance\"\n                    }\n                ],\n                \"productSpecification\": {\n                    \"id\": \"a6514bd3534560102f18ddeeff7b1247\",\n                    \"name\": \"SD-WAN Security\",\n                    \"@type\": \"ProductSpecificationRef\"\n                },\n                \"relatedParty\": [\n                    {\n                        \"id\": \"51670151c35420105252716b7d40ddfe\",\n                        \"firstName\": \"Joe\",\n                        \"lastName\": \"Doe\",\n                        \"email\": \"abc@example.com\",\n                        \"phone\": \"1234567890\",\n                        \"@type\": \"RelatedParty\",\n                        \"@referredType\": \"OrderLineItemContact\"\n                    }\n                ],\n                \"place\": {\n                    \"id\": \"25ab9c4d0a0a0bb300f7dabdc0ca7c1c\",\n                    \"@type\": \"Place\"\n                }\n            },\n            \"productOffering\": {\n                \"id\": \"69017a0f536520103b6bddeeff7b127d\",\n                \"name\": \"Premium SD-WAN Offering\"\n            },\n            \"productOrderItemRelationship\": [\n                {\n                    \"id\": \"POI100\",\n                    \"relationshipType\": \"HasParent\"\n                }\n            ],\n            \"@type\": \"ProductOrderItem\",\n            \"state\": \"new\"\n        }\n    ],\n    \"relatedParty\": [\n        {\n            \"id\": \"eaf68911c35420105252716b7d40ddde\",\n            \"name\": \"Sally Thomas\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"CustomerContact\"\n        },\n        {\n            \"id\": \"ffc68911c35420105252716b7d40dd55\",\n            \"name\": \"Funco Intl\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Customer\"\n        },\n        {\n            \"id\": \"59f16de1c3b67110ff00ed23a140dd9e\",\n            \"name\": \"Funco External\",\n            \"@type\": \"RelatedParty\",\n            \"@referredType\": \"Consumer\"\n        }\n    ],\n    \"@type\": \"ProductOrder\",\n    \"id\": \"6be0a925c3a220103e2e73ce3640ddfe\",\n    \"state\": \"new\"\n}\n```\n\n"}}