WMS-API

创建订单

POST

/api/order/create

请求参数

Body 参数application/json

订单对象

warehouse

string

发货仓库编号

必需

erpNo

string

erp单号

必需

platform

string

平台

必需

platformOrderNo

string

平台订单号

可选

buyerName

string

可选

买家名称 (线下物流订单必填)

buyerPhone

string

买家手机号

可选

recipientCountry

string

必需

收件人(国家/地区)二字码

recipientProvince

string

可选

收件人(省/州)(线下物流订单必填)

recipientCity

string

可选

收件人(市/县)(线下物流订单必填)

recipientArea

string

收件人(区/县)

可选

recipientAddress

string

可选

收货人地址(详细地址)(线下物流订单必填)

recipientAddress2

string

可选

收货人地址(详细地址2)

recipientEmail

string

收件人电子邮箱

可选

zipCode

string

可选

邮编(线下物流订单必填)

taxId

string

收件人税号

可选

recipientCompany

string

收件人公司

可选

type

integer

必需

渠道类型，
1：线上订单（推送时必须有面单和运单号信息），默认为线上订单
2：线下物流（推送时无面单和运单号，需要调用物流接口获取）

默认值:

logisticsId

integer

可选

物流id(传线上物流id，或者客户物流渠道id)

logisticsName

string

物流名称

必需

amount

number

订单金额

可选

currency

string

币种

可选

trackingNo

string

可选

运单号(线上物流订单必填)

labelUrl

string

可选

面单URL(线上物流订单必填)

expireTime

string

过期时间

可选

skuList

array[object (CreateOrderSkuVo) {7}]

商品信息

必需

skuId

integer

商品id

可选

sku

string

商品SKU

必需

num

integer

商品数量

必需

unitPrice

number

商品单价

可选

itemNameEn

string

英文品名

可选

itemNameCn

string

中文品名

可选

hsCode

string

商品海关编码

可选

packageType

integer

可选

包裹类型 1:信封 2:Pack袋 3:自备包装(线下物流订单必填)

pickingNote

string

拣货备注

可选

示例


{
    "warehouse": "PDAyh",
    "erpNo": "Pass202506131039",
    "platform": "店小秘",
    "platformOrderNo": "order202506131039",
    "trackingNo": "tr202506131039",
    "recipientCountry": "US",
    "recipientProvince": "Kedah",
    "recipientCity": "Bling",
    "recipientAddress": "坂田街道",
    "zipCode": "001001",
    "length": "10",
    "width": "5",
    "height": "5",
    "amount": "10",
    "currency": "CNY",
     "buyerName":"11111",
    "buyerPhone":"222",
    "skuList": [
        {
            "sku": "ww222",
            "num": 1,
            "hsCode": 10086
        }
    ],
    "type": 1,
    "packageType": 1,
    "logisticsId": "341",
    "logisticsName": "Entrego MP", 
    "labelUrl": "https://wms-1251220924.cos.accelerate.myqcloud.com/test/label/api/file/31/20231019063905/120cf6d32cb276c4f9f0cdbe45683fa2.pdf"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/order/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "warehouse": "PDAyh",
    "erpNo": "Pass202506131039",
    "platform": "店小秘",
    "platformOrderNo": "order202506131039",
    "trackingNo": "tr202506131039",
    "recipientCountry": "US",
    "recipientProvince": "Kedah",
    "recipientCity": "Bling",
    "recipientAddress": "坂田街道",
    "zipCode": "001001",
    "length": "10",
    "width": "5",
    "height": "5",
    "amount": "10",
    "currency": "CNY",
     "buyerName":"11111",
    "buyerPhone":"222",
    "skuList": [
        {
            "sku": "ww222",
            "num": 1,
            "hsCode": 10086
        }
    ],
    "type": 1,
    "packageType": 1,
    "logisticsId": "341",
    "logisticsName": "Entrego MP", 
    "labelUrl": "https://wms-1251220924.cos.accelerate.myqcloud.com/test/label/api/file/31/20231019063905/120cf6d32cb276c4f9f0cdbe45683fa2.pdf"
}'

返回响应

🟢200成功

application/json

Body

[API接口响应结果类] 0 1

code

integer

可选

错误码：0为成功，其他为失败

默认值:

message

string

错误提示信息

可选

data

object

数据

可选

requestId

string

请求Id

可选

示例

{
  "code": 0,
  "message": "",
  "data": {},
  "requestId": ""
}

修改于 2025-06-13 02:52:46

根据RefreshToken刷新AccessToken

取消订单