生成【报销单】接口
概述
该接口主要用于第三方平台或自主研发者，通过调用【报销单】的生成接口，将第三方的报销费用信息推送到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 | 为小写token，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 | Integer | 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 | Integer | 0 | |||
| 冲借款金额 | AMTN_CJK | Integer | 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 | Integer | 是 | |||
| 本位币 | AMTN | Integer | 是 | |||
| 核准付款金额 | AMTN_SH | Integer | 已知核准金额则要输入 | |||
| 摘要 | REM | string | 200 | |||
| 报销项次 | BX_ITM | Integer | 是 | |||
| 冲销金额 | BX_AMT | Integer | ||||
| 核准付款金额(外) | AMT_SH | Integer | 已知核准金额则要输入 | |||
| 鞋服组合栏位 | 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 | |
| 税额 | TAX | Integer | 0 | |||
| 外币税额 | AMT_TAX | Integer | 0 | |||
| 税率 | TAX_RTO | Integer | 0 | |||
| 核准税额 | TAX_SH | Integer | 0 | |||
| 核准外币税额 | AMT_TAX_SH | Integer | 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 | Integer | 0 | |||
| 单价 | UP | Integer | 0 | |||
| 冲借款金额（外） | AMT_CJK | Integer | 0 | |||
| 冲借款金额 | AMTN_CJK | Integer | 0 | |||
| 客户/厂商代号 | CUS_NO | string | 12 | |||
| 已转固定资产 | FLG_FX | string | 1 | |||
| 冲借款税额 | TAX_CJK | Integer | 0 | |||
| 冲借款税额(外) | AMT_TAX_CJK | Integer | 0 | |||
| 核准金额 | AMTN_CHK | Integer | 0 | 是 | 与AMTN_SH一样 | |
| 核准金额(外) | AMT_CHK | Integer | 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": "AA200800000000000007", //第三方单号，必填 "PGM": "MONBX", //单据程序代号 "MF_BX": [ //新增单据表头信息 { "BX_NO": "AA200800000000000007", //为手工编码时必须与REP_NO相同 "BX_DD": "2020-08-11 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": "AA200800000000000007", "ITM": 1, "BX_DD": "2020-08-11 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": "AA200800000000000013",
"BX_DD": "2020-08-11 00:00:00",
"DEP": "00000000",
"USR_NO": "9999",
"PAY_ID": "银行付款",
"PRT_SW": "N",
"CHK_MAN": "ADMIN",
"USR": "ADMIN",
"CLS_DATE": "2020-08-11 00:00:00",
"BIL_TYPE": "",
"REM": "表身备注",
"CLS_ID": "F",
"MOB_ID": "",
"SYS_DATE": "2020-08-11 11:47:00",
"BNK_NO": "001",
"FK_EST_DD": "2020-08-12 00:00:00",
"LJ_BX1": "AABBCC"
}
],
"TF_BX": [ //生成的单据表身信息
{
"BX_NO": "AA200800000000000013",
"ITM": 1,
"BX_DD": "2020-08-11 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": "AA200800000000000013"
}
],
"TF_BX_Z": [ //已插入表身自定义栏位信息
{
"LJ_BX2": "AABBCC",
"BX_NO": "AA200800000000000013",
"ITM": 1
}
]
}
}