批量查询【制程生产验收单】接口

概述

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

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
程序代号 PGM     MRPBO  
单据别(TI) TY_NO string 2 TQ  
送检单号 TY_NO string 20     ERP的单号,可多张单号,加中括号[],单号之间用豆号隔开,如”TY_NO”:[“PR11110001″,”PR11110002”]
日期类型 DATE_TYPE String 1   0表示单据日期,1表示制单日期,2表示终审日期,3修改日期
开始日期 START_DATE datetime       从开始日期开始查询单据,当单号为空时,日期必填
结束日期 END_DATE datetime       查询以结束日期截止的单据,当单号为空时,日期必填
单据部门 DEP string 8     多个部门,用中括号[]包住多个部门,以豆号隔开,不含下属部门,如”DEP”:[“01″,”02”];单个部门,不用中括号,有含下属
排序 ORDER_BY         例如:“ORDER BY”:{“TY_NO”:”DESC”}

请求JSON示例

{
  "PGM":"MRPBO",   //程序代号
  "TY_ID":"TQ",    //单据别,但若单据无单据别,该参数可不用
  "TY_NO":"",   //按单号查询,可多张单号,加中括号[],单号之间用豆号隔开
  "DATE_TYPE":0,        //0表示单据日期,1表示制单日期,2表示终审日期,3修改日期
  "START_DATE":"2021-01-01",  //查询的开始日期
  "END_DATE":"2021-12-31",   //查询的结束日期
  "DEP":"00000000",      //有[]表示多选,不含下属部门;没有[]表示单选且含下属
  "ORDER_BY":{        //排序规则
      "TY_NO":"DESC"   //DESC表示降序排序
  }
}

返回结果示例

{
    "code": 0,     //为0表示成功,否则为失败
    "message": "查询成功",
    "data": {
        "UP_DD": "2021-12-28 19:10:37",     //本次查询单据的最大日期
        "TOTAL_NUM": 1,       //本次查询单据的总单量,每次查询最大返回5000笔
        "DEFINE_INFO": {},
        "BILL_LIST": [        //本次查询单据的明细信息
            {
                "MF_TY": [
                    {
                        "TY_ID": "TQ",
                        "TY_NO": "TQ1C280001",
                        "TY_DD": "2021-12-28 00:00:00",
                        "TI_NO": "TQ1C280001",
                        "USR": "ADMIN",
                        "CHK_MAN": "ADMIN",
                        "PRT_SW": "N",
                        "PRE_CLS_ID": "F",
                        "CLS_DATE": "2021-12-28 00:00:00",
                        "DEP": "00000000",
                        "SYS_DATE": "2021-12-28 19:10:37",
                        "CLS_ID_OK": "F",
                        "CLS_ID_LOST": "F",
                        "CHK_KND": "1",
                        "APP_NAME_DATA": "ONLINE-API"
                    }
                ],
                "TF_TY": [
                    {
                        "TY_ID": "TQ",
                        "TY_NO": "TQ1C280001",
                        "ITM": 1,
                        "PRD_NO": "1003",
                        "PRD_NAME": "1003成品",
                        "PRD_MARK": "",
                        "WH": "00000000",
                        "UNIT": "1",
                        "QTY_CHK": 10.00000000,
                        "QTY_OK": 8.00000000,
                        "QTY_LOST": 2.00000000,
                        "BIL_NO": "TZ1C280001",
                        "TI_NO": "T51C280001",
                        "MO_NO": "MO1C280001",
                        "SPC_NO": "01",
                        "PRC_ID": "5",
                        "BUILD_BIL": "",
                        "BUILD_BIL_ID": "",
                        "EST_ITM": 1,
                        "PRE_ITM": 1,
                        "QTY_PRE": 0.00000000,
                        "ZC_NO": "01",
                        "ID_NO": "1003->AAA",
                        "QTY1_CHK": 20.00000000,
                        "QTY1_OK": 16.00000000,
                        "QTY1_LOST": 4.00000000,
                        "TI_ITM": 1,
                        "QTY_LOST_RTN": 0.00000000,
                        "QTY1_LOST_RTN": 0.00000000,
                        "QTY1_PRE": 0.00000000
                    }
                ],
                "BILL_STATE": {
                    "READONLY": false,
                    "READONLY_REM": []
                }
            }
        ]
    }
}