OCR ใบแจ้งยอดธนาคาร

อ่านรายการเดินบัญชีธนาคารไทย แล้วส่งกลับข้อมูลบัญชีและตารางรายการทั้งหมด

POST/ocr/v3/bank-statement/fileทดลองใช้

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

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

Input

OutputPOST /ocr/v3/bank-statement/file

bank_name

ธนาคารกสิกรไทย

account_holder_name

น.ส. สมหญิง ตัวอย่าง

account_number

XXX-2-48512-X

account_type

เงินฝากออมทรัพย์

branch

สาขาซีคอนสแควร์ 2

period_from

01-04-2018

period_to

20-09-2018

total_withdrawal_amount

101797.39

total_deposit_amount

101780.19

transactions

date: 10-09-2018 description: ฝากเงินสด ไม่มีสมุดคู่ฝาก withdrawal: — deposit: 100 balance: 206.14 channel: 0929

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Response

Request

curl -X POST "https://api.iapp.co.th/ocr/v3/bank-statement/file" \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "target_lang=th" \
  -F "include_confidence=true"

Response

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

{
    "docs": [
        {
            "message": "success",
            "raw": {},
            "processed": {
                        "bank_name": "ธนาคารกสิกรไทย",
                        "account_holder_name": "น.ส. สมหญิง ตัวอย่าง",
                        "account_number": "XXX-2-48512-X",
                        "account_type": "เงินฝากออมทรัพย์",
                        "branch": "สาขาซีคอนสแควร์ 2",
                        "period_from": "01-04-2018",
                        "period_to": "20-09-2018",
                        "total_withdrawal_amount": 101797.39,
                        "total_deposit_amount": 101780.19,
                        "transactions": [
                                    {
                                                "date": "10-09-2018",
                                                "description": "ฝากเงินสด ไม่มีสมุดคู่ฝาก",
                                                "withdrawal": null,
                                                "deposit": 100.0,
                                                "balance": 206.14,
                                                "channel": "0929"
                                    }
                        ]
            },
            "confidence": {
                        "bank_name": 0.95,
                        "account_holder_name": 0.95,
                        "account_number": 0.95,
                        "account_type": 0.95,
                        "branch": 0.95,
                        "period_from": 0.95
            },
            "process_ms": 4120
        }
    ],
    "docs_count": 1,
    "process_ms": 4300
}

Request

ส่งเป็น multipart/form-data เท่านั้น ไม่มีแบบ Base64 ไฟล์ PDF อ่านและคิดเงินทุกหน้า

Headers

apikeystringrequired

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

Body

filefilerequired

ใบแจ้งยอด ไฟล์ PDF, JPEG, PNG หรือ WEBP ไม่เกิน 50 MB ส่งซ้ำได้: หลายเอกสารใน Request เดียว

return_ocrboolean

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

target_langstring

ภาษาของค่าที่แยกได้: th (ค่าเริ่มต้น), en หรือ auto (ใช้ภาษาเดียวกับเอกสาร)

include_confidenceboolean

ค่าเริ่มต้น true: ค่าความมั่นใจ 0.00 ถึง 1.00 รายฟิลด์

/v3/store/ocr/bank-statement คือ Endpoint เดียวกันภายใต้ prefix ของ store

Response

Header iapp-input-pages บอกจำนวนหน้าที่คิดเงิน

docsarray

หนึ่งรายการต่อเอกสารที่อ่าน

docs.processedobject

ฟิลด์ที่อ่านได้จากเอกสาร

docs.processed.bank_namestring

ธนาคาร

docs.processed.account_holder_namestring

ชื่อเจ้าของบัญชี

docs.processed.account_numberstring

ตามที่พิมพ์ รวมตัว X ที่ปิดบังไว้

docs.processed.account_typestring

เช่น เงินฝากออมทรัพย์

docs.processed.branchstring

สาขา

docs.processed.period_fromdocs.processed.period_to

ช่วงเวลาของรายการ

docs.processed.total_withdrawal_amountdocs.processed.total_deposit_amount

ยอดรวม บาท

docs.processed.transactionsarray

รายการละหนึ่งแถว

docs.processed.transactions.datestring

docs.processed.transactions.descriptionstring

docs.processed.transactions.withdrawal

docs.processed.transactions.depositnumber

docs.processed.transactions.balancenumber

docs.processed.transactions.channelstring

docs.messagestring

ข้อความสถานะ

docs.rawobject

ข้อความ OCR ดิบ เมื่อขอ

docs.confidenceobject

ความมั่นใจรายฟิลด์ 0 ถึง 1

docs.process_msinteger

เวลาที่ใช้ประมวลผล เป็นมิลลิวินาที

docs_countinteger

จำนวนเอกสารที่อ่าน

process_msinteger

เวลาที่ใช้ประมวลผล เป็นมิลลิวินาที

รหัสสถานะ

รหัส	ความหมาย
400	นามสกุลไฟล์ไม่รองรับ หรือไฟล์เกิน 50 MB
404	ชนิดเอกสารใน URL ไม่รู้จัก
422	ไม่มีไฟล์แนบ
500	ประมวลผลผิดพลาด Response มีรหัสไว้แจ้งฝ่ายสนับสนุน

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

ผลการทดสอบ

ความแม่นยำรายฟิลด์ บนชุดประเมินภายในจากเอกสารไทยจริงที่ตรวจเฉลยซ้ำด้วยตา รวมภาพถ่ายความละเอียดต่ำและบิลที่มีลายมือเขียนทับบางส่วน

รายการ	ผล
ใบแจ้งยอดธนาคาร 2 ฉบับ 10 ฟิลด์	100%
เอกสารทั้งหกชนิด 25 ฉบับ 147 ฟิลด์	98.6%

ข้อจำกัด

• แยกได้เฉพาะฟิลด์ข้างต้น
• ภาพสแกนคุณภาพต่ำ แสงสะท้อน หรือลายมือเขียนทับตัวพิมพ์ ทำให้ความแม่นยำลดลง ควรใช้ PDF ต้นฉบับถ้ามี ภาพถ่ายตรง ๆ ในแสงสม่ำเสมอ หรือภาพสแกน 300 dpi ขึ้นไป และส่งฟิลด์ที่ความมั่นใจต่ำให้คนตรวจ

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

การขอความยินยอมและการแจ้งเจ้าของข้อมูลตาม PDPA และ GDPR เป็นหน้าที่ของคุณในฐานะผู้ควบคุมข้อมูล