注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 淘宝物流API

qimen.taobao.logistics.wms.pkdeliveryorder.create (包裹出库单下发)

包裹出库单下发

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request PackageDeliveryRequest 必须 请求
  • └ delivery_order_code
  • String
  • 必须
  • lbx739403
  • 包裹出库单号
  • └ warehouse_code
  • String
  • 必须
  • JYEms
  • 服务商仓code
  • └ supplier_id
  • String
  • 必须
  • xxx2432
  • 物流服务商ID
  • └ logistics_owner
  • String
  • 必须
  • TaoTian
  • 物流主体,例如:TaoTian(淘天)
  • └ order_type
  • String
  • 必须
  • ZXCK
  • 业务类型,取值:ZXCK(正向出库)、NXCK(逆向出库)
  • └ additional_instructions
  • String
  • 可选
  • DFJJS,CGGJS
  • 英文逗号分隔多个指令:DFJJS-到付件拒收,CGGJS-超规格拒收
  • packages
  • PackageDTO []
  • 必须
  • 列表
  • └ package_line
  • String
  • 必须
  • unit739403
  • 包裹单号
  • └ oaid_order_source_code
  • String
  • 可选
  • 3233432
  • 主订单id,正向出库时下发
  • └ tms_cp_code
  • String
  • 可选
  • STO
  • 原发货快递公司,正向出库/逆向出库均下发
  • └ mail_no
  • String
  • 可选
  • 2233243
  • 原运单号,正向出库/逆向出库均下发
  • └ package_owner_code
  • String
  • 可选
  • LBYQJ
  • 包裹货主
  • receiver_info
  • ContactInfo
  • 必须
  • 收件人信息
  • └ name
  • String
  • 必须
  • 老王
  • 姓名,逆向出库时下发
  • └ tel
  • String
  • 可选
  • 808786543
  • 固定电话
  • └ mobile
  • String
  • 可选
  • xxx,1223453
  • 移动电话
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ town
  • String
  • 可选
  • 五常街道
  • 城镇
  • └ detail_address
  • String
  • 必须
  • 文一西路966
  • 详细地址
  • └ aid
  • String
  • 可选
  • 123hu12
  • 订单oaid,正向出库时下发
  • └ extend_props
  • Map
  • 可选
  • ext
  • ext
  • sender_info
  • ContactInfo
  • 必须
  • 寄件人信息
  • └ detail_address
  • String
  • 必须
  • 文一西路966皓
  • 详细地址,正逆向出库时均下发
  • └ town
  • String
  • 可选
  • 五常街道
  • 城镇,正逆向出库时均下发
  • └ area
  • String
  • 可选
  • 余杭
  • 区域,正逆向出库时均下发
  • └ city
  • String
  • 必须
  • 杭州
  • 城市,正逆向出库时均下发
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份,正逆向出库时均下发

响应参数

名称 类型 示例值 描述
response Response 结果
  • └ outer_order_code
  • String
  • 12312312
  • wms系统包裹出库单号
  • └ success
  • String
  • true
  • 成功/失败
  • └ err_code
  • String
  • 231231
  • 二级错误码
  • └ err_msg
  • String
  • 出库异常
  • 二级错误信息

请求示例

{"request":{"logistics_owner":"TaoTian","additional_instructions":"DFJJS,CGGJS","delivery_order_code":"lbx739403","warehouse_code":"JYEms","packages":[{"sender_info":{"area":"余杭","town":"五常街道","province":"浙江省","city":"杭州","detail_address":"文一西路966皓"},"package_line":"unit739403","package_owner_code":"LBYQJ","extend_props":"ext","oaid_order_source_code":"3233432","tms_cp_code":"STO","mail_no":"2233243","receiver_info":{"area":"余杭","province":"浙江省","town":"五常街道","city":"杭州","detail_address":"文一西路966","name":"老王","mobile":"xxx,1223453","tel":"808786543","aid":"123hu12"}}],"supplier_id":"xxx2432","order_type":"ZXCK"}}

响应示例

{
    "response":{
        "outer_order_code":"12312312",
        "success":"true",
        "err_code":"231231",
        "err_msg":"出库异常"
    }
}

验签示例

{"success":"不等于true","err_msg":"Illegal request","err_code":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案
response-body-parse-error

API工具

FAQ

返回
顶部