单据差异查询接口
概述
该接口主要用于第三方平台或自主研发者，需要通过日期、单号、部门批量查询ERP系统的单据时，则可调用该单据的差异查询接口，将Sunlike ERP或Online ERP系统中的批量单据信息查询到第三方平台中。
以下对批量查询接口 vs 差异查询接口说明：
系统配套提供批量查询接口、差异查询接口两类查询接口，遵循配套规则：凡具备批量查询接口的业务单据，均同步提供对应差异查询接口，两类接口分工、调用逻辑存在明显区别。
批量查询接口 vs 差异查询接口核心区别：
1、DATE_TYPE 参数使用规则不同：
- 批量查询接口：通过DATE_TYPE区分查询维度，需根据业务场景分开调用；参数取值定义：0：单据日期、1：制单日期、2：终审日期、3：修改日期；
- 差异查询接口：无需区分DATE_TYPE类型，无需按该参数拆分调用;
2、返回数据内容与结构不同
- 批量查询接口：仅返回对应DATE_TYPE筛选维度下的单据全量基础数据；
- 差异查询接口：不区分DATE_TYPE返回单据数据，包含新增、终审、修改、删除四类记录：
- 新增、终审、修改单据数据：展示于业务单据表头、表身节点；表头字段CLS_DATE存在值 → 该单据为终审单据；表头字段MODIFY_DD存在值 → 该单据为修改单据
- 已删除单据数据：统一存放于 BILD 区域。
本文以【受订单差异查询接口】作为标准范例，系统内其余各类业务单据均可参照本范例，结合对应单据批量查询接口规则完成适配调整，调整有两点：
- 接口地址修改：将原批量查询接口地址内的 BATCHDATA替换为 GetChangeData，即为该单据差异查询接口地址；
- 请求参数删减：移除批量查询接口必填参数 DATE_TYPE，差异查询接口不再传递该参数。
参数说明
请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/DRPSO/GetChangeData | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 程序代号 | PGM | 是 | DRPSO | 以受订单为例 | ||
| 单据别 | OS_ID | String | 2 | 是 | SO | |
| 单据号码 | OS_NO | String | 20 | ERP的单据号码，可多张单号，加中括号[]，单号之间用豆号隔开，如”OS_NO”:[“SO11110001″,”SO11110002”] | ||
| 开始日期 | 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":"DRPSO", //程序代号，
"OS_ID":"SO", //单据别，但若单据无单据别，该参数可不用
"OS_NO":"", //按单号查询，可多张单号，加中括号[]，单号之间用豆号隔开
"START_DATE":"2026-07-22 00:00:00.000", //查询的开始日期
"END_DATE":"2026-07-23 23:42:36.000", //查询的结束日期
"PO_DEP":"00000000", //有[]表示多选，不含下属部门；没有[]表示单选且含下属
"ORDER_BY":{ //排序规则
"OS_NO":"DESC", //DESC表示降序排序
"CUS_NO":"ASC" //ASC表示升序排序
}
}
返回结果示例
{
"code": 0, //0表示执行成功
"message": "查询成功",
"data": {
"UP_DD": "2026-07-23 16:32:23",
"TOTAL_NUM": 3, //本次查询单据的总数量
"BILL_LIST": [
{
"MF_POS": [
{
"OS_ID": "SO",
"ZHANG_ID": "1",
"OS_NO": "SOA260722001",
"OS_DD": "2026-07-22 00:00:00",
"CUS_NO": "PCXH01",
"CUS_NAME": "批次销货测试01",
"SAL_NO": "",
"EST_DD": "2026-07-22 00:00:00",
"TAX_ID": "1",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2026-08-01; 票据到期日:2026-09-01",
"SEND_MTH": "1",
"DIS_CNT": 0.00000000,
"PO_DEP": "00000000",
"PAY_DD": "2026-08-01 00:00:00",
"CHK_DD": "2026-09-01 00:00:00",
"INT_DAYS": 30,
"CLS_REM": "",
"USR": "ADMIN",
"CLS_ID": "F",
"PRT_SW": "N",
"PRT_USR": "",
"CLS_DATE": "2026-07-22 10:48:13",
"CHK_MAN": "ADMIN",
"EXC_RTO": 1.00000000,
"SYS_DATE": "2026-07-22 10:48:11",
"ISOVERSH": "F",
"HS_ID": "T",
"HIS_PRICE": "T",
"MOB_ID": "",
"AMTN_INT": 0.00000000,
"RP_NO": "",
"BIL_COUNT": 0,
"MODIFY_DD": "2026-07-22 10:48:19",
"MODIFY_MAN": "ADMIN",
"BIL_FILE_COUNT": 0
}
],
"TF_POS": [
{
"OS_ID": "SO",
"OS_NO": "SOA260722001",
"ITM": 1,
"PRD_NO": "A001",
"PRD_NAME": "A系列-001",
"PRD_NAME_UN": "A系列-001",
"PRD_MARK": "",
"WH": "501",
"FREE_ID_DEF": "F",
"UNIT": "1",
"QTY": 10.00000000,
"UP": 1.00000000,
"AMT": 10.00000000,
"AMTN": 10.00000000,
"TAX_RTO": 5.00000000,
"TAX": 0.00000000,
"PRE_ITM": 1,
"CHK_TAX": "",
"UP_PO": 0.00000000,
"EST_DD": "2026-07-22 00:00:00",
"CST_STD": 0.00000000,
"OS_DD": "2026-07-22 00:00:00",
"EST_ITM": 1,
"CUS_OS_NO": "",
"BZ_KND": "",
"SPC": "[000]",
"TPL_NO": "002",
"UP_STD": 0.00000000,
"QTY_FRAC1": 10.00000000,
"SUP_PRD_MARK": "",
"QTY_OLD_ALL": 10.0,
"BAR_CODE": "A001",
"TRANSM": "0",
"LOGIST": "0",
"SUP_PRD_NO": "",
"PRD_IMAGE": "",
"ACT_DSC": "",
"ACT_REM": "",
"UNITNAME": "个",
"TRAN_BIL_ITM": 1,
"PRD_NO_NO": "A001",
"CST_STD_UNIT": 0.000000,
"WLGL_UP": "1.00000000",
"S1": 1.00000000,
"IMAGE__picture": "",
"QTY_TJ": 0.00
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
},
{
"MF_POS": [
{
"OS_ID": "SO",
"ZHANG_ID": "1",
"OS_NO": "SOA260722002",
"OS_DD": "2026-07-22 00:00:00",
"CUS_NO": "PCXH02",
"CUS_NAME": "批次销货测试02",
"SAL_NO": "",
"EST_DD": "2026-07-22 00:00:00",
"TAX_ID": "1",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2026-08-01; 票据到期日:2026-09-01",
"SEND_MTH": "1",
"DIS_CNT": 0.00000000,
"PO_DEP": "00000000",
"PAY_DD": "2026-08-01 00:00:00",
"CHK_DD": "2026-09-01 00:00:00",
"INT_DAYS": 30,
"CLS_REM": "",
"USR": "ADMIN",
"PRT_SW": "N",
"PRT_USR": "",
"CLS_DATE": "2026-07-22 10:48:26",
"CHK_MAN": "ADMIN",
"EXC_RTO": 1.00000000,
"SYS_DATE": "2026-07-22 10:48:25",
"ISOVERSH": "F",
"HS_ID": "T",
"HIS_PRICE": "T",
"MOB_ID": "",
"AMTN_INT": 0.00000000,
"RP_NO": "",
"BIL_COUNT": 0,
"BIL_FILE_COUNT": 0
}
],
"TF_POS": [
{
"OS_ID": "SO",
"OS_NO": "SOA260722002",
"ITM": 1,
"PRD_NO": "A001",
"PRD_NAME": "A系列-001",
"PRD_NAME_UN": "A系列-001",
"PRD_MARK": "",
"WH": "501",
"FREE_ID_DEF": "F",
"UNIT": "1",
"SEND_WH": "",
"QTY": 10.00000000,
"UP": 1.00000000,
"AMT": 10.00000000,
"AMTN": 10.00000000,
"TAX_RTO": 5.00000000,
"TAX": 0.00000000,
"PRE_ITM": 1,
"CHK_TAX": "",
"UP_PO": 0.00000000,
"EST_DD": "2026-07-22 00:00:00",
"CST_STD": 0.00000000,
"OS_DD": "2026-07-22 00:00:00",
"EST_ITM": 1,
"CUS_OS_NO": "",
"BZ_KND": "",
"SPC": "[000]",
"TPL_NO": "002",
"UP_STD": 0.00000000,
"QTY_FRAC1": 10.00000000,
"SUP_PRD_MARK": "",
"QTY_OLD_ALL": 10.0,
"BAR_CODE": "A001",
"TRANSM": "0",
"LOGIST": "0",
"SUP_PRD_NO": "",
"PRD_IMAGE": "",
"ACT_DSC": "",
"ACT_REM": "",
"UNITNAME": "个",
"TRAN_BIL_ITM": 1,
"PRD_NO_NO": "A001",
"CST_STD_UNIT": 0.000000,
"WLGL_UP": "1.00000000",
"S1": 1.00000000,
"IMAGE__picture": "",
"QTY_TJ": 0.00
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
},
{
"MF_POS": [
{
"OS_ID": "SO",
"ZHANG_ID": "1",
"OS_NO": "SOA260722003",
"OS_DD": "2026-07-22 00:00:00",
"CUS_NO": "PCXH01",
"CUS_NAME": "批次销货测试01",
"SAL_NO": "",
"EST_DD": "2026-07-22 00:00:00",
"TAX_ID": "1",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2026-08-01; 票据到期日:2026-09-01",
"SEND_MTH": "1",
"DIS_CNT": 0.00000000,
"PO_DEP": "00000000",
"PAY_DD": "2026-08-01 00:00:00",
"CHK_DD": "2026-09-01 00:00:00",
"INT_DAYS": 30,
"CLS_REM": "",
"USR": "ADMIN",
"PRT_SW": "N",
"PRT_USR": "",
"CLS_DATE": "2026-07-23 16:32:23",
"CHK_MAN": "ADMIN",
"EXC_RTO": 1.00000000,
"SYS_DATE": "2026-07-23 16:32:21",
"ISOVERSH": "F",
"HS_ID": "T",
"HIS_PRICE": "T",
"MOB_ID": "",
"AMTN_INT": 0.00000000,
"RP_NO": "",
"BIL_COUNT": 0,
"MODIFY_DD": "2026-07-22 11:48:19",
"BIL_FILE_COUNT": 0
}
],
"TF_POS": [
{
"OS_ID": "SO",
"OS_NO": "SOA260722003",
"ITM": 1,
"PRD_NO": "A001",
"PRD_NAME": "A系列-001",
"PRD_NAME_UN": "A系列-001",
"PRD_MARK": "",
"WH": "501",
"FREE_ID_DEF": "F",
"UNIT": "1",
"QTY": 10.00000000,
"UP": 1.00000000,
"AMT": 10.00000000,
"AMTN": 10.00000000,
"TAX_RTO": 5.00000000,
"TAX": 0.00000000,
"PRE_ITM": 1,
"CHK_TAX": "",
"UP_PO": 0.00000000,
"EST_DD": "2026-07-22 00:00:00",
"CST_STD": 0.00000000,
"OS_DD": "2026-07-22 00:00:00",
"EST_ITM": 1,
"CUS_OS_NO": "",
"BZ_KND": "",
"SPC": "[000]",
"TPL_NO": "002",
"UP_STD": 0.00000000,
"QTY_FRAC1": 10.00000000,
"SUP_PRD_MARK": "",
"QTY_OLD_ALL": 10.0,
"BAR_CODE": "A001",
"TRANSM": "0",
"LOGIST": "0",
"SUP_PRD_NO": "",
"PRD_IMAGE": "",
"ACT_DSC": "",
"ACT_REM": "",
"UNITNAME": "个",
"TRAN_BIL_ITM": 1,
"PRD_NO_NO": "A001",
"CST_STD_UNIT": 0.000000,
"WLGL_UP": "1.00000000",
"S1": 1.00000000,
"IMAGE__picture": "",
"QTY_TJ": 0.00
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
}
}
],
"BILD": [//删除记录
{
"SQNO": "SOA260708002",
"USR": "ADMIN",
"DEL_DATE": "2026-07-22 10:47:36"
},
{
"SQNO": "SOA260721001",
"USR": "ADMIN",
"DEL_DATE": "2026-07-22 10:47:17"
},
{
"SQNO": "SOA260721002",
"USR": "ADMIN",
"DEL_DATE": "2026-07-22 10:47:22"
}
]
}
}