批量查询【凭证输入】接口
概述
该接口主要用于第三方平台或自主研发者，需要通过日期、单号、部门批量查询ERP系统的单据时，则可调用该单据的批量查询接口，将Sunlike ERP或Online ERP系统中的批量单据信息查询到第三方平台中。
参数说明
请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/accvhed/BATCHDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 程序代号 | PGM | 是 | VENTRYWIN | |||
| 单据号码 | MAK_NO | String | 20 | ERP的单据号码，可多张单号，加中括号[]，单号之间用豆号隔开，如”MAK_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”:{“MAK_NO”:”DESC”, “CUS_NO”:”ASC”} |
请求JSON示例
{
"PGM":"VENTRYWIN", //程序代号
"MAK_NO":"", //按单号查询，可多张单号，加中括号[]，单号之间用豆号隔开
"DATE_TYPE":0, //0表示单据日期，1表示制单日期，2表示终审日期，3修改日期
"START_DATE":"2021-01-01", //查询的开始日期
"END_DATE":"2021-01-31", //查询的结束日期
"DEP":"00000000", //有[]表示多选，不含下属部门；没有[]表示单选且含下属
"ORDER_BY":{ //排序规则
"MAK_NO":"DESC" //DESC表示降序排序
}
}
返回结果示例
{
"code": 0,
"message": "查询成功",
"data": {
"UP_DD": "2021-10-29 14:25:34",
"TOTAL_NUM": 1,
"DEFINE_INFO": {
"VHED": [
"TEST01"
],
"VDTL": [
"TF_TEST01"
]
},
"BILL_LIST": [
{
"VHED": [
{
"MAK_NO": "MK1A290001",
"MAK_DAT": "2021-10-29 00:00:00",
"VOH_NO": "VH1A290001",
"VOH_DAT": "2021-10-29 00:00:00",
"VOH_ID": "3",
"POS_DAT": "2021-10-29 00:00:00",
"CHK_MAN": "ADMIN",
"POS_MAN": "ADMIN",
"AMT": 100.00000000,
"PRT_SW": "N",
"USR": "ADMIN",
"A": "",
"SYS_DATE": "2021-10-29 14:25:34",
"CLS_DATE": "2021-10-29 14:25:35",
"MOB_ID": "",
"PRT_USR": "",
"DEP": "00000000",
"DEP_NAME": "First Department",
"TEST01": "表头测试"
}
],
"VDTL": [
{
"MAK_NO": "MK1A290001",
"ITM": 1,
"VOH_DAT": "2021-10-29 00:00:00",
"DC": "D",
"ACC_NO": "1001",
"DEP": "00000000",
"AMTN": 100.00000000,
"EXC_RTO": 1.00000000,
"OBJ": "",
"POS": "T",
"VOH_ID": "3",
"CLS_ID1": "",
"CLS_ID2": "",
"CUR_ID": "",
"CLS_ID3": "",
"CLS_ID4": "",
"PRE_ITM": 1,
"ACC_NAME": "库存现金",
"DEP_NAME": "First Department",
"ENG_NAME": "Cash on hand",
"TF_TEST01": "表身测试1",
"AMTND": 100.00,
"ACCNO": "1001",
"DEP_NO": "00000000"
},
{
"MAK_NO": "MK1A290001",
"ITM": 2,
"VOH_DAT": "2021-10-29 00:00:00",
"DC": "C",
"ACC_NO": "1122",
"DEP": "00000000",
"AMTN": 100.00000000,
"EXC_RTO": 1.00000000,
"OBJ": "",
"POS": "T",
"VOH_ID": "3",
"CLS_ID1": "",
"CLS_ID2": "",
"CUR_ID": "",
"CLS_ID3": "",
"CLS_ID4": "",
"PRE_ITM": 2,
"ACC_NAME": "应收账款",
"DEP_NAME": "First Department",
"ENG_NAME": "Accounts receivable",
"TF_TEST01": "表身测试2",
"AMTNC": 100.00,
"ACCNO": "1122",
"DEP_NO": "00000000"
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
]
}
}