API 列表

xiaodian.logistics.online.send.v2

  • 免费
  • 需要授权

API功能描述(支持get和post)

新版物流发货接口（支持拆单发货）。

公共参数

名称 类型 必选 描述
app_key Long 是 接入时申请的app_key
method String 是 接口名称
access_token String 是 Oauth2.0授权获得的access_token
sign String 是 对 API 调用参数（除sign外）进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 是 时间戳，使用Unix时间戳格式
format String 是 响应格式。默认为json格式，固定
sign_method String 否 参数的加密方法选择，当前只支持Md5
version String 否 API协议版本，固定值为：1.0

输入参数

名称 类型 必选 描述 示例值
tradeOrderConsignReqDTO Object 是 发货请求对象
shipType Number 是 发货类型，0-物流发货
itemOrderList Number[] 是 发货商品订单ID列表集合
shopOrderId Number 是 店铺订单ID
expressCode String 是 快递公司编码:expressCode,如"zhaijisong"就代表宅急送,各个快递公司对应的编码为:     [     {         "expressIcon":"http://s8.mogucdn.com/pic/141118/logo_ieydcy3cgqzgiobzmqytambqgyyde_100x100.jpg",         "expressUrl":"http://www.yto.net.cn",         "expressName":"圆通速递",         "expressCode":"yuantong"     },     {         "expressIcon":"http://s8.mogucdn.com/pic/141118/logo_ieygiyldgqzgiobzmqytambqmeyde_100x100.jpg",         "expressUrl":"http://www.zto.cn",         "expressName":"中通速递",         "expressCode":"zhongtong"     },     {         "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieygeylbgqzgiobzmqytambqgyyde_100x100.jpg",         "expressUrl":"http://www.sto.cn",         "expressName":"申通快递",         "expressCode":"shentong"     },     {         "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieygkntegqzgiobzmqytambqmeyde_100x100.jpg",         "expressUrl":"http://www.yundaex.com",         "expressName":"韵达快运",         "expressCode":"yunda"     },     {         "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie4wmnrqmy2wemztguzdambqgqyde_100x100.png",         "expressUrl":"http://www.800bestex.com",         "expressName":"百世汇通",         "expressCode":"huitongkuaidi"     },     {         "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydkobsguzgiobzmqytambqgiyde_100x100.jpg",         "expressUrl":"http://www.ttkdex.com",         "expressName":"天天快递",         "expressCode":"tiantian"     },     {         "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieydgyjrguzgiobzmqytambqmmyde_100x100.jpg",         "expressUrl":"http://www.sf-express.com/cn/sc/",         "expressName":"顺丰速运",         "expressCode":"shunfeng"     },     {         "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydimteguzgiobzmqytambqgyyde_100x100.jpg",         "expressUrl":"http://www.qfkd.com.cn",         "expressName":"全峰快递",         "expressCode":"quanfengkuaidi"     },     {         "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydanryguzgiobzmqytambqhayde_100x100.jpg",         "expressUrl":"http://www.ems.com.cn",         "expressName":"EMS",         "expressCode":"ems"     },     {         "expressIcon":"http://s7.mogucdn.com/pic/141118/logo_ieydqy3fguzgiobzmqytambqgiyde_100x100.jpg",         "expressUrl":"http://www.fastexpress.com.cn",         "expressName":"快捷速递",         "expressCode":"kuaijiesudi"     },     {         "expressIcon":"http://s20.mogucdn.com/pic/141118/logo_ieydem3ggqzgiobzmqytambqgiyde_100x100.jpg",         "expressUrl":"http://yjcx.chinapost.com.cn",         "expressName":"邮政包裹",         "expressCode":"youzhengguonei"     },     {         "expressIcon":"http://s20.mogucdn.com/pic/141118/logo_ieydqnddguzgiobzmqytambqmeyde_100x100.jpg",         "expressUrl":"http://www.uc56.com",         "expressName":"优速快递",         "expressCode":"youshuwuliu"     },     {         "expressIcon":"http://s20.mogucdn.com/pic/141118/logo_ieygmzlggqzgiobzmqytambqgyyde_100x100.jpg",         "expressUrl":"http://www.gto365.com",         "expressName":"国通快递",         "expressCode":"guotongkuaidi"     },     {         "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydemruguzgiobzmqytambqgiyde_100x100.jpg",         "expressUrl":"http://www.zjs.com.cn",         "expressName":"宅急送",         "expressCode":"zhaijisong"     },     {         "expressIcon":"http://s8.mogucdn.com/pic/150325/19b0oi_ie2gmzbrmiyginrsgazdambqgiyde_1024x814_100x100.jpg",         "expressUrl":"https://www.usps.com",         "expressName":"USPS",         "expressCode":"usps"     },     {         "expressIcon":"http://s16.mogucdn.com/p1/151202/upload_ie4ggojvmu3wenztguzdambqgiyde_100x100.png",         "expressUrl":"http://www.ztky.com/GoodsTrace?funcid=14&companyid=1",         "expressName":"中铁物流",         "expressCode":"zhongtielogistic"     },     {         "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ieytkmjqmzsdmnzugezdambqmeyde_100x100.jpg",         "expressUrl":"http://adaexpress.com.au/wp",         "expressName":"明大快递",         "expressCode":"adaexpress"     },     {         "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ieztmmrvmjtdinzugezdambqgyyde_100x100.jpg",         "expressUrl":"http://www.pcaexpress.com.au/zh",         "expressName":"PCA",         "expressCode":"pcaexpress"     },     {         "expressIcon":"http://s6.mogucdn.com/p1/150520/1iaxbq_ie2dkmbxmy3gcnrugezdambqgiyde_100x100.jpg",         "expressUrl":"http://www.cnpex.com.au",         "expressName":"cnpex中邮快递",         "expressCode":"cnpex"     },     {         "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ie2winjuga3wcnrugezdambqhayde_100x100.jpg",         "expressUrl":"http://auspost.com.au",         "expressName":"Australiapost",         "expressCode":"auspost"     },     {         "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ieytknbsgm3wcnrugezdambqmeyde_100x100.jpg",         "expressUrl":"http://www.parcelforce.com",         "expressName":"Parcelforce",         "expressCode":"parcelforce"     },     {         "expressIcon":"http://s8.mogucdn.com/p1/150520/1iaxbq_ie2gmmlege3wcnrugezdambqgiyde_100x100.jpg",         "expressUrl":"http://www.cn.dhl.com/zh/express.html",         "expressName":"dhl",         "expressCode":"dhlen"     },     {         "expressIcon":"http://s6.mogucdn.com/p1/150520/1iaxbq_ie2dqolgga3wcnrugezdambqgiyde_100x100.jpg",         "expressUrl":"http://www.chronopost.fr/transport-express/livraison-colis",         "expressName":"法国邮局",         "expressCode":"chronopostfren"     },     {         "expressIcon":"http://s7.mogucdn.com/p1/150520/1iaxbq_iezgendegvrtinzugezdambqmmyde_100x100.jpg",         "expressUrl":"http://www.colissimo.fr/particuliers/home.jsp",         "expressName":"colissimo",         "expressCode":"colissimo"     },     {         "expressIcon":"http://s21.mogucdn.com/p1/150520/1iaxbq_ieytomjzmzstqnzugezdambqmeyde_100x100.jpg",         "expressUrl":"http://www.sundarexpress.com",         "expressName":"美国顺达快递",         "expressCode":"sundarexpress"     },     {         "expressIcon":"http://s6.mogucdn.com/p1/150520/1iaxbq_iezdgmbume3tqnzugezdambqmmyde_100x100.jpg",         "expressUrl":"http://www.ajexpress.com.au",         "expressName":"捷记方舟",         "expressCode":"ajexpress"     },     {         "expressIcon":"http://s16.mogucdn.com/p1/150610/upload_ie2gimrvmzsdsmtcgezdambqgiyde_100x100.jpg",         "expressUrl":"http://www.arkexpress.com.au",         "expressName":"方舟速递",         "expressCode":"arkexpress"     },     {         "expressIcon":"http://www.changjiangexpress.com/Home/Query",         "expressName":"长江国际速递",         "expressCode":"changjiang"     },     {         "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie4gmyzrmu4tanbtguzdambqgiyde_100x100.png",         "expressUrl":"https://www.doortodoor.co.kr/m/sub/sub_006.jsp",         "expressName":"CJ物流",         "expressCode":"doortodoor"     },     {         "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie3tsnjzmq4tanbtguzdambqgayde_100x100.png",         "expressUrl":"http://www.ilogen.com/d2d/index.jsp",         "expressName":"logen路坚",         "expressCode":"ilogen"     },     {         "expressIcon":"http://s18.mogucdn.com/p1/151201/upload_ifrwgzrqmq4tanbtguzdambqhayde_100x100.png",         "expressUrl":"http://www.post.japanpost.jp/index.html",         "expressName":"日本郵便",         "expressCode":"japanposten"     },     {         "expressIcon":"http://s17.mogucdn.com/p1/151201/upload_ie4wkzjxmm4tanbtguzdambqgqyde_100x100.png",         "expressUrl":"http://www.kuronekoyamato.co.jp/top.html",         "expressName":"ヤマト運輸",         "expressCode":"yamato"     },     {         "expressIcon":"http://s17.mogucdn.com/p1/151208/upload_ifrdeyjygq4dqnrvguzdambqmeyde_100x100.jpg",         "expressUrl":"http://www.sagawa-exp.co.jp",         "expressName":"佐川急便",         "expressCode":"sagawa"     },     {         "expressIcon":"http://s16.mogucdn.com/p1/151208/upload_ifqwmzrqgu4dqnrvguzdambqgyyde_100x100.jpg",         "expressUrl":"http://www.seino.co.jp/seino",         "expressName":"西濃運輸",         "expressCode":"seino"     },     {         "expressIcon":"http://s18.mogucdn.com/p1/151207/upload_ie4tmmtcmy3wemzvguzdambqgqyde_100x100.jpg",         "expressUrl":"http://www.xlobo.com",         "expressName":"贝海国际速递",         "expressCode":"xlobo"     },     {         "expressIcon":"http://s18.mogucdn.com/p1/151221/upload_ifqtmn3bmrrwcojzguzdambqgyyde_100x100.jpg",         "expressUrl":"http://www.koreapost.go.kr/kpost/sub/subpage.jsp?contId=010101100000",         "expressName":"韩国邮政",         "expressCode":"koreapost"     },     {         "expressIcon":"http://s6.mogucdn.com/pic/141118/logo_ieydomjrgyzgiobzmqytambqmeyde_100x100.jpg",         "expressUrl":"",         "expressName":"其它",         "expressCode":"others"     },     {         "expressIcon":"http://s16.mogucdn.com/p1/151201/upload_ie4ggzjwgq4tenbtguzdambqgiyde_100x100.png",         "expressUrl":"http://www.deppon.com",         "expressName":"德邦物流",         "expressCode":"debangwuliu"     },     {         "expressIcon":"http://s2.mogucdn.com/mlcdn/c45406/170322_4iia16g23l9a715ebcf682i8hb626_100x100.png",         "expressUrl":"http://www.ane56.com/search/waybilltrack.jsp",         "expressName":"安能物流",         "expressCode":"annengwuliu"     },     {         "expressIcon":"http://s3.mogucdn.com/mlcdn/c45406/170927_31k6h88cee84b0aj452j9b7c709f4_100x100.jpg",         "expressUrl":"http:ots.exfresh.net/",         "expressName":"安鲜达",         "expressCode":"exfresh"     },     {         "expressIcon":"http://s3.mogucdn.com/mlcdn/c45406/171026_7ld4afdfa06a17ee47f7bgi87428b_100x100.png",         "expressUrl":"http://www.ky-express.com/",         "expressName":"跨越速运",         "expressCode":"kuayue"     },     {         "expressIcon":"http://s3.mogucdn.com/mlcdn/c45406/171024_2ihj94kl73541ebl9b3giii3476h4_100x100.png",         "expressUrl":"http://www.jdwl.com/",         "expressName":"京东快递",         "expressCode":"jd"     } ]
expressId String 是 物流ID
buyerAddressDTO Object 否 买家收货地址对象（比如发货时买家修改了地址）
province String 是 省
city String 是 市
area String 是 区
address String 是 详细地址
zip String 是 邮编
name String 是 收件人姓名
mobile String 是 收件人手机号
sellerReceiveAddressDTO Object 否 卖家收货地址对象,如果指定则退货到此地址；不指定则退货到店铺配置的地址
province String 是 省
city String 是 市
area String 是 区
address String 是 详细地址
zip String 是 邮编
name String 是 收件人姓名
mobile String 是 收件人手机号

返回参数

名称 类型 描述 默认值
status Object 状态描述
code String 状态码
msg String 状态提示
result Object 结果描述
data Object 结果内容
shipRetDTO Object 发货结果对象
hasConsignSucceed Boolean 是否发货成功，true-成功，fasle-失败
hasAllShiped Boolean 是否已全部发货，true-已全部发货，false-未全部发货

请求参数示例

1).
{
	"tradeOrderConsignReqDTO": {
		"shipType": "0",
		"itemOrderList": ["80215620050893"],
		"shopOrderId": "80215620040893",
		"expressCode": "yuantong",
		"expressId": "222221",
		"buyerAddressDTO": null
	}
}

返回示例

1).
{
	"status": {
		"code": "0000000",
		"msg": "操作成功"
	},
	"result": {
		"data": {
			"shipRetDTO": {
				"hasConsignSucceed": true,
				"hasAllShiped": true
			}
		}
	},
	"success": true
}

异常示例

常见问题

1).是否允许重复发货？
重复发货会提示错误“请勿重复发货”

API测试工具