对接快递100快递管家API之订单信息修改接口

105 阅读2分钟

订单信息修改

1.功能描述

 用于修改导入成功未打印的订单信息;不支持批量导入需逐一提交;

2.接口信息

请求地址b.kuaidi100.com/v7/open/api…
通信协议HTTPS
请求方式POST
字符集UTF-8
请求Conent-Typeapplication/x-www-form-urlencoded

3.接口规则

  1. 未打印前的订单可通过此接口进行修改,已打印产生快递单号的订单,不支持修改;
  2. “订单信息修改接口”的请求参数同“订单信息导入接口”,提交修改请求时,只需传入对应的“order_number”及需要修改的信息即可;

4.请求参数

名称类型是否必填描述
app_keyString由快递100提供,接入应用的唯一标识
([快递管家官网API服务],管理中的App Key)
access_tokenString授权注册时获取的access_token(访问令牌)
timestamplong时间戳,自1970年01月01日起到现在的秒数,
例: 1502963129
signString签名,签名算法参照【签名说明】
dataStringJson字符串,贵方的订单信息数据

data参数

​ 同"订单信息导入接口"data参数

示例:

app_key=LeWFeuaGwdf&access_token=uoKbfafdfafcCce&timestamp=1502963129&sign=3CF35D130E8B197553ADE1BAEA2615F0&data={
	"receiver":{
       "company": "金蝶集团",
	   "mobile": "13888885555",
	   "name": "刘生",
	   "addr": "安徽亳州涡阳县牌坊镇陈兰大药房"
	   },
	"order_number": "ord123456"
}

5.返回参数

名称类型(字符长度)是否必填描述
statusString(5)200:成功401:失败
messageString(30)成功/失败原因

示例:

成功:
{
  "status": "200",
  "message": "success"
}

失败:
{
  "status": "401",
  "message": "签名方式有误"

6.接口异步回调信息

​ 请求的Content-Type:application/json;charset=UTF-8

6.1.请求参数

名称类型(字符长度)是否必填描述
app_keyString由快递100提供,接入应用的唯一标识
([快递管家官网API服务],管理中的App Key)
timestamplong时间戳,自1970年01月01日起到现在的秒数,
例: 1502963129
typeString回调接口推送类型,固定为:UPDATE_SEND
signString签名,签名算法参照【签名说明】
dataStringJson字符串
└order_numberString(30)订单编号
└statusString(5)200:成功
401:失败
└messageString(30)成功/失败原因

示例:

成功:
{
	"app_key": "LeWFeuaGwx1v",
	"data":{
        "order_number":"ORD123456",
        "status": "200",
        "message": "success"
        },
	"type": "UPDATE_SEND",
	"timestamp": 1596100607
}

失败:
{
	"app_key": "LeWFeuaGwx1v",
	"data": {
        "order_number":"ORD123456",
        "status": "401",
        "message": "订单不存在"
        },
	"type": "UPDATE_SEND",
	"timestamp": 1596100607
}

6.2.返回参数

名称类型(字符长度)是否必填描述
statusString(5)200:成功
400:失败

示例:

成功:
{“status”:200}
失败:
{“status”:400}

接口源地址:www.kuaidi100.com/ecommerce/a…