รองรับ Simple Partial Receipt พร้อมปรับ referencedToMe / referencedByMe

1. การเปลี่ยนแปลง Response Model ของ referencedToMe และ referencedByMe
2. รองรับการแบ่งรับชำระเงิน (Partial Receipt) แบบ Simple สำหรับใบเสร็จรับเงิน

เริ่มมีผลบน Production Environment: 18/03/2026

---

1. การเปลี่ยนแปลง Response Model ของ referencedToMe และ referencedByMe

Response ของเอกสารทุกประเภทจะมีการเปลี่ยนแปลง model ของ referencedToMe และ referencedByMe

สิ่งที่เปลี่ยนแปลง

เดิม field type ใน referencedToMe / referencedByMe ใช้เก็บ ประเภทเอกสารปลายทาง แต่ตั้งแต่การอัปเดตนี้เป็นต้นไป:

• ค่าประเภทเอกสารปลายทางจะถูกย้ายไปอยู่ใน field documentType แทน
• field type จะเปลี่ยนความหมายเป็น ประเภทการอ้างอิง (reference type) ตามตารางด้านล่าง

ค่า	ความหมาย	หมายเหตุ
1	ImportDocument	อ้างอิงจากการเปลี่ยนประเภทเอกสาร (Upgrade)
5	Batch	อ้างอิงจากการสร้างใบวางบิลรวมหรือใบเสร็จรวม
11	BatchPartialPayments	อ้างอิงระหว่างใบเสร็จแบบแบ่งชำระกับใบกำกับภาษีต้นทาง
13	DepositFirst	อ้างอิงมัดจำงวดแรก
15	DepositLast	อ้างอิงมัดจำงวดสุดท้าย

ตัวอย่าง referencedByMe ใน response ของใบเสร็จแบบแบ่งชำระ:

"referencedByMe": [
    {
        "referenceId": "9962945",
        "referenceDocumentType": "7",
        "referenceDocumentSerial": "INV2026030045",
        "documentId": "66603",
        "documentType": "9",
        "documentSerial": "RE2026030079",
        "type": 11
    }
]

APIs ที่ได้รับผลกระทบ

• APIs เอกสารทุกประเภทที่มี referencedToMe และ referencedByMe ใน response

---

2. รองรับการแบ่งรับชำระเงิน (Partial Receipt) แบบ Simple

FlowAccount OpenAPI ได้เพิ่มการรองรับการสร้างใบเสร็จรับเงินแบบแบ่งชำระ (Partial Receipt) แบบ Simple จากใบกำกับภาษี โดยสามารถแบ่งรับชำระเงินเป็นรายงวดได้ผ่าน endpoint POST /receipts

การแบ่งรับชำระเงินแบบ Simple (Partial Receipt) ช่วยให้ผู้ใช้งาน API สามารถสร้างใบเสร็จรับเงินจากใบกำกับภาษีเป็นรายงวดได้ โดยภาษีมูลค่าเพิ่มคำนวณในระดับเอกสาร เหมาะสำหรับใบกำกับภาษีที่มีอัตราภาษีเดียว โดยระบุเพียง documentId, documentType และ partialAmount ต่อรายการ — ระบบจะดึงข้อมูลทางการเงินจากใบกำกับภาษีต้นทางและคำนวณค่าที่เกี่ยวข้องให้โดยอัตโนมัติ

สามารถดูรายละเอียด การแบ่งรับชำระเงิน (Partial Receipt) เพิ่มเติมได้ที่ Tutorial: การแบ่งรับชำระเงิน (Partial Receipt)

Field ระดับเอกสารที่ต้องระบุ

Field	ประเภท	คำอธิบาย
isBatchDocument	boolean	ต้องเป็น true เสมอ — ระบุว่าเป็นเอกสารแบบแบ่งชำระ
partialPaymentMethod	number	ต้องเป็น 11 (RECPartial)
creditType	number	ต้องเป็น 3 (เงินสด)
grandTotal	decimal	ต้องเท่ากับผลรวมของ partialAmount ทุกรายการ

Field ระดับรายการสินค้าที่ต้องระบุ

Field	ประเภท	คำอธิบาย
documentId	number	recordId ของใบกำกับภาษีต้นทาง (ต้องมากกว่า 0)
documentType	number	ต้องเป็น 7 (ใบกำกับภาษี)
partialAmount	decimal	ยอดที่ต้องการชำระในงวดนี้ (ต้องมากกว่า 0 และไม่เกินยอดคงเหลือ)

สามารถดูรายละเอียดเพิ่มเติมได้ที่ Tutorial: ใบเสร็จแบบแบ่งชำระแบบ Simple

API ที่ได้รับผลกระทบ

• POST /receipts