不匹配数据映射写入

业务场景说明

凭证不匹配数据映射写入接口,当每刻中的基础数据和财务系统中的不一致时可以同步不匹配数据映射功能将每刻中的数据映射为财务系统中对应的编码和名称。本文档说明如何通过接口请求方式,将不匹配的映射关系写入每刻报销内。

注:financeCode 请查看编码对照表

接口说明

  • 单次导入限制为100条数据

请求方式

POST

一、员工

接口地址

/openapi/voucher/mapping/employee/import

请求参数

参数说明

字段名称 字段说明 必有 字段类型
financeCode 财务系统版本编码编码对照表 String
mappingSetBizCode 映射集编码 String
dataList 导入的员工工号映射关系 List<object>
    bizCode 员工工号业务编码 String
    mappingCode 映射后编码 String
    mappingName 映射后名称 String

参数示例

{
    "financeCode": "F02",
    "mappingSetBizCode": "VMS200413Y261USG",
    "dataList": [
        {
            "bizCode": "MK003",
            "mappingCode": "0417001",
            "mappingName": "员工A"
        },
        {
            "bizCode": "MK004",
            "mappingCode": "0417002",
            "mappingName": "员工B"
        }
    ]
}

响应参数

参数说明

字段名称 字段说明 必有 字段类型
businessCode 导入的业务编码 String
status 导入状态(成功为true,失败为false) boolean
messageList 错误信息(仅导入失败时返回) List<string>

参数示例

{
    "code": "ACK",
    "message": "message.success",
    "data": [
        {
            "businessCode": "MK003",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "MK004",
            "status": false,
            "messageList": [
                "未查询到匹配的业务编码"
            ]
        }
    ],
    "success": true
}

二、部门

接口地址

api/openapi/voucher/mapping/department/import

请求参数

参数说明

字段名称 字段说明 必有 字段类型
financeCode 财务系统版本编码编码对照表 String
mappingSetBizCode 映射集编码 String
groupList 导入的部门映射关系 List<object>
    bizCodes 部门业务编码 List<string>
    mappingCode 映射后编码 String
    mappingName 映射后名称 String
includeChildDept 是否包含子部门(false-不包含,true-包含 如果不填,默认是false) Boolean

参数示例

{
    "financeCode": "F02",
    "mappingSetBizCode": "VMS20041611X6EIRN",
    "groupList": [
        {
            "mappingCode": "0417-001",
            "mappingName": "0417部门A",
            "bizCodes": [
                "DI1805221OYZHJK6",
                "DI1908071UXF1NGH",
                "DI2001061HIX0IYR"
            ],
            "includeChildDept":true
        }
    ]
}

响应参数

参数说明

字段名称 字段说明 必有 字段类型
businessCode 导入的业务编码 String
status 导入状态(成功为true,失败为false) boolean
messageList 错误信息(仅导入失败时返回) List<string>

参数示例

{
    "code": "ACK",
    "message": "message.success",
    "data": [
        {
            "businessCode": "DI2001061HIX0IYR",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "DI1805221OYZHJK6",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "DI1908071UXF1NGH",
            "status": true,
            "messageList": []
        }
    ],
    "success": true
}

三、自定义档案(选项组)组别

接口地址

api/openapi/voucher/mapping/optiongroup/import

请求参数

参数说明

字段名称 字段说明 必有 字段类型
financeCode 财务系统版本编码编码对照表 String
mappingSetBizCode 映射集编码 String
dataList 导入的选项组映射关系 List<object>
    bizCode 选项组业务编码 String
    mappingCode 映射后编码 String
    mappingName 映射后名称 String

参数示例

{
    "financeCode": "F02",
    "mappingSetBizCode": "VMS200413Y261URW",
    "dataList": [
        {
            "bizCode": "RD1808111P2FW9OG",
            "mappingCode": "0417-001",
            "mappingName": "0417测试选项组A"
        },
        {
            "bizCode": "EC1803221E22UHXD_CT1804161M4OYRY8",
            "mappingCode": "0417-002",
            "mappingName": "0417测试选项组B"
        }
    ]
}

响应参数

参数说明

字段名称 字段说明 必有 字段类型
businessCode 导入的业务编码 String
status 导入状态(成功为true,失败为false) boolean
messageList 错误信息(仅导入失败时返回) List<string>

参数示例

{
    "code": "ACK",
    "message": "message.success",
    "data": [
        {
            "businessCode": "EC1803221E22UHXD_CT1804161M4OYRY8",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "RD1808111P2FW9OG",
            "status": true,
            "messageList": []
        }
    ],
    "success": true
}

四、选项

接口地址

api/openapi/voucher/mapping/optionitem/import

请求参数

参数说明

字段名称 字段说明 必有 字段类型
financeCode 财务系统版本编码编码对照表 String
mappingSetBizCode 映射集编码 String
groupList 导入的选项映射关系 List<object>
    bizCodes 选项业务编码 List<string>
    mappingCode 映射后编码 String
    mappingName 映射后名称 String
    groupCode 选项所属的选项组业务编码 String

参数示例

{
    "financeCode": "F02",
    "mappingSetBizCode": "VMS2004161EZQ31FK",
    "groupList": [
        {
            "mappingCode": "0417-001",
            "mappingName": "0417选项单位A",
            "groupCode":"RD2004151N01OB9C",
            "bizCodes": [
                "RDD2004151N0EST1C",
                "RDD2004151N091U68",
                "DI2001061HIX0IYR"
            ]
        }
    ]
}

响应参数

参数说明

字段名称 字段说明 必有 字段类型
businessCode 导入的业务编码 String
status 导入状态(成功为true,失败为false) boolean
messageList 错误信息(仅导入失败时返回) List<string>

参数示例

{
    "code": "ACK",
    "message": "message.success",
    "data": [
        {
            "businessCode": "RDD2004151N0EST1C",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "RDD2004151N091U68",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "DI2001061HIX0IYR",
            "status": false,
            "messageList": [
                "未查询到匹配的业务编码"
            ]
        }
    ],
    "success": true
}

五、币种

接口地址

api/openapi/voucher/mapping/currency/import

注意事项 目前系统仅支持传“CNY”类型

请求参数

参数说明

字段名称 字段说明 必有 字段类型
financeCode 财务系统版本编码编码对照表 String
mappingSetBizCode 映射集编码 String
dataList 导入的币种映射关系 List<object>
    bizCode 币种业务编码 String
    mappingCode 映射后编码 String
    mappingName 映射后名称 String

参数示例

{
    "financeCode": "F02",
    "mappingSetBizCode": "VMS200413Y261URY",
    "dataList": [
        {
            "bizCode": "CNY2",
            "mappingCode": "0419-001",
            "mappingName": "币种1"
        },
        {
            "bizCode": "CNY3",
            "mappingCode": "0419-003",
            "mappingName": "币种2"
        }
    ]
}

响应参数

参数说明

字段名称 字段说明 必有 字段类型
businessCode 导入的业务编码 String
status 导入状态(成功为true,失败为false) boolean
messageList 错误信息(仅导入失败时返回) List<string>

参数示例

{
    "code": "ACK",
    "message": "message.success",
    "data": [
        {
            "businessCode": "CNY3",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "CNY2",
            "status": true,
            "messageList": []
        }
    ],
    "success": true
}

六、往来单位

接口地址

api/openapi/voucher/mapping/tradingpartner/import

请求参数

参数说明

字段名称 字段说明 必有 字段类型
financeCode 财务系统版本编码编码对照表 String
mappingSetBizCode 映射集编码 String
groupList 导入的往来单位映射关系 List<object>
    bizCodes 往来单位业务编码 List<string>
    mappingCode 映射后编码 String
    mappingName 映射后名称 String

参数示例

{
    "financeCode": "F02",
    "mappingSetBizCode": "VMS20041611X6EIRO",
    "groupList": [
        {
            "mappingCode": "0417-001",
            "mappingName": "0417往来单位A",
            "bizCodes": [
                "DI1805221OYZHJK6",
                "DI1908071UXF1NGH",
                "DI2001061HIX0IYR"
            ]
        }
    ]
}

响应参数

参数说明

字段名称 字段说明 必有 字段类型
businessCode 导入的业务编码 String
status 导入状态(成功为true,失败为false) boolean
messageList 错误信息(仅导入失败时返回) List<string>

参数示例

{
    "code": "ACK",
    "message": "message.success",
    "data": [
        {
            "businessCode": "DI1805221OYZHJK6",
            "status": true,
            "messageList": []
        },
        {
            "businessCode": "DI2001061HIX0IYR",
            "status": true,
            "messageList": []
        }
    ],
    "success": true
}

修改记录:

2021-09-08 部门不匹配数据映射写入接口新增 是否包含子部门-includeChildDept 参数 2022-07-27 币种不匹配数据映射写入接口放开仅人民币的限制

Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""