PATCH /drivers/{id}/status → { stage, reason, notes } → POST /audit/escalation → logged → POST /whatsapp/send → escalation_notice_ar (if selected)
🤝
Payment Arrangement
Set up a structured repayment plan for overdue balance.
Total Overdue (QAR)
Split Into
First Payment Date *
Frequency
Include Penalty Fee
Collection Method
📋 Arrangement Schedule Preview
Notes to Driver
POST /arrangements → { driver_id, instalments, method, notes } → POST /qpay/payment-link/schedule → links sent per instalment date → POST /whatsapp/send → arrangement_confirmed_ar
⚖️
Flag for Legal Action
This will mark the driver for legal collection proceedings.
Legal Stage *
Amount in Dispute (QAR)
Grace Period Before Action
Evidence / Documentation
Assigned To
⚠️ Once flagged for legal action, driver's contract will be suspended and access revoked. Deposit will be applied to outstanding balance.
🗑️
Write Off Balance
Writing off a balance removes it from receivables. This is irreversible.
Amount to Write Off (QAR)
Write-Off Category
Approval Required From
Justification *
POST /write-offs → { driver_id, amount, category, justification } → Requires approval_token from approver → POST /accounting/journal → credit bad debt expense
💬
Send Communication
Send a targeted message to the driver.
Channel *
Template
Message *
Language
Schedule
POST /whatsapp/send → { driver_id, message, template } → POST /audit/comm → logged in comms history
📢
Bulk Communication
Send to selected drivers.
Channel
Message Template
Message
POST /whatsapp/batch → [driver_ids] → template → POST /twilio/sms/batch → Arabic messages
⬇️
De-escalate Driver
Driver will be moved to a lower risk stage.
Move To
Reason
Notes
⚙️
Automation Rule Settings
Configure when and how the system automatically escalates, notifies, and acts on at-risk drivers.