Lingxing
切换旧版

创建订单

POST/pb/mp/order/v2/create

创建多平台店铺手工单，包含自定义平台订单，对应系统中订单类型为“手工订单”类型

API Path请求协议请求方式令牌桶容量
/pb/mp/order/v2/create HTTPSPOST10

请求参数

platform_codeinteger必填
平台code
store_idstring必填
店铺id
ordersarray<object>必填
订单列表
隐藏子属性
platform_order_nostring必填
平台单号【同一店铺不支持重复】
site_codestring
站点
buyer_notestring
买家留言
receiver_country_codestring必填
国家/地区二字简码
customer_shipping_amountnumber
客付运费【币种默认为店铺币种】
customer_tax_amountnumber
客付税费【币种默认为店铺币种】
order_total_amountnumber
订单金额【币种默认为店铺币种】
widstring
仓库id ，【当填写了该字段，则logistics_type_id 必填】
global_purchase_timenumber
订购时间(秒级时间戳)
global_payment_timenumber
付款时间(秒级时间戳)
remarkstring
客服备注
logistics_type_idstring
物流方式id， 【当填写了该字段，则wid必填】
receiver_namestring必填
收件人
address_typeinteger
地址类型
1:住宅地址”
2:“商业地址”
buyer_choose_expressstring
客选物流
receiver_company_namestring
公司名
citystring必填
城市
address_line1string必填
地址1
amount_currencystring
币种，默认与店铺的币种一致，ISO 4217标准码
order_custom_fieldsobject
订单自定义字段
itemsarray<object>必填
订单产品信息
隐藏子属性
skustring
本地SKU（SKU和MSKU必填其中一个）
quantityinteger必填
数量
unit_pricenumber必填
单价【币种默认为店铺币种】
mskustring
MSKU（SKU和MSKU必填其中一个）
stock_deduction_typestring
库存扣减类型 1表示“空”， 2表示“SKU+订单店铺”
item_custom_fieldsobject
订单产品自定义字段
shipping_infoobject
物流信息（传则下层全必填）
隐藏子属性
tms_waybill_nostring必填
物流号
tms_tracking_nostring必填
追踪号
file_namestring必填
面单文件名
base64Filestring必填
面单base64
sender_tax_typeinteger
"税号类型:
1=>IOSS编号
2=>VAT税号
3=>CPF税号
4=>EORI号码
5=>收件人税号
7=>VOEC税号"
sender_tax_nostring
税号

请求示例

{
    "platform_code": 10009,
    "store_id": "110283406273996288",
    "orders": [
        {
            "buyer_note": "xxx",
            "customer_shipping_amount": "20.00",
            "customer_tax_amount": "2.00",
            "order_total_amount": "20.80",
            "platform_order_no": "10379511104466944",
            "receiver_country_code": "CN",
            "wid": "1",
            "logistics_type_id": "1",
            "items": [
                {
                    "sku": "xhp004",
                    "quantity": 1,
                    "unit_price": "10.00",
                    "stock_deduction_type": 1
                }
            ]
        }
    ]
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
提示信息
request_idstring必填
请求链路id
示例 ad9c1a8625c74f3ea0525e216374e31a1676514819613
response_timestring必填
响应时间
示例 2023-02-16 10:33:40
dataarray<object>必填
响应数据
隐藏子属性
error_detailsarray<object>必填
错误信息
隐藏子属性
error_messagestring必填
失败原因
platform_order_nostring必填
平台单号
success_detailsarray<object>必填
成功详情
隐藏子属性
global_order_nointeger必填
系统单号
platform_order_nostring必填
平台单号
示例 10379511104466944

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "request_id": "2ecb8a09-275e-4773-9399-ebfbb17c1804.1689906739215",
    "response_time": "2023-07-21 10:32:19",
    "data": {
        "error_details": [],
        "success_details": [
            {
                "platform_order_no": "263407812560417017",
                "global_order_no": "103336708973801472"
            }
        ]
    }
}

附加说明

以对象名为custom_fields举例

创建入参：

参数名说明必填类型
custom_fields自定义字段，键为自定义字段标识id，值为对象否[object]
custom_fields>>id字段Id是[string]
custom_fields>>val字段值是[array] [string]
custom_fields>>character字段额外属性（单位、币种等）是[string]

查询反参：

自定义字段custom_fields字段格式如下:

参数名说明类型
custom_fields自定义字段，键为自定义字段标识id，值为对象[object]
custom_fields>>id字段Id[string]
custom_fields>>name字段名称[string]
custom_fields>>val字段值[array] [string]
custom_fields>>val_text字段值文本描述[string]
custom_fields>>character字段属性[string]

案例：

传参格式以字段类型为准，可在对应手工单创建页面查看所有预设自定义入参

{
  "custom_fields": {
    "207625221713657857": {
      "id": "207625221713657857",
      "name": "自定义文本字段1",
      "val": "自定义值1",
      "val_text": "自定义值1",
      "character": ""
    },
    "207628319154110465": {
      "id": "207628319154110465",
      "name": "自定义金额字段",
      "val": "1",
      "val_text": "￥1",
      "character": "CNY"
    },
    "207628315704386049": {
        "id": "207628315704386049",
        "name": "自定义多选框",
        "val": ["207628364666183680","207628724481196032"],
        "val_text": "",
        "character": ""
    }
  }
}