Create Line Items

You can add a line item (SKU) with quantity to an existing order. If that item is already on the order, the requested quantity will be added to the existing quantity.

Any items added will inherit the traits of the order, including the collection traits. For example, if the order contains a collection with delivery dates March thru April, the newly added SKU will inherit those delivery dates.

Note: You can only add Order Line Items to the Order if the Order is in the In Progres, Notes, or Pending status. If you want to add an item to the Order in other statuses, you must change its status to one of the above statuses first.

Workflow

  1. To get the order id, you can use the GET orders endpoint.
  2. To get the line item id, you can use the GET skus endpoint. a. You can filter this request by a JOOR product id.

Discounts:

You can apply discounts at the SKU line item level. To do that, you can use one of the following 3 fields: "item_price", "discount_amount" or "discount_percentage".

  • item_price: The final price of an SKU after discounts have been applied (discounted price).
  • discount_amount: A discount value that will be subtracted from "wholesale_price". The new "item_price" will be calculated using the formula: "item_price = wholesale_price - discount_amount".
  • discount_percentage: A discount percentage to be applied to "wholesale_price". The new "item_price" will be calculated using the formula: "item_price = wholesale_price - wholesale_price * discount_percentage / 100". The "discount_percentage" value must be between 0 and 100.

For each of those 3 fields, only one of these three fields can be used per SKU. If more than one per SKU is specified, the request will be rejected with the following error: "Multiple discounts for the same SKU are not allowed. Please include only one of the following fields: item_price, discount_percentage, discount_amount."

📘

Line Item Object References

Click on "Add Object" below to view the reference documentation for creating a line item.

Language
Click Try It! to start a request and see the response here!