OCR ใบแจ้งค่าน้ำประปา

อ่านใบแจ้งค่าน้ำของการประปานครหลวงหรือส่วนภูมิภาค แล้วส่งกลับข้อมูลผู้ใช้น้ำ ค่ามิเตอร์ และค่าใช้จ่าย

POST/ocr/v3/water-bill/fileทดลองใช้

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

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

Input

OutputPOST /ocr/v3/water-bill/file

provider

การประปานครหลวง

customer_name

—

customer_address

32/14 ม.3 ตำบลท่าจีน อำเภอสามพราน จังหวัดนครปฐม 11130

account_number

67983262

invoice_number

192011-5

invoice_date

12/02/2567

current_reading

606

previous_reading

567

consumption_cubic_meter

39

water_usage_charge

430.39

monthly_service_fee

25

discount

0

subtotal_before_vat

461.24

vat_amount

32.29

total_amount

493.53

due_date

22/02/2567

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

Request

curl -X POST "https://api.iapp.co.th/ocr/v3/water-bill/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": {
                        "provider": "การประปานครหลวง",
                        "customer_name": null,
                        "customer_address": "32/14 ม.3 ตำบลท่าจีน อำเภอสามพราน จังหวัดนครปฐม 11130",
                        "account_number": "67983262",
                        "invoice_number": "192011-5",
                        "invoice_date": "12/02/2567",
                        "current_reading": 606,
                        "previous_reading": 567,
                        "consumption_cubic_meter": 39,
                        "water_usage_charge": 430.39,
                        "monthly_service_fee": 25.0,
                        "discount": 0.0,
                        "subtotal_before_vat": 461.24,
                        "vat_amount": 32.29,
                        "total_amount": 493.53,
                        "due_date": "22/02/2567"
            },
            "confidence": {
                        "provider": 0.95,
                        "customer_name": 0.95,
                        "customer_address": 0.95,
                        "account_number": 0.95,
                        "invoice_number": 0.95,
                        "invoice_date": 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/water-bill คือ Endpoint เดียวกันภายใต้ prefix ของ store

Response

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

docsarray

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

docs.processedobject

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

docs.processed.providerstring

ผู้ให้บริการ เช่น การประปานครหลวง

docs.processed.customer_namedocs.processed.customer_address

ชื่อผู้ใช้น้ำและที่อยู่ที่ใช้น้ำ

docs.processed.account_numberdocs.processed.invoice_numberdocs.processed.invoice_date

เลขทะเบียนผู้ใช้น้ำ เลขที่ใบแจ้งหนี้ และวันที่ออก

docs.processed.current_readingdocs.processed.previous_readingdocs.processed.consumption_cubic_meter

ค่ามิเตอร์ครั้งนี้และครั้งก่อน และปริมาณที่ใช้ (ลูกบาศก์เมตร)

docs.processed.water_usage_chargedocs.processed.monthly_service_feedocs.processed.discount

ค่าใช้จ่าย บาท

docs.processed.subtotal_before_vatdocs.processed.vat_amountdocs.processed.total_amount

ยอดรวม บาท

docs.processed.due_datestring

วันครบกำหนดชำระ

docs.messagestring

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

docs.rawobject

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

docs.confidenceobject

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

docs.process_msinteger

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

docs_countinteger

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

process_msinteger

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

รหัสสถานะ

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

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

ผลการทดสอบ

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

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

ข้อจำกัด

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

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

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