Add Items to existing order

Updated 2 weeks ago ​by nussi

Overview

The endpoint presented in this article is for adding new items to an existing 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.

Endpoint

Example for such endpoint for TT server is

https://tt.api.sellercloud.com/rest/api/Orders/{orderID}/items

For your server, endpoint will be:

https://{your_server_id}.api.sellercloud.com/rest/api/Orders/{orderID}/items

Request

  • Method Type: HttpPost
  • Authorization: Use Bearer Token + token received from token authentication
  • Header info: Content-Type: application/json
  • Parameters: orderID of the order

Data Type

Description

[

{

"ProductID": "string",

"ProductName": "string",

"SitePrice": 0,

"DiscountValue": 0,

"DiscountType": "FixedAmount",

"Qty": 0,

"LineTaxTotal": 0,

"FinalValueFee": 0,

"ReferenceID": "string"

}

]

Information about the Product.

ProductID and Qty are mandatory fields.

Reference ID is an optional field for storing an alternative identifier for the item. (like the Channel's order item identifier)

Important:

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

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

Response

  • 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 order items."


How did we do?