泰国预扣税证明 OCR

读取泰国预扣税证明（50 ทวิ），返回付款方、收款方、每笔付款及其预扣税，以及合计。

POST/ocr/v3/tax-deduction-certificate/file

另有 1 个端点

试一试

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

• v3.0
• 运行中

输入

输出POST /ocr/v3/tax-deduction-certificate/file

documentType

หนังสือรับรองการหักภาษี ณ ที่จ่าย

documentForm

ภ.ง.ด.3

bookNumber

TX63XXXX

taxDeductor

name: บริษัท XXXXXXXXXX จำกัด taxId: 010XXXXXXXX64 address: XXXX เขตจอมทอง กรุงเทพมหานคร 10150

taxpayer

name: นายXXXXX เป็นตัวอย่าง taxId: 31XXXXXXXX123 address: XXXX เขตสาทร กรุงเทพมหานคร

paymentTypes

paymentDate: 02/09/63 amount: 12000 withholdingTax: 360

totalAmount

12000

totalTax

360

taxPayerMethod

ออกภาษีให้ตลอดไป

全部字段见“响应”一节其他端点：/tax-deduction-certificate 见请求

请求

curl -X POST https://api.iapp.co.th/ocr/v3/tax-deduction-certificate/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@certificate.pdf"

响应

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

{
  "message": "success",
  "processed": {
    "documentType": "หนังสือรับรองการหักภาษี ณ ที่จ่าย",
    "documentForm": "ภ.ง.ด.3",
    "bookNumber": "TX63XXXX",
    "taxDeductor": { "name": "บริษัท XXXXXXXXXX จำกัด", "taxId": "010XXXXXXXX64",
                     "address": "XXXX เขตจอมทอง กรุงเทพมหานคร 10150" },
    "taxpayer": { "name": "นายXXXXX เป็นตัวอย่าง", "taxId": "31XXXXXXXX123",
                  "address": "XXXX เขตสาทร กรุงเทพมหานคร" },
    "paymentTypes": [ { "paymentDate": "02/09/63", "amount": 12000.00, "withholdingTax": 360.00 } ],
    "totalAmount": 12000.00,
    "totalTax": 360.00,
    "taxPayerMethod": "ออกภาษีให้ตลอดไป"
  },
  "confidence": { "documentForm": 0.95, "taxDeductor": 0.95, "taxpayer": 0.95, "totalTax": 0.95 }
}

请求

以 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/tax-deduction-certificate/file	文件	每页 1 IC

/v3/store/ocr/tax-deduction-certificate 是 store 前缀下的同一服务。

响应

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

processedobject

从文档读取的字段

processed.documentTypeprocessed.documentFormprocessed.bookNumberprocessed.documentNumber

文件及其表格：ภ.ง.ด.1ก、1ก พิเศษ、2、2ก、3、3ก 或 53

processed.taxDeductorobject

扣税的付款方

processed.taxDeductor.namestring

processed.taxDeductor.taxIdstring

processed.taxDeductor.addressstring

processed.taxpayerobject

收款方

processed.taxpayer.namestring

processed.taxpayer.taxIdstring

processed.taxpayer.addressstring

processed.paymentTypesarray

每笔付款一项

processed.paymentTypes.paymentDatestring

processed.paymentTypes.amountnumber

processed.paymentTypes.withholdingTaxnumber

processed.totalAmountprocessed.totalTax

合计

processed.socialSecurity

amount 与 year（如有）

processed.taxPayerMethodstring

หักภาษี ณ ที่จ่าย、ออกภาษีให้ตลอดไป、ออกภาษีให้ครั้งเดียว 或 อื่นๆ

messagestring

状态信息

confidenceobject

各字段置信度，0 到 1

状态码

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

详情

实测

在 5,000 份泰国预扣税证明的基准集上测得。

指标	结果
证明编号	99.5%
金额	99.8%
日期	99.0%
税号	99.7%
全部字段	99.5%
每份耗时	典型 25–30 秒，第 95 百分位 45 秒，最长 67 秒

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

限制

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

数据处理

服务符合 GDPR 与 PDPA。

更新日志

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