文档

测试

订单唯一码收货

websocket测试

POST

请求地址/router

接口描述

订单唯一码收货

系统相关界面

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

请求地址

|环境|服务地址(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.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

修改时间

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}] } ```

异常示例

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

错误码解释

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

上一篇波次手动拣选

nextDoc 出库单查询