无线打印

websocket测试

POST

请求地址/router

请求地址

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有： | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式，可选值：json | | version | string | 是 | API协议版本可选值：1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息（即access_token，由系统分配） |

请求头

参数名

类型

描述

必填

Content-Type

string

multipart/form-data

必填

API接口地址

参数名

类型

描述

必填

method

string

erp.print.wireless

必填

请求参数

参数名

类型

描述

必填

uniqueCode

string

唯一识别码

必填

printType

int

无线打印类型： 1快递单

必填

noCheck

boolean

是否跳过不校验

可选

checkTradeStatus

boolean

是否校验订单状态，默认true

可选

tradeParams

list

订单参数

必填

sid

long

系统订单号

必填

outSid

string

运单号指定单号重打的时候必填

可选

waybillType

int

运单类型，1 主单； 2 子单

必填

multiCount

int

加包数量

必填

reprint

int

rePrint=2表示一单多包第一次打印，其他情况都传 0

可选

请求示例

一单一包： ----------------- ```` { "uniqueCode": "100278583332749824", "printType": 1, "noCheck": true, "tradeParams": [ { "sid": 4309411179338339, "multiCount": 0, "waybillType": 1 } ] } ```` 一单多包： ----------------- ```` { "noCheck":true, "printType":1, "tradeParams":[ { "rePrint":2, "sid":4306557101632310, "waybillType":1 , "multiCount": 2 } ], "uniqueCode":"000140336565449216" } ````

响应参数

参数名

类型

描述

必填

success

boolean

示例：true

必填

trace_id

string

示例：3553483395407017

必填

响应示例

``` { "success": true, "trace_id": "long" } ```

异常示例

```` { "msg": "多发异常", "traceId": "2537991707062437375", "errorList": [ { "outSid": "K_538698344565248", "sid": 4309411179338339 } ], "success": true } ````

错误码解释

| 错误码 |错误信息| 子错误码 | 子错误信息 | 解决方案| |-|-|-|-|-| |50000|无线打印唯一识别码为空|检查请求参数uniqueCode| |50001|订单打印参数格式错误|检查请求参数tradeParams是否是jsonArray| |50002|订单打印sid为空|检查请求参数tradeParams是否有未设置sid的明细| |50002|未查询到订单信息|检查返回参数errorList中sid是否正确| |50002|订单非待打印快递单状态|检查返回参数errorList中sid是否待打印快递单状态| |50003|打印异常|500|多发异常| |50003|打印异常|501|必须开启多平台打印分组| |50003|打印异常|502|重复任务| |50003|打印异常|503|未查询到订单数据| |50003|打印异常|504|订单没有运单号| |50003|打印异常|505|订单没有模版| |50003|打印异常|506|获取单号失败|