发票 OCR 识别API接口查询
增值税发票结构化识别（普票/专票/电子票/全电/卷票等）。filters：image / url / pdf_file / ofd_file 四选一（优先级 image > url > pdf_file > ofd_file）；query 也可直接填图片 url。可选 type：normal（默认）或 roll（卷票）；seal_tag：是否开启印章识别；pdf_file_num / ofd_file_num：PDF/OFD 页码（默认第 1 页）。hits 字段名如 InvoiceNum、SellerName、CommodityTaxRate 等。本接口无分页，不支持 filters.offset。
已开放
调用入口：POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域（必填） | cloud |
| type | string | 数据类型（必填） | invoice_ocr |
| query | string | 自然语言检索词 | https://example.com/invoice.jpg |
| filters | object | 结构化过滤条件，见下方「常用 filters」 | — |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| url | string | 发票图片公网 URL（与 image/pdf_file/ofd_file 四选一） | https://example.com/invoice.jpg |
| image | string | 发票图片 base64（四选一；勿带过大正文） | — |
| pdf_file | string | 发票 PDF 的 base64（四选一） | — |
| ofd_file | string | 发票 OFD 的 base64（四选一） | — |
| pdf_file_num | string | PDF 页码（pdf_file 有效时，默认 1） | 1 |
| ofd_file_num | string | OFD 页码（ofd_file 有效时，默认 1） | 1 |
| type | string | 票种：normal（默认，普票/专票/电子票）或 roll（卷票） | normal |
| seal_tag | boolean | 是否开启印章识别（true/false） | false |
返回字段（hits[]）
| 字段 | 类型 | 说明 |
|---|---|---|
| InvoiceType | string | 发票种类 |
| InvoiceTypeOrg | string | 发票名称 |
| InvoiceCode | string | 发票代码 |
| InvoiceNum | string | 发票号码 |
| InvoiceDate | string | 开票日期 |
| CheckCode | string | 校验码 |
| PurchaserName | string | 购方名称 |
| PurchaserRegisterNum | string | 购方纳税人识别号 |
| PurchaserAddress | string | 购方地址及电话 |
| PurchaserBank | string | 购方开户行及账号 |
| SellerName | string | 销方名称 |
| SellerRegisterNum | string | 销方纳税人识别号 |
| SellerAddress | string | 销方地址及电话 |
| SellerBank | string | 销方开户行及账号 |
| TotalAmount | string | 合计金额 |
| TotalTax | string | 合计税额 |
| AmountInFiguers | string | 价税合计（小写） |
| AmountInWords | string | 价税合计（大写） |
| NoteDrawer | string | 开票人 |
| CommodityName | list | 货物名称 |
| CommodityAmount | list | 金额 |
| CommodityTaxRate | list | 税率 |
| CommodityTax | list | 税额 |
| source | string | 来源标识 |
| disclaimer | string | 数据口径说明 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"cloud", "type":"invoice_ocr", "query":"https://example.com/invoice.jpg", "filters":{ "url":"https://example.com/invoice.jpg", "pdf_file_num":"1", "ofd_file_num":"1", "type":"normal", "seal_tag":"false" } }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。