文档中心 > API类目 > MMC物流域项目

qimen.taobao.tcc.waybill.receive (淘菜菜运单同步api)

将淘菜菜运力平台的部分运单信息同步给第三方承运商

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	更多限制	描述
driverInfo	DriverInfo	可选		运力信息
└ plateNumber String 可选沪A12345 车牌号
loadingInfo	LoadingInfo	可选		装货方信息
└ loadingCity String 可选上海市装货地市 └ loadingProvince String 可选上海市装货地省 └ loadingRegion String 可选浦东新区装货地区 └ plannedPickupTime String 可选 2021-10-02 08:00:00 计划取货时间 └ loadingAddress String 可选张江高科技园区科苑路99号装货地地址 └ loadingContactMobile String 可选装货联系人电话 17512574426 └ loadingContact String 可选装货联系人装货联系人 └ latitude String 可选 32.12 纬度 └ longitude String 可选 12.12 经度
receiveList	ReceiveList []	可选	最大列表长度：999999	收货方列表
└ unloadingCity String 可选苏州市卸货地市 └ unloadingAddress String 可选星湖街328号卸货地址 └ unloadingProvince String 可选江苏省卸货地省 └ unloadingRegion String 可选工业园区卸货地区 └ plannedDeliveryTime String 可选 2021-10-02 14:00:00 计划收货时间 └ stationCode String 可选 G1000 卸货地址编码 └ unloadingContact String 可选卸货联系人联系人 └ unloadingContactMobile String 可选卸货联系电话联系人电话 └ latitude String 可选 32.12 纬度 └ longitude String 可选 12.12 经度
basicInfo	BasicInfo	可选		基本信息
└ receiveTime String 可选 2021-10-01 12:30:00 接单时间 └ externalOrderNo String 可选 EXT456 外部单号 └ createTime String 可选 2021-10-01 12:00:00 创建时间/调度时间 └ orderStatus String 可选已派车订单状态 └ waybillStatus String 可选运输中运单状态 └ tenantCode String 可选 T1020751 租户编码 └ dispatchStatus String 可选运输中派车单状态 └ customerCode String 可选 TEST1672544643726 货主编码 └ estimatedCost String 可选 100 预估运费 └ edit String 可选 false 是否编辑(true-编辑 false-新增) └ driverExternalCode String 可选 Test1234 司机注册码 └ operator String 可选小明操作员

响应参数

名称	类型	示例值	描述
data	Data		响应数据
└ unifyNo String U订单号外部唯一号 orderList OrderList [] 站点明细列表 └ stationCode String G121212 站点code └ odrNo String 123 外部第三方订单号
bizMsg	String	成功	错误信息
bizCode	String	success	错误码
success	Boolean	true	是否正确执行(为false时bizCode要有值)

请求示例

{"driverInfo":{"plateNumber":"沪A12345"},"loadingInfo":{"loadingCity":"上海市","loadingContact":"装货联系人","loadingProvince":"上海市","loadingContactMobile":"装货联系人电话","loadingRegion":"浦东新区","latitude":"32.12","plannedPickupTime":"2021-10-02 08:00:00","loadingAddress":"张江高科技园区科苑路99号","longitude":"12.12"},"receiveList":[{"stationCode":"G1000","unloadingCity":"苏州市","unloadingContact":"卸货联系人","unloadingContactMobile":"卸货联系电话","latitude":"32.12","unloadingAddress":"星湖街328号","unloadingProvince":"江苏省","unloadingRegion":"工业园区","plannedDeliveryTime":"2021-10-02 14:00:00","longitude":"12.12"}],"basicInfo":{"receiveTime":"2021-10-01 12:30:00","externalOrderNo":"EXT456","createTime":"2021-10-01 12:00:00","edit":"false","orderStatus":"已派车","waybillStatus":"运输中","customerCode":"TEST1672544643726","driverExternalCode":"Test1234","tenantCode":"T1020751","estimatedCost":"100","dispatchStatus":"运输中","operator":"小明"}}

响应示例

{
    "data":{
        "unifyNo":"U订单号",
        "orderList":[
            {
                    "stationCode":"G121212",
                    "odrNo":"123"
            }
        ]
    },
    "bizMsg":"成功",
    "bizCode":"success",
    "success":true
}

验签示例

{"bizMsg":"Illegal request","success":"false","bizCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

MMC物流域项目

qimen.taobao.tcc.waybill.receive (淘菜菜运单同步api)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ