出库申请单查询
| 基本信息
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 出库申请单查询 | 查询出库申请单列表 |
| 请求状态 | POST | RESTful方式 |
| 接口路径 | http://localhost:23798/api/Wms/QueryOutApplyBill | 向服务器地址发送POST请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/Wms/QueryOutApplyBill | 远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数 |
| 请求参数
Headers
| 参数名称 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|
| Content-Type | 是 | application/json | 用于指定数据的传输类型 |
| LoginId | 是 | e835943e-55c2-4bf0-832d-6f4166592941 | 用户登录的LoginId，取用户登录或账套验证接口返回的LoginId |
| sn | 否 | MGR_REST_1001 | 远程模式需添加sn参数，MGRREST+ERP注册号 |
Body
| 参数名称 | 类型 | 是否必须 | 参数值 | 备注 | 其它信息 |
|---|---|---|---|---|---|
| BilQueryCount | int | 否 | 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 | 单据信息,JOSN格式 |
| ErrorStr | string | 错误信息 |
| 调用范例
BODY JSON
无需赋值的字段不需要添加
{
"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'代表过滤未结案。空代表过滤全部
}
返回的JSON
{
"CallOK": "T", //执行是否成功, 是:"T" 否:"F"
"Data": { //单据信息,JOSN格式
"BillData": [ //申请单信息
{
"ref_id": "Enterpriser", //系统标识,T系列统一为Enterpriser
"delivery_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配置界面处设置申请单类型，接口根据类型查询返回该类型单据作为申请单。