泰国收据 OCR

读取泰国收据或税务发票，印刷或手写皆可，返回开票方、客户、每个明细项和合计，各字段附置信度。

POST/ocr/v3/receipt/file

另有 1 个端点

试一试

• 价格1 IC每页
• 累计调用104.8K次

• v3.0
• 运行中

输入

输出POST /ocr/v3/receipt/file

invoiceType

ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ

invoiceBook

—

invoiceID

4504RC112566/004044

invoiceDate

27/11/2566

issuerName

หจก.บุญรอดคอฟฟี (ตลาดรัตนบุรี)

issuerTaxID

0323560000723

items

itemNo: 1 itemName: ชาเขียวนม ร้อน ขนาดใหญ่ itemUnit: 1 itemUnitCost: 60 itemTotalCost: 60

totalCost

60

discount

0

totalCostAfterDiscount

60

vat

3.93

grandTotal

60

全部字段见“响应”一节其他端点：/receipt 见请求

请求

curl -X POST https://api.iapp.co.th/ocr/v3/receipt/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@receipt.jpg"

响应

200成功。字段在"响应"一节说明。

{
    "message": "success",
    "processed": {
        "invoiceType": "ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ",
        "invoiceBook": null,
        "invoiceID": "4504RC112566/004044",
        "invoiceDate": "27/11/2566",
        "issuerName": "หจก.บุญรอดคอฟฟี (ตลาดรัตนบุรี)",
        "issuerTaxID": "0323560000723",
        "items": [
            {
                "itemNo": 1,
                "itemName": "ชาเขียวนม ร้อน ขนาดใหญ่",
                "itemUnit": 1,
                "itemUnitCost": 60.0,
                "itemTotalCost": 60.0
            }
        ],
        "totalCost": 60.0,
        "discount": 0.0,
        "totalCostAfterDiscount": 60.0,
        "vat": 3.93,
        "grandTotal": 60.0
    },
    "confidence": {
        "invoiceType": 0.95,
        "invoiceBook": 0.9,
        "invoiceID": 0.95,
        "invoiceDate": 0.9,
        "issuerName": 0.95,
        "issuerTaxID": 0.95,
        "items": 0.9,
        "totalCost": 0.95,
        "discount": 0.95,
        "totalCostAfterDiscount": 0.95,
        "vat": 0.95,
        "grandTotal": 0.95
    },
    "process_ms": 6821
}

请求

以 multipart/form-data 发送到 /file。PDF 最多 10 页。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

收据。JPEG、PNG、HEIC、HEIF 或 PDF，最大 10 MB。

return_imageboolean

设为 true 时以 Base64 返回处理后的图像。

return_ocrboolean

设为 true 时附带原始 OCR 文本。

端点	接受	价格
/ocr/v3/receipt/file	文件	每页 1 IC

/v3/store/ocr/receipt 是 store 前缀下的同一服务。

响应

return_ocr 为 true 时，raw 返回 OCR 文本。

processedobject

从文档读取的字段

processed.invoiceTypeprocessed.invoiceBookprocessed.invoiceIDprocessed.invoiceDateprocessed.purchaseOrderID

单据：标题或类型、册号、编号、日期，以及关联的采购订单

processed.issuerNameprocessed.issuerAddressprocessed.issuerTaxIDprocessed.issuerPhone

开票方

processed.customerNameprocessed.customerAddressprocessed.customerTaxIDprocessed.customerPhone

客户

processed.itemsarray

每行一项

processed.items.itemNointeger

processed.items.itemCode

processed.items.itemNamestring

processed.items.itemUnitinteger

processed.items.itemUnitCostnumber

processed.items.itemTotalCostnumber

processed.totalCostprocessed.discountprocessed.totalCostAfterDiscountprocessed.vatprocessed.grandTotal

合计，泰铢，保留两位小数；vat 为 7% 税额

messagestring

状态信息

confidenceobject

各字段置信度，0 到 1

process_msinteger

处理耗时，毫秒

状态码

代码	含义
400	参数或文件格式无效
404	未知端点
500	处理失败

详情

实测

在 10,000 张泰国收据的基准集上测得。

指标	结果
发票号	99.2%
金额	99.5%
日期	98.7%
明细项	97.8%
全部字段	98.8%
耗时	典型 5–10 秒，第 95 百分位 12 秒，最长 15 秒

标准版式识别率 99% 以上，非标准版式 95% 以上，手写部分 90% 以上。

限制

• 泰文文档。
• 每个 API 密钥每秒 10 次请求。
• 分辨率低于 300 dpi、光线差、破损、褪色或手写修改会降低准确率。

数据处理

服务符合 GDPR 与 PDPA。

更新日志

版本	日期	变更
3.0	2024 年 12 月 27 日	首次发布。