订单发货拦截接口
接口描述
订单发货拦截接口(只能拦截待审核,待财审订单,将订单作废)
系统相关界面
"界面路径:【交易】----【订单发货】----【扫描发货】"
请求地址
环境 | 服务地址(HTTP/HTTPS) |
---|---|
V2正式环境(推荐) | https://gw.superboss.cc/router |
2022年4月1日以后申请的APP Key,统一使用V2正式环境的请求地址:https://gw.superboss.cc/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
application/x-www-form-urlencoded
必填
API接口地址
参数名
类型
描述
必填
method
string
erp.trade.send.goods.intercept
必填
请求参数
参数名
类型
描述
必填
sids
string
系统订单号,多个逗号隔开
必填
请求示例
示例一:
{
"sids":"1,2,3"
}
响应参数
参数名
类型
描述
必填
successIds
long [ ]
成功id集合
success
boolean
示例:true
trace_id
string
示例:3553483395407017
failedIds
long [ ]
失败id集合
响应示例
{
"successIds":[1,2],
"failedIds":[3],
"success": boolean,
"trace_id": "long"
}
异常示例
{
"code": "25",
"msg": "服务方法(erp.trade.send.goods.intercept:1.0)的签名无效",
"success": false,
"trace_id": "3553483395423660"
}
错误码解释
错误码 | 错误信息 | 解决方案 |
---|---|---|
30003 | 系统订单号不能为空 | 系统订单号不能为空 |
30004 | 系统订单号格式不正确 | 系统订单号格式不规范,请按规范填写 |
30005 | 系统订单号最多支持20组! | 请检查系统订单号是否超过20组 |
30006 | 订单发货拦截失败 | 请根据返回的错误信息进行处理 |