订单新增

POST

/open/order/add

订单管理-开放平台

为更好的支持海外仓处理客户订单的尾程上网情况，请各大ERP系统尽可能的传递 outPromisedShippingTime 参数（即最晚履约时间、SLA时间、剩余发货时间等意思）

请求参数

Body 参数application/json

country

string

国家

可选

示例值:

Malaysia

city

string

市

必需

示例值:

Bandar Baharu

district

string

区

可选

示例值:

Bandar Baharu

province

string

省

必需

示例值:

Bandar Baharu

address

string

地址

必需

示例值:

Bandar Baharu

mobile

string

手机

必需

示例值:

15454125412

zipcode

string

收件人邮编

可选

示例值:

123456

contact

string

联系人

必需

示例值:

bob

cusRemark

string

客户备注

可选

示例值:

123

storeId

integer <int64>

店铺id

可选

payAmount

number

支付金额

必需

示例值:

150

paidTime

string <date-time>

可选

支付时间（yyyy-MM-dd HH:mm:ss）

currency

string

币种

必需

示例值:

MYR

details

array[object (SalesOrderDetailInsertDTO) {3}]

订单明细

必需

quantity

integer <int32>

数量

必需

示例值:

actualPrice

number

实际价格

必需

示例值:

18.8

skuCode

string

卖家SKU

必需

示例值:

test-123

countryCode

string

国家编码（三字码）

必需

示例值:

MYS

warehouseId

integer <int64>

必需

仓库id（调用仓库列表接口取id字段）

示例值:

1000

isCod

enum<string>

可选

是否货到付款（1.是 0.否）

枚举值:

示例值:

sellerRemark

string

卖家备注

可选

示例值:

卖家备注

shipmentProvider

string

必需

物流渠道（线上订单使用平台物流渠道名称【不用和本系统进行物流映射】。如果需要使用仓库物流【比如当地的线下物流】的话需要调用物流渠道列表接口取code字段）

示例值:

JT EXPRESS

shippingFee

number

运费

可选

示例值:

erpOrderCode

string

必需

客户订单号（唯一）最大长度64

示例值:

S123456789

outSalesOrderCode

string

平台订单号

可选

示例值:

47888888888

outSalesOrderStatus

string

平台订单状态

可选

示例值:

WAITING

outCreateTime

string <date-time>

可选

平台创建时间（yyyy-MM-dd HH:mm:ss）

outPromisedShippingTime

string <date-time>

可选

平台最晚发货时间（yyyy-MM-dd HH:mm:ss）

waybillPdfUrl

string

可选

面单地址（平台订单必填）

expressNo

string

可选

快递单号（平台订单必填）

示例值:

123456

isAutoAudit

boolean

是否自动审核

可选

默认值:

true

示例值:

true

packageType

enum<string>

可选

包材类型（见外包材类型枚举值）

枚举值:

boxplasticbubblecottonnoneout_none

示例

{
  "country": "Malaysia",
  "city": "Bandar Baharu",
  "district": "Bandar Baharu",
  "province": "Bandar Baharu",
  "address": "Bandar Baharu",
  "mobile": "15454125412",
  "zipcode": "123456",
  "contact": "bob",
  "cusRemark": "123",
  "storeId": 0,
  "payAmount": 150,
  "paidTime": "2019-08-24T14:15:22Z",
  "currency": "MYR",
  "details": [
    {
      "quantity": 1,
      "actualPrice": 18.8,
      "skuCode": "test-123"
    }
  ],
  "countryCode": "MYS",
  "warehouseId": 1000,
  "isCod": "1",
  "sellerRemark": "卖家备注",
  "shipmentProvider": "JT EXPRESS",
  "shippingFee": 8,
  "erpOrderCode": "S123456789",
  "outSalesOrderCode": "47888888888",
  "outSalesOrderStatus": "WAITING",
  "outCreateTime": "2019-08-24T14:15:22Z",
  "outPromisedShippingTime": "2019-08-24T14:15:22Z",
  "waybillPdfUrl": "string",
  "expressNo": "123456",
  "isAutoAudit": true,
  "packageType": "box"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://demo01.haixingcang.com/open/order/add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country": "Malaysia",
    "city": "Bandar Baharu",
    "district": "Bandar Baharu",
    "province": "Bandar Baharu",
    "address": "Bandar Baharu",
    "mobile": "15454125412",
    "zipcode": "123456",
    "contact": "bob",
    "cusRemark": "123",
    "storeId": 0,
    "payAmount": 150,
    "paidTime": "2019-08-24T14:15:22Z",
    "currency": "MYR",
    "details": [
        {
            "quantity": 1,
            "actualPrice": 18.8,
            "skuCode": "test-123"
        }
    ],
    "countryCode": "MYS",
    "warehouseId": 1000,
    "isCod": "1",
    "sellerRemark": "卖家备注",
    "shipmentProvider": "JT EXPRESS",
    "shippingFee": 8,
    "erpOrderCode": "S123456789",
    "outSalesOrderCode": "47888888888",
    "outSalesOrderStatus": "WAITING",
    "outCreateTime": "2019-08-24T14:15:22Z",
    "outPromisedShippingTime": "2019-08-24T14:15:22Z",
    "waybillPdfUrl": "string",
    "expressNo": "123456",
    "isAutoAudit": true,
    "packageType": "box"
}'

返回响应

🟢200OK

application/json

Body

code

integer <int32>

可选

msg

string

可选

data

object (OpenSalesOrderVO)

可选

salesOrderCode

string

海星订单号

可选

trace

string

可选

extra

object

可选

额外字段

object

可选

boolean

可选

示例

{
  "code": 0,
  "msg": "string",
  "data": {
    "salesOrderCode": "string"
  },
  "trace": "string",
  "extra": {
    "property1": {},
    "property2": {}
  },
  "ok": true
}

🟠400Bad Request

🟠403Forbidden

🔴500Internal Server Error

修改于 2025-02-24 08:37:00

商品单位

订单列表