ข้อมูลอ้างอิงใบเสร็จแบบแบ่งชำระ
Field เฉพาะสำหรับใบเสร็จแบบแบ่งชำระ
Field ต่อไปนี้ใช้เฉพาะกับการสร้างใบเสร็จแบบแบ่งชำระ นอกเหนือจาก field ทั่วไปของใบเสร็จรับเงิน
ระดับเอกสาร
| Field | ประเภท | Required | คำอธิบาย |
|---|
isBatchDocument | boolean | YES | ต้องเป็น true เสมอ — ระบุว่าเป็นเอกสารแบบแบ่งชำระ |
partialPaymentMethod | number | YES | ต้องเป็น 11 (RECPartial) |
publishedOn | string (date) | YES | วันที่ออกเอกสาร (yyyy-MM-dd) |
creditType | number | YES | ต้องเป็น 3 (เงินสด) ค่าอื่นไม่รองรับสำหรับใบเสร็จแบบแบ่งชำระ |
grandTotal | decimal | YES | ต้องเท่ากับ partialAmount ของรายการ |
documentReference | array | NO | ต้องเป็น null หรือ [] เท่านั้น |
ระดับรายการสินค้า
| Field | ประเภท | Required | คำอธิบาย |
|---|
documentId | number | YES | recordId ของใบกำกับภาษีต้นทาง (ต้องมากกว่า 0) |
documentType | number | YES | ต้องเป็น 7 (ใบกำกับภาษี) |
partialAmount | decimal | YES | ยอดที่ต้องการชำระในงวดนี้ (ต้องมากกว่ า 0 และไม่เกินยอดคงเหลือ) |
เงื่อนไขของใบกำกับภาษีต้นทาง
ระบบตรวจสอบใบกำกับภาษีต้นทาง (INV) ก่อนสร้างใบเสร็จแบบแบ่งชำระทุกครั้ง INV ที่ใช้ต้องผ่านเงื่อนไขทั้งหมดต่อไปนี้
สถานะของเอกสาร
- INV ต้องมีอยู่ในระบบ
- INV ต้องไม่ถูกลบหรือยกเลิก (Void)
- สถานะ INV ต้องเป็น รอดำเนินการ (1), รอเก็บเงิน (3) หรือ แบ่งจ่าย (11)
- INV ต้องอยู่ในบริษัทเดียวกับผู้เรียก API
ประเภทเอกสาร
creditType ของ INV ต้องเป็น 1 (ตามจำนวนวัน) หรือ 5 (ไม่แสดงวันที่)
- INV ต้องไม่เป็นเอกสารมัดจำ
เอกสารอ้างอิง
- INV ต้องไม่มีเอกสารอ้างอิงประเภท CN, DN หรือ BLC
- INV ต้องไม่มีใบเสร็จรับเงินแบบปกติอ้างอิงอยู่ — อนุญาตเฉพาะใบเสร็จแบบแบ่งชำระเท่านั้น
ดูรายละเอียด error message ทั้งหมดได้ที่ รหัสข้อผิดพลาด
ค่า Enum ที่เกี่ยวข้อง
documentType — ประเภทของเอกสาร
| ค่า | ความหมาย | หมายเหตุ |
|---|
7 | ใบกำกับภาษี (Tax Invoice) | ประเภทเดียวที่รองรับในการสร้างใบเสร็จแบบแบ่งชำระ |
9 | ใบเสร็จรับเงิน (Receipt) | ใบเสร็จแบบแบ่งชำระ |
creditType — ประเภทเครดิต
| ค่า | ความหมาย | หมายเหตุ |
|---|
1 | ตามจำนวนวัน | ค่าที่รองรับสำหรับ INV ต้นทาง |
3 | เงินสด | ค่าที่ต้องระบุใน request ใบเสร็จแบบแบ่งชำระ |
5 | ไม่แสดงวันที่ | ค่าที่รองรับสำหรับ INV ต้นทาง |
partialPaymentMethod — วิธีการชำระแบบแบ่งจ่าย
| ค่า | ความหมาย | หมายเหตุ |
|---|
11 | RECPartial | ค่าเดียวที่รองรับสำหรับใบเสร็จแบบแบ่งชำระ |
status — สถานะของใบกำกับภาษีต้นทาง (INV)
| ค่า | ความหมาย | หม ายเหตุ |
|---|
1 | รอดำเนินการ | สถานะเริ่มต้น สามารถสร้างใบเสร็จแบบแบ่งชำระได้ |
3 | รอเก็บเงิน | สามารถสร้างใบเสร็จแบบแบ่งชำระได้ |
9 | เปิดใบเสร็จแล้ว | ชำระครบแล้ว ไม่สามารถสร้างใบเสร็จแบบแบ่งชำระเพิ่มได้ |
11 | แบ่งจ่าย | ชำระบางส่วนแล้ว สามารถสร้างใบเสร็จแบบแบ่งชำระงวดถัดไปได้ |
referencedByMe[].type / referencedToMe[].type — ประเภทการอ้างอิง
| ค่า | ความหมาย | หมายเหตุ |
|---|
1 | ImportDocument | อ้างอิงจากการเปลี่ยนประเภทเอกสาร (Upgrade) สามารถสร้างใบเสร็จแบบแบ่งชำระเพิ่มได้ |
5 | Batch | อ้างอิงจากการสร้างใบวางบิลรวมหรือใบเสร็จรวม ไม่สามารถสร้างใบเสร็จแบบแบ่งชำระเพิ่มได้ |
11 | BatchPartialPayments | อ้างอิงระหว่างใบเสร็จแบบแบ่งชำระกับใบกำกับภาษีต้นทาง สามารถสร้างใบเสร็จแบบแบ่งชำระเพิ่มได้ |
13 | DepositFirst | อ้างอิงมัดจำงวดแรก ไม่สามารถสร้างใบเสร็จแบบแบ่งชำระเพิ่มได้ |
15 | DepositLast | อ้างอิงมัดจำงวดสุดท้าย ไม่สามารถสร้างใบเสร็จแบบแบ่งชำระเพิ่มได้ |
documentDeductionType — ประเภทการหักเงิน