票据/消费记录查询
- 接口:common/invoices/result
- Method:POST
- 数据格式:JSON
- 限流信息:100次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明:票据/消费记录查询
- 其他补充信息:
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
|
timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
|
data |
JSON |
查询的参数 |
TRUE |
|
data.identification_ids |
String[] |
票据识别任务列表 |
TRUE |
|
data.language |
String |
语言 |
TRUE |
返回参数
字段名称 |
字段类型 |
字段描述 |
bizId |
String |
当前次接口同步的唯一标识 |
resMsg |
String |
返回信息描述 |
bizId |
String |
唯一标识 |
data |
Array |
票据信息 |
data.expenses |
Array |
识别结果列表 |
data.expense.expense_id |
String |
消费记录id |
data.expense.receipts |
Array |
票据信息 |
data.expense.identification_id |
String |
票据识别任务id |
data.expense.creation_date |
String |
创建日期 |
data.expense.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_attachments |
Array |
附件文件列表 |
data.expenses.receipts.invoice_status |
String |
识别状态 Y 已验真 F 查验失败 C 待查验 |
示例:
请求数据
{
"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",
"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",
}