创建订单

POST

/openApi/erp/createOrder

此接口用于预报创建订单操作

请求参数

Header 参数

apiAccount

string

必需

API KEY，可在OMS后台进行申请或联系业务员申请

timestamp

string

必需

当前 UNIX 时间戳，可记录发起 API 请求的时间。例如 1681766460。注意：如果与服务器时间相差超过5分钟，会引起签名过期错误

sign

string

必需

签名：apiAccount+ apiPasswd+ timestamp三个参数进行拼接，然后MD5加密获取MD5值

Body 参数application/json

customerBillNo

string

客户单号

必需

productNo

string

销售产品编号

必需

fbaWarehouse

string

FBA仓库代码

可选

收货地址为FBA仓库必填

recipientCompany

string

收件公司名称

必需

recipientName

string

收件人名称

必需

recipientPhone

string

收件人电话

必需

recipientCountry

string

收件国家二字码

必需

recipientZipcode

string

收件邮政编码

必需

recipientProvince

string

收件省/州编码

必需

recipientCity

string

收件城市

必需

recipientAddress1

string

收件详细地址

必需

vatNumber

string

VAT税号

可选

goodsTypeNo

string

货物类型

必需

可选：包裹/袋子/文件

customerRemark

string

客户备注

可选

customsVoList

array [object {15}]

必需

fbaNo

string

FBA单号

可选

FBA货物必填

referenceId

string

Reference Id

可选

参考号

lenght

number

长

必需

width

number

宽

必需

height

number

高

必需

weight

number

重量

可选

单位KG

customsCode

string

海关编码

必需

tradeNameCn

string

中文品名

必需

tradeNameEn

string

英文品名

必需

declaredPiece

number

单箱数量

必需

declaredUnitPrice

number

单价

必需

brand

string

品牌

必需

model

string

规格/型号

必需

material

string

材质

可选

purpose

string

用途

可选

示例

{
    "customerBillNo": "string",
    "productNo": "string",
    "fbaWarehouse": "string",
    "recipientCompany": "string",
    "recipientName": "string",
    "recipientPhone": "string",
    "recipientCountry": "string",
    "recipientZipcode": "string",
    "recipientProvince": "string",
    "recipientCity": "string",
    "recipientAddress1": "string",
    "vatNumber": "string",
    "goodsTypeNo": "string",
    "customerRemark": "string",
    "customsVoList": [
        {
            "fbaNo": "string",
            "referenceId": "string",
            "lenght": 0,
            "width": 0,
            "height": 0,
            "weight": 0,
            "customsCode": "string",
            "tradeNameCn": "string",
            "tradeNameEn": "string",
            "declaredPiece": 0,
            "declaredUnitPrice": 0,
            "brand": "string",
            "model": "string",
            "material": "string",
            "purpose": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openApi/erp/createOrder' \
--header 'apiAccount;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerBillNo": "string",
    "productNo": "string",
    "fbaWarehouse": "string",
    "recipientCompany": "string",
    "recipientName": "string",
    "recipientPhone": "string",
    "recipientCountry": "string",
    "recipientZipcode": "string",
    "recipientProvince": "string",
    "recipientCity": "string",
    "recipientAddress1": "string",
    "vatNumber": "string",
    "goodsTypeNo": "string",
    "customerRemark": "string",
    "customsVoList": [
        {
            "fbaNo": "string",
            "referenceId": "string",
            "lenght": 0,
            "width": 0,
            "height": 0,
            "weight": 0,
            "customsCode": "string",
            "tradeNameCn": "string",
            "tradeNameEn": "string",
            "declaredPiece": 0,
            "declaredUnitPrice": 0,
            "brand": "string",
            "model": "string",
            "material": "string",
            "purpose": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

message

string

响应消息

必需

示例

成功示例异常示例

{"code":200,"message":"下单成功"}

客户对接API

获取面单