POST /2025-07/cloud/inbound

Method: POST

URL:

Sandbox URL:

Description: Create inbound order.

Parameters required to be sent

Parameter	Description	Type
carrier	Carrier. The maximum length is 32.	String
tracking_no	Tracking No.	String
expected_inbound_date	Expected inbound date, format (yyyy-MM-dd).	String
items		Object, Required
quantity	Quantity for the product.	Number, Required
sku_number	SKU No. for the product.	String, Required
package_number	Package number. 0 means "I'm not sure yet".	Number, Required
reference	Reference of the inbound order. The maximum length is 47.	String
remarks	Remarks.	String
shipper	Shipper address.	Object
first_name	First name. The maximum length is 64.	String
last_name	Last name. The maximum length is 64.	String, Required
email	Email. The maximum length is 128.	String, must have @
phone	Phone number. The maximum length is 32.	String, Required
address1	Address. The maximum length is 256.	String, Required
address2	Address 2. The maximum length is 256.	String
zip_code	Zip code. The maximum length is 15.	String
district	District. The maximum length is 60.	String
city	City. The maximum length is 60.	String, Required
province	Province. The maximum length is 60.	String, Required
country	Country. The maximum length is 60.	String, Required
company_name	Company name.	String, Required
warehouse_code	Warehouse code.	String, Required

Body

{
  "carrier": "sf-express",
  "tracking_no": "SF7444400088263",
  "expected_inbound_date": "2019-06-03",
  "items": [
    {
      "quantity": 2,
      "sku_number": "iphone-4"
    },
    {
      "quantity": 1,
      "sku_number": "iphone-5"
    }
  ],
  "package_number": 1,
  "reference": "#20190603001",
  "remarks": "Please take it lightly, thank you!",
  "shipper": {
    "address1": "3131 Las Vegas Blvd. South",
    "address2": "",
    "city": "Shenzhen",
    "country": "China",
    "district": "Nanshan",
    "email": "arthur@zhenhub.com",
    "first_name": "Arthur",
    "last_name": "Chen",
    "phone": "+852 3152xxxx",
    "province": "Guangdong",
    "zip_code": "518000",
    "company_name": "Testing Company"
  },
  "warehouse_code": "warehouse01"
}

Response

Response payload.

Payload return an error with the description and data = empty. If the request is successful, the data contains an object with the result.

{
  "code": 200,
  "message": "Successful!",
  "data": 443513787594258323
}