文档中心 > API类目 > 新零售供应链API

qimen.alibaba.ascp.dchain.industry.waybill.add (三方快运服务商补单)

三方快运服务商补单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request Request 必须 请求体
  • └ requestTime
  • String
  • 必须
  • 业务请求时间戳(精度毫秒 eg:1659080423659)103
  • 时间戳
  • parcelInfoDTOList
  • ParcelInfoStandardDTO []
  • 必须
  • 包裹信息
  • └ volume
  • String
  • 必须
  • 包裹体积126
  • 包裹体积(cm3)
  • └ name
  • String
  • 必须
  • 名称6
  • 名称
  • └ waybillType
  • Number
  • 可选
  • 1
  • 包裹类型1:母单 2 :子单
  • └ feature
  • String
  • 可选
  • 扩展字段63
  • 扩展字段
  • └ weight
  • String
  • 必须
  • 包裹重量16
  • 包裹重量(kg)
  • └ width
  • String
  • 可选
  • 2
  • 宽(cm)
  • └ length
  • String
  • 可选
  • 1
  • 长(cm)
  • └ height
  • String
  • 可选
  • 3
  • 高(cm)
  • └ boxCode
  • String
  • 可选
  • 11
  • 箱号
  • └ idempotentKey
  • String
  • 必须
  • 111
  • 幂等键(若幂等键相同,不报错,返回追加子单相同响应报文)
  • └ orderId
  • String
  • 必须
  • 111
  • 客户订单号
  • └ routeKey
  • String
  • 必须
  • RAzN8HWJwYcq44AVBh4yf5jr8dASjfigjc1ekic8GxE9VywssZC
  • 路由键

响应参数

名称 类型 示例值 描述
response Response 响应
  • data
  • Data
  • 响应内容
  • waybillStandardInfoDTOS
  • WaybillStandardInfoDTO []
  • 运单信息集合
  • └ deliveryService
  • String
  • 派送方式/服务方式
  • 派送方式/服务方式
  • └ fullSectionCode
  • String
  • 全段码(三段码)
  • 全段码(三段码)
  • └ routingInfo
  • String
  • 路由信息
  • 路由信息
  • └ transportationMode
  • String
  • 运输方式
  • 运输方式
  • └ destinationDistribution
  • String
  • 目的分拨
  • 目的分拨
  • └ packageType
  • String
  • 包装
  • 包装
  • └ warehouseArea
  • String
  • 库区
  • 库区
  • └ feature
  • String
  • {}
  • 扩展信息
  • └ destinationPrimaryNode
  • String
  • 目的一级网点
  • 目的一级网点
  • └ destinationSecondaryNode
  • String
  • 目的二级网点
  • 目的二级网点
  • └ printTime
  • String
  • 1659080423659
  • 打印时间
  • └ sendOutlets
  • String
  • 寄件网点
  • 寄件网点
  • └ waybillType
  • Number
  • 1
  • 运单类型1:母单 2 :子单 (母单不为包裹,有多少包裹就需要回传多少子单,若无母单,则随机子单为母单)
  • └ waybillNo
  • String
  • MSF
  • 运单号
  • └ feature
  • String
  • {}
  • 扩展信息
  • └ orderId
  • String
  • 123456
  • 客户订单号
  • └ success
  • Boolean
  • false
  • 是否成功
  • └ responseMsg
  • String
  • 异常
  • 错误信息
  • └ responseCode
  • String
  • 1001
  • 错误码

请求示例

{"request":{"requestTime":"业务请求时间戳(精度毫秒 eg:1659080423659)103","idempotentKey":"111","routeKey":"RAzN8HWJwYcq44AVBh4yf5jr8dASjfigjc1ekic8GxE9VywssZC","orderId":"111","parcelInfoDTOList":[{"volume":"包裹体积126","waybillType":1,"feature":"扩展字段63","name":"名称6","width":"2","length":"1","weight":"包裹重量16","height":"3","boxCode":"11"}]}}

响应示例

{
    "response":{
        "data":{
            "waybillStandardInfoDTOS":[
                {
                        "deliveryService":"派送方式\/服务方式",
                        "fullSectionCode":"全段码(三段码)",
                        "routingInfo":"路由信息",
                        "transportationMode":"运输方式",
                        "destinationDistribution":"目的分拨",
                        "packageType":"包装",
                        "warehouseArea":"库区",
                        "feature":"{}",
                        "destinationPrimaryNode":"目的一级网点",
                        "destinationSecondaryNode":"目的二级网点",
                        "printTime":"1659080423659",
                        "sendOutlets":"寄件网点",
                        "waybillType":1,
                        "waybillNo":"MSF"
                }
            ],
            "feature":"{}",
            "orderId":"123456"
        },
        "success":false,
        "responseMsg":"异常",
        "responseCode":"1001"
    }
}

验签示例

{"success":"false","responseCode":"sign-check-failure","responseMsg":"Illegal request"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部