对接快递100快递管家API之云打印接口

236 阅读2分钟

1.功能描述

 用于在贵方系统发起打印操作,无须页面嵌套,方便快捷地进行快递单打印;调用此接口必须购买快递100云盒或云打印机;

2.接口信息

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

3.请求参数

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

data参数

名称类型(字符长度)是否必填描述
print_listString(500)接入方需要打印的订单编号列表,最多一次支持 20 个
订单打印,用英文逗号分隔。
例:O12345,O23456,O34567
siidString(50)云盒、云打印机的设备码,不传时,使用系统默
认配置(需在快递管家绑定快递 100 云盒或云打印机,
并启用“自动打印”功能)
express_companyString(30)快递公司编码,“订单信息导入接口”未传值时则
此处必填
service_typeString(30)业务类型,默认:标准快递

示例:

app_key=LeWFeuaGwdf&access_token=uoKbfafdfafcCce&timestamp=1502963129&sign=3CF35D130E8B197553ADE1BAEA2615F0&data={
    "print_list": "O12345,O23456,O34567",
    "express_company": "shunfeng"
}

4.返回参数

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

示例:

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

失败:
{
  "status": "401",
  "message": "打印机不在线"

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