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

อ่านหนังสือรับรองการหักภาษี ณ ที่จ่าย (50 ทวิ) แล้วส่งกลับข้อมูลผู้จ่าย ผู้รับ รายการจ่ายแต่ละรายการพร้อมภาษีที่หัก และยอดรวม

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

และอีก 1 endpoint

ทดลองใช้

• ราคา1 ICต่อหน้า
• ให้บริการแล้ว22Kครั้ง

• v3.0
• ใช้งานได้

Input

OutputPOST /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

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

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /tax-deduction-certificate ดูที่ Request

Request

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

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
  "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 }
}

Request

ส่งเป็น multipart/form-data ไปที่ /file ไฟล์ PDF ได้ไม่เกิน 10 หน้า

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

filefilerequired

หนังสือรับรอง ไฟล์ JPEG, PNG, HEIC, HEIF หรือ PDF ไม่เกิน 10 MB

return_imageboolean

ใส่ true เพื่อรับภาพที่ประมวลผลแล้วกลับเป็น Base64

return_ocrboolean

ใส่ true เพื่อรับข้อความ OCR ดิบด้วย

Endpoint	รับ	ราคา
/ocr/v3/tax-deduction-certificate/file	ไฟล์	1 IC ต่อหน้า

/v3/store/ocr/tax-deduction-certificate คือบริการเดียวกันภายใต้ prefix ของ store

Response

เมื่อตั้ง 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	ไม่รู้จัก Endpoint
500	ประมวลผลไม่สำเร็จ

รายละเอียดเพิ่มเติม

ผลการทดสอบ

วัดบนชุดทดสอบหนังสือรับรองการหักภาษี ณ ที่จ่าย 5,000 ฉบับ

รายการ	ผล
เลขที่หนังสือรับรอง	99.5%
จำนวนเงิน	99.8%
วันที่	99.0%
เลขประจำตัวผู้เสียภาษี	99.7%
ทุกฟิลด์	99.5%
เวลาต่อฉบับ	โดยทั่วไป 25–30 วินาที เปอร์เซ็นไทล์ที่ 95 อยู่ที่ 45 วินาที สูงสุด 67 วินาที

เอกสารรูปแบบมาตรฐานอ่านได้ 99% ขึ้นไป รูปแบบไม่มาตรฐาน 95% ขึ้นไป ส่วนที่เขียนด้วยลายมือ 90% ขึ้นไป

ข้อจำกัด

• รองรับเฉพาะหนังสือรับรองภาษาไทย
• ความละเอียดต่ำกว่า 300 dpi แสงไม่ดี เอกสารชำรุด สีจาง หรือการแก้ด้วยลายมือ ทำให้ความแม่นยำลดลง
• 10 Request ต่อวินาทีต่อ API key

การจัดการข้อมูล

บริการเป็นไปตาม GDPR และ PDPA

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
3.0	27 ธ.ค. 2567	เปิดให้บริการ