申请单查询
| 基本信息
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 申请单查询 | 查询申请单列表,包含出入库 |
| 请求状态 | POST | RESTful方式 |
| 接口路径 | http://localhost:23798/api/Wms/QueryApplyBill | 向服务器地址发送POST请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/Wms/QueryApplyBill | 远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数 |
| 支持日期 | 2023-01-31 | 自该日期起支持 |
| 请求参数
Headers
| 参数名称 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|
| Content-Type | 是 | application/json | 用于指定数据的传输类型 |
| LoginId | 是 | e835943e-55c2-4bf0-832d-6f4166592941 | 用户登录的LoginId，取用户登录或账套验证接口返回的LoginId |
| sn | 否 | MGR_REST_1001 | 远程模式需添加sn参数，MGR_REST_ERP注册号 |
Body
| 参数名称 | 类型 | 是否必须 | 参数值 | 备注 | 其它信息 |
|---|---|---|---|---|---|
| BilQueryCount | number | 否 | 100 | 返回的最大单据数 | 一次请求返回的最多为多少笔单据信息，注意是单据笔数不是记录数。最大返回数为100 |
| UsrNo | string | 否 | ADMIN | 操作员 | 账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo |
| start_date | string | 否 | "2022-8-16" | 开始日期 | 过滤单据生效时间大于等于该时间的单据数据，可精确到秒 |
| end_date | string | 否 | "2023-8-16" | 结束日期 | 过滤单据生效时间小于等于该时间的单据数据，可精确到秒 |
| warehouse_code | string | 否 | 0000,0001 | 仓库 | 过滤单据仓库包含该仓库的单据数据，支持多个，以(,英文逗号)隔开 |
| request_id | string | 否 | CK,MO | 申请单据ID | 过滤单据ID包含该ID的单据数据，支持多个，以(,英文逗号)隔开 |
| request_code | string | 否 | CK28160001,CK28160002 | 申请单据号码 | 过滤单据号码包含该号码的单据数据，支持多个，以(,英文逗号)隔开。支持模糊查询 |
| not_generate_id | string | 否 | SA,ML | 出入库单据ID | 过滤单据ID不包含该ID的出入库单据数据，支持多个，以(,英文逗号)隔开 |
| CloseId | string | 否 | T | 是否结案 | 'T'代表过滤结案；'F'代表过滤未结案。空代表过滤全部 |
| 返回数据
| 参数名称 | 类型 | 参数值 | 备注 |
|---|---|---|---|
| CallOK | string | T | 执行是否成功, 是:"T" 否:"F" |
| Data | object | "BillData": [], "DataCount": 0 | 单据信息，json格式 |
| ErrorStr | string | 错误信息 |
| 调用范例
Request
无需赋值的字段不需要添加
{
"BilQueryCount":100, // 非必须，返回的最大单据笔数，注意不是记录数，最大为100
"UsrNo":"ADMIN", // 非必须，操作员
"start_date":"2022-8-16", // 非必须，开始日期
"end_date":"2023-8-16", // 非必须，结束日期
"warehouse_code":"0000,0001", // 非必须，仓库，包含
"request_id":"CK,MO", // 非必须，申请单据ID，包含
"request_code":"CK28160001,CK28160002", // 非必须，申请单据号码，包含
"not_generate_id":"SA,ML", // 非必须，目标单据ID，不包含
"CloseId":"" // 非必须，'T'代表过滤结案；'F'代表过滤未结案。空代表过滤全部
}
Response
{
"CallOK": "T", // 执行是否成功，是:"T" 否:"F"
"Data": { // 单据信息，json格式
"BillData": [ // 申请单信息
{
"ref_id": "Enterpriser", // 系统标识，T系列统一为Enterpriser
"drt_id": "-1", // 出入库标识，1为入库，-1为出库
"order_date": "2022/10/20 0:00:00", // 申请单单据日期
"order_type": "01", // WMS业务类型
"request_id": "CK", // 申请单单据ID
"request_code": "CK2A200001", // 申请单单据号码
"request_itm": "1", // 申请单PRD_ITM原单项次，表头项次为0
"cus_no": "111", // 申请单客户代号
"cus_name": "客户11", // 申请单客户名称
"department": "0000", // 申请单部门代号
"bill_type": "", // 单据类别
"schedule_date": "", // 预交日期
"operator_code": "ADMIN", // 制单人
"operate_time": "2022/10/20 12:12:23", // 制单时间
"last_modified_date": "2022/10/20 12:12:23", // 最近修改时间。回调接口时，该时间值要保持不变的返回回调接口，不要作转换
"item_code": "0033", // 货品代号
"item_name": "成品03", // 货品名称
"sku_property": "", // 货品特征
"batch_code": "", // 批号
"warehouse_code": "0000", // 申请出库仓库
"qty": "1.00000000", // 申请主单位数量
"qty1": "0.00000000", // 申请副数量
"source_bilid": "SO", // 申请单来源单单据ID
"source_bilno": "SO2A200001", // 申请单来源单单据号码
"source_bilitm": "1", // 申请单来源单项次
"generate_id": "SA" // 对应出入库单单据ID，用于后续产生ERP出库单
}
],
"DataCount": 1 // 返回的记录数
},
"ErrorStr": "" // 错误信息
}
| 备注
- 必须在Headers里面传入用户登录或账套验证的
LoginId。 - 每次返回最大单据数为
BilQueryCount，BilQueryCount为空则默认取100，一次请求返回的最多为多少笔单据信息，注意是单据笔数不是记录数，例如值为3，则按生效时间升序排序后前3张单据信息，一张单据信息可能对应多笔记录。 - 注意取的
last_modified_date最近修改时间后，传入回调接口时应与取得时保持一样，不要作转换。用于判断申请单存不存在修改。 - 需要在ERP系统中的WMS配置界面处设置申请单类型，接口根据类型查询返回该类型单据作为申请单。