波次信息查询

websocket测试

POST

https://gw.kuaimai.com/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

multipart/form-data

必填

API接口地址

参数名

类型

描述

必填

method

string

erp.trade.waves.query

必填

请求参数

参数名

类型

描述

必填

pageNo

int

页码

可选

pageSize

int

页数, 默认20

可选

start

string

创建开始时间格式:yyyy-MM-dd HH:mm:ss

可选

end

string

创建结束时间格式:yyyy-MM-dd HH:mm:ss

可选

pickStartTime

string

拣选完成开始时间格式:yyyy-MM-dd HH:mm:ss

可选

pickEndTime

string

拣选完成结束时间格式:yyyy-MM-dd HH:mm:ss

可选

status

int

波次状态 1 未完成 3已完成 4已取消

可选

请求示例

示例一：


{
  "outerId":"string"
}

示例二：


{
  "sysItemId":long
}

响应参数

参数名

类型

描述

必填

traceId

string

链路id

必填

list

array

波次数据列表

必填

tradesCount

int

订单数量

必填

code

string

波次号

必填

warehouseId

int

仓库id

必填

int

波次id

必填

list

array

订单列表

必填

sid

int

系统单号

必填

positionNo

int

位置号

必填

tradeWaveStatus

int

波次订单状态 0：未完结，1：已完结，2：已剔出

必填

waveId

int

波次号

必填

status

int

波次状态 1 未完成 3已完成 4已取消

必填

itemCount

int

商品数量

必填

pickEndTime

long

拣选完成时间

必填

total

int

总数

必填

success

boolean

示例：true

必填

响应示例


{
    "traceId": "2477213974865246250",
    "list": [
        {
            "tradesCount": 2,
            "code": "2428",
            "warehouseId": 69936,
            "id": 2428,
            "list": [
                {
                    "sid": 3743020828089104,
                    "matchedStatus": 0,
                    "packStaffId": 0,
                    "positionNo": 1,
                    "id": 235995,
                    "tradeWaveStatus": 0,
                    "waveId": 2428,
                    "packTime": 946656000000,
                    "printTimes": 0
                },
                {
                    "sid": 3752942399761523,
                    "matchedStatus": 0,
                    "packStaffId": 0,
                    "positionNo": 2,
                    "id": 235996,
                    "tradeWaveStatus": 0,
                    "waveId": 2428,
                    "packTime": 946656000000,
                    "printTimes": 0
                }
            ],
            "status": 1,
            "itemCount": 2
        }
    ],
    "total": 8,
    "success": true
}

异常示例


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

错误码解释

错误码	错误信息	解决方案
content1	content2	content3