生成【报销单】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【报销单】的生成接口，将第三方员工报销费用的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【报销单】。
参数说明
1.请求方式
| 请求方式 | POST | |||||
| 接口地址 | http://ERPAPI站点/MONBX/ADDDATA | |||||
| 格式 | JSON | |||||
| 编码类型 | UTF-8 | |||||
2.header参数
| Content-Type | application/json | |||||
| Authorization | token | 授权接口所获取的值 | ||||
3.请求参数
| 字段名称 | 字段代号 | 类型 | 长度 | 必填 | 固定值 | 备注 |
| 第三方单号 | REF_NO | 是 | 第三方单号，必填 | |||
| 程序代号 | PGM | 是 | MONBX | |||
| 数据表MF_BX | ||||||
| 报帐单号 | BX_NO | string | 20 | 是 | 1.自动编码，则不用传值； 2.手工编码，则与REF_NO必须相同 |
|
| 报帐日期 | BX_DD | datetime | 是 | |||
| 报帐部门 | DEP | string | 8 | 是 | ||
| 报帐人员 | USR_NO | string | 12 | 是 | ||
| 支付方式 | PAY_ID | string | 10 | 是 | 银行付款’ 或 ‘现金付款’ | |
| 打印注记 | PRT_SW | string | 1 | |||
| 拷贝注记 | CPY_SW | string | 1 | |||
| 审核人 | CHK_MAN | string | 12 | |||
| 制单人 | USR | string | 12 | 是 | ||
| 终审日期 | CLS_DATE | datetime | ||||
| 备注 | REM | string | 0 | |||
| 币别 | CUR_ID | string | 4 | |||
| 汇率 | EXC_RTO | Integer | ||||
| 结案标志 | CLS_ID | string | 1 | |||
| 审核模版 | MOB_ID | string | 10 | |||
| 锁单人 | LOCK_MAN | string | 12 | |||
| 锁单时间 | LOCK_DATE | datetime | 0 | |||
| 输单日期 | SYS_DATE | datetime | ||||
| 打印人员 | PRT_USR | string | 12 | |||
| 转入单据别 | OS_ID | string | 2 | |||
| 转入单据号 | OS_NO | string | 20 | |||
| 作废标记 | CANCEL_ID | string | 1 | |||
| 工程案号 | CAS_NO | string | 20 | |||
| 打印日期 | PRT_DATE | datetime | 0 | |||
| 单据类别 | BIL_TYPE | string | 10 | |||
| 凭证模版 | VOH_ID | string | 2 | |||
| 凭证号码 | VOH_NO | string | 20 | |||
| 报销类型 | BX_TYPE | string | 2 | |||
| 收款人(员工) | SAL_NO_SK | string | 12 | |||
| 收款人(供应商) | CUS_NO_SK | string | 12 | |||
| 冲借款金额 | AMTN_JK_CLS | float | 0 | |||
| 补单扣款帐户 | BACC_NO_BD | string | 4 | |||
| 最近修改日期 | MODIFY_DD | datetime | 0 | |||
| 最近修改人 | MODIFY_MAN | string | 12 | |||
| 收款银行 | BNK_NO | string | 7 | 当PAY_ID=银行付款，才要在此字段输入银行代号 | ||
| 银行帐号 | ID_CODE | string | 30 | |||
| 收款人名称 | SK_NAME | string | 50 | |||
| 计划付款日 | FK_EST_DD | datetime | 0 | |||
| 冲借款金额（外） | AMT_CJK | float | 0 | |||
| 冲借款金额 | AMTN_CJK | float | 0 | |||
| 还款单ID | HK_ID | string | 2 | |||
| 还款单号 | HK_NO | string | 20 | |||
| 已转资金付款申请标志 | FLAG_FKSQ | string | 1 | |||
| 已转网银付款申请标志 | FLAG_FKSQ_WY | string | 1 | |||
| 需切制凭证 | FLAG_VOH | string | 1 | |||
| 合同号 | CONTRACT | string | 80 | |||
| 数据表TF_BX | ||||||
| 报帐单号 | BX_NO | string | 20 | 是 | 必须与MF_BX的BX_NO相同 | |
| 项次 | ITM | Integer | 是 | |||
| 报帐日期 | BX_DD | datetime | ||||
| 费用科目 | ACC_NO | string | 20 | 需要切凭证要在此字段输入科目代号 | ||
| 外币金额 | AMT | float | 是 | |||
| 本位币 | AMTN | float | 是 | |||
| 核准付款金额 | AMTN_SH | float | 已知核准金额则要输入 | |||
| 摘要 | REM | string | 200 | |||
| 报销项次 | BX_ITM | Integer | 是 | |||
| 冲销金额 | BX_AMT | float | ||||
| 核准付款金额(外) | AMT_SH | float | 已知核准金额则要输入 | |||
| 鞋服组合栏位 | COMPOSE_IDNO | string | 50 | |||
| 核准人 | SAL_NO | string | 12 | 已知核准人则要输入 | ||
| 费用代号 | FEE_ID | string | 10 | |||
| 起始日期 | SDAY | datetime | ||||
| 结束日期 | EDAY | datetime | ||||
| 天数 | DAYS | Integer | 0 | |||
| 单据张数 | FORM_CNT | Integer | ||||
| 工程案号 | CAS_NO | string | 20 | |||
| 阶段编号 | TASK_ID | Integer | 0 | |||
| 部门代号 | DEP | string | 8 | |||
| 转入单据别 | OS_ID | string | 2 | |||
| 转入单据号 | OS_NO | string | 20 | |||
| 扣税类别 | TAX_ID | string | 1 | 1不扣税；2应税内含；3应税外加，默认为1 | ||
| 税额 | float | float | 0 | |||
| 外币税额 | float | float | 0 | |||
| 税率 | TAX_RTO | Integer | 0 | |||
| 核准税额 | TAX_SH | float | 0 | |||
| 核准外币税额 | AMT_TAX_SH | float | 0 | |||
| 发票号码 | INV_NO | string | 20 | |||
| 发票日 | INV_DD | datetime | 0 | |||
| 申报期别 | INV_YM | Integer | 0 | |||
| 买受人抬头 | TITLE_BUY | string | 50 | |||
| 发票别 | METH_ID | string | 2 | |||
| 发票金额 | AMT_INV | Integer | 0 | |||
| 发票税额 | TAX_INV | Integer | 0 | |||
| 自定义代号 | OBJ | string | 30 | |||
| 发票来源单ID | INV_BIL_ID | string | 2 | |||
| 发票来源单号 | INV_BIL_NO | string | 20 | |||
| 报销人员 | SAL_NO_BX | string | 12 | 要与表头的USR_NO一样 | ||
| 数量 | QTY | float | 0 | |||
| 单价 | UP | float | 0 | |||
| 冲借款金额（外） | AMT_CJK | float | 0 | |||
| 冲借款金额 | AMTN_CJK | float | 0 | |||
| 客户/厂商代号 | CUS_NO | string | 12 | |||
| 已转固定资产 | FLG_FX | string | 1 | |||
| 冲借款税额 | TAX_CJK | float | 0 | |||
| 冲借款税额(外) | AMT_TAX_CJK | float | 0 | |||
| 核准金额 | AMTN_CHK | float | 0 | 与AMTN_SH一样 | ||
| 核准金额(外) | AMT_CHK | float | 0 | 与AMT_SH一样 | ||
| 统一编号 | UNI_NO_PAY | string | 20 | |||
| 费用转固定资产标识 | FLG_UK | string | 1 | |||
4.自定义参数
| 字段名称 | 字段代号 | 类型 | 长度 | 是否 | 固定值 | 备注 |
| 数据表MF_BX_Z（表头自定义字段） | ||||||
| 自定义栏位1 | 自定义 | string | 2 | 自定义字段可为文件、数字、日期、备注等类型，若为数字字段，可用于计算，例如自定义三个字段：JD_NO1,JD_NO2,JD_NO3，而JD_NO3=JD_NO1*JD_NO2，那么在JSON里只要上传JD_NO1和JD_NO2即可。 | ||
| 自定义栏位2 | 自定义 | string | ||||
| …… | …… | …… | ||||
| 数据表TF_BX_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": "LJAA200800000008", //第三方单号，必填 "PGM": "MONBX", //单据程序代号 "MF_BX": [ //新增单据表头信息 { "BX_NO": "LJAA200800000008", "BX_DD": "2020-08-18 00:00:00", "DEP": "00000000", "USR_NO": "9999", "PAY_ID": "银行付款", "USR": "ADMIN", "BIL_TYPE": "", "REM": "表身备注", "CLS_ID": "F", "MOB_ID": "", "BNK_NO": "001", "FK_EST_DD": "2020-08-12 00:00:00", "LJ_BX1":"AABBCC" //表头自定义栏位信息 } ], "TF_BX": [ //新增单据表身信息 { "BX_NO": "LJAA200800000008", "ITM": 1, "BX_DD": "2020-08-18 00:00:00", "ACC_NO": "1002", "AMT": 1000.0, "AMTN": 1000.0, "AMTN_SH": 800.0, "REM": "出差使用", "BX_ITM": 1, "AMT_SH": 800.0, "SAL_NO": "0001", "FEE_ID": "01", "DEP": "00000000", "CAS_NO": "", "TAX_ID": "1", "TAX": 0.0, "AMT_TAX": 0.0, "TAX_RTO": 5.0, "TAX_SH": 0.0, "AMT_TAX_SH": 0.0, "TAX_CJK": 0.0, "AMT_TAX_CJK": 0.0, "SAL_NO_BX": "9999", "AMTN_CHK": 800.0, "AMT_CHK": 800.0, "LJ_BX2":"AABBCC" //表身自定义栏位信息 } ] }
返回结果示例
{ "code": 0, //为0表示执行成功，其他表示错误 "message": "新增成功", //提示信息 "data": { "MF_BX": [ //生成单据表头信息 { "BX_NO": "LJAA200800000008", "BX_DD": "2020-08-18 00:00:00", "DEP": "00000000", "USR_NO": "9999", "PAY_ID": "银行付款", "PRT_SW": "N", "CHK_MAN": "ADMIN", "USR": "ADMIN", "CLS_DATE": "2020-08-18 00:00:00", "BIL_TYPE": "", "REM": "表身备注", "CLS_ID": "F", "MOB_ID": "", "SYS_DATE": "2020-08-20 16:45:10", "BNK_NO": "001", "FK_EST_DD": "2020-08-12 00:00:00", "LJ_BX1": "AABBCC" } ], "TF_BX": [ //生成单据表身信息 { "BX_NO": "LJAA200800000008", "ITM": 1, "BX_DD": "2020-08-18 00:00:00", "ACC_NO": "1002", "AMT": 1000.0, "AMTN": 1000.0, "AMTN_SH": 800.0, "REM": "出差使用", "BX_ITM": 1, "AMT_SH": 800.0, "SAL_NO": "0001", "FEE_ID": "01", "DEP": "00000000", "CAS_NO": "", "TAX_ID": "1", "TAX": 0.0, "AMT_TAX": 0.0, "TAX_RTO": 5.0, "TAX_SH": 0.0, "AMT_TAX_SH": 0.0, "TAX_CJK": 0.0, "AMT_TAX_CJK": 0.0, "SAL_NO_BX": "9999", "AMTN_CHK": 800.0, "AMT_CHK": 800.0, "LJ_BX2": "AABBCC" } ], "MF_BX_Z": [ //生成单据表头自定义信息 { "LJ_BX1": "AABBCC", "BX_NO": "LJAA200800000008" } ], "TF_BX_Z": [ //生成单据表身自定义信息 { "LJ_BX2": "AABBCC", "BX_NO": "LJAA200800000008", "ITM": 1 } ] } }