Skip to main content
POST
/
api
/
openapi
/
order
Create Orders
curl --request POST \
  --url https://api.platform.poderp.com/api/openapi/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "uniqueRequestId": "<string>",
  "orderItems": [
    {
      "orderNo": "<string>",
      "recipient": {
        "receiverName": "<string>",
        "country": "<string>",
        "state": "<string>",
        "city": "<string>",
        "postcode": "<string>",
        "address1": "<string>",
        "phone": "<string>",
        "remark": "<string>",
        "email": "jsmith@example.com"
      },
      "product": {
        "quantity": 123,
        "sku": "<string>",
        "spu": "<string>",
        "size": "<string>",
        "color": "<string>",
        "attributes": {}
      },
      "imageUrls": []
    }
  ]
}
'
This response has no body data.
Import orders into the system. You can specify products in two ways:
  • By SKU code (recommended): Pass the sku field with a code from List Products. The system resolves size, color, and SPU automatically.
  • By SPU + size + color: Pass spu, size, and color individually (legacy method, still supported).

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Order details

uniqueRequestId
string
required

Unique identifier for this order batch, used for deduplication and later querying waybills

orderItems
object[]
required

Response