天心天思数字化API平台

批量查询【托工领料申请单】接口

概述

该接口主要用于第三方平台或自主研发者，需要通过日期、单号、部门批量查询ERP系统的单据时，则可调用该单据的批量查询接口，将Sunlike ERP或Online ERP系统中的批量单据信息查询到第三方平台中。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/MRPQL/BATCHDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
程序代号 PGM     是 MRPQ4  
申请单ID QL_ID string 2 是 Q4  
领料申请单号 QL_NO string 20     ERP的单号，可多张单号，加中括号[]，单号之间用豆号隔开，如”QL_NO”:[“Q411110001″,”Q411110002”]
日期类型 DATE_TYPE String 1 是   0表示单据日期，1表示制单日期，2表示终审日期，3修改日期
开始日期 START_DATE datetime       从开始日期开始查询单据，当单号为空时，日期必填
结束日期 END_DATE datetime       查询以结束日期截止的单据，当单号为空时，日期必填
单据部门 DEP string 8     多个部门，用中括号[]包住多个部门，以豆号隔开，不含下属部门，如”DEP”:[“01″,”02”]；单个部门，不用中括号，有含下属
排序 ORDER_BY         例如：“ORDER BY”:{“QL_NO”:”DESC”}

请求JSON示例

{
  "PGM":"MRPQ4",   //单据别
  "QL_ID":"Q4",
  "QL_NO":"",   //按单号查询，可多张单号，用豆号隔开
  "DATE_TYPE":0,        //0表示单据日期，1表示制单日期，2表示终审日期，3修改日期
  "START_DATE":"2022-07-01",  //查询的开始日期
  "END_DATE":"2022-07-31",   //查询的结束日期
  "DEP":"00000000",      //有[]表示多选，不含下属部门；没有[]表示单选且含下属
  "ORDER_BY":
  {"QL_NO":"DESC"
  }
}

返回结果示例

{
    "code": 0,              //0值表示执行成功，其他值则表示失败
    "message": "查询成功",
    "data": {
        "UP_DD": "2022-07-11 18:33:16",
        "TOTAL_NUM": 1,
        "BILL_LIST": [             //请求批量查询返回的单据明细信息
            {
                "MF_QL": [
                    {
                        "QL_ID": "Q4",
                        "QL_NO": "Q42207110001",
                        "QL_DD": "2022-07-11 00:00:00",
                        "QL_TYPE": "1",
                        "MO_NO": "MO2207110001",
                        "PRD_MARK": "",
                        "USR_NO": "001",
                        "DEP": "965",
                        "REM": "",
                        "CUS_NO": "CU0301",
                        "USR": "ADMIN",
                        "CHK_MAN": "ADMIN",
                        "PRT_SW": "N",
                        "CLS_DATE": "2022-07-11 18:33:16",
                        "BIL_TYPE": "",
                        "SYS_DATE": "2022-07-11 18:33:16",
                        "TZ_NO": "TW2207110001",
                        "APP_NAME_DATA": "ONLINE-API"
                    }
                ],
                "TF_QL": [
                    {
                        "QL_ID": "Q4",
                        "QL_NO": "Q42207110001",
                        "ITM": 1,
                        "QL_DD": "2022-07-11 00:00:00",
                        "QL_TYPE": "1",
                        "PRD_NO": "WDP004",
                        "PRD_NAME": "原色鼓芯",
                        "PRD_MARK": "",
                        "UNIT": "1",
                        "WH": "YH001",
                        "QTY": 1.00000000,
                        "BAT_NO": "",
                        "MO_NO": "MO2207110001",
                        "TZ_NO": "TW2207110001",
                        "BIL_ID": "TW",
                        "BIL_NO": "TW2207110001",
                        "PRE_ITM": 1,
                        "EST_ITM": 1,
                        "ZC_NO": "22",
                        "REM": ""
                    }
                ],
                "BILL_STATE": {
                    "READONLY": false,
                    "READONLY_REM": []
                }
            }
        ]
    }
}