一、ERP API说明

生成【其他收入单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【其他收入单】的生成接口，将第三方的其他收入费用信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【其他收入单】。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/MONEXR/ADDDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 MONEXR 　
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_EXP
费用识别码 EP_ID string 2 是 ER 　
费用单号 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 是 ER 　
其它费用单号 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": "ER2009160001",          //第三方单号，必填
  "PGM": "MONEXR",           //单据程序代号
  "MF_EXP": [           //新增单据表头信息
    {
      "EP_DD": "2020-09-16",
      "EP_ID": "ER",
      "EP_NO": "",
      "USR": "0001",
      "USR_NO": "0001",
      "OPN_ID": "2",
      "BIL_TYPE": "01",
      "DEP": "00000000"
    }
  ],
  "TF_EXP": [            //新增单据表身信息
    {
      "ITM": 1,
      "IDX_NO": "0001",
      "CUS_NO": "C0001",
      "EXC_RTO": 1.0,
      "TAX_ID": "2",
      "AMT": 500.0,
      "AMTN_NET": 476.19,
      "TAX": 23.81,
      "DEP": "00000000",
      "PAY_REM": "结帐期:2020-10-01;票据到期日:2020-11-01",
      "SAL_NO": "0002",
      "PAY_DD": "2020-10-01",
      "EP_ID": "ER",
      "EP_NO": "",
      "CHK_DD": "2020-11-01",
      "CHK_DAYS": 30,
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "INT_DAYS": 30,
      "RTO_TAX": 5.0,
      "KEY_ITM": 1,
      "CAS_NO": "",
      "GEN_VOH": "F",
      "ZHANG_ID": "1",
      "OBJ": "",
      "TAXCODE": ""
    },
    {
      "ITM": 2,
      "IDX_NO": "0002",
      "CUS_NO": "C0001",
      "EXC_RTO": 1.0,
      "TAX_ID": "2",
      "AMT": 800.0,
      "AMTN_NET": 761.9,
      "TAX": 38.1,
      "DEP": "00000000",
      "PAY_REM": "结帐期:2020-10-01;票据到期日:2020-11-01",
      "SAL_NO": "0002",
      "PAY_DD": "2020-10-01",
      "EP_ID": "ER",
      "EP_NO": "",
      "CHK_DD": "2020-11-01",
      "CHK_DAYS": 30,
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "INT_DAYS": 30,
      "RTO_TAX": 5.0,
      "KEY_ITM": 2,
      "CAS_NO": "",
      "GEN_VOH": "F",
      "ZHANG_ID": "1",
      "OBJ": "",
      "TAXCODE": ""
    }
  ]
}

返回结果示例

{
    "code": 0,               //为0表示执行成功，其他表示错误
    "message": "新增成功",            //提示信息
    "data": {
        "MF_EXP": [                  //生成单据表头信息
            {
                "EP_DD": "2020-09-16 00:00:00",
                "EP_ID": "ER",
                "EP_NO": "ER2009160001",
                "USR": "0001",
                "PRT_SW": "N",
                "USR_NO": "0001",
                "OPN_ID": "2",
                "SYS_DATE": "2020-09-16 11:41:32",
                "BIL_TYPE": "01",
                "DEP": "00000000",
                "CHK_MAN": "0001",
                "CLS_DATE": "2020-09-16 00:00:00"
            }
        ],
        "TF_EXP": [               //生成单据表身信息
            {
                "ITM": 1,
                "IDX_NO": "0001",
                "CUS_NO": "C0001",
                "EXC_RTO": 1.0,
                "TAX_ID": "2",
                "AMT": 500.0,
                "AMTN_NET": 476.19,
                "TAX": 23.81,
                "ARP_NO": "AR2009160001",
                "DEP": "00000000",
                "KP_ID": "F",
                "PAY_REM": "结帐期:2020-10-01;票据到期日:2020-11-01",
                "SAL_NO": "0002",
                "PAY_DD": "2020-10-01 00:00:00",
                "EP_ID": "ER",
                "EP_NO": "ER2009160001",
                "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,
                "CAS_NO": "",
                "GEN_VOH": "F",
                "ZHANG_ID": "1",
                "OBJ": "",
                "TAXCODE": ""
            },
            {
                "ITM": 2,
                "IDX_NO": "0002",
                "CUS_NO": "C0001",
                "EXC_RTO": 1.0,
                "TAX_ID": "2",
                "AMT": 800.0,
                "AMTN_NET": 761.9,
                "TAX": 38.1,
                "ARP_NO": "AR2009160002",
                "DEP": "00000000",
                "KP_ID": "F",
                "PAY_REM": "结帐期:2020-10-01;票据到期日:2020-11-01",
                "SAL_NO": "0002",
                "PAY_DD": "2020-10-01 00:00:00",
                "EP_ID": "ER",
                "EP_NO": "ER2009160001",
                "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": 2,
                "CAS_NO": "",
                "GEN_VOH": "F",
                "ZHANG_ID": "1",
                "OBJ": "",
                "TAXCODE": ""
            }
        ]
    }
}