订单获取结果推送接口

用户提交订单获取任务的时候，使用到callbackUrl才会有获取结果推送。每条消息推送用户接收和保存成功后，应该返回这样的响应报文：{"result":true,"returnCode":200,"message":"成功"}，我方根据result等于true作为推送成功标识，其他均为推送失败。推送失败会隔半小时后重推，连续3次重推都失败则放弃该条消息的推送。任务列表中，每个任务查询失败，隔5分钟后重试，连续3次重试都失败则会终止查询并且推送一条queryStatus=Abort的消息告知用户。

parma数据结构

参数名称	数据类型	参数描述
taskId	string	任务ID
queryStatus	string	查询状态，Fail：查询失败；Empty：查无结果；Success：查询成功；Abort：终止，连续多次查询都失败
orders	array[object]	订单列表

orders数据结构

参数名称	数据类型	参数描述
shopType	string	店铺类型，若使用淘宝店铺，填入：TAOBAO
shopId	string	店铺ID
shopName	string	店铺名称
orderNum	string	店铺订单号
orderStatus	string	订单状态，UNPAY：未付款；UNSHIP：待发货（默认值）；SHIPED：等待卖家确认收货；FINISH：交易成功/完成；CLOSE：交易关闭/取消
receiverName	string	收件人姓名
receiverMobile	string	收件人手机号
receiverPhone	string	收件人电话号码
receiverProvince	string	收件人省份
receiverCity	string	收件人城市
receiverDistrict	string	收件人区县
receiverAddress	string	收件人详细地址
createAt	string	订单创建时间，格式：yyyy-MM-dd HH:mm:ss
updateAt	string	订单更新时间，格式：yyyy-MM-dd HH:mm:ss
payTime	string	支付时间，格式：yyyy-MM-dd HH:mm:ss
totalFee	number	商品金额
payment	number	实付金额
postFee	number	邮费
oaid	string	此字段用于淘宝接口解密
goodsList	array[object	商品信息列表

goodsList数据结构

参数名称	数据类型	参数描述
goodName	string	商品名称
goodCount	number	商品数量
goodPrice	number	商品价格
sku	string	sku外部编码
goodSpec	string	商品规格
goodPicPath	string	商品图片地址

3.5 查询无结果的回调param参数示例

{
    "taskId": "bb8122cb5a3f48c9be2724e7f3fb2813",
    "queryStatus": "Empty",
    "reason": "查询无结果",
    "orders": []
}

Copy

3.6 查询有记录的回调param参数示例

{
	"taskId": "3edfaa990f85494e9c02457c0c5311ef",
	"queryStatus": "Success",
	"orders": [{
			"shopType": "TAOBAO",
			"shopId": "413979111",
			"shopName": "百递云商城",
			"orderNum": "2225344358701466111",
			"orderStatus": "CLOSE",
			"receiverName": "魏**",
			"receiverMobile": "*******8333",
			"receiverProvince": "山东省",
			"receiverCity": "滨州市",
			"receiverDistrict": "滨城区",
			"createAt": "2021-11-03 15:00:27",
			"updateAt": "2021-11-12 16:11:53",
			"payTime": "2021-11-03 15:00:34",
			"totalFee": 428.00,
			"payment": 394.54,
			"postFee": 0.00,
			"oaid": "1nCBEibYKKvewXQ561QB1xTz74abVtmEHrYMa45WDhVOjfTnf0u4MOZYl4nKd235NuswGicxN",
			"goodsList": [{
				"goodName": "快递100云打印机 电商远程打印热敏打印机电子面单标签快递打单机",
				"goodCount": 1,
				"goodPrice": 428.00,
				"sku": "KD10020200324YDYJ21",
				"goodSpec": "套餐类型:官方标配;颜色分类:云打印机二代4寸 电脑WIFI两用[123联单通用]",
				"goodPicPath": "u:2225344358701466562_1"
			}]
		},
		{
			"shopType": "TAOBAO",
			"shopId": "413979377",
			"shopName": "百递云商城",
			"orderNum": "2072638327546571134",
			"orderStatus": "CLOSE",
			"receiverName": "潘**",
			"receiverMobile": "*******5124",
			"receiverProvince": "山东省",
			"receiverCity": "日照市",
			"receiverDistrict": "东港区",
			"createAt": "2021-11-02 15:22:05",
			"updateAt": "2021-11-12 16:11:35",
			"payTime": "2021-11-02 15:22:11",
			"totalFee": 389.00,
			"payment": 358.79,
			"postFee": 0.00,
			"oaid": "1zbwYrXC3GyRImh7umicJ234JnqqgDjeKEZzicPxz5UngzzeYEN0IJYTUX6fAJi1QcCcl4ngnk",
			"goodsList": [{
				"goodName": "快递100云打印机 电商远程打印热敏打印机电子面单标签快递打单机",
				"goodCount": 1,
				"goodPrice": 389.00,
				"sku": "KD10020200709SCYDYJ01",
				"goodSpec": "套餐类型:官方标配;颜色分类:云打印机二代3寸 电脑WIFI两用[一联单专用]",
				"goodPicPath": "u:2072638327546573112_1"
			}]
		}
	]


}

Copy

3.8 信息代码含义

信息代码	信息内容描述	原因及建议处理方式
200	成功	成功
101	请求格式错误	请求为post方式的application/x-www-form-urlencoded，而不是application/json，请勿用错格式提交参数
102	签名验证失败	32位大写，按MD5 (param + key + secret)的顺序进行MD5加密，不需要加上“+”号，secret在授权邮件里面有。注意加密的param参数值必须要和请求提交的param值一致（包括param里面属性字段的顺序）
103	缺少必填参数	根据文档补充必填参数的赋值
104	参数错误	根据文档修改参数值
401	KEY过期	没有可用单量，账号需要充值再使用
402	客户不存在	账号错误，请检查账号信息是否有误
500	系统繁忙，请稍后再试	快递100的服务器出现间歇或临时性异常，请联系快递100排查原因
60101	暂不支持该店铺类型	检查店铺类型是否填写有误
60102	店铺授权错误	获取店铺授权信息失败，请联系快递100排查原因
60103	店铺未授权，请授权后再调用	店铺未授权或者授权已过期，请重新授权
60104	店铺授权已过期，请重新授权后再调用	店铺授权已过期，请重新授权
60201	时间范围过大，请调整时间范围重试
60202	时间范围错误，请调整时间范围重试

application/json

Body

result

string

必需

提交结果。true表示成功，否则隔半小时重推，连续3次重推失败则放弃该消息推送

returnCode

number

返回编码

必需

message

string

返回报文描述

必需

订单获取结果推送接口

3.5 查询无结果的回调param参数示例

3.6 查询有记录的回调param参数示例

3.8 信息代码含义

请求参数

返回响应

订单获取结果推送接口

3.5 查询无结果的回调param参数示例#

3.6 查询有记录的回调param参数示例#

3.8 信息代码含义#

请求参数

返回响应

3.5 查询无结果的回调param参数示例

3.6 查询有记录的回调param参数示例

3.8 信息代码含义