🧾 แกะข้อมูลจากใบเสร็จรับเงิน / ใบแจ้งหนี้ / ใบวางบิล / ใบกำกับภาษี (Thai Receipt OCR) 🆕

🧾 ใบเสร็จรับเงิน / ใบแจ้งหนี้ / ใบวางบิล / ใบกำกับภาษี

ยินดีต้อนรับสู่ Thai Receipt OCR API โซลูชันที่ใช้พลังของ AI ที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด สำหรับการดึงข้อมูลจากใบเสร็จรับเงินและใบแจ้งหนี้ภาษาไทย เอกสารนี้จะช่วยให้คุณสามารถผสานรวมและใช้บริการ OCR ของเราได้อย่างมีประสิทธิภาพ

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

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

   • API key จาก ไอแอพพ์เทคโนโลยี
   • ใบเสร็จรับเงินภาษาไทย / อังกฤษ โดยใช้ภาพพิมพ์หรือภาพเขียนด้วยลายมือ
   • รูปแบบไฟล์ที่รองรับ: JPEG, JPG, PNG, HEIC, HEIF, PDF
   • ขนาดไฟล์สูงสุด: 10MB

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

   • การประมวลผลที่รวดเร็ว (5-10 วินาทีต่อเอกสาร)
   • การดึงข้อความที่มีความแม่นยำสูง
   • รองรับรูปแบบไฟล์หลายรูปแบบ

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

   • การดึงข้อมูลรายละเอียดต่างๆ รวมถึง:
     • รายละเอียดใบแจ้งหนี้ (ประเภท, ID, วันที่, เลขที่หนังสือ)
     • ข้อมูลผู้ออกใบแจ้งหนี้ (ชื่อ, ที่อยู่, เลขประจำตัวผู้เสียภาษี, ข้อมูลติดต่อ)
     • ข้อมูลลูกค้า (ชื่อ, ที่อยู่, เลขประจำตัวผู้เสียภาษี, ข้อมูลติดต่อ)
     • รายการสินค้า (รหัสสินค้า, ชื่อ, จำนวน, ราคาต่อหน่วย, รวม)
     • สรุปทางการเงิน (ราคารวม, ส่วนลด, ภาษีมูลค่าเพิ่ม, รวมทั้งสิ้น)
   • รองรับเอกสารทั้งแบบหน้าเดียวและหลายหน้า (PDF)
   • ตัวเลือกในการส่งคืนข้อความ OCR ต้นฉบับและภาพที่ประมวลผลแล้ว
   • รูปแบบการตอบสนอง JSON ที่ยืดหยุ่นพร้อมการดึงข้อมูลรายละเอียด

4. ความปลอดภัยและการปฏิบัติตามกฎระเบียบ

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

API ของเราได้รับการออกแบบมาเพื่อจัดการกับรูปแบบและเค้าโครงใบเสร็จรับเงินต่างๆ ที่ใช้กันทั่วไปในประเทศไทย ตั้งแต่ใบเสร็จรับเงินค้าปลีกแบบง่ายๆ ไปจนถึงใบกำกับภาษีอย่างเป็นทางการ แบบจำลอง AI หลังการประมวลผลได้รับการฝึกฝนให้เข้าใจโครงสร้างใบเสร็จรับเงินภาษาไทยและสามารถดึงข้อมูลได้อย่างน่าเชื่อถือ แม้จากเอกสารที่มีเสียงรบกวนหรือสแกนไม่ชัดเจน

ตัวอย่าง

นี่คือใบเสร็จรับเงินตัวอย่างและข้อมูลที่ดึงออกมา:

คำขอ:

cURL

curl -X POST "https://api.iapp.co.th/ocr/v3/receipt/file" \
-H "apikey: YOUR_API_KEY" \
-F "file=@/path/to/receipt.jpg" \
-F "return_image=false" \
-F "return_ocr=false"

วิธีการรับ API Key?

กรุณาเยี่ยมชม iApp AI Portal เพื่อดู API key ที่มีอยู่ของคุณหรือขอ API key ใหม่

การตอบสนอง:

{
    "message": "success",
    "processed": {
        "invoiceType": "ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ",
        "invoiceBook": null,
        "invoiceID": "4504RC112566/004044",
        "invoiceDate": "27/11/2566",
        "issuerName": "หจก.บุญรอดคอฟฟี (ตลาดรัตนบุรี)",
        "issuerTaxID": "0323560000723",
        "items": [
            {
                "itemNo": 1,
                "itemName": "ชาเขียวนม ร้อน ขนาดใหญ่",
                "itemUnit": 1,
                "itemUnitCost": 60.0,
                "itemTotalCost": 60.0
            }
        ],
        "totalCost": 60.0,
        "discount": 0.0,
        "totalCostAfterDiscount": 60.0,
        "vat": 3.93,
        "grandTotal": 60.0
    },
    "process_ms": 6821
}

คุณสมบัติและความสามารถ

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

1. การประมวลผลเอกสาร

   • การดึงข้อความและการจดจำข้อมูลที่มีความแม่นยำสูง
   • รองรับภาษาไทย / อังกฤษ
   • รองรับการพิมพ์ / การเขียนด้วยลายมือ
   • เวลาในการประมวลผลที่รวดเร็ว 5-10 วินาทีต่อเอกสาร
   • รองรับรูปแบบหลายรูปแบบ (JPEG, JPG, PNG, HEIC, HEIF, PDF)
   • การจัดการเอกสารหลายหน้า
   • ตัวเลือกในการส่งคืนข้อความ OCR ต้นฉบับและภาพที่ประมวลผลแล้ว
   • การประมวลผลที่สอดคล้องกับ GDPR และ PDPA

2. การดึงข้อมูล

   • รูปแบบการตอบสนอง JSON ที่ยืดหยุ่นพร้อมการดึงข้อมูลรายละเอียด

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

ฟิลด์	ประเภท	คำอธิบาย
invoiceType	String	ชื่อหรือประเภทของใบแจ้งหนี้
invoiceBook	String	เลขที่หนังสือของใบแจ้งหนี้
invoiceID	String	เลขที่ใบแจ้งหนี้
invoiceDate	String	วันที่ออกใบแจ้งหนี้
purchaseOrderID	String	เลขที่ใบสั่งซื้อที่เชื่อมโยง
issuerName	String	ชื่อผู้ออกใบแจ้งหนี้
issuerAddress	String	ที่อยู่ของผู้ออกใบแจ้งหนี้
issuerTaxID	String	เลขประจำตัวผู้เสียภาษีของผู้ออกใบแจ้งหนี้
issuerPhone	String	เบอร์โทรติดต่อของผู้ออกใบแจ้งหนี้
customerName	String	ชื่อลูกค้า
customerAddress	String	ที่อยู่ของลูกค้า
customerTaxID	String	เลขประจำตัวผู้เสียภาษีของลูกค้า
customerPhone	String	เบอร์โทรติดต่อของลูกค้า
items	Array	อาร์เรย์ของรายการสินค้าพร้อมรายละเอียดด้านล่าง
- itemNo	String	ลำดับเลขที่สินค้า
- itemCode	String	รหัสสินค้า/บริการ
- itemName	String	ชื่อสินค้า/บริการ
- itemUnit	Number	จำนวนสินค้า
- itemUnitCost	Number	ราคาต่อหน่วย
- itemTotalCost	Number	ราคารวมของสินค้า
totalCost	Number	รวมราคาสินค้าทั้งหมด
discount	Number	จำนวนส่วนลด (ถ้ามี)
totalCostAfterDiscount	Number	ราคารวมหลังหักส่วนลด
vat	Number	จำนวนภาษีมูลค่าเพิ่ม (7%)
grandTotal	Number	จำนวนเงินรวมทั้งหมดรวมภาษีมูลค่าเพิ่ม

หมายเหตุ: ค่าเงินทั้งหมดจะปัดเศษเป็นทศนิยมสองตำแหน่ง

ข้อมูลอ้างอิง API

ยินดีต้อนรับสู่ Thai Receipt OCR API เครื่องมืออันทรงพลังสำหรับการแปลงใบเสร็จรับเงินและใบแจ้งหนี้ภาษาไทยเป็นข้อมูล JSON ที่มีโครงสร้าง API นี้ใช้เทคโนโลยี OCR และ AI ขั้นสูงเพื่อดึงข้อมูลสำคัญต่างๆ เช่น รายละเอียดใบแจ้งหนี้ ข้อมูลผู้ออกและลูกค้า รายการสินค้า และยอดรวมทางการเงิน

การจดจำใบเสร็จรับเงิน

จุดสิ้นสุดนี้จะประมวลผลภาพใบเสร็จรับเงินหรือ PDF และส่งคืนข้อมูลที่ดึงมาในรูปแบบที่มีโครงสร้าง

POST https://api.iapp.co.th/ocr/v3/receipt/file

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

ชื่อ	ประเภท	จำเป็นต้องใช้	คำอธิบาย
apikey	string	ใช่	API key ของคุณ

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

พารามิเตอร์	ประเภท	จำเป็นต้องใช้	คำอธิบาย
file	file	ใช่	ภาพใบเสร็จรับเงิน (JPEG, PNG) หรือเอกสาร PDF
return_image	boolean	ไม่ใช่	รวมภาพที่เข้ารหัส base64 ในการตอบสนอง (ค่าเริ่มต้น: false)
return_ocr	boolean	ไม่ใช่	รวมข้อความ OCR ดิบในการตอบสนอง (ค่าเริ่มต้น: false)

รูปแบบไฟล์ที่รองรับ

• รูปภาพ: JPEG, PNG
• เอกสาร: PDF (หน้าเดียวหรือหลายหน้า)

รูปแบบการตอบสนอง

{
    "message": "success",
    "raw": {
        "image": "string", // Base64 encoded, only if return_image=true
        "text": "string" // Only if return_ocr=true
    },
    "processed": {
        "invoiceType": "string",
        "invoiceBook": "string",
        "invoiceID": "string",
        "invoiceDate": "string",
        "purchaseOrderID": "string",
        "issuerName": "string",
        "issuerAddress": "string",
        "issuerTaxID": "string",
        "issuerPhone": "string",
        "customerName": "string",
        "customerAddress": "string",
        "customerTaxID": "string",
        "customerPhone": "string",
        "items": [
            {
                "itemNo": "string",
                "itemCode": "string",
                "itemName": "string",
                "itemUnit": "number",
                "itemUnitCost": "number",
                "itemTotalCost": "number"
            }
        ],
        "totalCost": "number",
        "discount": "number",
        "totalCostAfterDiscount": "number",
        "vat": "number",
        "grandTotal": "number"
    },
    "template": "receipt",
    "iapp": "string",
    "process_ms": "number"
}

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

สถานะ	รหัส	คำอธิบาย
400	BAD_REQUEST	พารามิเตอร์หรือรูปแบบไฟล์ไม่ถูกต้อง
401	UNAUTHORIZED	API key ไม่ถูกต้องหรือหายไป
404	NOT_FOUND	จุดสิ้นสุดไม่ถูกต้อง
500	INTERNAL_SERVER_ERROR	การประมวลผลล้มเหลว

ราคา

ชื่อบริการ AI API	จุดสิ้นสุด	IC ต่อคำขอ	On-Premise
Receipt OCR [v1.0]	receipt-ocr	1 IC/Request	ติดต่อ

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

Python

import requests
apiKey = 'YOUR_API_KEY'
filePath = '/path/to/receipt.jpg'
url = "https://api.iapp.co.th/ocr/v3/receipt/file"

headers = {'apikey': apiKey}
files = {'file': ('receipt.jpg', open(filePath, 'rb'), 'image/jpeg')}
data = {'return_image': 'false', 'return_ocr': 'false'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

Javascript

const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")

const apiKey = "YOUR_API_KEY"
const filePath = "/path/to/receipt.jpg"
const url = "https://api.iapp.co.th/ocr/v3/receipt/file"

const form = new FormData()
form.append("file", fs.createReadStream(filePath))
form.append("return_image", "false")
form.append("return_ocr", "false")

try {
    const response = await axios.post(url, form, {
        headers: {
            ...form.getHeaders(),
            apikey: apiKey,
        },
    })
    return response.data
} catch (error) {
    throw error
}

PHP

$url = 'https://api.iapp.co.th/ocr/v3/receipt/file';
$apiKey = 'YOUR_API_KEY';
$filePath = '/path/to/receipt.jpg';

$headers = array(
    'apikey: ' . $apiKey
);

$postFields = array(
    'file' => new CURLFile($filePath),
    'return_image' => 'false',
    'return_ocr' => 'false'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/ocr/v3/receipt/file")!
let filePath = "/path/to/receipt.jpg"
let apiKey = "YOUR_API_KEY"

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue(apiKey, forHTTPHeaderField: "apikey")

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

var body = Data()
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"receipt.jpg\"\r\n".data(using: .utf8)!)
body.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
body.append(try! Data(contentsOf: URL(fileURLWithPath: filePath)))
body.append("\r\n--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"return_image\"\r\n\r\nfalse\r\n".data(using: .utf8)!)
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"return_ocr\"\r\n\r\nfalse\r\n".data(using: .utf8)!)
body.append("--\(boundary)--\r\n".data(using: .utf8)!)

request.httpBody = body

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data, error == nil else {
        print("Error: \(error?.localizedDescription ?? "Unknown error")")
        return
    }
    print(String(data: data, encoding: .utf8)!)
}

task.resume()

Kotlin

import okhttp3.*
import java.io.File

val client = OkHttpClient()
val apiKey = "YOUR_API_KEY"
val filePath = "/path/to/receipt.jpg"
val url = "https://api.iapp.co.th/ocr/v3/receipt/file"

val file = File(filePath)
val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.name, RequestBody.create(MediaType.parse("image/jpeg"), file))
    .addFormDataPart("return_image", "false")
    .addFormDataPart("return_ocr", "false")
    .build()

val request = Request.Builder()
    .url(url)
    .post(requestBody)
    .addHeader("apikey", apiKey)
    .build()

client.newCall(request).enqueue(object : Callback {
    override fun onFailure(call: Call, e: IOException) {
        e.printStackTrace()
    }

    override fun onResponse(call: Call, response: Response) {
        response.use {
            if (!response.isSuccessful) throw IOException("Unexpected code $response")
            println(response.body()?.string())
        }
    }
})

Java

import okhttp3.*;
import java.io.File;
import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        String apiKey = "YOUR_API_KEY";
        String url = "https://api.iapp.co.th/ocr/v3/receipt/file";
        String filePath = "/path/to/receipt.jpg";

        File file = new File(filePath);
        RequestBody requestBody = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("file", file.getName(), RequestBody.create(MediaType.parse("image/jpeg"), file))
            .addFormDataPart("return_image", "false")
            .addFormDataPart("return_ocr", "false")
            .build();

        Request request = new Request.Builder()
            .url(url)
            .post(requestBody)
            .addHeader("apikey", apiKey)
            .build();

        client.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                e.printStackTrace();
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
                System.out.println(response.body().string());
            }
        });
    }
}

Dart

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

String url = 'https://api.iapp.co.th/ocr/v3/receipt/file';
String filePath = '/path/to/receipt.jpg';
String apiKey = 'YOUR_API_KEY';

void main() async {
    var url = Uri.parse(url);
    var request = http.MultipartRequest('POST', url)
        ..headers['apikey'] = apiKey
        ..files.add(await http.MultipartFile.fromPath('file', filePath))
        ..fields['return_image'] = 'false'
        ..fields['return_ocr'] = 'false';

    var response = await request.send();

    if (response.statusCode == 200) {
        var responseData = await response.stream.bytesToString();
        print(responseData);
    } else {
        print('Error: ${response.statusCode}');
    }
}

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

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• ภาษาที่รองรับ: ภาษาไทย
• ไฟล์ PDF: สูงสุด 10 หน้า
• การจำกัดอัตรา: 10 คำขอต่อวินาทีต่อ API key

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

1. ตรวจสอบให้แน่ใจว่าคุณภาพของภาพดีเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด
2. ใช้รูปแบบ JPEG หรือ PNG สำหรับรูปภาพ
3. ใช้การจัดการข้อผิดพลาดสำหรับคำขอที่ล้มเหลว
4. เก็บข้อมูลการตอบสนองไว้เมื่อประมวลผลเอกสารเดียวกันหลายครั้ง
5. ตั้งค่าการหมดเวลาที่เหมาะสมสำหรับไฟล์ขนาดใหญ่

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

ความแม่นยำโดยรวม

จากชุดข้อมูลมาตรฐานของใบเสร็จรับเงินภาษาไทย 10,000 ใบ:

ประเภทฟิลด์	ความแม่นยำ (%)	หมายเหตุ
เลขที่ใบแจ้งหนี้	99.2%	รวมถึงเลขที่ใบกำกับภาษี
จำนวนเงิน	99.5%	ค่าเงินและยอดรวม
วันที่	98.7%	รูปแบบวันที่ภาษาไทยต่างๆ
รายการสินค้า	97.8%	รายละเอียดสินค้าและราคา
โดยรวม	98.8%	ค่าเฉลี่ยถ่วงน้ำหนัก

ความเร็วในการประมวลผล

• เวลาในการประมวลผลเฉลี่ย: 5-10 วินาที
• เปอร์เซ็นไทล์ที่ 95: 12 วินาที
• เวลาในการประมวลผลสูงสุด: 15 วินาที

ปัจจัยที่มีผลต่อความแม่นยำ

1. คุณภาพของภาพ

   • ความละเอียด (แนะนำอย่างน้อย 300 DPI)
   • สภาพแสง
   • ความคมชัดของภาพ

2. สภาพของเอกสาร

   • ความเสียหายทางกายภาพ
   • การซีดจางหรือการสึกหรอ
   • การแก้ไขด้วยลายมือ

3. รูปแบบใบเสร็จรับเงิน

   • รูปแบบมาตรฐาน: ความแม่นยำ 99%+
   • เค้าโครงที่ไม่เป็นมาตรฐาน: ความแม่นยำ 95%+
   • องค์ประกอบที่เขียนด้วยลายมือ: ความแม่นยำ 90%+

ประวัติ

แบบจำลองของเราได้รับการฝึกฝนอย่างต่อเนื่องบนข้อมูลใหม่เพื่อปรับปรุงความแม่นยำ:

เวอร์ชัน	วันที่วางจำหน่าย	ความแม่นยำ	การปรับปรุงที่สำคัญ
3.0	2024-12-27	96.5%	เวอร์ชันพื้นฐาน