1、基本信息

  （1）请求方法: http post

  （2）请求地址: http://{hostname}/apicenter/api/order

  （3）说明: 

  1. 新增订单
  2. 一个订单仅包含一个包裹信息，一订单多包裹需要拆单


2、请求参数

名称 数据类型 说明 是否必填
centre_code String 仓库编码,默认CKMX 是
client_code String 店铺编码，默认CK2023 是
logistics_provider Object 物流商信息 是
platform_order_number String 第三方订单号 否
- code String 物流编码，见运输服务 否
- conformation String 签名服务，见签名服务 否
- insurance_code String 保险币种 否
- insurance_value String 保险金额 否
- customer_number String 参考单号 否
- tracking_number String 物流跟踪编号 否
- label_url String 面单路径 否
- label_base64 String 面单编码格式 否
packages Object 包裹信息 是
- salesPlatform String 销售平台 是
- order_number String 订单号 是
- payment_method String 付款方式 否
receiver Object 收件人信息 是
- name String 收件人姓名 是
- company String 收件人公司 否
- address String 收件人住址 是
- district String 收件人地区 否
- city String 收件人城市 是
- province String 收件人省份 是
- country_code String 收件人国家代码，二字代码 是
- post_code String 收件人邮政编码 是
- phone String 收件人电话 是
- email String 收件人电子邮件 否
items Array SKU 商品详情 是
- sku String SUK 代码 是
- qty int 商品数量 是
- unit_price double 商品单价 否


3、请求示例

  1. {
  2.     "centre_code": "PH-NB001",
  3.     "client_code": "KEC_860892PH",
  4.     "callback_foms_required": false,
  5.     "logistics_provider": {
  6.         "code": "DTPHPH000",
  7.         "account": "DTPHPH000",
  8.         "service": "DTPHPH000",
  9.         "tracking_number": "KECWPH00016066",
  10.         "label_url": "https://spider.kec-app.com//package/b41da873-695b-2bca-b6dd-2ed9d8f5e668/label"
  11.     },
  12.     "package": {
  13.         "order_number": "SYT-PH02130005X",
  14.         "platform_order_id": "SYT-PH02130005X",
  15.         "declared_value": 10,
  16.         "declared_value_currency": "PHP",
  17.         "payment_method": "PP"
  18.     },
  19.     "sender": {
  20.         "name": "郑木松",
  21.         "address": "Units 13-21 , SFB Laguna Technopark, Phase 8, Brgy, Biñan, Laguna Waze: Lemcon Binan Laguna , - binan, laguna , -",
  22.         "city": "binan",
  23.         "province": "laguna",
  24.         "country_code": "PH",
  25.         "post_code": "4024",
  26.         "phone": "15625861935",
  27.         "email": "479718175@qq.com"
  28.     },
  29.     "receiver": {
  30.         "name": "Ventura Jr. N. Orinion",
  31.         "address": "Zone 3 Asan Norte, Sison, Pangasinan",
  32.         "city": "Sison",
  33.         "province": "Pangasinan",
  34.         "country_code": "PH",
  35.         "post_code": "2434",
  36.         "phone": "9616271711",
  37.         "email": "SYT-PH02130005X@placeholder.com"
  38.     },
  39.     "items": [
  40.         {
  41.             "sku": "LP40SJ001",
  42.             "description": "lp40pro白色耳机",
  43.             "unit_price": 10,
  44.             "currency": "PHP",
  45.             "qty": 1,
  46.             "platform_id": "10001",
  47.             "line_item_id": "10001",
  48.             "platform_name": "OPENAPI"
  49.         }
  50.     ]
  51. }


4、响应参数

名称 数据类型 说明
code Integer code
msg String 提示信息


5、响应示例

  1. {
  2.     "msg": "操作成功",
  3.     "code": 201
  4. }
备注
  • 更多返回错误代码请看首页的错误代码描述