1.基本信息

POST {请求地址}/apicenter/api/order

2.请求参数

Body 请求参数

  1. {
  2.     "centre_code": "mabang",
  3.     "client_code": "20",
  4.     "client_type": 2,
  5.     "platform_type": "tiktok",
  6.     "platform_order_number": "7861345751257",
  7.     "real_time_response": false,
  8.     "process_type": 1,
  9.     "customer_logistics": "jito",
  10.     "desc":" 测试备注",
  11.     "package_id":"tiktok_order0012454545",
  12.     "shipping_provider_id":"8545675454500214",
  13.     "shipping_provider_name":"jito",
  14.     "logistics_provider": {
  15.         "code": "manual_tracking_no",
  16.         "tracking_number": "222225555",
  17.     },
  18.     "package": {
  19.         "order_number": "mabang-test002"
  20.     },
  21.     "receiver": {
  22.         "name": "Juan Carlos García",
  23.         "address": "Calle vía de Dublín 7. Planta 1.",
  24.         "city": "Madrid",
  25.         "province": "Madrid",
  26.         "district": "111",
  27.         "country_code": "PH",
  28.         "post_code": "111",
  29.         "phone": "+34 655549503",
  30.         "email": "mabang@qq.com"
  31.     },
  32.     "sender": {
  33.         "name": "寄件人",
  34.         "address": "寄件人地址",
  35.         "city": "寄件人城市",
  36.         "province": "寄件人省",
  37.         "district": "寄件人区",
  38.         "country_code": "寄件人国家代码",
  39.         "post_code": "寄件人邮编",
  40.         "phone": "寄件人手机",
  41.         "email": "寄件人Email"
  42.     },
  43.     "items": [
  44.         {
  45.             "sku": "-ALB-908",
  46.             "currency": "PHP",
  47.             "unit_price": 10,
  48.             "qty": 1,
  49.             "platform_sku_id":"1234",
  50.         },
  51.         {
  52.             "unit_price": 10,
  53.             "currency": "PHP",
  54.             "sku": "#",
  55.             "qty": 1,
  56.             "platform_sku_id":"5648",
  57.         }
  58.     ]
  59. }
名称 位置 类型 必选 中文名 说明
centre_code body string 是 仓库编码 warehouseCode
client_code body string 是 海外仓客户（店铺）id 正式数据请联系管理员获取
client_type body integer 是 客户（店铺）类型 自定义平台为1，第三方平台为2
special_order_tag body int 否 订单的特殊标签 1 :发空包；2：打印发票；3：自定义面单
platform_type body String 是 电商平台 （shopee，lazada，tiktok，tokopedia） 请选择其中一个平台，非强制校验传值错误可能会导致业务流程异常
platform_order_number body String 是 第三方参考订单号（电商平台单号）
real_time_response body boolean 否· 实时验证所有订单数据 默认false
process_type body integer 否 订单流程类型,1:普通,2:已交运,3:转单 none
customer_logistics body string 是 客选物流名称 客户实际使用的物流商名称
desc body string 否 备注
package_id body string 否 package_id tikok 平台订单号 ，当platform_type=“tiktok”时必填
shipping_provider_id body string 否 shipping_provider_id tiktok物流单号 ，（用于认证仓信息回传）当platform_type=“tiktok”时必填，（用于认证仓信息回传，tiktok官方获取途径
shipping_provider_name body string 否 shipping_provider_name tiktok物流提供商名称 ，当platform_type=“tiktok”时必填，（用于认证仓信息回传，tiktok官方获取途径
logistics_provider body object 是 提供的物流信息详情 用于提供订单发货的物流信息详情
»» code body string 是 运输服务 推送物流单到wms模式为请传 manual_tracking_no
»» tracking_number body string 否 跟踪号 none
»» label_url body string 否 面单地址 请使用上传物流订单信息接口推送
»» label_base64 body string 否 面单base64 请使用上传物流订单信息接口推送
package body object 是 包裹信息 none
»» order_number body string 是 上游平台订单号 不允许带特殊字符，关联物流面单信息
receiver body object 是 收件人详情 none
»» name body string 是 姓名 none
»» address body string 是 详细地址 none
»» city body string 是 城市 none
»» province body string 是 省份 none
»» district body string 是 区 none
»» country_code body string 是 国家码 none
»» post_code body string 是 邮编 none
»» phone body string 是 联系方式 none
»» email body string 是 邮箱 none
sender body object 否 寄件人详情 none
»» name body string 否 姓名 none
»» address body string 否 详细地址 none
»» city body string 否 城市 none
»» province body string 否 省份 none
»» district body string 否 区 none
»» country_code body string 否 国家码 none
»» post_code body string 否 邮编 none
»» phone body string 否 联系方式 none
»» email body string 否 邮箱 none
items body [object] 是 SKU 商品详情 none
»» sku body string 是 sku none
»» currency body string 是 币种 none
»» unit_price body string 是 单价 none
»» qty body integer 是 数量 none
»» platform_sku_id body string 否 sku_id SKU ID ，当platform_type=“tiktok”时必填，（用于认证仓信息回传，tiktok官方获取途径

3.返回结果

返回示例

201 Response

  1. {
  2.   "code": 201,
  3.   "data": {
  4.     "order_number": "string",
  5.     "status": "string",
  6.     "number_of_package": 0,
  7.     "total_weight": "string",
  8.     "logistic_provider_code": "string",
  9.     "status_message": "string",
  10.     "shortage_at": "string",
  11.     "cancel_at": "string",
  12.     "allocate_at": "string",
  13.     "pack_at": "string",
  14.     "handover_at": "string",
  15.     "tracking_number": "string",
  16.     "logistics_message": "string",
  17.     "sorting_code": "string",
  18.     "sorting_no": "string",
  19.     "items": [
  20.       "string"
  21.     ]
  22.   },
  23.   "message": "string"
  24. }

4.返回数据结构

状态码 201

名称 类型 中文名 说明
» code integer 响应码 none
» data object 响应数据 none
»» order_number string 订单号 none
»» status string 订单状态 none
»» number_of_package integer 包裹数量 none
»» total_weight string 包装重量 none
»» logistic_provider_code string 物流供应商简称 none
»» status_message string 状态消息 none
»» shortage_at string 缺货时间 none
»» cancel_at string 取消时间 none
»» allocate_at string 分配时间 none
»» pack_at string 打包拣货时间 none
»» handover_at string 出库时间 none
»» tracking_number string 物流单号 none
»» logistics_message string 物流消息 none
»» sorting_code string 分拣编码 none
»» sorting_no string 分拣编号 none
»» items [string] 商品信息 none
» message string 响应描述 none