OCR ใบเสร็จและใบกำกับภาษี

อ่านใบเสร็จหรือใบกำกับภาษีไทย ทั้งพิมพ์และเขียนมือ แล้วส่งกลับข้อมูลผู้ออก ลูกค้า ทุกรายการสินค้า และยอดรวม พร้อมค่าความมั่นใจรายฟิลด์

POST/ocr/v3/receipt/file

และอีก 1 endpoint

ทดลองใช้

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

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

Input

OutputPOST /ocr/v3/receipt/file

invoiceType

ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ

invoiceBook

—

invoiceID

4504RC112566/004044

invoiceDate

27/11/2566

issuerName

หจก.บุญรอดคอฟฟี (ตลาดรัตนบุรี)

issuerTaxID

0323560000723

items

itemNo: 1 itemName: ชาเขียวนม ร้อน ขนาดใหญ่ itemUnit: 1 itemUnitCost: 60 itemTotalCost: 60

totalCost

60

discount

0

totalCostAfterDiscount

60

vat

3.93

grandTotal

60

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

Request

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

Response

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

{
    "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
    },
    "confidence": {
        "invoiceType": 0.95,
        "invoiceBook": 0.9,
        "invoiceID": 0.95,
        "invoiceDate": 0.9,
        "issuerName": 0.95,
        "issuerTaxID": 0.95,
        "items": 0.9,
        "totalCost": 0.95,
        "discount": 0.95,
        "totalCostAfterDiscount": 0.95,
        "vat": 0.95,
        "grandTotal": 0.95
    },
    "process_ms": 6821
}

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/receipt/file	ไฟล์	1 IC ต่อหน้า

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

Response

เมื่อตั้ง return_ocr เป็น true จะได้ raw ที่เป็นข้อความ OCR มาด้วย

processedobject

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

processed.invoiceTypeprocessed.invoiceBookprocessed.invoiceIDprocessed.invoiceDateprocessed.purchaseOrderID

เอกสาร: ชื่อหรือประเภท เล่มที่ เลขที่ วันที่ และใบสั่งซื้อที่อ้างถึง

processed.issuerNameprocessed.issuerAddressprocessed.issuerTaxIDprocessed.issuerPhone

ผู้ออก

processed.customerNameprocessed.customerAddressprocessed.customerTaxIDprocessed.customerPhone

ลูกค้า

processed.itemsarray

รายการละหนึ่งชุด

processed.items.itemNointeger

processed.items.itemCode

processed.items.itemNamestring

processed.items.itemUnitinteger

processed.items.itemUnitCostnumber

processed.items.itemTotalCostnumber

processed.totalCostprocessed.discountprocessed.totalCostAfterDiscountprocessed.vatprocessed.grandTotal

ยอดรวม บาท ทศนิยมสองตำแหน่ง vat คือภาษี 7%

messagestring

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

confidenceobject

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

process_msinteger

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

รหัสสถานะ

รหัส	ความหมาย
400	พารามิเตอร์หรือรูปแบบไฟล์ไม่ถูกต้อง
404	ไม่รู้จัก Endpoint
500	ประมวลผลไม่สำเร็จ

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

ผลการทดสอบ

วัดบนชุดทดสอบใบเสร็จไทย 10,000 ใบ

รายการ	ผล
เลขที่ใบเสร็จ	99.2%
จำนวนเงิน	99.5%
วันที่	98.7%
รายการสินค้า	97.8%
ทุกฟิลด์	98.8%
เวลา	โดยทั่วไป 5–10 วินาที เปอร์เซ็นไทล์ที่ 95 อยู่ที่ 12 วินาที สูงสุด 15 วินาที

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

ข้อจำกัด

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

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

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

Changelog

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