批量转移票据

  • 接口:/common/invoices/receiptTransfer
  • Method:POST
  • 数据格式:JSON
  • 限流信息:100次每天和50次每小时
  • 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种

接口说明:此接口用于票据转发接口,支持单张发票和批量发票的转发操作,转发给他人则变更持有人。

  • 其中有一些校验规则需要知晓:
    1. 转发给自己则不进行转发
    2. 票据全部已报销则不进行转发

请求参数

字段名称 字段类型 字段描述 是否必填
expense_ids Integer List 票据id true
employee_number String 目标员工code true
user_name String 目标员工姓名 false

注意:请求参数中系统将优先使用employee_number,当系统发现employee_number未传值而user_name赋值了, 那么系统能够兼容使用user name进行目标员工信息的获取。当二者都未传值那么系统将报错:"票据转移到人员为空!"

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码(见附录)
resMsg String 响应描述信息
bizId String 请求唯一标识码
validatorErrors Array 字段强校验不合格的数据

示例:

请求数据

{
    "bizId": "c40f1bf0-e757-4a72-8863-fd6749821584",
    "timestamp": 1591266599229,
    "data": {
         "employee_number": "support-1368579927556096@cloudpense.com",
         "expense_ids" : [5299]
    }
}

返回数据

执行成功
{
    "resCode": 200000,
    "resMsg": "票据查验接口调用成功!",
    "bizId": "c40f1bf0-e757-4a72-8863-fd6749821584",
    "data": {
        "validatorErrors": []
    }
}
执行失败
{
    "resCode": 200000,
    "resMsg": "票据查验接口调用成功!",
    "bizId": "c40f1bf0-e757-4a72-8863-fd6749821584",
    "data": {
        "validatorErrors": [
            {
                "code": "3385918",
                "messages": "未查询到符合规范的票据"
            }
        ]
    }
}

results matching ""

    No results matching ""