批量转移票据
- 接口:/common/invoices/receiptTransfer
- Method:POST
- 数据格式:JSON
- 限流信息:100次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
接口说明:此接口用于票据转发接口,支持单张发票和批量发票的转发操作,转发给他人则变更持有人。
- 其中有一些校验规则需要知晓:
- 转发给自己则不进行转发
- 票据全部已报销则不进行转发
请求参数
字段名称 | 字段类型 | 字段描述 | 是否必填 |
---|---|---|---|
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": "未查询到符合规范的票据"
}
]
}
}