ภาพรวมใบกำกับภาษีซื้อ (Supplier Invoice)
ใบกำกับภาษีซื้อ (Supplier Invoice) ช่วยให้ผู้ใช้งาน API สามารถแนบข้อมู ลใบกำกับภาษีที่ได้รับจากผู้จำหน่ายเข้ากับเอกสารค่าใช้จ่าย (Expense) หรือเอกสารใบรับสินค้า (Purchase) ที่มีอยู่แล้วในระบบ เพื่อรองรับ workflow การบริหารภาษีมูลค่าเพิ่ม (VAT Management) โดยไม่ต้องเข้าไปดำเนินการผ่านหน้า UI
ประเภทเอกสารที่รองรับ
documentType | คำอธิบาย |
|---|---|
expenses | เอกสารค่าใช้จ่าย |
purchases | เอกสารใบรับสินค้า |
หลักการทำงาน
ผู้ใช้งานสามารถแนบใบกำกับภาษีซื้อเข้ากับเอกสารค่าใช้จ่ายหรือเอกสารใบรับสิน ค้าที่มีอยู่แล้ว โดยระบุข้อมูลของใบกำกับภาษีซื้อ เช่น เลขที่เอกสาร วันที่ ชื่อผู้จำหน่าย และแนบไฟล์ (ถ้ามี)
เอกสารแต่ละรายการสามารถแนบใบกำกับภาษีซื้อได้ สูงสุด 1 รายการ เท่านั้น
supplierInvoiceStatus ของเอกสารต้นทางจะเป็นตัวกำหนดว่าสามารถแก้ไขได้หรือไม่
supplierInvoiceStatus | ค่า | สร้าง | แก้ไข | ลบ | สถานะ |
|---|---|---|---|---|---|
Awaiting | 1 | ได้ | ไม่ได้ | ไม่ได้ | รอใบกำกับภาษี |
WaitingForRefund | 3 | ไม่ได้ | ได้ | ได้ | รับใบกำกับภาษีแล้ว |
CreatedBatchFiling | 5 | ไม่ได้ | ไม่ได้ | ไม่ได้ | ยื่นแบบแล้ว |
NoRefund | 7 | ได้ | ได้ | ไม่ได้ | ไม่ใช้สิทธิขอคืน |
AwaitingPP36 | 9 | ไม่ได้ | ได้ | ได้ | รอยื่น ภ.พ.36 |
WaitingToPayPP36 | 11 | ไม่ได้ | ไม่ได้ | ไม่ได้ | รอชำระ ภ.พ.36 |
AwaitingTaxReceipt | 13 | ไม่ได้ | ไม่ได้ | ไม่ได้ | รอใบเสร็จสรรพากร |
การเปลี่ยนสถานะของเอกสารต้นทาง
เมื่อสร้างใบกำ กับภาษีซื้อ
Expense/Purchase: supplierInvoiceStatus = Awaiting (1)
│
▼ สร้างใบกำกับภาษีซื้อสำเร็จ
Expense/Purchase: supplierInvoiceStatus = WaitingForRefund (3)
กรณี supplierInvoiceStatus เดิมเป็น NoRefund (7) สถานะจะ ไม่ถูกเปลี่ยน เป็น WaitingForRefund — คงเป็น NoRefund เหมือนเดิม
เมื่อลบใบกำกับภาษีซื้อ
Expense/Purchase: supplierInvoiceStatus = WaitingForRefund (3)
│
▼ ลบใบกำกับภาษีซื้อสำเร็จ
Expense/Purchase: supplierInvoiceStatus = Awaiting (1)
สถานะของเอกสารต้นทาง (เช่น Approved) จะ ไม่ถูกย้อนกลับ หลังจากลบใบกำกับภาษีซื้อ
การตรวจสอบเอกสารซ้ำ (Duplicate Detection)
ระบบตรวจสอบความซ้ำของใบกำกับภาษีซื้อจาก 4 field ร่วมกัน:
| Field | คำอธิบาย |
|---|---|
documentSerial | เลขที่ใบกำกับภาษีซื้อ |
documentDate | วันที่ในใบกำกับภาษีซื้อ |
contactName | ชื่อผู้จำหน่าย |
companyId | บริษัทของผู้เรียก API (จาก Token) |
หากพบข้อมูลซ้ำ ระบบจะตอบกลับด้วย 409 Conflict (code 95013) — ไม่สามารถข้ามการตรวจสอบซ้ำได้
การแนบไฟล์
สามารถแนบไฟล์ได้ สูงสุด 1 ไฟล์ ต่อใบกำกับภาษีซื้อ
| ข้อจำกัด | รายละเอียด |
|---|---|
| จำนวนไฟล์สูงสุด | 1 ไฟล์ ต่อใบกำกับภาษีซื้อ |
| ขนาดไฟล์สูงสุด | ไม่เกิน 10 MB |
| นามสกุลที่รองรับ | jpg, jpeg, png, bmp, tif, tiff, pdf, doc, docx, xls, xlsx, ppt, pptx |
ข้อมูลเพิ่มเติม
- ดูตัวอย่าง Payload และ Response ของแต่ละ endpoint ได้ที่ จัดการใบกำกับภาษีซื้อ (CRUD)
- ดูข้อมูลอ้างอิง field ทั้งหมดได้ที่ ข้อมูลอ้างอิง
- ดูรหัสข้อผิดพลาดทั้งหมดได้ที่ รหัสข้อผิดพลาด