Fuel Bunks
Available to: Admin, Super Admin, Fuel Bunk Owner, Fuel Bunk Manager
Fuel Bunks are the physical fuel stations where machinery gets refueled. This section covers bunk registration, profile management, rate cards, and commission configuration.
Bunk List
Navigate to Fuels → Bunks (/fuels/bunks) to view all registered fuel bunks.
List Features
- Table view with sortable columns — name, status, oil company, owner type, commission details
- Card view for a visual overview
- Global search across bunk name and details
Filtering
| Filter | Description |
|---|---|
| Status | Active, Inactive, Blocked, Under Review |
| Owner Type | Self or Company |
| Name | Search by bunk name |
| Is Linked Bunk | Filter linked/unlinked bunks |
| Commission Values | Filter by Petrol/Diesel commission ranges |
Bunk Statuses
| Status | Description |
|---|---|
| Active | Bunk is operational and accepting requests |
| Inactive | Bunk is temporarily not operational |
| Blocked | Bunk has been blocked by admin |
| Under Review | Bunk registration is being reviewed |
Creating a Bunk
Navigate to Fuels → Bunks → Add (/fuels/bunks/add) to register a new fuel bunk.
The creation follows a multi-step wizard that varies based on your role:
Admin Flow
- Select creation mode — Choose "Add as Admin"
- Enter bunk details — Name, oil company
- Select owner — Search and assign a bunk owner
- Submit — Bunk is created and ready for further configuration
Owner / Manager Flow
- Select creation mode — Choose "Add as Owner" or "Add as Manager"
- Verify mobile — OTP verification for the bunk's contact number
- Enter bunk details — Name, oil company
- Submit — Bunk is created under your ownership/management
Required Fields
| Field | Required | Description |
|---|---|---|
| Name | Yes | Name of the fuel bunk |
| Oil Company | Yes | Associated oil company (e.g., IOCL, BPCL, HPCL) |
| Owner Type | Yes | Self (individual) or Company |
| Owner | Conditional | Required when admin is creating on behalf of an owner |
Bunk Account
After creating a bunk, click on it from the list to access the full account view (/fuels/bunks/$bunkId/account).
The account page has multiple tabs:
General Information
Edit the bunk's basic details:
| Field | Description |
|---|---|
| Name | Bunk display name |
| Fuel Bunk ID | Unique identifier |
| Oil Company | Associated oil company |
| Owner Type | Self or Company |
| Profile Image | Bunk photo/logo |
Settings
Configure operational settings:
| Setting | Description |
|---|---|
| Status | Active, Inactive, Blocked, Under Review |
| Is Linked Bunk | Whether this bunk is linked to the platform for automated operations |
| Opening Time | Daily opening time |
| Closing Time | Daily closing time |
Commission Configuration
Configure commission for settlements:
| Field | Description |
|---|---|
| Diesel Commission Type | Percentage or Fixed amount |
| Diesel Commission Value | Commission value for diesel |
| Petrol Commission Type | Percentage or Fixed amount |
| Petrol Commission Value | Commission value for petrol |
| Settlement Duration (Days) | Number of days until settlement is due |
Access via Account → Edit Commission (/fuels/bunks/$bunkId/account/editCommission).
Rate Card
Manage fuel rates for the bunk (/fuels/bunks/$bunkId/account/rate-card).
The rate card section has three views:
Current Rate
Shows the active rate for each fuel type. To set a new current rate:
- Click Edit on the current rate card
- Select Fuel Type (Petrol or Diesel)
- Enter the Rate
- Save — the new rate takes effect immediately
Upcoming Rates
Schedule future rate changes:
- Click Add Upcoming Rate
- Select Fuel Type
- Enter the Rate
- Select the Effective Date
- Save — the rate will automatically activate on the scheduled date
Rate History
View all past rates with their effective dates. This provides an audit trail of rate changes over time.
Address
Manage the bunk's physical address (/fuels/bunks/$bunkId/account/address/$addressId).
Identity Documents
Update identity and registration documents:
| Document | Path |
|---|---|
| Registration Number | /fuels/bunks/$bunkId/account/reg-no |
| PAN | /fuels/bunks/$bunkId/account/pan |
/fuels/bunks/$bunkId/account/email |
Mobile Verification
Verify contact numbers via OTP:
| Type | Path |
|---|---|
| Primary Mobile | /fuels/bunks/$bunkId/account/mobile → OTP at /mobile/otp |
| Alternate Mobile | /fuels/bunks/$bunkId/account/alt-mobile → OTP at /alt-mobile/otp |
Personnel
Assign people to the bunk:
| Role | Description |
|---|---|
| Owner | Bunk owner (individual or company) |
| Managers | Bunk managers who handle operations |
| Salesmen | Staff who manage fuel dispensing |
Delete Bunk
A delete option is available with a confirmation modal to prevent accidental deletion.