批量查询【采购单】接口
概述
该接口主要用于第三方平台或自主研发者，需要通过日期、单号、部门批量查询ERP系统的单据时，则可调用该单据的批量查询接口，将Sunlike ERP或Online ERP系统中的批量单据信息查询到第三方平台中。
参数说明
请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/DRPPO/BATCHDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 程序代号 | PGM | 是 | DRPPO | |||
| 单据别 | OS_ID | String | 2 | 是 | PO | |
| 单据号码 | OS_NO | String | 20 | ERP的单据号码，可多张单号，加中括号[]，单号之间用豆号隔开，如”OS_NO”:[“PO11110001″,”PO11110002”] | ||
| 单据日期类型 | DATE_TYPE | String | 1 | 是 | 0表示单据日期，1表示制单日期，2表示终审日期，3修改日期 | |
| 开始日期 | START_DATE | datetime | 从开始日期开始查询单据，当单号为空时，日期必填 | |||
| 结束日期 | END_DATE | datetime | 查询以结束日期截止的单据，当单号为空时，日期必填 | |||
| 单据部门 | PO_DEP | string | 8 | 多个部门，用中括号[]包住多个部门，以豆号隔开，不含下属部门，如”DEP”:[“01″,”02”]；单个部门，不用中括号，有含下属 | ||
| 排序 | ORDER_BY | 例如： “ORDER BY”:{“OS_NO”:”DESC”, “CUS_NO”:”ASC”} |
请求JSON示例
{
"PGM":"DRPPO", //程序代号
"OS_ID":"PO", //单据别，但若单据无单据别，该参数可不用
"OS_NO":"", //按单号查询，可多张单号，加中括号[]，单号之间用豆号隔开
"DATE_TYPE":0, //0表示单据日期，1表示制单日期，2表示终审日期，3修改日期
"START_DATE":"2021-01-01", //查询的开始日期
"END_DATE":"2021-01-31", //查询的结束日期
"PO_DEP":"00000000", //有[]表示多选，不含下属部门；没有[]表示单选且含下属
"ORDER_BY":{ //排序规则
"OS_NO":"DESC", //DESC表示降序排序
"CUS_NO":"ASC" //ASC表示升序排序
}
}
返回结果示例
{
"code": 0, //本次返回单据中最大的单据日期
"message": "查询成功",
"data": {
"UP_DD": "2021-01-18 18:51:13", //本次查询的单号总数量，每次最大返回单号数为5000笔
"TOTAL_NUM": 2, //本次查询的单号总数量，每次最大返回单号数为5000笔
"BILL_LIST": [ //返回的批量单据明细，含单据表头表身
{
"MF_POS": [
{
"OS_ID": "PO",
"OS_NO": "PO11180002",
"OS_DD": "2021-01-18 00:00:00",
"CUS_NO": "1001",
"SAL_NO": "10001",
"EST_DD": "2021-01-18 00:00:00",
"TAX_ID": "2",
"BIL_TYPE": "",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2021-02-01;票据到期日:2021-03-01",
"SEND_MTH": "1",
"DIS_CNT": 0.00000000,
"PO_DEP": "0101",
"PAY_DD": "2021-02-01 00:00:00",
"CHK_DD": "2021-03-01 00:00:00",
"INT_DAYS": 30,
"USR": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2021-01-18 00:00:00",
"CHK_MAN": "ADMIN",
"EXC_RTO": 1.00000000,
"TOT_QTY": 15.00000000,
"SYS_DATE": "2021-01-18 18:51:13",
"HS_ID": "F",
"HIS_PRICE": "T",
"PRE_ID": "F",
"BIL_COUNT": 0,
"BIL_FILE_COUNT": 0
}
],
"TF_POS": [
{
"OS_ID": "PO",
"OS_NO": "PO11180002",
"ITM": 1,
"PRD_NO": "00001",
"PRD_NAME": "00001货品",
"PRD_MARK": "",
"WH": "A000",
"UNIT": "1",
"QTY": 15.00000000,
"UP": 1.00000000,
"AMT": 15.00000000,
"AMTN": 14.29000000,
"TAX_RTO": 5.00000000,
"TAX": 0.71000000,
"PRE_ITM": 1,
"EST_DD": "2021-01-18 00:00:00",
"CST_STD": 0.00000000,
"QTY_RK": 15.00000000,
"OS_DD": "2021-01-18 00:00:00",
"QTY_YS": 15.00000000,
"EST_ITM": 1,
"CUS_OS_NO": "",
"UNCFM_ID": "F",
"GROUP_DEP": "",
"CUS_NO": "1001",
"SCM_USR": "ADMIN",
"SCM_DD": "2021-01-18 00:00:00",
"UP_PO": 1.00000000,
"GETUP_FROM": "3",
"CHK_TAX": "F",
"CST_STD_UNIT": 0.00,
"PRD_NO_NO": "00001",
"WLGL_UP": "1.00000000"
}
]
},
{
"MF_POS": [
{
"OS_ID": "PO",
"OS_NO": "PO11180001",
"OS_DD": "2021-01-18 00:00:00",
"CUS_NO": "1001",
"SAL_NO": "10001",
"EST_DD": "2021-01-18 00:00:00",
"TAX_ID": "2",
"BIL_TYPE": "",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2021-02-01;票据到期日:2021-03-01",
"SEND_MTH": "1",
"DIS_CNT": 0.00000000,
"PO_DEP": "0101",
"PAY_DD": "2021-02-01 00:00:00",
"CHK_DD": "2021-03-01 00:00:00",
"INT_DAYS": 30,
"USR": "ADMIN",
"CLS_ID": "T",
"PRT_SW": "N",
"CLS_DATE": "2021-01-18 00:00:00",
"CHK_MAN": "ADMIN",
"EXC_RTO": 1.00000000,
"TOT_QTY": 1.00000000,
"SYS_DATE": "2021-01-18 10:43:58",
"HS_ID": "F",
"HIS_PRICE": "T",
"BACK_ID": "PR",
"PRE_ID": "F",
"BIL_COUNT": 0,
"BIL_FILE_COUNT": 0
}
],
"TF_POS": [
{
"OS_ID": "PO",
"OS_NO": "PO11180001",
"ITM": 1,
"PRD_NO": "00001",
"PRD_NAME": "00001货品",
"PRD_MARK": "",
"WH": "A000",
"UNIT": "1",
"QTY": 1.00000000,
"UP": 1.00000000,
"AMT": 1.00000000,
"AMTN": 0.95000000,
"TAX_RTO": 5.00000000,
"TAX": 0.05000000,
"PRE_ITM": 1,
"EST_DD": "2021-01-18 00:00:00",
"CST_STD": 0.00000000,
"QTY_PRE": 1.00000000,
"OS_DD": "2021-01-18 00:00:00",
"EST_ITM": 1,
"CUS_OS_NO": "",
"UNCFM_ID": "F",
"GROUP_DEP": "",
"CUS_NO": "1001",
"SCM_USR": "ADMIN",
"SCM_DD": "2021-01-18 00:00:00",
"UP_PO": 1.00000000,
"GETUP_FROM": "3",
"CHK_TAX": "F",
"CST_STD_UNIT": 0.00,
"PRD_NO_NO": "00001",
"WLGL_UP": "1.00000000"
}
]
}
]
}
}