跳到主要内容

订单唯一码收货

系统相关界面​

"界面路径：【交易】----【验货出库/到货扫描】"

请求地址​

环境服务地址(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
application/x-www-form-urlencoded
必填

API接口地址​

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

请求参数​

全部展开
参数名
类型
描述
必填
uniqueCode
string
唯一码号
必填

请求示例​

示例一：

{
  "uniqueCode":"string"
}

响应参数​

全部展开
参数名
类型
描述
必填
uniqueCodeVO
object
uniqueCodeVO
sysSkuId
long
系统商品skuID（注意，纯商品是-1）
uniqueCode
string
唯一码
codeType
string
默认0；1（单）；2（多）；3（备）
orderId
long
商品子订单ID
sysItemId
long
系统主商品ID
refundStatus
string
WAIT_SELLER_AGREE --待卖家同意退款 WAIT_BUYER_RETURN_GOODS--待买家退货 WAIT_SELLER_CONFIRM_GOODS--待卖家确认收货 SELLER_REFUSE_BUYER--卖家同意退款 CLOSED--退款关闭 SUCCESS--退款成功 NO_REFUND--未退款
outerId
string
平台商家编码
positionNo
string
分拣货位
positionStockRegion
string
分拣库区
printTime
long
打印时间
sid
long
系统订单号
status
integer
唯一码状态 1-等待采购, 2-等待拣选, 3-已拣选, 4-等待收货, 5-已收货, 6-已出库, 7-已取消, 8-已下架, 9-已出库未收货, 10-待入库, 11-在库, 12-已作废, 13-已验货唯一码状态 1-等待采购, 2-等待拣选, 3-已拣选, 4-等待收货, 5-已收货, 6-已出库, 7-已取消, 8-已下架, 9-已出库未收货, 10-待入库, 11-在库, 12-已作废, 13-已验货, 14-已退回, 15-已采退
created
long
创建时间
必填
modified
long
修改时间
必填
isExcep
integer
订单异常状态 0-无异常, 1-有异常
exceptions
array
系统异常标签
exceptNames
array
自定义异常
success
boolean
示例：true
trace_id
string
示例：3553483395407017

响应示例​

{
   "uniqueCodeVO":[{    
    "sysSkuId": long,
    "uniqueCode": "string",
    "codeType": "number",
    "orderId": long,
    "sysItemId": long,
    "refundStatus": "string",
    "outerId": "string",
    "positionNo": "string",
    "positionStockRegion": "string",
    "printTime": long,
    "sid": long,
    "status": integer,
    "created": long,
    "modified": long,
    "isExcep": integer,
    "exceptions": [string, string],
    "exceptNames": [string, string]
    }]
}

异常示例​

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

错误码解释​

错误码错误信息解决方案
30007唯一码号不能为空请检查该参数是否有值
30008订单唯一码收货失败请根据返回的错误信息进行处理