查询异步识别票据数据
接口说明
- url: /common/invoices/result
- method: POST
- 数据格式: JSON
- 限流信息:100次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明:票据识别任务编号查询,常与票据异步识别和票据异步识别结果查询 搭配使用。该接口返回已在系统中创建的消费记录和票据查询 VO,不返回 Loki/Thanos 原始 OCR 或查验 DTO。
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
|
| timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
|
| data |
JSON |
查询的参数 |
TRUE |
|
| data.identification_ids |
String[] |
票据识别任务列表 |
TRUE |
|
| data.language |
String |
语言 |
TRUE |
响应参数
| 字段名称 |
字段类型 |
字段描述 |
| bizId |
String |
当前次接口同步的唯一标识 |
| resCode |
Integer |
响应状态,200000 代表处理成功 |
| resMsg |
String |
返回信息描述 |
| data |
Object |
票据识别结果对象 |
| data.expenses |
Array |
识别结果列表 |
| data.expenses[].expense_id |
String |
消费记录 ID |
| data.expenses[].receipts |
Array |
已创建的票据列表 |
| data.expenses[].identification_id |
String |
票据识别任务 ID |
| data.expenses[].creation_date |
String |
创建日期 |
| data.expenses[].created_by |
String |
票据拥有人 |
| data.expenses[].receipts[].invoice_num |
String |
发票号码 |
| data.expenses[].receipts[].invoice_code |
String |
发票代码 |
| data.expenses[].receipts[].invoice_type |
String |
发票类型 |
| data.expenses[].receipts[].invoice_status |
String |
发票识别查验状态 |
| data.expenses[].receipts[].invoice_attachments |
Array |
票据附件列表 |
| data.expenses[].receipts[].invoice_attachments[].file_name |
String |
附件文件名 |
请求示例
{
"bizId" : "634899ef-d591-4829-ac18-0bcc135251ff",
"timestamp" : 1597910515274,
"data" : {
"identification_ids": ["123", "456", "789"],
"language": "zh_CN"
}
}
响应示例
处理成功时响应
{
"resCode" : 200000,
"resMsg" : "票据识别结果查询成功",
"bizId" : "c40f1bf0-e757-4a72-8863-fd6749821584",
"data" : {
"expenses": [
{
"expense_id": 123,
"receipts": [
{
"invoice_num": "123",
"invoice_code": "456",
"invoice_type": "01",
"invoice_attachments": [
{
"file_name": "abcdefg"
},...],
"invoice_status": "Y"
}
],
"identification_id": "34334",
"creation_date": "2020-09-18",
"created_by": "test"
}]
}
}
处理失败时响应
{
"resCode": 500000,
"resMsg": "票据识别结果查询失败!",
"bizId": "d629d829-d53c-4221-8cb1-4340949f67b6"
}