跳到主要内容

入库申请单查询

| 基本信息​

信息值备注
接口名称入库申请单查询查询入库申请单列表
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/Wms/QueryInApplyBill向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/Wms/QueryInApplyBill远程模式向服务器地址发送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​

参数名称类型是否必须参数值备注其它信息
BilQueryCountint否100返回的最大单据数一次请求返回的最多是多少笔单据信息，注意是单据笔数不是记录数。最大返回数为100
UsrNostring否ADMIN操作员账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo
start_datestring否"2022-8-16"开始日期过滤单据生效时间>=该时间的单据数据，可精确到秒
end_datestring否"2023-8-16"结束日期过滤单据生效时间<=该时间的单据数据，可精确到秒
warehouse_codestring否0000,0001仓库过滤单据仓库包含该仓库的单据数据，支持多个，以(,英文逗号)隔开
request_idstring否PO,MO申请单据ID过滤单据ID包含该ID的单据数据，支持多个，以(,英文逗号)隔开
request_codestring否PO28160001,PO28160002申请单据号码过滤单据号码包含该号码的单据数据，支持多个，以(,英文逗号)隔开。支持模糊查询
not_generate_idstring否PC,MM入库单据ID过滤单据ID不包含该ID的入库单据数据，支持多个，以(,英文逗号)隔开
CloseIdstring否T是否结案'T'代表过滤结案；'F'代表过滤未结案。空代表过滤全部

| 返回数据​

参数名称类型参数值备注
CallOKstringT执行是否成功, 是:"T" 否:"F"
Dataobject"BillData": [],
"DataCount": 0		单据信息,JOSN格式
ErrorStrstring错误信息

| 调用范例​

BODY JSON​

无需赋值的字段不需要添加

{
    "BilQueryCount":100,                      //非必须,返回的最大单据笔数，注意不是记录数，最大为100                     
    "UsrNo":"ADMIN",                          //非必须,操作员                      
    "start_date":"2022-8-16",                 //非必须,开始日期              
    "end_date":"2023-8-16",                   //非必须,结束日期                
    "warehouse_code":"0000,0001",             //非必须,仓库,包含            
    "request_id":"PO,MO",                     //非必须,申请单据ID,包含                   
    "request_code":"PO28160001,PO28160002",   //非必须,申请单据号码,包含 
    "not_generate_id":"PC,MM",                //非必须,入库单据ID,不包含
    "CloseId":""                              //非必须,'T'代表过滤结案；'F'代表过滤未结案。空代表过滤全部
}

返回的JSON​

{
    "CallOK": "T",                            //执行是否成功, 是:"T" 否:"F"
    "Data": {                                 //单据信息,JOSN格式
        "BillData": [                         //申请单信息
            {
                "ref_id": "Enterpriser",                        //系统标识,T系列统一为Enterpriser
                "entry_order_date": "2022/10/20 0:00:00",       //申请单单据日期
                "order_type": "04",                             //WMS业务类型
                "request_id": "MO",                             //申请单单据ID
                "request_code": "MO2A200001",                   //申请单单据号码
                "request_itm": "0",                             //申请单PRD_ITM原单项次,表头项次为0
                "supplier_code": "111",                         //申请单厂商代号
                "supplier_name": "厂商11",                       //申请单厂商名称
                "department": "0000",                           //申请单部门代号
                "bill_type": "",                                //单据类别
                "expect_start_time": "",                        //预交日期
                "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": "",                             //申请单来源单单据ID
                "source_bilno": "",                             //申请单来源单单据号码
                "source_bilitm": "",                            //申请单来源单项次
                "generate_id": "MM"                             //对应入库单单据ID,用于后续产生ERP入库单
            }
        ],
        "DataCount": 1                           //返回的记录数
    },
    "ErrorStr": ""                               //错误信息
}

| 备注​

必须在Headers里面传入用户登录或账套验证的LoginId。

每次返回最大单据数为BilQueryCount，BilQueryCount为空则默认取100，一次请求返回的最多为多少笔单据信息，注意是单据笔数不是记录数，例如值为3，则按生效时间升序排序后前3张单据信息，一张单据信息可能对应多笔记录。

注意取的last_modified_date最近修改时间后，传入回调接口时应与取得时保持一样，不要作转换。用于判断申请单存不存在修改。

需要在ERP系统中的WMS配置界面处设置申请单类型，接口根据类型查询返回该类型单据作为申请单。