ใบแจ้งหนี้รถร่วม (Partner Invoice)

เมนูนี้ใช้สำหรับดูและ export ใบแจ้งหนี้ของบริษัทรถร่วม โดยระบบแยกเป็น 2 ระดับ

1. หน้ารวมตามเดือน
2. หน้ารายละเอียดของบริษัทรถร่วมในพื้นที่ทำงานที่เลือก

ระดับที่ 1: หน้ารวมใบแจ้งหนี้รถร่วม

หน้า list ใช้ endpoint GET /partner-invoice และส่ง query หลักดังนี้

• month
• q
• page
• pageSize

จาก response เดียวกัน หน้า list จะนำข้อมูลไปใช้ 2 ส่วนพร้อมกัน

• ตารางรายการ
• การ์ดสรุปด้านบน
  • driverCount
  • totalAmount
  • maxAmount
  • minAmount

ข้อมูลที่แสดงในรายการ

ระบบจะแสดงข้อมูลโดยจัดกลุ่มตาม:

• บริษัทรถร่วม (Partner Company)
• พนักงานขับรถ (Driver)
• พื้นที่ทำงาน (Work Area)
• สถานะ (Status)

พร้อมแสดงยอดรวมทั้งหมด, ยอดสูงสุด และยอดต่ำสุด ของเดือนนั้น

การกรองข้อมูล

• เดือน (Month): เลือกเดือนที่ต้องการดู (รูปแบบ YYYY-MM เช่น 2025-01)
• ค้นหา: ค้นหาด้วยชื่อพนักงานขับรถ หรือรหัสพนักงาน

การเข้าไปดูรายละเอียด

เมื่อกดดูจากหน้ารวม ระบบจะพาไปที่

• /contract-invoice/:partnerCompanyId?partnerName=...&monthYear=...&workAreaId=...

จุดที่ต้องรู้คือหน้า detail ต้องใช้ทั้ง

• partnerCompanyId
• workAreaId

เพราะ endpoint จริงคือ GET /partner-invoice/{id}/{workAreaId}

ระดับที่ 2: หน้ารายละเอียดใบแจ้งหนี้รถร่วม

หน้า detail จะแสดงข้อมูลระดับรายการย่อย เช่น

• รหัสรถ
• ชื่อนักขับรถร่วม
• ลูกค้า
• สัญญา
• จำนวนเที่ยว
• จำนวนเงินสุทธิ

หน้าเดียวกันนี้ยังมี summary ท้ายตารางที่ frontend คำนวณเพิ่มให้ด้วย

• ราคา
• ภาษีหัก ณ ที่จ่าย 1%
• รวมจำนวนเงินทั้งสิ้นหลังหักภาษี

การ Export ใบแจ้งหนี้รถร่วม

ระบบรองรับการ Export หลายรูปแบบ:

รูปแบบ	คำอธิบาย
Export ทั้งหน้ารายละเอียด	Export ข้อมูลของ partnerCompany + workArea ที่กำลังเปิดดู
Export รายแถว	Export เฉพาะ driver + contract ของแถวนั้น

endpoint export ที่ยืนยันจากโค้ดคือ

• GET /partner-invoice/{id}/{workAreaId}/export
• GET /partner-invoice/{id}/{workAreaId}/{driverId}/{contractId}/export

tip

หน้า detail เหมาะสำหรับใช้ตรวจความถูกต้องก่อน export จริง เพราะจะแสดงทั้งยอดรายแถวและยอดรวมหลังหักภาษี

รายงานใบแจ้งหนี้รถร่วม (Partner Invoice Report)

นอกจากรายการรายเดือน ยังมีหน้า รายงาน ที่สามารถกรองข้อมูลได้ละเอียดขึ้น:

• กรองตามช่วงวันที่ (Start Date – End Date)
• กรองตามบริษัทรถร่วม
• กรองตามลูกค้า
• กรองตามพื้นที่ทำงาน

ดูรายละเอียดต่อที่ รายงานข้อมูลการวางบิลรถร่วม

อ้างอิงโค้ด

• atp30-tos-frontend/src/views/pages/contract-invoice/index.tsx
• atp30-tos-frontend/src/views/pages/contract-invoice/viewContractInvoice.tsx
• atp30-tos-frontend/src/api/contract-bus-company-invoices.ts