当前位置: API文档
purchase.StockInPreOrder.search(预约入库单查询)
¥标准
1.接口说明
1.1 接口描述:分页查询 |
1.2 适用版本:客户端 V1.5.1,9及以上版本 |
1.3 增量获取:支持 |
1.4 时间跨度:start_time和end_time最大跨度为7天 |
1.5注意事项: |
2.调用场景
2.1 举例说明:财务系统、SAP、线下ERP、数据分析等系统的对接 |
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/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
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
开始时间 | start_time | String | 40 | N | 最后修改时间 不传入单号的情况下必须传入时间条件, 时间范围最大7天 |
结束时间 | end_time | String | 40 | N | 最后修改时间 不传入单号的情况下必须传入时间条件, 时间范围最大7天 |
预约单单号 | pre_order_no | String | N | 预约单单号 |
pager
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
分页大小 | page_size | Int | 4 | 否 | 分页大小 |
页号 | page_no | Int | 4 | 否 | 从0开始 |
4.响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | 是 | 状态码,0表示调用成功 | |
错误信息 | message | String | 是 | 无错误信息不返回 | |
返回信息 | data | <Map<String, Object>> | 是 | 返回信息 |
data
响应参数说明示例值或者格式、具体含义、使用方法及注意事项
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
总条数 | total_count | Int | 是 | 总条数 | |
数据节点 | order_list | List<Map<String, Object>> | 是 | 数据节点 |
order_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
预约单id | pre_order_id | int | Y | 预约单id | |
预约单号 | pre_order_no | String | Y | 预约单号 | |
业务单号 | busi_order_no | String | Y | 业务单号 | |
业务单类型 | busi_order_type | Byte | Y | 1:采购单 2:调拨单 3:其他入库业务单 4:生产单 | |
车牌号 | car_number | String | Y | 车牌号 | |
审核时间 | check_time | String | Y | 审核时间 | |
创建时间 | created | String | Y | 创建时间 | |
派送人员 | deliver_name | String | Y | 派送人员 | |
预计派送时间 | deliver_time | String | Y | 预计派送时间 | |
标记名称 | flag_time | String | Y | 标记名称 | |
最后修改时间 | modified | String | Y | 最后修改时间 | |
供应商名称 | provider_name | String | Y | 供应商名称 | |
状态 | status | Byte | Y | 10:已取消 20:待审核 30:已审核 40:已驳回 50:已完成 | |
联系电话 | telno | String | Y | 联系电话 | |
仓库名称 | warehouse_name | String | Y | 仓库名称 | |
仓库编号 | warehouse_no | String | Y | 仓库编号 | |
仓库id | warehouse_id | String | Y | 仓库id | |
预约单明细 | detail_List | List<Map<String,Object>> | Y | 预约单明细 |
detail_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
预约单明细唯一键 | rec_id | int | Y | 预约单明细唯一键 | |
辅助数量 | aux_num | Decimal(19,4) | Y | 辅助数量 | |
条码 | barcode | String | Y | 条码 | |
基本单位 | base_unit_name | String | Y | 基本单位 | |
批次号 | batch_no | String | Y | 批次号 | |
品牌名称 | brand_name | String | Y | 品牌名称 | |
分类名称 | class_name | String | Y | 分类名称 | |
有效期 | expire_date | String | Y | 有效期 | |
货品名称 | goods_name | String | Y | 货品名称 | |
货品编号 | goods_no | String | Y | 货品编号 | |
数量 | num | Decimal(19.4) | Y | 数量 | |
供应商货品编号 | provider_goods_no | String | Y | 供应商货品编号 | |
规格名称 | spec_name | String | Y | 规格名称 | |
商家编码 | spec_no | String | Y | 商家编码 | |
辅助单位名称 | unit_name | String | Y | 辅助单位名称 |
5.请求示例
[ { "end_time": "2024-04-27", "start_time": "2024-04-20" } ] | |
<?php header("Content-Type: text/html; charset=UTF-8"); date_default_timezone_set("Asia/Shanghai"); $client = new WdtErpClient("url", "wdtapi3", "appkey", "secret") $params = new stdClass(); $params->start_time = '2022-07-15 11:42:56'; $params->end_time = '2022-07-19 11:42:56'; $pager = new Pager(1, 0, true); $data = $client->pageCall("purchase.StockInPreOrder.search", $pager, $parMap); | |
JAVA | |
C# |
6.响应示例
6.1 正常响应示例
{ "data": { "order_list": [ { "busi_order_no": "QR3306", "busi_order_type": 3, "car_number": "", "check_time": "2024-04-28 09:52:46", "created": "2024-04-15 20:23:43", "deliver_name": "", "deliver_time": "2024-04-18 00:00:00", "detail_list": [ { "aux_num": 1.0, "barcode": "all1", "base_unit_id": 3, "base_unit_name": "m箱", "batch_id": 0, "batch_no": null, "brand_id": 5, "brand_name": "1", "class_id": 0, "class_name": "无", "expire_date": null, "goods_name": "原味酸奶", "goods_no": "sn1", "num": 1.0, "pre_order_id": 5, "provider_goods_no": null, "rec_id": 11, "spec_name": "阿拉蕾11号", "spec_no": "all1", "unit_id": 50, "unit_name": "g43" }, { "aux_num": 3.0, "barcode": "all1", "base_unit_id": 3, "base_unit_name": "m箱", "batch_id": 0, "batch_no": null, "brand_id": 5, "brand_name": "1", "class_id": 0, "class_name": "无", "expire_date": null, "goods_name": "原味酸奶", "goods_no": "sn1", "num": 3.0, "pre_order_id": 5, "provider_goods_no": null, "rec_id": 13, "spec_name": "阿拉蕾11号", "spec_no": "all1", "unit_id": 50, "unit_name": "g43" }, { "aux_num": 2.0, "barcode": "all2", "base_unit_id": 3, "base_unit_name": "m箱", "batch_id": 0, "batch_no": null, "brand_id": null, "brand_name": "无", "class_id": null, "class_name": "无", "expire_date": null, "goods_name": null, "goods_no": null, "num": 2.0, "pre_order_id": 5, "provider_goods_no": null, "rec_id": 12, "spec_name": "阿拉蕾12号", "spec_no": "all2", "unit_id": 50, "unit_name": "g43" }, { "aux_num": 1.0, "barcode": "BC23091905", "base_unit_id": 0, "base_unit_name": "无", "batch_id": 0, "batch_no": null, "brand_id": null, "brand_name": "无", "class_id": null, "class_name": "无", "expire_date": null, "goods_name": null, "goods_no": null, "num": 1.0, "pre_order_id": 5, "provider_goods_no": null, "rec_id": 8, "spec_name": "蓝白条", "spec_no": "daj-sn2BW", "unit_id": 0, "unit_name": "无" }, { "aux_num": 1.0, "barcode": "", "base_unit_id": 0, "base_unit_name": "无", "batch_id": 0, "batch_no": null, "brand_id": null, "brand_name": "无", "class_id": null, "class_name": "无", "expire_date": null, "goods_name": null, "goods_no": null, "num": 1.0, "pre_order_id": 5, "provider_goods_no": null, "rec_id": 9, "spec_name": "", "spec_no": "62901", "unit_id": 0, "unit_name": "无" }, { "aux_num": 2.0, "barcode": "", "base_unit_id": 0, "base_unit_name": "无", "batch_id": 0, "batch_no": null, "brand_id": null, "brand_name": "无", "class_id": null, "class_name": "无", "expire_date": null, "goods_name": null, "goods_no": null, "num": 2.0, "pre_order_id": 5, "provider_goods_no": null, "rec_id": 10, "spec_name": "默认规格", "spec_no": "62903", "unit_id": 0, "unit_name": "无" } ], "flag_id": 0, "flag_name": "无", "modified": "2024-04-28 09:52:45", "pre_order_id": 5, "pre_order_no": "YD202404150009", "provider_id": 0, "status": 30, "telno": "" } ], "total_count": 30 }, "status": 0 } |
6.2 异常响应示例
{ "message": "未知错误1", "status": 5 } |