Fuel Stations (EDC)

Fuel stations fiscalise through an EDC (Electronic Dispensing Controller) setup: every sale is fiscalised with the pump, nozzle and tank it came from, and the station reports nozzle status, shifts and disconnections. The whole cycle runs through the same API as the rest of your sales.

Station setup

Endpoint Purpose
POST /query-fuel-types The fuel type tree
POST /query-fuel-pump-versions Your pumps and the default buyer per branch
POST /query-fuel-pump-details A pump's nozzles, tanks and EDC devices
POST /query-edc-uom-rates Unit-of-measure conversion rates for fuel
POST /query-edc-device-versions Approved EDC device models and versions

Sales and shifts

Endpoint Purpose
POST /issue-e-invoice Each fuel sale, with the tank, pump and nozzle it came from
POST /upload-nozzle-status Nozzle state changes: available, lifted, fueling, hung up, locked, offline
POST /upload-shift Each shift per nozzle: meter readings, invoice count and total
POST /upload-edc-disconnections Controller disconnections and abnormal transactions
{
    "shiftNo": "20261008-01",
    "startVolume": "15230.50",
    "endVolume": "15880.75",
    "nozzleNo": "N-01",
    "pumpNo": "P-01",
    "tankNo": "T-01",
    ...
}

Want a working example of a fuel station shift upload? Chat with our team

Review

Endpoint Purpose
POST /query-edc-invoices Fuel station invoices, filtered by fuel type, buyer, branch or date
POST /query-efd-location A device's latest recorded locations
POST /update-buyer-details Fill in the buyer on a fuel invoice after the sale - see Buyers
Looking for the complete reference? Field definitions, code lists, validation rules, error handling, and ready-to-run examples for every endpoint are available inside your EFRIS Simplified dashboard once your business is registered on the platform.
Sign in to the dashboard · Get started

Stuck on an integration step? Our engineers reply fast.