天心天思数字化API平台

生成【单客户收款-预收款】接口

概述

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

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO 　 　 是 　 第三方单号，必填
程序代号 PGM 　 　 是 MONAA 　
收付款表头冲帐库参数：
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表TF_MON(收付款表头冲帐库)
收付款识别码 RP_ID string 1 是 　1 1:收款；2:付款
收付款单号 RP_NO string 20 是 　 1.自动编码，则不用传值；
2.手工编码，则与REF_NO必须相同
项次 ITM integer 　 是 　 　
是预收付款否 IRP_ID string 1 　 　 T是预收付款，F或NULL为否
冲消注记 CLS_ID string 1 　 　 　
批号 BAT_NO string 40 　 　 　
收付款日期 RP_DD datetime 　 是 　 格式：YYYY-MM-DD
凭证号码 VOH_NO string 20 　 　 　
凭证模版代号 VOH_ID string 2 　 　 　
客户/厂商代号 CUS_NO string 12 　 　 　
是否含下属 INCLUDESON string 1 　 　 　
现金收付款(本位币) AMTN_BC float 　 　 　 　
银行存款收付款(本位币) AMTN_BB float 　 　 　 　
收付款折扣(本位币) AMTN_DISCNT float 　 　 　 　
第1张票据金额(本位币) AMTN_CHK1 float 　 　 　 　
第2张票据金额(本位币) AMTN_CHK2 float 　 　 　 　
其它收付款(本位币) AMTN_OTHER float 　 　 　 　
预收付款(本位币) AMTN_IRP float 　 　 　 　
应收付帐款(本位币) AMTN_ARP float 　 　 　 　
冲消金额(本位币) AMTN_CLS float 　 　 　 　
现金收付款(外币) AMT_BC float 　 　 　 　
银行存款收付款(外币) AMT_BB float 　 　 　 　
收付款折扣(外币) AMT_DISCNT float 　 　 　 　
第1张票据金额(外币) AMT_CHK1 float 　 　 　 　
第2张票据金额(外币) AMT_CHK2 float 　 　 　 　
其它收付款(外币) AMT_OTHER float 　 　 　 　
预收付款(外币) AMT_IRP float 　 　 　 　
应收付帐款(外币) AMT_ARP float 　 　 　 　
现金变动单号 BC_NO string 20 　 　 　
现金帐户代号 CACC_NO string 4 　 　 　
帐户变动单号 BB_NO string 20 　 　 　
银行帐户代号 BACC_NO string 4 　 　 　
第1张票据号码 CHK1_NO string 40 　 　 　
第2张票据号码 CHK2_NO string 40 　 　 　
其他科目 ACC_NO_OTHER string 20 　 　 　
币别 CUR_ID string 4 　 　 　
汇率 EXC_RTO float 　 　 　 　
摘要 REM string 0 　 　 　
批次冲销单号 CLS_NO string 25 　 　 　
业务员 USR_NO string 12 　 　 　
审核人 CHECK_MAN string 12 　 　 　
第3张票据号码 CHK3_NO string 40 　 　 　
第4张票据号码 CHK4_NO string 40 　 　 　
第5张票据号码 CHK5_NO string 40 　 　 　
第3张票据金额(外币) AMT_CHK3 float 　 　 　 　
第4张票据金额(外币) AMT_CHK4 float 　 　 　 　
第5张票据金额(外币) AMT_CHK5 float 　 　 　 　
第3张票据金额(本位币) AMTN_CHK3 float 　 　 　 　
第4张票据金额(本位币) AMTN_CHK4 float 　 　 　 　
第5张票据金额(本位币) AMTN_CHK5 float 　 　 　 　
部门代号 DEP string 8 是 　 　
录入员 USR string 12 是 　 　
审核注记 CHK_MAN string 12 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
冲消金额(外币) AMT_CLS float 　 　 　 　
多客户收款否 ISMULTCUS string 1 　 　 　
终审日期 CLS_DATE datetime 　 　 　 　
超收金额处理方式 CS_ID string 1 　 　 　
预收付款单号 IRP_NO string 20 　 　 　
冲预收/预付 RT_ID string 1 　 　 　
模拟单号 RP_ML_NO string 20 　 　 　
传真代号 FAX_ID string 20 　 　 　
回款本位币金额 AMTN_FAX float 　 　 　 　
回款金额(外币) AMT_FAX float 　 　 　 　
何种款项(产品) IDX_NO string 10 　 　 　
鞋服组合栏位 COMPOSE_IDNO string 50 　 　 　
扣款比例 RTO_KK float 　 　 　 　
审核模版 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
附件张数 FJ_NUM integer 　 　 　 　
输单日期 SYS_DATE datetime 　 　 　 　
是否即收付 JSF_ID string 1 　 　 　
采购/受订单号 BIL_NO string 40 　 　 　
采购/受订ID BIL_ID string 2 　 　 　
工程案号 CAS_NO string 20 　 　 　
任务编号 TASK_ID integer 0 　 　 　
发票号码 INV_NO string 20 　 　 　
打印人员 PRT_USR string 12 　 　 　
票据金额 AMTN_CHK float 0 　 　 　
票据金额(外) AMT_CHK float 0 　 　 　
多客户厂商表身唯一项次 PRE_ITM integer 0 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
银行汇款转帐结案 TR_ID string 1 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
单据类别 BIL_TYPE string 10 　 　 　
交易状态 B2E_STATUS string 1 　 　 　
网银凭证号 PAY_VOH_NO string 20 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
是否旧资料 OLD_ID string 1 　 　 　
是保证金否 IEA_ID string 1 　 　 　
是订金否 IOR_ID string 1 　 　 　
集团往来凭证 VOH_NO_JTWL string 20 　 　 　
收款类型 SK_TYPE string 1 　 　 　
对帐人 DZ_USR string 12 　 　 　
对帐日期 DZ_DATE datetime 0 　 　 　
返利单号 RG_NO string 20 　 　 　
不按明细冲销 FLAG_NOTMX string 1 　 　 　
含税订金 HS_ID string 1 　 　 　
订金税额（本位币） AMTN_TAX float 0 　 　 　
订金税额（外） AMT_TAX float 0 　 　 　
冲销税额（本位币） AMTN_TAX_CLS float 0 　 　 　
冲销税额（外） AMT_TAX_CLS float 0 　 　 　
订金税率 TAX_RTO float 0 　 　 　
预收付款税额(本位币) AMTN_TAX_IRP float 0 　 　 　
预收付款税额(外币) AMT_TAX_IRP float 0 　 　 　
含税定金 DJ_ID string 1 　 　 　
订金税率 RTO_DJ float 0 　 　 　
订金税额 AMTN_DJ float 0 　 　 　
订金税额（外） AMT_DJ float 0 　 　 　
冲销税额 AMTN_CX float 0 　 　 　
冲销税额（外） AMT_CX float 0 　 　 　
网银类型 B2E_TYPE string 8 　 　 　
网银付款凭证号 PZ_NO string 60 　 　 　
对账单号 DZ_NO string 20 　 　 　
合同号 CONTRACT string 80 　 　 　
收付款主库参数：
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_MON(收付款主库)
收付款识别码(1:收款；2:付款) RP_ID string 1 是 　 必须与TF_MON的RP_ID相同
收付款单号 RP_NO string 20 是 　 必须与TF_MON的RP_NO相同
收付款日期 RP_DD datetime 　 是 　 必须与TF_MON的RP_DD相同
操作员 USR_NO string 12 　 　 　
部门代号 DEP string 8 是 　 必须与TF_MON的DEP相同
摘要 REM string 200 　 　 　
本位币金额 AMTN float 　 　 　 　
应收付帐款 AMTN_ARP float 　 　 　 　
来源单识别码 BIL_ID string 2 　 　 　
来源单号 BIL_NO string 40 　 　 　
凭证模版代号 VOH_ID string 2 　 　 　
凭证号码 VOH_NO string 20 　 　 　
录入员 USR string 12 是 　 必须与TF_MON的USR相同
审核注记 CHK_MAN string 12 　 　 　
打印注记 PRT_SW string 1 　 　 　
拷贝注记 CPY_SW string 1 　 　 　
现金合计 AMTN_BC float 　 　 　 　
银行存款合计 AMTN_BB float 　 　 　 　
票据合计 AMTN_CHK float 　 　 　 　
其他金额合计 AMTN_OTHER float 　 　 　 　
是否多客户收款 ISMULTCUS string 1 　 　 　
终审日期 CLS_DATE datetime 　 　 　 　
审核模版 MOB_ID string 10 　 　 　
锁单人 LOCK_MAN string 12 　 　 　
锁单时间 LOCK_DATE datetime 0 　 　 　
附件张数 FJ_NUM integer 　 　 　 　
输单日期 SYS_DATE datetime 　 　 　 　
工程案号 CAS_NO string 20 　 　 　
任务编号 TASK_ID integer 0 　 　 　
打印人员 PRT_USR string 12 　 　 　
发票号码 INV_NO string 20 　 　 　
作废标记 CANCEL_ID string 1 　 　 　
打印日期 PRT_DATE datetime 0 　 　 　
单据类别 BIL_TYPE string 10 　 　 　
最近修改日期 MODIFY_DD datetime 0 　 　 　
最近修改人 MODIFY_MAN string 12 　 　 　
水单关联项次 KEY_ITM integer 0 　 　 　
对账否 CK_ID string 1 　 　 　
处理否 CL_ID string 1 　 　 　
水单多项次 MUL_ITM string 0 　 　 　
其他收入/支出冲帐库参数：
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表TF_MON3(其他收入/支出冲帐库)
收付款ID RP_ID string 1 是 　 必须与TF_MON的RP_ID相同
收付款单号 RP_NO string 20 是 　 必须与TF_MON的RP_NO相同
与TF_MON项 ITM integer 　 是 　 　
项次 ITM2 integer 　 是 　 　
会计科目 ACC_NO string 20 　 　 　
币别 CUR_ID string 4 　 　 　
汇率 EXC_RTO float 0 　 　 　
本位币金额 AMTN float 　 　 　 　
外币金额 AMT float 　 　 　 　
是溢(预)收款 YS_ID string 1 　 　 　
是扣款金额 KK_ID string 1 　 　 　
是否批次冲销时产生 ISMULT_CLS string 1 　 　 　
备注 REM string 100 　 　 　
部门代号 DEP string 8 　 　 　
经办人 SAL_NO string 12 　 　 　
客户代号 CUS_NO string 12 　 　 　
自定义代号 OBJ string 30 　 　 　
票据明细冲帐库参数：
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表TF_MON4(票据明细冲帐库)
收付款ID RP_ID string 1 是 　 必须与TF_MON的RP_ID相同
收付款单号 RP_NO string 20 是 　 必须与TF_MON的RP_NO相同
与TF_MON项 ITM integer 0 是 　 　
项次 ITM2 integer 0 是 　 　
币别 CUR_ID string 4 　 　 　
汇率 EXC_RTO float 0 　 　 　
票据号码 CHK_NO string 40 　 　 　
票据金额 AMTN_CHK float 0 　 　 　
票据金额(外) AMT_CHK float 0 　 　 　

请求JSON示例

{
  "REF_NO": "RT2009160001",      //第三方单号，必填
  "PGM": "MONAA",      //单据程序代号
  "TF_MON": [      //新增收付款表头冲帐信息
    {
      "RP_ID": "1",
      "RP_NO": "",
      "ITM": 1,
      "IRP_ID": "T",
      "CLS_ID": "F",
      "RP_DD": "2020-09-16 00:00:00",
      "CUS_NO": "C0001",
      "HS_ID": "F",
      "AMTN_TAX_IRP": 0.0,
      "AMT_TAX_IRP": 0.0,
      "AMTN_NET_IRP": 0.0,
      "AMTN_BC": 100.0,
      "AMTN_BB": 200.0,
      "AMTN_CHK": 300.0,
      "AMTN_OTHER": 400.0,
      "AMTN_IRP": 0.0,
      "AMT_CHK": 0.0,
      "CACC_NO": "201",
      "BACC_NO": "001",
      "EXC_RTO": 1.0,
      "USR_NO": "0001",
      "DEP": "103",
      "SK_TYPE": "1",
      "USR": "ADMIN",
      "CS_ID": "0",
      "IEA_ID": "F",
      "IOR_ID": "F"
    }
  ],
  "MF_MON": [         //新增收付款主库信息
    {
      "RP_ID": "1",
      "RP_NO": "",
      "RP_DD": "2020-09-16 00:00:00",
      "USR_NO": "0001",
      "DEP": "103",
      "AMTN": 1000.0,
      "USR": "ADMIN"
    }
  ],
  "TF_MON3": [         //新增其他收入/支出冲帐库信息
    {
      "RP_ID": "1",
      "RP_NO": "",
      "ITM": 1,
      "ITM2": 1,
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "AMTN": 400.0
    }
  ],
  "TF_MON4": [         //新增票据明细冲帐库信息
    {
      "RP_ID": "1",
      "RP_NO": "",
      "ITM": 1,
      "ITM2": 1,
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "CHK_NO": "P20200916001",
      "AMTN_CHK": 300.0,
      "CHK_KND": "0",
      "BANK_NO": "001",
      "BACC_NO": "001",
      "END_DD": "2020-09-30 00:00:00"
    }
  ]
}

返回结果示例

{
    "code": 0,             //为0表示执行成功，其他表示错误
    "message": "新增成功",           //提示信息
    "data": {
        "TF_MON": [                 //生成收付款表头冲帐信息
            {
                "RP_ID": "1",
                "RP_NO": "RT2009160001",
                "ITM": 1,
                "IRP_ID": "T",
                "CLS_ID": "F",
                "RP_DD": "2020-09-16 00:00:00",
                "CUS_NO": "C0001",
                "HS_ID": "F",
                "AMTN_TAX_IRP": 0.0,
                "AMT_TAX_IRP": 0.0,
                "AMTN_NET_IRP": 0.0,
                "INCLUDESON": "F",
                "AMTN_BC": 100.0,
                "AMTN_BB": 200.0,
                "AMTN_CHK": 300.0,
                "AMTN_OTHER": 400.0,
                "AMTN_IRP": 0.0,
                "AMTN_CLS": 0.0,
                "AMT_CHK": 0.0,
                "BC_NO": "BT2009160002",
                "CACC_NO": "201",
                "BB_NO": "BT2009160001",
                "BACC_NO": "001",
                "EXC_RTO": 1.0,
                "USR_NO": "0001",
                "DEP": "103",
                "SK_TYPE": "1",
                "USR": "ADMIN",
                "CHK_MAN": "ADMIN",
                "PRT_SW": "N",
                "AMT_CLS": 0.0,
                "CLS_DATE": "2020-09-16 00:00:00",
                "CS_ID": "0",
                "SYS_DATE": "2020-09-16 14:18:09",
                "IEA_ID": "F",
                "IOR_ID": "F"
            }
        ],
        "MF_MON": [                     //生成收付款主库信息
            {
                "RP_ID": "1",
                "RP_NO": "RT2009160001",
                "RP_DD": "2020-09-16 00:00:00",
                "USR_NO": "0001",
                "DEP": "103",
                "AMTN": 1000.0,
                "USR": "ADMIN",
                "CLS_DATE": "2020-09-16 00:00:00",
                "LOCK_MAN": "",
                "FJ_NUM": 0,
                "CAS_NO": ""
            }
        ],
        "TF_MON3": [                   //生成其他收入/支出冲帐库信息
            {
                "RP_ID": "1",
                "RP_NO": "RT2009160001",
                "ITM": 1,
                "ITM2": 1,
                "CUR_ID": "",
                "EXC_RTO": 1.0,
                "AMTN": 400.0
            }
        ],
        "TF_MON4": [                  //生成票据明细冲帐库信息
            {
                "RP_ID": "1",
                "RP_NO": "RT2009160001",
                "ITM": 1,
                "ITM2": 1,
                "CUR_ID": "",
                "EXC_RTO": 1.0,
                "CHK_NO": "P20200916001",
                "AMTN_CHK": 300.0,
                "CHK_KND": "0",
                "CUS_NO": "C0001",
                "BANK_NO": "001",
                "BACC_NO": "001",
                "END_DD": "2020-09-30 00:00:00",
                "CAH_DD": "2020-09-30 00:00:00"
            }
        ]
    }
}