Add Items to existing purchase order


The endpoint presented in this article is for adding new items to an existing purchase order.

In order to consume the endpoint you must:

  • Be authenticated user

For information on how you can authenticate, see: Authentication

As soon as you do authentication and receive a valid token, it needs to be passed on the call when adding new items.


Example for such endpoint for TT server is{id}/items

For your server, endpoint will be:



  • Method Type: HttpPost
  • Authorization: Use Bearer Token + token received from token authentication
  • Header info: Content-Type: application/json
  • Parameters: ID of the Purcahse Order, Array of products to be added.
Data TypeDescription

“ProductID”: “string”,
“QtyUnitsOrdered”: integer,
“UnitPrice”: integer,
“QtyCasesOrdered”: integer,
“QtyUnitsPerCase”: integer,
“CasePrice”: integer,
“DiscountType”: integer,
“DiscountValue”: integer,
“WarehouseID”: integer


Information about the Product.

ProductID and Qty are mandatory fields.

Depending on whether the PO has “CaseQtyMode” enabled the mandatory Qty fields are

-Enabled: CasePrice, QtyUnitsPerCase, QtyCasesOrdered
-Disabled: QtyUnitsOrdered, UnitPrice

DiscountType, DiscountValue, WarehouseID are optional fields.


Adding an item that has the same SKU as an existing purchase order item will create a new, separate item on the PO.

To update an already-existing order item, use this endpoint instead.


  • If a server error occurs, then the response will be status code 400 => Bad Request
  • If the request is successful, the response will have status code 200 OK, and: “Successfully saved the purchase items.”

Was this article helpful?

Get RMA Shipping Labels Data