文档中心 > API类目 > 五道口API

qimen.alibaba.tcls.aelophy.delivery.create (创建配送单)

创建第三方配送单

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
callDeliveryRequest	CallDeliveryRequest	必须			请求参数
└ merchantCode String 必须 CSSJ 商家编码 └ outOrderId String 必须 50011002233 外部单号 └ deliveryShopId String 必须 2324 isv配送店ID └ deliveryChannelCode String 可选 SF 配送渠道 └ payTime Number 必须 1642666808008 支付时间 └ startTime Number 必须 1642666808008 配送开始时间 └ endTime Number 必须 1642666808008 配送结束时间 └ orderFrom Number 必须 3 订单来源 └ serialNo String 可选 222 订单小号 receiver Receiver 必须收件人 └ address String 必须测试地址地址 └ phone String 必须 13811122211 手机号 └ name String 必须张三姓名 └ lng String 必须 120.11 经度 └ lat String 必须 38.22 纬度 goodsList GoodsList [] 必须商品列表 └ skuName String 必须测试商品商品名称 └ saleQuantity Number 必须 1 数量 └ subOrderId String 必须 50002233 子单号 └ totalWeight Number 必须 1000 总重

响应参数

名称	类型	示例值	描述
deliveryResult	DeliveryResult		返回结果
└ errCode String SYS_ERROR 错误码 └ success Boolean false 是否成功 └ errMsg String 系统异常错误信息 └ errorFormat String SYS_ERROR:系统异常格式化错误信息 model Model 数据 └ merchantCode String CSSJ 商家编码 └ outOrderId String 500011222334455 交易单号 └ deliveryStatus String SHIPPING 配送状态 └ deliveryShopId String 412 isv配送店ID └ orderFrom Number 4 订单来源 └ deliveryChannelCode String SF 配送平台编码 └ deliveryChannelName String 顺丰配送平台名称 └ deliveryNo String 2 配送单号 └ deliveryDiscountFee Number 10 配送费优惠 └ deliveryOriginalFee Number 100 配送费原价 └ deliveryActualFee Number 90 实际配送费 └ deliveryEndTime Number 1642667839209 配送结束时间 └ deliveryStartTime Number 1642667839209 配送开始时间 └ deliveryPhone String 13322233322 配送员手机号 └ deliveryName String 张三配送员姓名 └ deliveryDistance Number 100 配送距离 └ predictDeliveryTime Number 40 预计配送时长（分钟）

请求示例

{"callDeliveryRequest":{"deliveryShopId":"2324","merchantCode":"CSSJ","receiver":{"address":"测试地址","lng":"120.11","phone":"13811122211","name":"张三","lat":"38.22"},"payTime":0,"outOrderId":"50011002233","goodsList":[{"skuName":"测试商品","saleQuantity":1,"subOrderId":"50002233","totalWeight":1000}],"deliveryChannelCode":"SF","startTime":0,"orderFrom":3,"endTime":0,"serialNo":"222"}}

响应示例

{
    "deliveryResult":{
        "errCode":"SYS_ERROR",
        "success":false,
        "errMsg":"系统异常",
        "errorFormat":"SYS_ERROR:系统异常",
        "model":{
            "merchantCode":"CSSJ",
            "outOrderId":"500011222334455",
            "deliveryStatus":"SHIPPING",
            "deliveryShopId":"412",
            "orderFrom":4,
            "deliveryChannelCode":"SF",
            "deliveryChannelName":"顺丰",
            "deliveryNo":"2",
            "deliveryDiscountFee":10,
            "deliveryOriginalFee":100,
            "deliveryActualFee":90,
            "deliveryEndTime":1642667839209,
            "deliveryStartTime":1642667839209,
            "deliveryPhone":"13322233322",
            "deliveryName":"张三",
            "deliveryDistance":100,
            "predictDeliveryTime":40
        }
    }
}

验签示例

{"deliveryResult":{"success":"false","errCode":"sign-check-failure","errMsg":"Illegal request"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

五道口API

qimen.alibaba.tcls.aelophy.delivery.create (创建配送单)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ