📄 泰国税款扣除证明 OCR
1 IC每页
欢迎来到泰国税款扣除证明 OCR API,这是由艾艾普科技有限公司开发的一款人工智能解决方案,用于从泰国税款扣除证明中提取数据。本文档将帮助您有效集成和使用我们的 OCR 服务。
试用演示!
入门指南
-
前提条件
- 艾艾普科技的 API 密钥
- 泰国税款扣除证明图片
- 支持的文件格式:JPEG, JPG, PNG, HEIC, HEIF, PDF
- 最大文件大小:10MB
-
快速入门
- 快速处理(每份文档 5-10 秒)
- 高精度文本提取
- 支持多种文件格式
-
主要功能
- 详细字段提取,包括:
- 证明详情(ID,日期)
- 扣缴义务人信息(姓名,地址,税号)
- 纳税人信息(姓名,地址,税号)
- 收入详情(类型,金额,代扣税款)
- 财务摘要(总收入,总代扣税款)
- 支持单页和多页文档(PDF)
- 可选返回原始 OCR 文本和处理后的图像
- 灵活的 JSON 响应格式,包含详细的字段提取
- 详细字段提取,包括:
-
安全与合规
- 符合 GDPR 和 PDPA
- 安全的 API 端点
- 处理后不保留数据
我们的 API 旨在处理泰国常用的各种税款扣除证明格式和布局。后处理人工智能模型经过训练,能够理解泰国税务文件结构,即使在嘈杂或扫描质量差的文档中也能可靠地提取信息。
示例
以下是泰国税款扣除证明的样本及其提取的数据:
请求:
cURL
curl -X POST https://api.iapp.co.th/ocr/v3/tax-deduction-certificate/file \
-H apikey: YOUR_API_KEY \
-F file=@/path/to/certificate.jpg \
-F return_image=false \
-F return_ocr=false
如何获取 API Key?
请访问 API Key 管理 页面查看您现有的 API Key 或申请新的 API Key。
API 端点
| 端点 | 方法 | 描述 | 费用 |
|---|---|---|---|
/v3/store/ocr/tax-deduction-certificate/ocr/v3/tax-deduction-certificate | POST | 从泰国税款扣除证明中提取数据 | 每页 1 IC |
响应:
{
"message": "success",
"raw": {},
"processed": {
"documentType": "หนังสือรับรองการหักภาษี ณ ที่จ่าย",
"documentForm": "ภ.ง.ด.3",
"bookNumber": "TX63XXXX",
"documentNumber": null,
"taxDeductor": {
"name": "บริษัท XXXXXXXXXXXXXXXXXXXX จำกัด",
"taxId": "010XXXXXXXX64",
"address": "XXXX XXXXXX XXXXXXXX เขตจอมทอง กรุงเทพมหานคร 10150"
},
"taxpayer": {
"name": "นายXXXXX เป็นตัวอย่าง",
"taxId": "31XXXXXXXX123",
"address": "XXXX XXXXXX XXXXXXXX เขตสาทร กรุงเทพมหานคร"
},
"paymentTypes": [
{
"paymentDate": "02/09/63",
"amount": XXXXX.XX,
"withholdingTax": XXXX.XX
}
],
"totalAmount": XXXXX.XX,
"totalTax": XXXX.XX,
"socialSecurity": {
"amount": null,
"year": null
},
"taxPayerMethod": "ออกภาษีให้ตลอดไป"
},
"template": "tax-deduction-certificate",
"iapp": {
"page": 0,
"char": 3260
},
"process_ms": 46649
}
功能与能力
核心功能
-
文档处理
- 高精度文本提取和字段识别
- 支持泰语
- 快速处理时间,每份文档 25-30 秒
- 多格式支持(JPEG, JPG, PNG, HEIC, HEIF, PDF)
- 多页文档处理
- 可选返回原始 OCR 文本和处理后的图像
- 符合 GDPR 和 PDPA 的处理
-
数据提取
- 灵活的 JSON 响应格式,包含详细的字段提取
支持的字段
| 字段 | 类型 | 描述 |
|---|---|---|
| documentType | String | 税务文件类型 |
| documentForm | String | 表单类型(ภ.ง.ด.1ก, ภ.ง.ด.1ก พิเศษ, ภ.ง.ด.2, ภ.ง.ด.3, ภ.ง.ด.2ก, ภ.ง.ด.3ก, ภ.ง.ด.53) |
| bookNumber | String | 文件簿号 |
| documentNumber | String | 文件号 |
| taxDeductor.name | String | 扣缴义务人姓名 |
| taxDeductor.taxId | String | 扣缴义务人税号 |
| taxDeductor.address | String | 扣缴义务人地址 |
| taxpayer.name | String | 纳税人姓名 |
| taxpayer.taxId | String | 纳税人税号 |
| taxpayer.address | String | 纳税人地址 |
| paymentTypes[].paymentDate | String | 付款日期 |
| paymentTypes[].amount | Number | 付款金额 |
| paymentTypes[].withholdingTax | Number | 代扣税款金额 |
| totalAmount | Number | 总付款金额 |
| totalTax | Number | 总代扣税款金额 |
| socialSecurity.amount | Number | 社会保障缴费金额 |
| socialSecurity.year | Number | 社会保障缴费年份 |
| taxPayerMethod | String | 纳税方式(หักภาษี ณ ที่จ่าย, ออกภาษีให้ตลอดไป, ออกภาษีให้ครั้งเดียว, อื่นๆ) |
API 参考
欢迎来到泰国税款扣除证明 OCR API,这是一个将泰国税款扣除证明转换为结构化 JSON 数据的强大工具。该 API 利用先进的 OCR 和人工智能技术,提取关键信息,如文件详情、扣缴义务人和纳税人数据、付款信息和税款金额。
识别税款扣除证明
有两个可用的端点用于处理税款扣除证明:
1. 文件上传
POST https://api.iapp.co.th/ocr/v3/tax-deduction-certificate/file
请求头
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| apikey | string | 是 | 您的 API 密钥 |
请求体 (multipart/form-data)
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| file | file | 是 | 税款证明图片 (JPEG, PNG) 或 PDF 文档 |
| return_image | boolean | 否 | 在响应中包含 Base64 编码的图像(默认为:false) |
| return_ocr | boolean | 否 | 在响应中包含原始 OCR 文本(默认为:false) |
支持的文件类型
- 图片:JPEG, PNG, HEIC, HEIF
- 文档:PDF(最多 10 页)
响应格式
{
"message": "success",
"raw": {
"image": "string", // Base64 编码,仅当 return_image=true 时提供
"text": "string" // 仅当 return_ocr=true 时提供
},
"processed": {
"documentType": "string",
"documentForm": "string",
"bookNumber": "string",
"documentNumber": "string",
"taxDeductor": {
"name": "string",
"taxId": "string",
"address": "string"
},
"taxpayer": {
"name": "string",
"taxId": "string",
"address": "string"
},
"paymentTypes": [
{
"paymentDate": "string",
"amount": "number",
"withholdingTax": "number"
}
],
"totalAmount": "number",
"totalTax": "number",
"socialSecurity": {
"amount": "number",
"year": "number"
},
"taxPayerMethod": "string"
},
"template": "tax-deduction-certificate",
"iapp": {
"page": "number",
"char": "number"
},
"process_ms": "number"
}
2. Base64 图片
POST https://api.iapp.co.th/ocr/v3/tax-deduction-certificate/base64
请求头
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| apikey | string | 是 | 您的 API 密钥 |
请求体
您可以将 Base64 数据作为 JSON 或表单数据发送:
JSON 格式:
{
"base64_string": "string", // Base64 编码的图像数据
"return_image": false, // 可选
"return_ocr": false // 可选
}
表单数据格式:
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| base64_string | string | 是 | Base64 编码的图像数据 |
| return_image | boolean | 否 | 在响应中包含 Base64 编码的图像(默认为:false) |
| return_ocr | boolean | 否 | 在响应中包含原始 OCR 文本(默认为:false) |
响应格式
与文件上传端点相同
代码示例
Curl
curl -X POST https://api.iapp.co.th/v3/store/ocr/tax-deduction-certificate \
-H "apikey: YOUR_API_KEY" \
-F "file=@/path/to/file.jpg"
