跳到主要内容

包装验货

接口描述​

参数运单号与订单号需要传其中一个,如果都传的情况,以运单号为准,有强唯一码商品的订单,验货需要传入快麦系统生成的唯一码对应!

系统相关界面​

"界面路径：【交易】----【包装验货】"

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境（推荐）https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即access_token，由系统分配）

请求头​

全部展开
参数名
类型
描述
必填
Content-Type
string
multipart/form-data
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
erp.trade.pack
必填

请求参数​

全部展开
参数名
类型
描述
必填
uniqueCodes
string
唯一码信息,逗号隔开
sid
string
系统订单号
orderIdIdentCodes
string
子订单与识别码的对应参数
orderScanInfos
string
包装验货扫描信息(json字符串)例如:[{"scanCode":"abc", "num":1},{"scanCode":"def", "num":3}]
canForce
boolean
是否支持强制 支持true/不支持false
必填
outSid
string
运单号

请求示例​

示例一：

{
    "uniqueCodes": "032131231,04324232534";
    "packmaOuterIds": "string";
    "staffId": number;
    "orderScanInfos": "string";
    "sid": string;
    "orderIdIdentCodes": string;
    "canForce": true;
}

响应参数​

全部展开
参数名
类型
描述
必填
success
boolean
示例：true
trace_id
string
示例：3553483395407017

响应示例​

{
    "success": boolean,
    "trace_id": "long"
}

异常示例​

{
    "code": "25",
    "msg": "服务方法(erp.trade.pack:1.0)的签名无效",
    "success": false,
    "trace_id": "3553483395423660"
}

错误码解释​

错误码错误信息解决方案
30000扫描数量不规范，不能小于0扫描数量不规范，不能小于0
30001扫码类型不规范，请按规范填写扫码类型不规范，请按规范填写
30002包装验货失败请根据返回的错误信息进行处理