Skip to main content

Settlements

Available to: Admin, Super Admin

Settlements track the financial reconciliation between the platform and fuel bunks. Each settlement is generated from fuel buy requests and includes commission deductions.

Settlement List

Navigate to Fuels → Settlements (/fuels/settlements) to view all settlement records.

Settlement Details

Each settlement record includes:

FieldDescription
Fuel BunkThe bunk associated with the settlement
AmountTotal fuel purchase amount
Commission TypePercentage or Fixed
Commission ValueCommission rate or fixed amount
Commission AmountCalculated commission deducted
Final AmountSettlement amount after commission (Amount - Commission)
Settlement Due DateWhen the settlement payment is due
StatusPayment status of the settlement
Fuel Buy RequestThe linked buy request that generated this settlement

Aggregated Totals

The settlement list displays summary totals at the top:

  • Total Amount — Sum of all fuel purchase amounts
  • Total Commission Amount — Sum of all commissions
  • Total Settlement Amount — Net amount after all commissions

Filtering

FilterDescription
Fuel Bunk NameSearch by bunk name
StatusFilter by settlement payment status
Settlement Due DateFilter by due date range
Commission FieldsFilter by commission type/value ranges
Final AmountFilter by settlement amount range

How Settlements Work

Creation

When a bunk salesman accepts a fuel buy request, a settlement is automatically created:

  1. Commission is calculated using the bunk's configured commission type and value:
    • Percentage: Commission = Amount x (Commission Value / 100)
    • Fixed: Commission = Fixed commission amount per transaction
  2. Final amount = Amount - Commission Amount
  3. Due date = Accepted date + Settlement Duration Days (configured in bunk settings)
  4. Settlement is created with status "Unpaid"

Payment

Settlements are paid out automatically:

  1. A daily automated job checks for all Unpaid settlements where the due date has arrived
  2. For each eligible settlement, the final amount is credited to the bunk owner's company wallet with the source "Bunk Settlement"
  3. The settlement status changes to "Paid"

Settlement Statuses

StatusDescription
UnpaidSettlement created, awaiting due date for auto-payment
PaidFinal amount has been credited to the company wallet
tip

To see the wallet credit, go to Companies → [Company] → Account → Wallet and look for entries with source "Bunk Settlement".