ข้อมูลอ้างอิงใบกำกับภาษีซื้อ
Field สำหรับ Request
| Field | ประเภท | Required | คำอธิบาย |
|---|---|---|---|
documentSerial | string | YES | เลขที่ใบกำกับภาษีซื้อ |
contactName | string | YES | ชื่อผู้จำหน่าย |
contactBranch | string | YES | สาขาของผู้จำหน่าย |
documentDate | string (date) | NO | วันที่ใบกำกับภาษีซื้อ (yyyy-MM-dd) หากไม่ระบุ จะใช้ค่า วันที่ออกเอกสารต้นทาง |
contactTaxId | string | Conditional | เลขผู้เสียภาษี P.P.30: บังคับ ต้องเป็น 13 หลัก, P.P.36: ไม่บังคับ |
taxForm | number (integer) | NO | แบบแสดงภาษี 1 (P.P.30, ค่าเริ่มต้น) หรือ 3 (P.P.36) |
vatableAmount | number (decimal) | Conditional | มูลค่าก่อน VAT สำหรับ P.P.36 ต้องมากกว่า 0 สำหรับ P.P.30 จะใช้ค่าจากเอกสารต้นทาง |
vatAmount | number (decimal) | Conditional | มูลค่า VAT สำหรับ P.P.36 ต้องมากกว่า 0 สำหรับ P.P.30 จะใช้ค่าจากเอกสารต้นทาง |
file | object | NO | ไฟล์แนบ สูงสุด 1 ไฟล์ |
โครงสร้าง file
| Field | ประเภท | Required | คำอธิบาย |
|---|---|---|---|
file.fileName | string | YES (เมื่อส่ง file) | ชื่อไฟล์พร้อมนามสกุล เช่น invoice.pdf |
file.base64Data | string | YES (เมื่อส่ง file) | เนื้อหาไฟล์ในรูปแบบ Base64 |
Field สำหรับ Response
| Field | ประเภท | คำอธิบาย |
|---|---|---|
id | number (integer) | รหัสใบกำกับภาษีซื้อ |
documentDate | string | วันที่ใบกำกับภาษีซื้อ |
documentSerial | string | เลขที่ใบกำกับภาษีซื้อ |
contactName | string | ชื่อผู้จำหน่าย |
contactTaxId | string | เลขผู้เสียภาษี |
contactBranch | string | สาขาของผู้จำหน่าย |
taxForm | number (integer) | แบบแสดงภาษี (1=P.P.30, 3=P.P.36) |
vatableAmount | number (decimal) | มูลค่าก่อน VAT |
vatAmount | number (decimal) | มูลค่า VAT |
supplierInvoiceStatus | number (integer) | สถานะใบกำกับภาษีซื้อ |
createdOn | string | วันที่สร้าง |
modifiedOn | string | วันที่แก้ไขล่าสุด |
attachments | array | รายการไฟล์แนบ (ดูโครงสร้างด้านล่าง) |
โครงสร้าง attachments
| Field | ประเภท | คำอธิบาย |
|---|---|---|
mediaId | number (integer) | รหัสไฟล์ |
fileName | string | ชื่อไฟล์ |
mediaType | number (integer) | ประเภทไฟล์ |
url | string | URL ของไฟล์ |
uploadedOn | DateTime | วันที่อัปโหลด |
เงื่อนไขของเอกสารต้นทาง
เอกสารค่าใช้จ่ายหรือเอกสารซื้อที่ต้องการแนบใบกำกับภาษีซื้อ ต้องผ่านเงื่อนไขทั้งหมดต่อไปนี้
สำหรับ POST (สร้าง)
| เงื่อนไข | HTTP Status | Error Code |
|---|---|---|
| เอกสารต้องมีอยู่ในระบบ | 404 | 190000 |
| เอกสารต้องอยู่ในบริษัทเดียวกัน | 404 | 190000 |
| เอกสารต้องไม่ถูกลบ | 404 | 190000 |
| เอกสารต้องไม่ถูกยกเลิก (Void) | 400 | 70020 |
| เอกสารต้องไม่อยู่ในแบบยื่นภาษี (Batch Tax Filing) | 400 | 70005 |
supplierInvoiceStatus ต้องเป็น Awaiting (1) หรือ NoRefund (7) | 400 | 70000 |
สำหรับ PUT (แก้ไข)
| เงื่อนไข | HTTP Status | Error Code |
|---|---|---|
เงื่อนไขเดียวกับ POST (ยกเว้นข้อ supplierInvoiceStatus) | ตามข้างต้น | ตามข้างต้น |
| ต้องมีใบกำกับภาษีซื้อแนบอ ยู่แล้ว | 400 | 190000 |
supplierInvoiceStatus ต้องไม่เป็น WaitingToPayPP36 (11), AwaitingTaxReceipt (13) หรือ CreatedBatchFiling (5) | 400 | 70005 |
สำหรับ GET (ดึงข้อมูล)
| เงื่อนไข | HTTP Status | Error Code |
|---|---|---|
| เอกสารต้องมีอยู่ในระบบและอยู่ในบริษัทเดียวกัน | 404 | 190000 |
| เอกสารต้องไม่ถูกลบ | 404 | 190000 |
สำหรับ DELETE (ลบ)
| เงื่อนไข | HTTP Status | Error Code |
|---|---|---|
| เอก สารต้องมีอยู่ในระบบและอยู่ในบริษัทเดียวกัน | 404 | 190000 |
| เอกสารต้องไม่ถูกลบ | 404 | 190000 |
| ต้องมีใบกำกับภาษีซื้อแนบอยู่แล้ว | 400 | 190000 |
supplierInvoiceStatus ต้องไม่เป็น CreatedBatchFiling (5), NoRefund (7), WaitingToPayPP36 (11) หรือ AwaitingTaxReceipt (13) | 400 | 70005 |
ข้อจำกัดของไฟล์แนบ
| ข้อจำกัด | รายละเอียด |
|---|---|
| จำนวนไฟล์สูงสุด | 1 ไฟล์ ต่อใบกำกับภาษีซื้อ |
| ขนาดไฟล์สูงสุด | ไม่เกิน 10 MB |
| นามสกุลที่รองรับ | jpg, jpeg, png, bmp, tif, tiff, pdf, doc, docx, xls, xlsx, ppt, pptx |
ค่า Enum ที่เกี่ยวข้อง
supplierInvoiceStatus สถานะของใบกำกับภาษีซื้อบนเอกสารต้นทาง
| ค่า | ความหมาย | คำอธิบาย | สร้าง | แก้ไข | ลบ |
|---|---|---|---|---|---|
1 | Awaiting | รอใบกำกับภาษี | ได้ | ไม่ได้ | ไม่ได้ |
3 | WaitingForRefund | รับใบกำกับภาษีแล้ว | ไม่ได้ | ได้ | ได้ |
5 | CreatedBatchFiling | ยื่นแบบแล้ว | ไม่ได้ | ไม่ได้ | ไม่ได้ |
7 | NoRefund | ไม่ใช้สิทธิขอคืน | ได้ | ได้ | ไม่ได้ |
9 | AwaitingPP36 | รอยื่น ภ.พ.36 | ไม่ได้ | ได้ | ได้ |
11 | WaitingToPayPP36 | รอชำระ ภ.พ.36 | ไม่ได้ | ไม่ได้ | ไม่ได้ |
13 | AwaitingTaxReceipt | รอใบเสร็จสรรพากร | ไม่ได้ | ไม่ได้ | ไม่ได้ |
taxForm แบบแสดงภาษี
| ค่า | ความหมาย | หมายเหตุ |
|---|---|---|
1 | P.P.30 | ค่า vatableAmount และ vatAmount เท่ากับเอกสารต้นทาง |
3 | P.P.36 | ต้องระบุ vatableAmount > 0 และ vatAmount > 0 |
documentType ประเภทเอกสารที่รองรับ
| ค่า | ความหมาย |
|---|---|
18 | Expense (ค่าใช้จ่าย) |
19 | Purchase (ใบรับสินค้า) |