概述
该接口主要用于第三方平台或自主研发者,通过调用【其他支出单】的生成接口,将第三方的其他费用支出信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【其他支出单】。
参数说明
1.请求方式
请求方式 |
POST |
接口地址 |
http://ERPAPI站点/MONEXP/ADDDATA |
格式 |
JSON |
编码类型 |
UTF-8 |
2.header参数
Content-Type |
application/json |
Authorization |
token |
授权接口所获取的值 |
3.请求参数
字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
第三方单号 |
REF_NO |
|
|
是 |
|
第三方单号,必填 |
程序代号 |
PGM |
|
|
是 |
MONEXP |
|
字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
数据表MF_EXP |
费用识别码 |
EP_ID |
string |
2 |
是 |
EP |
|
费用单号 |
EP_NO |
string |
20 |
是 |
|
1.自动编码,则不用传值;
2.手工编码,则与REF_NO必须相同 |
日期 |
EP_DD |
datetime |
|
是 |
|
格式:YYYY-MM-DD |
来源单识别码 |
BIL_ID |
string |
2 |
|
|
|
来源单号 |
PC_NO |
string |
30 |
|
|
|
凭证模版代号 |
VOH_ID |
string |
2 |
|
|
|
凭证号码 |
VOH_NO |
string |
20 |
|
|
|
操作员 |
USR_NO |
string |
12 |
是 |
|
|
部门代号 |
DEP |
string |
8 |
是 |
|
|
摘要 |
REM |
string |
50 |
|
|
|
开帐标志 |
OPN_ID |
string |
1 |
|
|
|
录入员 |
USR |
string |
12 |
是 |
|
|
审核注记 |
CHK_MAN |
string |
12 |
|
|
|
打印注记 |
PRT_SW |
string |
1 |
|
|
|
拷贝注记 |
CPY_SW |
string |
1 |
|
|
|
终审日期 |
CLS_DATE |
datetime |
|
|
|
|
单据类别 |
BIL_TYPE |
string |
10 |
|
|
|
审核模版 |
MOB_ID |
string |
10 |
|
|
|
锁单人 |
LOCK_MAN |
string |
12 |
|
|
|
锁单时间 |
LOCK_DATE |
datetime |
0 |
|
|
|
附件张数 |
FJ_NUM |
integer |
|
|
|
|
工程案号 |
CAS_NO |
string |
20 |
|
|
|
输单日期 |
SYS_DATE |
datetime |
|
|
|
|
任务编号 |
TASK_ID |
integer |
0 |
|
|
|
打印人员 |
PRT_USR |
string |
12 |
|
|
|
合同 |
Contract |
string |
0 |
|
|
|
作废标记 |
CANCEL_ID |
string |
1 |
|
|
|
打印日期 |
PRT_DATE |
datetime |
0 |
|
|
|
单据类别区分(进:PC 销:SA) |
BIL_TYPE_SPC |
string |
2 |
|
|
|
关联单据类别 |
REF_ID |
string |
2 |
|
|
|
关联单号 |
REF_NO |
string |
255 |
|
|
|
最近修改日期 |
MODIFY_DD |
datetime |
0 |
|
|
|
最近修改人 |
MODIFY_MAN |
string |
12 |
|
|
|
对帐人 |
DZ_USR |
string |
12 |
|
|
|
对帐日期 |
DZ_DATE |
datetime |
0 |
|
|
|
贸易来源单号 |
SG_NO |
string |
20 |
|
|
|
来源暂估单 |
ZG_NO |
string |
20 |
|
|
|
集团单据唯一值 |
GROUP_KEY |
string |
100 |
|
|
|
相同纳税区标志 |
SAME_TAX_AREA |
string |
1 |
|
|
|
工程人员 |
CAS_MAN |
string |
12 |
|
|
|
调整发票差额 |
TZZG |
string |
1 |
|
|
|
字段名称 |
字段代号 |
类型 |
长度 |
必填 |
固定值 |
备注 |
数据表TF_EXP |
其它费用识别码 |
EP_ID |
string |
2 |
是 |
EP |
|
其它费用单号 |
EP_NO |
string |
20 |
是 |
|
必须与MF_EXP的EP_NO相同 |
项次 |
ITM |
integer |
|
是 |
|
|
费用项目 |
IDX_NO |
string |
20 |
是 |
|
|
客户代号 |
CUS_NO |
string |
12 |
是 |
|
|
币别 |
CUR_ID |
string |
4 |
|
|
|
汇率 |
EXC_RTO |
float |
|
|
|
|
税别 |
TAX_ID |
string |
1 |
|
|
|
外币金额 |
AMT |
float |
|
|
|
|
未税本位币 |
AMTN_NET |
float |
|
|
|
|
税额 |
TAX |
float |
|
|
|
|
立帐单号 |
ARP_NO |
string |
20 |
|
|
|
发票号码 |
INV_NO |
string |
20 |
|
|
|
会计科目 |
ACC_NO |
string |
20 |
|
|
|
分摊方式 |
SHARE_MTH |
string |
1 |
|
|
|
批号 |
BAT_NO |
string |
40 |
|
|
|
摘要 |
REM |
string |
800 |
|
|
|
结帐日 |
PAY_DD |
datetime |
|
|
|
|
部门 |
DEP |
string |
8 |
|
|
|
收付款单号 |
RP_NO |
string |
20 |
|
|
|
票据日期 |
CHK_DD |
datetime |
|
|
|
|
票据天数 |
CHK_DAYS |
integer |
|
|
|
|
即收付金额 |
AMT_RP |
float |
|
|
|
|
业务员 |
SAL_NO |
string |
12 |
|
|
|
分摊结案否 |
CLOSE_FT |
string |
1 |
|
|
|
费用已分摊金额 |
AMTN_FT_TOT |
float |
0 |
|
|
|
交易方式 |
PAY_MTH |
string |
1 |
|
|
|
付款天数 |
PAY_DAYS |
integer |
|
|
|
|
指定结帐日资料 |
CLS_REM |
string |
30 |
|
|
|
交易备注 |
PAY_REM |
string |
80 |
|
|
|
发票别 |
METH_ID |
string |
2 |
|
|
|
间隔天数 |
INT_DAYS |
integer |
|
|
|
|
分摊单ID |
BIL_ID |
string |
2 |
|
|
|
分摊单号 |
BIL_NO |
string |
40 |
|
|
|
鞋服组合栏位 |
COMPOSE_IDNO |
string |
50 |
|
|
|
发票日 |
INV_DD |
datetime |
|
|
|
|
申报期别 |
INV_YM |
integer |
|
|
|
|
买受人抬头 |
TITLE_BUY |
string |
50 |
|
|
|
发票退回金额 |
AMT_INV |
float |
|
|
|
|
发票退回税额 |
TAX_INV |
float |
|
|
|
|
税率 |
RTO_TAX |
float |
0 |
|
|
|
发票票面金额 |
AMT_FP |
float |
0 |
|
|
|
发票本位币金额 |
AMTN_NET_FP |
float |
0 |
|
|
|
发票税额 |
TAX_FP |
float |
0 |
|
|
|
立帐开票结案标志 |
LZ_CLS_ID |
string |
1 |
|
|
|
立帐开票自动结案回写 |
CLSLZ |
string |
1 |
|
|
|
开票标记 |
KP_ID |
string |
1 |
|
|
|
单据唯一项次 |
KEY_ITM |
integer |
0 |
|
|
|
自定义代号 |
OBJ |
string |
30 |
|
|
|
功能货币 |
CUR_ID_IFRS |
string |
4 |
|
|
|
工程案号 |
CAS_NO |
string |
20 |
|
|
|
阶段编号 |
TASK_ID |
integer |
0 |
|
|
|
发票来源单ID |
INV_BIL_ID |
string |
2 |
|
|
|
发票来源单号 |
INV_BIL_NO |
string |
20 |
|
|
|
立帐结案日期 |
LZ_CLS_DD |
datetime |
0 |
|
|
|
立帐方式 |
ZHANG_ID |
string |
1 |
是 |
|
1单张立帐;2不立帐;3开出发票才立帐 |
原单不切制凭证 |
GEN_VOH |
string |
1 |
|
|
|
对帐人 |
DZ_USR |
string |
12 |
|
|
|
对帐日期 |
DZ_DATE |
datetime |
0 |
|
|
|
已转固定资产 |
FLG_FX |
string |
1 |
|
|
|
预收付外币 |
AMT_IRP |
float |
0 |
|
|
|
预收付未税本位币 |
AMTN_IRP |
float |
0 |
|
|
|
预收付税额 |
TAX_IRP |
float |
0 |
|
|
|
已转资金付款申请标志 |
FLAG_FKSQ |
string |
1 |
|
|
|
预估单号 |
ZG_NO |
string |
20 |
|
|
|
预估追踪项次 |
EST_ITM |
integer |
0 |
|
|
|
转入单ID |
ZG_ID |
string |
2 |
|
|
|
POS账户代号 |
BACC_NO_POS |
string |
4 |
|
|
|
POS刷卡机代号 |
POS_NO |
string |
50 |
|
|
|
对账否 |
DZ_ID |
string |
1 |
|
|
|
处理否 |
CL_ID |
string |
1 |
|
|
|
|
DZ_ITM |
integer |
0 |
|
|
|
已开票金额差额 |
AMT_ZG_FP |
float |
0 |
|
|
|
已开票未税差额 |
AMTN_NET_ZG_FP |
float |
0 |
|
|
|
已开票税额差额 |
TAX_ZG_FP |
float |
0 |
|
|
|
资产代号 |
FX_NO |
string |
30 |
|
|
|
开始日期 |
START_DATE |
datetime |
0 |
|
|
|
结束日期 |
END_DATE |
datetime |
0 |
|
|
|
其他应收/付科目 |
ACC_NO_ARP |
string |
20 |
|
|
|
费用转固定资产标识 |
FLG_UK |
string |
1 |
|
|
|
预收付未税金额(本) |
AMTN_NET_IRP |
float |
0 |
|
|
|
预收付未税金额(外) |
AMT_NET_IRP |
float |
0 |
|
|
|
是预付款 |
ISIRP |
string |
1 |
|
|
|
采购单号 |
OS_NO |
string |
20 |
|
|
|
预收付款单 |
IRP_NO |
string |
20 |
|
|
|
4.自定义参数
字段名称 |
字段代号 |
类型 |
长度 |
是否 |
固定值 |
备注 |
数据表MF_EXP_Z(表头自定义字段) |
自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型,若为数字字段,可用于计算,例如自定义三个字段:JD_NO1,JD_NO2,JD_NO3,而JD_NO3=JD_NO1*JD_NO2,那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
自定义栏位2 |
自定义 |
string |
|
|
|
…… |
…… |
…… |
|
|
|
数据表TF_EXP_Z(表头自定义字段) |
自定义栏位1 |
自定义 |
string |
2 |
|
|
自定义字段可为文件、数字、日期、备注等类型,若为数字字段,可用于计算,例如自定义三个字段:JD_NO1,JD_NO2,JD_NO3,而JD_NO3=JD_NO1*JD_NO2,那么在JSON里只要上传JD_NO1和JD_NO2即可。 |
自定义栏位2 |
自定义 |
string |
|
|
|
…… |
…… |
…… |
|
|
|
请求JSON示例
{
"REF_NO": "EP2009160001", //第三方单号,必填
"PGM": "MONEXP", //单据程序代号
"MF_EXP": [ //新增单据表头信息
{
"EP_DD": "2020-09-16 00:00:00",
"EP_ID": "EP",
"EP_NO": "",
"USR": "ADMIN",
"USR_NO": "0001",
"OPN_ID": "2",
"BIL_TYPE": "01",
"DEP": "00000000"
}
],
"TF_EXP": [ //新增单据表身信息
{
"ITM": 1,
"IDX_NO": "0001",
"CUS_NO": "B0001",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"AMT": 1000.0,
"AMTN_NET": 952.38,
"TAX": 47.62,
"DEP": "00000000",
"PAY_REM": "结帐期:2020-10-01;票据到期日:2020-11-01",
"SAL_NO": "",
"PAY_DD": "2020-10-01 00:00:00",
"EP_ID": "EP",
"EP_NO": "",
"SHARE_MTH": "1",
"CHK_DD": "2020-11-01 00:00:00",
"CHK_DAYS": 30,
"PAY_MTH": "1",
"PAY_DAYS": 1,
"INT_DAYS": 30,
"RTO_TAX": 5.0,
"KEY_ITM": 1,
"GEN_VOH": "F",
"ZHANG_ID": "1",
"OBJ": ""
}
]
}
返回结果示例
{
"code": 0, //为0表示执行成功,其他表示错误
"message": "新增成功", //提示信息
"data": {
"MF_EXP": [ //生成单据表头信息
{
"EP_DD": "2020-09-16 00:00:00",
"EP_ID": "EP",
"EP_NO": "EP2009160001",
"USR": "ADMIN",
"PRT_SW": "N",
"USR_NO": "0001",
"OPN_ID": "2",
"SYS_DATE": "2020-09-16 11:41:15",
"BIL_TYPE": "01",
"DEP": "00000000",
"CHK_MAN": "ADMIN",
"CLS_DATE": "2020-09-16 00:00:00"
}
],
"TF_EXP": [ //生成单据表身信息
{
"ITM": 1,
"IDX_NO": "0001",
"CUS_NO": "B0001",
"EXC_RTO": 1.0,
"TAX_ID": "2",
"AMT": 1000.0,
"AMTN_NET": 952.38,
"TAX": 47.62,
"ARP_NO": "AP2009160001",
"DEP": "00000000",
"KP_ID": "F",
"PAY_REM": "结帐期:2020-10-01;票据到期日:2020-11-01",
"SAL_NO": "",
"PAY_DD": "2020-10-01 00:00:00",
"EP_ID": "EP",
"EP_NO": "EP2009160001",
"SHARE_MTH": "1",
"CHK_DD": "2020-11-01 00:00:00",
"CHK_DAYS": 30,
"PAY_MTH": "1",
"PAY_DAYS": 1,
"INT_DAYS": 30,
"RTO_TAX": 5.0,
"KEY_ITM": 1,
"GEN_VOH": "F",
"ZHANG_ID": "1",
"OBJ": ""
}
]
}
}