Water Bill OCR

1 ICต่อหน้า

v1.0 ใช้งานอยู่ ก.ค. 2026 POST /ocr/v3/water-bill/file

ยินดีต้อนรับสู่ Water Bill OCR API ซึ่งเป็นส่วนหนึ่งของ iApp Any Documents OCR โดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด แยกข้อมูลใบแจ้งหนี้จากใบแจ้งค่าน้ำของการประปานครหลวง (MWA) และการประปาส่วนภูมิภาค (PWA) รวมถึงการอ่านมิเตอร์, ปริมาณการใช้ และภาษีมูลค่าเพิ่ม จำนวนเงินจะถูกตรวจสอบความถูกต้องทางคณิตศาสตร์ (ยอดรวมย่อย + ภาษีมูลค่าเพิ่ม = ยอดรวม) เพื่อความน่าเชื่อถือบนภาพคุณภาพต่ำ

ลองใช้งาน Demo!

ทดลองใช้ AI Demo

เข้าสู่ระบบหรือสร้างบัญชีฟรีเพื่อใช้งาน AI Demo และสำรวจ API ที่ทรงพลังของเรา

รับ 50 เครดิตฟรี (IC) เมื่อสมัครสมาชิก!

โปรโมชันหมดเขต 31 ธันวาคม 2568

สร้างบัญชีฟรีเข้าสู่ระบบ

Example Images (Click to try)

Try Demo

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

อัปโหลดใบแจ้งค่าน้ำ

เอกสารตัวอย่าง — คลิกเพื่อขยาย

เริ่มต้นใช้งาน

1. ข้อกำหนดเบื้องต้น

   • API key จาก ไอแอพพ์เทคโนโลยี
   • ไฟล์เอกสาร: ใบแจ้งค่าน้ำ (ใบแจ้งค่าน้ำประปา)
   • รูปแบบไฟล์ที่รองรับ: PDF, JPG, JPEG, PNG, WEBP
   • ขนาดไฟล์สูงสุด: 50MB

2. เริ่มต้นใช้งานอย่างรวดเร็ว

   • POST ครั้งเดียวพร้อม multipart/form-data
   • ผลลัพธ์ JSON ที่มีโครงสร้าง, พร้อมคะแนนความเชื่อมั่นต่อฟิลด์
   • แต่ละหน้าอินพุตจะส่งคืนรายการของตัวเองใน docs, ดังนั้นสามารถส่งเอกสารหลายชุดในคำขอเดียว

3. คุณสมบัติหลัก

   • การแยกข้อมูลตามฟิลด์พร้อมคะแนนความเชื่อมั่น
   • ผลลัพธ์ภาษาไทยและอังกฤษผ่าน target_lang
   • ข้อความ OCR ดิบแบบเลือกได้ผ่าน return_ocr
   • รองรับภาพถ่ายและ PDF ที่สแกน

4. ความปลอดภัยและการปฏิบัติตามข้อกำหนด

   • เป็นไปตาม GDPR และ PDPA
   • จุดเชื่อมต่อ API ที่ปลอดภัย
   • ไม่มีข้อมูลคงค้างหลังการประมวลผล

วิธีรับ API Key?

โปรดไปที่หน้า การจัดการ API Key เพื่อดู API key ที่มีอยู่ของคุณ หรือขอใหม่

จุดเชื่อมต่อ API

จุดเชื่อมต่อ	เมธอด	คำอธิบาย	ราคา
/ocr/v3/water-bill/file /v3/store/ocr/water-bill	POST	แยกข้อมูลใบแจ้งหนี้จากใบแจ้งค่าน้ำของไทย (MWA / PWA)	1 IC ต่อหน้า

ทั้งสองรูปแบบมีค่าเท่ากัน ไม่มีรูปแบบ base64 สำหรับจุดเชื่อมต่อนี้ — รองรับการอัปโหลดไฟล์เท่านั้น

คำขอ

ส่วนหัวของคำขอ

ส่วนหัว	ค่า	จำเป็น
apikey	iApp API key ของคุณ	ใช่

เนื้อหาของคำขอ (multipart/form-data)

พารามิเตอร์	ประเภท	ค่าเริ่มต้น	คำอธิบาย
file	ไฟล์ (ทำซ้ำได้)	—	จำเป็น. ไฟล์เอกสาร. หน้า PDF จะถูกประมวลผลโดยอัตโนมัติ
return_ocr	บูลีน	false	รวมข้อความ OCR ดิบในผลลัพธ์
target_lang	สตริง	th	ภาษาของค่าที่แยกได้: th หรือ en
include_confidence	บูลีน	true	รวมคะแนนความเชื่อมั่นต่อฟิลด์ (0.00–1.00)

cURL

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"

ผลลัพธ์

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

ส่วนหัวการตอบกลับ iapp-input-pages จะรายงานจำนวนหน้าที่ถูกเรียกเก็บเงิน

ฟิลด์ที่รองรับ

ฟิลด์	ประเภท	คำอธิบาย
provider	String	หน่วยงานผู้ออก เช่น การประปานครหลวง
customer_name	String	ชื่อผู้ใช้น้ำประปา
customer_address	String	ที่อยู่บริการ
account_number	String	หมายเลขทะเบียนผู้ใช้น้ำประปา
invoice_number	String	เลขที่ใบแจ้งหนี้
invoice_date	String	วันที่ออกใบแจ้งหนี้
current_reading	Number	มิเตอร์น้ำปัจจุบัน
previous_reading	Number	มิเตอร์น้ำครั้งก่อน
consumption_cubic_meter	Number	ปริมาณน้ำที่ใช้ (ลบ.ม.)
water_usage_charge	Number	ค่าบริการใช้น้ำ (บาท)
monthly_service_fee	Number	ค่าบริการรายเดือน (บาท)
discount	Number	ส่วนลด (บาท)
subtotal_before_vat	Number	ยอดรวมก่อนภาษีมูลค่าเพิ่ม (บาท)
vat_amount	Number	จำนวนภาษีมูลค่าเพิ่ม (บาท)
total_amount	Number	ยอดชำระทั้งหมด (บาท)
due_date	String	วันที่ครบกำหนดชำระ

การจัดการข้อผิดพลาด

สถานะ	ความหมาย
400	นามสกุลไฟล์ไม่รองรับ หรือไฟล์ใหญ่กว่า 50MB
401	apikey ขาดหายหรือไม่ถูกต้อง
402	ยอดคงเหลือเครดิตไม่เพียงพอ
404	ประเภทเอกสารไม่ทราบใน URL
422	ไม่มีการแนบไฟล์กับคำขอ
500	ข้อผิดพลาดในการประมวลผล — ผลลัพธ์มีรหัสข้อผิดพลาดเพื่ออ้างอิงถึงฝ่ายสนับสนุน

ตัวอย่างโค้ด

Python

import requests

url = "https://api.iapp.co.th/ocr/v3/water-bill/file"
headers = {"apikey": "YOUR_API_KEY"}
files = {"file": open("document.pdf", "rb")}
data = {"target_lang": "th", "include_confidence": "true"}

response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()
print(result["docs"][0]["processed"])
print(result["docs"][0]["confidence"])

JavaScript

const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("target_lang", "th");
form.append("include_confidence", "true");

const res = await fetch("https://api.iapp.co.th/ocr/v3/water-bill/file", {
  method: "POST",
  headers: { apikey: "YOUR_API_KEY" },
  body: form,
});
const result = await res.json();
console.log(result.docs[0].processed);

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.iapp.co.th/ocr/v3/water-bill/file");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["apikey: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    "file" => new CURLFile("/path/to/document.pdf"),
    "target_lang" => "th",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Java

OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", "document.pdf",
        RequestBody.create(new File("/path/to/document.pdf"),
            MediaType.parse("application/pdf")))
    .addFormDataPart("target_lang", "th")
    .build();

Request request = new Request.Builder()
    .url("https://api.iapp.co.th/ocr/v3/water-bill/file")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

Swift

let url = URL(string: "https://api.iapp.co.th/ocr/v3/water-bill/file")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")

let boundary = UUID().uuidString
request.setValue("multipart/form-data; boundary=\(boundary)",
                 forHTTPHeaderField: "Content-Type")

var data = Data()
let fileData = try Data(contentsOf: URL(fileURLWithPath: "/path/to/document.pdf"))
data.append("--\(boundary)\r\n".data(using: .utf8)!)
data.append("Content-Disposition: form-data; name=\"file\"; filename=\"document.pdf\"\r\n\r\n".data(using: .utf8)!)
data.append(fileData)
data.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)

URLSession.shared.uploadTask(with: request, from: data) { responseData, _, _ in
    if let responseData, let json = String(data: responseData, encoding: .utf8) {
        print(json)
    }
}.resume()

Kotlin

val client = OkHttpClient()

val body = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file", "document.pdf",
        File("/path/to/document.pdf").asRequestBody("application/pdf".toMediaType())
    )
    .addFormDataPart("target_lang", "th")
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/ocr/v3/water-bill/file")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body?.string())
}

Dart

import 'package:http/http.dart' as http;

final request = http.MultipartRequest(
  'POST',
  Uri.parse('https://api.iapp.co.th/ocr/v3/water-bill/file'),
);
request.headers['apikey'] = 'YOUR_API_KEY';
request.fields['target_lang'] = 'th';
request.files.add(
  await http.MultipartFile.fromPath('file', '/path/to/document.pdf'),
);

final response = await request.send();
print(await response.stream.bytesToString());

ข้อจำกัดและแนวทางปฏิบัติที่ดีที่สุด

ข้อจำกัด

• ขนาดไฟล์สูงสุด 50MB ต่อคำขอ
• รูปแบบที่รองรับ: PDF, JPG, JPEG, PNG, WEBP
• ความแม่นยำขึ้นอยู่กับคุณภาพของภาพ — ภาพสแกนที่เสื่อมสภาพมาก, แสงสะท้อน และลายมือที่เขียนทับค่าที่พิมพ์ จะลดความแม่นยำของฟิลด์ลง
• การแยกข้อมูลจำกัดเฉพาะฟิลด์ที่ระบุไว้ข้างต้น

แนวทางปฏิบัติที่ดีที่สุด

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

ความแม่นยำและประสิทธิภาพ

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

ประเภทเอกสาร	เอกสาร	ฟิลด์	ความแม่นยำ
ใบแจ้งค่าน้ำ	5	25	100%
โดยรวม, ทั้งหกประเภทเอกสาร	25	147	98.6%

การสนับสนุน

ต้องการความช่วยเหลือ? ติดต่อเรา:

• อีเมล: sale@iapp.co.th
• โทรศัพท์: 086-322-5858
• Discord: iApp Technology