费用性质写入接口

业务场景说明

  1. 内部:有些公司有很多部门,配置费用性质时操作很复杂,需要有导入功能 ,提高实施效率。
  2. 某公司:由于部门变动,费用性质经常需要人为调整,希望费用性质能通过外部系统标签写入到费用性质

接口说明

  • 该接口目前的处理逻辑是全量更新,即通过接口写入的数据,会将之前的数据覆盖。需要增量写入请请查看[增量更新接口]
  • 考虑性能问题,单次导入暂限制为100条数据(指的是100条费用性质列表)
  • 因数据库查询性能及限制问题,填写的每个费用性质数据中的费用性质取值数据一次不能传递太多,最多几百个,否则查询数据库会报错,请注意

请求方式

POST

接口地址:

/api/openapi/voucher/accountingsubject/customoption/import

注:接口写入 部分参数填写规则请参考费用性质导入模板:

费用性质导入模版(空白).xlsx

请求参数说明:

字段名称 字段类型 必有 字段说明
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 往来单位费用性质支持将往来单位分类作为值写入*
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2025-01-09 09:00:14

results matching ""

    No results matching ""

    results matching ""

      No results matching ""