Skip to main content
Fuel Station / Forecourt POS for ERPNext — A build-to-order ERPNext app for petrol stations and forecourts that ties pump/noz — 1/1Illustrative preview

A build-to-order ERPNext app for petrol stations and forecourts that ties pump/nozzle meter reconciliation,

shift handovers, tank wet-stock and fuel-card sales into one auditable ledger.

ECOSIRE builds it to your scope, installs it, and supports it after go-live.

What is Fuel Station / Forecourt POS for ERPNext?

A build-to-order ERPNext app for petrol stations and forecourts that ties pump/nozzle meter reconciliation, shift handovers, tank wet-stock and fuel-card sales into one auditable ledger. ECOSIRE builds it to your scope, installs it, and supports it after go-live. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Pump/nozzle meter reconciliation: closing minus opening reading, net of test and calibration pours, reconciled against dispensed sales per nozzle
Site modelled as first-class DocTypes — `Fuel Tank`, `Pump`, `Nozzle`, with each nozzle bound to its source tank and fuel product
Shift-wise workflow: opening/closing `Shift Reading`, attendant assignment, and supervisor-authorised cash and card handover at close
Tank dip entry converted to volume through per-tank calibration (strapping) charts and compared to ERPNext book stock
Wet-stock variance report exposing shrinkage, evaporation, temperature swing, and delivery discrepancy per tank per day
Fuel-card and fleet-account sales with credit-limit and account-balance checks against the customer's fleet master
Combined forecourt + convenience-store ticket — dispensed fuel lines and shop items settle on one Sales Invoice
Movements post through native ERPNext Stock Entry, Sales Invoice, and Payment/Journal Entry so GL and stock valuation stay canonical
`hooks.py` doc events (`validate`, `on_submit`) block shift close when meter-vs-sales or cash-vs-collection delta exceeds your tolerance
Whitelisted server-script methods for dip entry and reconciliation, callable from POS and handheld apps over the Frappe REST API
Fuel delivery / tanker receipt DocType that updates tank book stock and reconciles delivered vs invoiced litres
Scheduler events for daily wet-stock roll-up, price-change stamping, and low-tank reorder flags
Client Scripts for attendant POS: nozzle pick, litre/amount toggle, fuel-card lookup, and quick shift-cash count
Role Profiles separating attendant, shift supervisor, and accountant, with permission rules on every forecourt DocType

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

Fuel retail is a wet-stock business, not a boxed-goods business. Every litre pumped has to reconcile back to a nozzle meter reading, a tank dip, and cash or fuel-card settlement at shift close — and a variance of even a fraction of a percent across a busy forecourt is real money leaking or being over-charged. ERPNext gives you a solid Sales Invoice, Stock Ledger, and Payment Entry backbone, but out of the box it has no concept of an opening/closing nozzle reading, a calibrated tank dip converted to litres, a pump-to-tank mapping, or a shift cash handover. Operators end up reconciling all of this in spreadsheets that never tie back to the accounting ledger.

ECOSIRE builds a proper Frappe app that adds the forecourt domain on top of ERPNext rather than bolting it on. We model the physical site as DocTypes — Fuel Tank, Pump, Nozzle (with its bound tank and product), Shift, Shift Reading, Tank Dip, and Fuel Card Account — and post the resulting movements through native ERPNext Stock Entries, Sales Invoices, and Journal/Payment Entries so your GL and stock valuation stay canonical. Nozzle throughput (closing meter minus opening meter, adjusted for test/calibration pours) is computed and reconciled against dispensed sales; tank dips are converted through per-tank calibration charts into volume and compared to book stock to surface shrinkage, evaporation, or delivery discrepancies as a variance report.

The logic lives where it belongs in Frappe. hooks.py doc events (validate, on_submit) enforce that a shift cannot close with an unbalanced meter-vs-sales or cash-vs-collection delta beyond your tolerance; whitelisted server methods expose reconciliation and dip-entry endpoints for the forecourt POS and any handheld dip app over the Frappe REST API; scheduler events roll up daily wet-stock variance and can flag tanks trending toward reorder. Client Scripts drive the attendant-facing POS — nozzle selection, litres/amount entry, fuel-card lookup against the customer's fleet account and credit limit — and combine dispensed-fuel and convenience-store (shop) lines on a single ticket. Role Profiles and permission rules separate the attendant, the shift supervisor who authorises handovers, and the accountant who reviews variance, with the full audit trail ERPNext already provides.

Because this is build-to-order, you receive an app scoped to your actual site layout, product slate, fuel-card partners and reporting needs — not a generic template you have to bend. After a short scoping call we confirm the DocType model and reconciliation rules, build against ERPNext v15/v16, and run UAT on a staging bench with your data before go-live. Typical delivery is one working week from confirmed scope, and you get the full git repository, installable source for your version, and a post-go-live support window so real forecourt edge cases get handled, not left to spreadsheets.

What you get

  • Installable source code for your commissioned version of the Fuel Station / Forecourt POS Frappe app (ERPNext v15/v16)
  • Installation and configuration on your bench — DocTypes, Role Profiles, workflows, calibration charts and site setup
  • Technical documentation: DocType model, doc events, whitelisted methods, scheduler jobs and REST endpoints
  • User guide plus a live training session for attendants, shift supervisors and accounting staff
  • UAT on a staging bench with your data, plus a documented rollback plan before go-live
  • Post-go-live support window for defect fixes and real-forecourt edge cases
  • Full git repository handover with commit history and branch/tag structure
  • Configuration workbook capturing pumps, nozzle-to-tank mapping, products, tolerances and fuel-card partners

Who this is for

Independent forecourt operator

Runs one or a few petrol stations and needs pump readings, tank dips and shift cash to reconcile against ERPNext accounting without maintaining parallel spreadsheets or a separate wet-stock tool.

Multi-site fuel retail chain

Operates several stations under one ERPNext instance and wants standardised shift handovers, per-site variance reporting and consolidated fuel-card/fleet-account billing across the network.

Fleet and fuel-card manager

Manages corporate fleet accounts and card-based fuelling; needs credit-limit enforcement at the pump and clean per-account statements posted straight into ERPNext receivables.

Finance / audit controller

Owns month-end and needs an auditable line from nozzle meter to tank dip to GL, with variance thresholds and role separation between attendants, supervisors and accountants.

How Fuel Station / Forecourt POS for ERPNext Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
Wet-stock reconciliationBuilt-in nozzle meter, tank dip and variance modelPossible but you specify and build it allPartial or generic, rarely dip-to-GLNo forecourt or dip concept at all
Shift handoverOpening/closing readings + supervisor-authorised cash/card handoverDepends on your build effortBasic shift close if offeredGeneric POS closing, no fuel shift
Fuel-card / fleet accountsCredit-limit checks at pump, posts to receivablesMust be built and tested from scratchVaries; often add-on or absentStandard customer only, no card logic
ERPNext GL/stock integrityPosts through native Stock/Sales/Payment entriesCorrect only if you enforce itSometimes bypasses core ledgersCanonical, but no fuel data feeding it
Fit to your siteScoped to your pumps, tanks, products and cardsFully bespoke, at full cost and timeGeneric template you bend to fitNot fuel-specific
Delivery timeone working week from confirmed scopeMonths of in-house discovery and buildFast to install, slow to actually fitImmediate but unusable for forecourt
OwnershipFull git repo + installable source handed overYou own it but carry all the riskVendor-locked, limited source accessCore, but no forecourt code exists
Support after go-liveDefined support window + optional ongoingYour team maintains everythingTiered subscription supportCommunity/self-support only

Frequently Asked Questions about Fuel Station / Forecourt POS

Is this an existing app I can download and install today?

No. It is build-to-order. ECOSIRE builds the Fuel Station / Forecourt POS app to your specific site layout, product slate and reconciliation rules on top of ERPNext, then installs and supports it. There is no instant marketplace download.

How long does delivery take?

Typical delivery is one working week from confirmed scope. After the scoping call we agree the DocType model and reconciliation rules; the timeline depends on the number of sites, fuel-card integrations and any custom reports. Complex multi-site rollouts are staged and quoted accordingly.

Which ERPNext versions is it built for?

We build against ERPNext and Frappe v15 and v16. We target the version your bench runs, keep changes to a proper installable app rather than core edits, and confirm the exact version during scoping so upgrades stay clean.

How does it handle wet-stock variance and tank dips?

Manual or metered dips are converted to volume through per-tank calibration charts and compared against ERPNext book stock. A daily variance report per tank surfaces shrinkage, evaporation and delivery discrepancies, and shift close can be blocked when meter-vs-sales or cash deltas exceed your tolerance.

Does it work with fuel cards and fleet accounts?

Yes. Fuel-card and fleet-account sales check the customer's account balance and credit limit at the pump, post to ERPNext receivables, and produce per-account statements. We map your specific card partners and account rules during scoping.

What support and updates do I get after go-live?

Every build includes a post-go-live support window for defect fixes and real forecourt edge cases. Because you receive the full git repository and installable source, you own the code; we also offer ongoing support and enhancement engagements beyond the initial window on request.

Will it interfere with our existing ERPNext accounting and stock?

No. It posts through native ERPNext Stock Entries, Sales Invoices and Payment/Journal Entries so your GL and stock valuation stay canonical. The forecourt logic lives in a separate Frappe app using DocTypes, hooks and whitelisted methods — not core modifications.

Request a quote

Fuel Station / Forecourt POS

A build-to-order ERPNext app for petrol stations and forecourts that ties pump/nozzle meter reconciliation, shift handovers, tank wet-stock and fuel-card sales into one auditable ledger. ECOSIRE builds it to your scope, installs it, and supports it after go-live.

  • Pump/nozzle meter reconciliation: closing minus opening reading, net of test and calibration pours, reconciled against dispensed sales per nozzle
  • Site modelled as first-class DocTypes — `Fuel Tank`, `Pump`, `Nozzle`, with each nozzle bound to its source tank and fuel product
  • Shift-wise workflow: opening/closing `Shift Reading`, attendant assignment, and supervisor-authorised cash and card handover at close
  • Tank dip entry converted to volume through per-tank calibration (strapping) charts and compared to ERPNext book stock

Request a Quotation

Tell us about your Fuel Station / Forecourt POS requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.