费用性质写入接口
业务场景说明
- 内部:有些公司有很多部门,配置费用性质时操作很复杂,需要有导入功能 ,提高实施效率。
- 某公司:由于部门变动,费用性质经常需要人为调整,希望费用性质能通过外部系统标签写入到费用性质
接口说明
- 该接口目前的处理逻辑是全量更新,即通过接口写入的数据,会将之前的数据覆盖。需要增量写入请请查看[增量更新接口]
- 考虑性能问题,单次导入暂限制为100条数据(指的是100条费用性质列表)
- 因数据库查询性能及限制问题,填写的每个费用性质数据中的费用性质取值数据一次不能传递太多,最多几百个,否则查询数据库会报错,请注意
请求方式
POST
接口地址:
/api/openapi/voucher/accountingsubject/customoption/import
注:接口写入 部分参数填写规则请参考费用性质导入模板:
请求参数说明:
字段名称 | 字段类型 | 必有 | 字段说明 |
---|---|---|---|
dataList | List<object> | 是 | 导入的费用性质列表 |
customOptionCategoryName | String | 是 | 费用性质类别 (填写系统维护的对应的费用性质名称:公司抬头/承担部门/承担人/平台类型/费用类型/单据小类/往来单位/对公费用业务场景/自定义档案/发票类型/税率类型) |
referenceDataName | String | 否 | 自定义档案名称(费用性质类别是自定义档案时,该自定义档案名称必填) |
customOptionName | String | 是 | 费用性质名称 (选择的费用性质类别对应的填写的名称) |
customOptionValue | String | 否 | 费用性质取值 (当费用性质类别选择平台类型/对公费用业务场景/发票类型/税率类型/往来单位时,必填。 如果不需要限定费用性质取值请填写“全部”(使用中文双引号); 当选择往来单位时,该字段填写:全部供应商/全部客户/往来单位) |
customOptionValueBizCode1 | String | 否 | 费用性质取值对应的编码1 (当费用性质选择:公司抬头/承担部门/承担人(承担人选择人员时,填写对应员工的工号)/费用类型/单据小类/自定义档案时,必填。 如果不需要限定费用性质取值请填写“全部”(使用中文双引号);如有多个,请用中文逗号","分隔 |
customOptionValueBizCode2 | String | 否 | 费用性质取值对应的编码2 (费用性质类别是承担人(承担人选择的是用户组时,填写对应用户组的系统维护的外部编码)) |
isIncludeChildDept | boolean | 否 | 是否包含下级 |
请求参数示例:
部门
{
"dataList":[
{
"customOptionCategoryName":"承担部门",
"referenceDataName":"",
"customOptionName":"STT的部门",
"customOptionValue":"",
"customOptionValueBizCode1":"DI210809ZZUGGAO,DI21081312GF5534",
"customOptionValueBizCode2":"",
"isIncludeChildDept":false
},
{
"customOptionCategoryName":"承担人",
"referenceDataName":"",
"customOptionName":"承担人测试",
"customOptionValue":"",
"customOptionValueBizCode1":"ZXW001,ZCY001",
"customOptionValueBizCode2":"UG2107301CGRTYTF,UG2107221ARM9YFI",
"isIncludeChildDept":false
}
]
}
往来单位:
往来单位(费用性质取值customOptionValue为:全部供应商/全部客户)
{
"dataList":[
{
"customOptionCategoryName":"往来单位",
"referenceDataName":"",
"customOptionName":"全部供应商的往来单位",
"customOptionValue":"全部供应商",
"customOptionValueBizCode1":"",
"customOptionValueBizCode2":"",
"isIncludeChildDept":false
}
]
}
往来单位(费用性质取值customOptionValue为:往来单位)
{
"dataList":[
{
"customOptionCategoryName":"往来单位",
"referenceDataName":"",
"customOptionName":"取值选择往来单位",
"customOptionValue":"往来单位",
"customOptionValueBizCode1":"test_1,test_2",
"customOptionValueBizCode2":"",
"isIncludeChildDept":false
}
]
}
往来单位(费用性质取值customOptionValue为:“全部”)
{
"dataList":[
{
"customOptionCategoryName":"往来单位",
"referenceDataName":"",
"customOptionName":"取值选择往来单位",
"customOptionValue":"“全部”",
"customOptionValueBizCode1":"",
"customOptionValueBizCode2":"",
"isIncludeChildDept":false
}
]
}
响应参数说明:
参数说明
字段名称 | 字段说明 | 必有 | 字段类型 |
---|---|---|---|
customOptionCategoryName | 费用性质类别 (费用性质类别_费用性质名称 拼接返回) |
是 | String |
status | 导入状态(成功为true,失败为false) | 是 | boolean |
messageList | 错误信息(仅导入失败时返回) | 否 | List<string> |
响应参数示例:
{
"code": "ACK",
"message": "",
"data": [
{
"businessCode": "承担人_承担人测试",
"status": true,
"messageList": []
},
{
"businessCode": "承担部门_STT的部门",
"status": false,
"messageList": [
"费用性质名称不存在"
]
}
],
"success": true
}
接口修改记录
2021-12-30 添加接口说明、字段说明
2022-04-14 DB-23267 往来单位费用性质支持按照往来单位类型全选需求新增逻辑。具体见:请求参数说明、请求参数示例
2022-06-27 DB-28255 新增费用性质删除接口
2022-11-01 DB-33555 往来单位费用性质支持将往来单位分类作为值写入*