API文档

wms.ErrorCorrection.queryWithDetail（纠错单查询)

¥标准

1.接口说明

1.1 接口描述：获取ERP纠错管理页面的数据

1.2 适用版本：客户端 V1.6.0.8及以上版本

1.3 增量获取：

1.4 时间跨度：

1.5注意事项：

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	http://47.92.239.46/openapi

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	key	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐	salt	String	是	由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称	method	String	是	调用的接口名称
版本号	v	String	是	1.0
秒级时间戳	timestamp	Int	是	秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名	sign	String	是	签名
分页大小	page_size	Int	否	分页大小，分页查询必传
分页编号	page_no	Int	否	分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数	calc_total	Int	否	是否计算查询结果的总条数, 需要计算则1, 否则填0

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
查询参数	params	Map<String, Object>		是	查询参数
分页	pager	Pager		是	分页

名称

字段

类型

长度

必须

描述

查询参数

params

Map<String, Object>

是

查询参数

分页

pager

Pager

是

分页

params

名称	字段	类型	长度	必须	描述
开始时间	start_time	String	40	是	纠错单修改时间格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	String	40	是	纠错单修改时间格式：yyyy-MM-dd HH:mm:ss
仓库编号	warehouse_no	String	40	否	仓库编号
纠错类型	type	tinyint	4	否	1:采购入库纠错
纠错单号	correction_no	String	40	否	传纠错单号的情况下，时间非必传
源单号	src_order_no	String	40	否	源单号

pager

名称	字段	类型	长度	必须	描述
分页大小	page_size	Int	4	否	分页大小
页号	page_no	Int	4	否	从0开始

4.响应参数

返回值为一个Map<String, Object>

名称	字段	类型	必须	描述
状态码	status	Int	是	状态码,0表示正常
错误信息	message	String	是	无错误信息不返回
单据信息	data	Map<String, Object>	是	单据信息

名称

字段

类型

长度

必须

描述

状态码

status

Int

是

状态码,0表示正常

错误信息

message

String

是

无错误信息不返回

单据信息

data

Map<String, Object>

是

单据信息

data

名称	字段	类型	长度	必须	描述
数据	result	List<Map<String, Object>>		是	明细数据
总数	total_count	Int	11	是	查询条件总单据数

名称

字段

类型

长度

必须

描述

数据

result

List<Map<String, Object>>

是

明细数据

总数

total_count

Int

是

查询条件总单据数

result

名称	字段	类型	长度	必须	描述
主键	rec_id	Int	11	是	主键
纠错单号	correction_no	String	40	是	纠错单号
纠错类型	type	tinyint	4	是	纠错类型
源单号	src_order_no	String	40	是	源单号
仓库名称	warehouse_name	String	64	是	仓库名称
业务单明细	detail_list	List<Map<String, Object>>		是	业务单明细

detail_list

名称	字段	类型	长度	必须	描述
主键id	rec_id	Int	11	是	主键
出入库类型	order_type	String	20	是	出入库类型
单号	order_no	String	40	是	生成的出入库单号
商家编码	spec_no	String	80	是	商家编码
货品名称	goods_name	String	255	是	货品名称
货品简称	short_name	String	255	是	货品简称
货品编号	goods_no	String	40	是	货品编号
规格名称	spec_name	String	100	是	规格名称
规格码	spec_code	String	40	是	规格码
条码	barcode	String	50	是	条码
是否残品	defect	bool	1	是	是否残品
数量	num	Decimal(19,4)		是	数量
正确数量	right_num	Decimal(19,4)		是	正确数量
批次	batch_no	String	40	是	批次
有效期	expire_date	String	40	是	有效期
生产日期	production_date	String	40	是	生产日期
备注	remark	String	255	是	备注

5.请求示例

json格式请求报文	[ { "start_time":"2025-11-17 13:00:59", "end_time": "2025-11-17 13:43:59", "warehouse_no":"dnew1", "type":1, "correction_no":"JC0105", "src_order_no":"RK2025111700018" } ]
PHP
JAVA
C#

6.响应示例

6.1 正常响应示例

JSON

{
    "status": 0,
    "data": {
        "result": [
            {
                "correction_no": "JC0105",
                "warehouse_name": "dnew1",
                "operator_id": 135,
                "created": "2025-11-17 13:43:59",
                "detail_list": [
                    {
                        "rec_id": 71,
                        "correction_id": 51,
                        "order_type": "纠错出库",
                        "order_no": "CK2025111721",
                        "num": 10.0000,
                        "right_num": 5.0000,
                        "defect": false,
                        "batch_no": "20251117000",
                        "expire_date": "",
                        "production_date": "",
                        "remark": "",
                        "goods_id": 1439,
                        "goods_name": "DFH毛衣",
                        "short_name": "DFH毛衣",
                        "goods_no": "DFH004",
                        "spec_code": "",
                        "spec_name": "",
                        "spec_no": "DFH004",
                        "barcode": "DFH004"
                    }
                ],
                "modified": "2025-11-17 13:43:59",
                "remark": "",
                "rec_id": 51,
                "type": 1,
                "src_order_no": "RK2025111700018",
                "warehouse_id": 885
            }
        ],
        "total_count": 1
    }
}

6.2 异常响应示例

JSON	{ "status": 100, "message": "参数中必须包含起止时间" }