批处理接口
概述
ERP标准单据的新增、修改、删除的操作，可以将多个接口的调用，在批处理接口中一次性调用，批处理接口在处理过程中存在任意接口处理失败，则视为全部失败，即在一个事务里。（自定义单据只支持新增、删除）
JSON结构中，SVC代表处理一个接口处理。
参数说明
请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/bill/BatchModify | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
请求JSON示例
[
{
"SVC":"DRPSO/ADDDATA",//受订单新增接口
"DATA":{
"REF_NO": "2026080701", //第三方单号，必填
"PGM": "DRPSO", //单据程序代号
"MF_POS": [ //新增单据表头信息
{
"OS_ID": "SO",
"ZHANG_ID": "1",
"OS_NO": "",
"OS_DD": "2026-08-07 00:00:00",
"CUS_NO": "GZ",
"SAL_NO": "001",
"EST_DD":"2026-08-25 00:00:00",
"CUR_ID": "",
"TAX_ID": "2",
"BIL_TYPE": "",
"TRAD_MTH": "TD000000210702001",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2022-08-01;票据到期日:2022-07-01",
"SEND_MTH": "1",
"AMTN_NET": 117.14,
"PO_DEP": "000101",
"PAY_DD": "2026-08-25 00:00:00",
"CHK_DD":"2026-08-25 00:00:00",
"INT_DAYS": 30,
"USR":"ADMIN",
"EXC_RTO": 1.0,
"HIS_PRICE": "T",
"MOB_ID": "@@",
"TAX": 5.86,
"ISSVS": "F",
"CFM_SW": "F",
"ICOS_ID": "F",
"DSF_NO": "apiSO-20220223-002", //新增单据表头自定义信息
"SEND_WH":"01"
}
],
"TF_POS": [ //新增单据表身信息
{
"OS_ID": "SO",
"OS_NO": "",
"ITM": 1,
"PRD_NO": "0526",
"PRD_NAME": "A系列-0081111",
"PRD_MARK": "",
"WH": "C001",
"FREE_ID_DEF": "F",
"UNIT": "1",
"PRM_NO": "",
"QTY": 60.0,
"UP": 358.00,
"AMT": 21580.0,
"AMTN": 117.14,
"TAX_RTO": 5.0,
"TAX": 5.86,
"AMT_DIS_CNT": "-100",
"PRE_ITM": 1,
"CHK_TAX": "F",
"EST_DD": "2026-08-25 00:00:00",
"CST_STD": 0.0,
"OS_DD": "2026-08-07 00:00:00",
"EST_ITM": 1,
"SPC": "4L",
"SUP_PRD_NM": "",
"SUP_PRD_MARK": "",
"BAR_CODE": "",
"SUP_PRD_NO": "",
"UNITNAME": "个",
"CHK_XZL": "T",
"TAXCODE": "",
"PRD_NO_NO": "0001",
"CST_STD_UNIT": 0.0,
"WLGL_UP": "123.0000",
"Z1":22,
"FH_NO":"01",
"REM":"表身备注",
"QTY_MRP": "5"
}
]
}
},
{
"SVC": "DRPSA/ADDDATA", //销货单新增接口
"DATA":{
"REF_NO": "2026080702",//第三方单号，必填
"PGM": "DRPSA",
"MF_PSS": [//销货单表头信息
{
"PS_ID": "SA",
"PS_NO": "", //ERP为自动编号，则取ERP系统编码;为手工编码，则与REF_NO必须相同
"PS_DD": "2026-08-07 00:00:00.000",
"PAY_DD": "2026-08-01 00:00:00.000",
"CHK_DD": "2026-07-01 00:00:00.000",
"CUS_NO": "GZ",
"DEP": "0001",
"TAX_ID": "2",
"OS_ID": "CK",
"OS_NO": "CK2407010001",
"SEND_MTH": "1",
"SEND_WH": "01",
"ZHANG_ID": "1",
"CUR_ID": "",
"EXC_RTO": 1.0,
"SAL_NO": "001",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2022-06-01;票据到期日:2022-07-01",
"USR": "ADMIN",
"YD_ID": "T",
"BIL_TYPE": "",
"SIGN_DD": "2022-07-19 00:00:00",
"CNTT_NO": "HT20220707001",
"VOH_ID": "01"
}
],
"TF_PSS": [ //销货单表身信息
{
"PS_ID": "SA",
"PS_NO": "",
"OS_ID": "SO",
"OS_NO": "SO2407010001",
"CK_NO": "CK2407010001",
"ITM": 1,
"PRE_ITM": 1,
"EST_ITM": 2,
"OTH_ITM": 1,
"PS_DD": "2026-08-07 00:00:00.000",
"WH": "C001",
"PRD_NO": "0317",
"PRD_NAME": "制成品0317",
"PRD_MARK": "",
"SPC": "4L",
"BAR_CODE": "",
"UPR": 500.0,
"IDX1": "A110101",
"MRK": "A",
"UNIT": "1",
"QTY": 1.00000000,
"UP": 5.00000000,
"AMTN_NET": 5.00000000,
"AMT": 5.00000000,
"UP_SALE": 10.000,
"AMTN_SALE": 10.000,
"CSTN_SAL": 10.000,
"TAX": 0.00,
"CST_STD": 0.0,
"BAT_NO": "",
"TAX_RTO": 5.0,
"SUP_PRD_NO": "",
"SUP_PRD_MARK": "",
"UP_CST": 5.0000,
"BB": "AAA" //表身自定义字段
}
]
}
}
]
返回结果示例
{
"code": 0, //为0表示执行成功，其他表示错误
"message": "处理成功",
"data": [
{
"MF_POS": [
{
"OS_ID": "SO",
"ZHANG_ID": "1",
"OS_NO": "SOA260807001",
"OS_DD": "2026-08-07 00:00:00",
"CUS_NO": "GZ",
"SAL_NO": "001",
"EST_DD": "2026-08-25 00:00:00",
"CUR_ID": "",
"TAX_ID": "2",
"BIL_TYPE": "",
"TRAD_MTH": "TD000000210702001",
"REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"PAY_REM": "结帐期:2022-08-01;票据到期日:2022-07-01",
"SEND_MTH": "1",
"SEND_WH": "01",
"AMTN_NET": 117.14,
"PO_DEP": "000101",
"PAY_DD": "2026-08-25 00:00:00",
"CHK_DD": "2026-08-25 00:00:00",
"INT_DAYS": 30,
"USR": "ADMIN",
"CLS_ID": "F",
"LZ_CLS_ID2": "F",
"PRT_SW": "N",
"CLS_DATE": "2026-08-07 12:16:33",
"CHK_MAN": "ADMIN",
"EXC_RTO": 1.0,
"SYS_DATE": "2026-08-07 12:16:33",
"ISOVERSH": "F",
"HS_ID": "F",
"HIS_PRICE": "T",
"MOB_ID": "@@",
"TAX": 5.86,
"ISSVS": "F",
"CFM_SW": "F",
"ICOS_ID": "F",
"CHK_FULL_PAID": "F",
"name": "广州分点",
"DSF_NO": "apiSO-20220223-002"
}
],
"TF_POS": [
{
"OS_ID": "SO",
"OS_NO": "SOA260807001",
"ITM": 1,
"PRD_NO": "0526",
"PRD_NAME": "A系列-0081111",
"PRD_NAME_UN": "A系列-0081111",
"PRD_MARK": "",
"WH": "C001",
"FREE_ID_DEF": "F",
"UNIT": "1",
"PRM_NO": "",
"QTY": 60.0,
"UP": 358.0,
"AMT": 21580.0,
"AMTN": 117.14,
"TAX_RTO": 5.0,
"TAX": 5.86,
"PRE_ITM": 1,
"CHK_TAX": "F",
"EST_DD": "2026-08-25 00:00:00",
"CST_STD": 0.0,
"OS_DD": "2026-08-07 00:00:00",
"REM": "表身备注;内部版本,禁止使用于商业或盈利用途,违者必究",
"EST_ITM": 1,
"FH_NO": "01",
"SPC": "4L",
"SUP_PRD_NM": "",
"SUP_PRD_MARK": "",
"AMT_DIS_CNT": -100.0,
"BAR_CODE": "",
"SUP_PRD_NO": "",
"QTY_MRP": 5.0,
"UNITNAME": "个",
"CHK_XZL": "T",
"TAXCODE": "",
"PRD_NO_NO": "0001",
"CST_STD_UNIT": 0.0,
"WLGL_UP": "123.0000",
"Z1": 22.0
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
},
"BilNo": "SOA260807001;SAA260807001"
},
{
"MF_PSS": [
{
"PS_ID": "SA",
"PS_NO": "SAA260807001",
"PS_DD": "2026-08-07 00:00:00",
"PAY_DD": "2026-08-01 00:00:00",
"CHK_DD": "2026-07-01 00:00:00",
"CUS_NO": "GZ",
"DEP": "0001",
"TAX_ID": "2",
"SEND_MTH": "1",
"SEND_WH": "01",
"ZHANG_ID": "1",
"CUR_ID": "",
"EXC_RTO": 1.0,
"SAL_NO": "001",
"ARP_NO": "ARA260807001",
"ARP_DD": "2026-08-07 00:00:00",
"PAY_MTH": "1",
"PAY_DAYS": 1,
"CHK_DAYS": 30,
"INT_DAYS": 30,
"PAY_REM": "结帐期:2022-06-01;票据到期日:2022-07-01",
"USR": "ADMIN",
"CHK_MAN": "ADMIN",
"PRT_SW": "N",
"CLS_DATE": "2026-08-07 12:16:33",
"CK_CLS_ID": "F",
"LZ_CLS_ID": "F",
"YD_ID": "T",
"BIL_TYPE": "",
"OS_ID": "CK",
"SYS_DATE": "2026-08-07 12:16:33",
"REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",
"SIGN_DD": "2022-07-19 00:00:00",
"CNTT_NO": "HT20220707001",
"OS_NO": "CK2407010001",
"VOH_ID": "01",
"KP_ID": "F",
"AMTN_TRANS": 0.0,
"BIL_FILE_COUNT": 1,
"SALECHK": "1"
}
],
"TF_PSS": [
{
"PS_ID": "SA",
"PS_NO": "SAA260807001",
"ITM": 1,
"PS_DD": "2026-08-07 00:00:00",
"WH": "C001",
"PRD_NO": "0317",
"PRD_NAME": "制成品0317",
"PRD_NAME_UN": "制成品0317",
"PRD_MARK": "",
"SPC": "4L",
"BAR_CODE": "",
"UPR": 500.0,
"IDX1": "A110101",
"MRK": "A",
"UNIT": "1",
"QTY_PS": 1.0,
"QTY": 1.0,
"UP": 5.0,
"AMTN_NET": 5.0,
"AMT": 5.0,
"UP_SALE": 10.0,
"AMTN_SALE": 10.0,
"PRE_ITM": 1,
"OS_NO": "SO2407010001",
"OS_ID": "SO",
"CSTN_SAL": 10.0,
"TAX": 0.0,
"OTH_ITM": 1,
"CST_STD": 0.0,
"BAT_NO": "",
"TAX_RTO": 5.0,
"EST_ITM": 2,
"REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",
"CK_NO": "CK2407010001",
"SUP_PRD_NO": "",
"SUP_PRD_MARK": "",
"UP_CST": 5.0,
"ZDY1": "sun-031711"
}
],
"BILL_STATE": {
"READONLY": false,
"READONLY_REM": []
},
"BilNo": "SOA260807001;SAA260807001"
}
]
}