Skip to main content
Fuel records capture every visit to the pump. KilomeTracker combines that data with your route history to calculate efficiency metrics — km/liter, km/gallon, and cost per km — so you can see exactly what each kilometer costs you.

Logging a refuel

1

Open the Add Refuel form

Click Add Refuel in the sidebar navigation.
2

Select a vehicle

Choose the vehicle alias from the dropdown. Only active vehicles are listed.
3

Choose fuel type

Select the fuel type (tipoCombustible) that matches what you put in the tank. See supported fuel types below.
4

Enter the amount spent

Type the total money spent on this refuel in the Amount spent field (cantidadGastada). This is the only required cost field.
5

Enter gallons and price per gallon (optional)

If you want efficiency calculations, fill in Gallons (galones) and Price per gallon (precioPorGalon). KilomeTracker uses gallons to compute km/gallon and km/liter metrics.
6

Set the date

Pick the refuel date (fecha). It defaults to today.
7

Add notes (optional)

Use the Additional notes field (notasAdicionales) for any extra context — station name, location, or octane grade.
8

Save the refuel

Click Save Refuel. The record is created immediately and appears in the fuel analysis dashboard.

Supported fuel types

Standard unleaded gasoline. The most common option for everyday passenger vehicles. Suitable for engines that do not require premium octane.
Higher-octane unleaded gasoline. Required or recommended for turbocharged and high-compression engines.
For diesel-engine vehicles including trucks, SUVs, and some passenger cars. Diesel records are included in cost and efficiency aggregations alongside gasoline records.
For electric vehicles. Use cantidadGastada to record the cost of a charging session. Gallons and price-per-gallon fields can be left blank.
For hybrid vehicles that accept both fuel and electric charging. You can log both fuel fills and charging sessions as separate records under this type.
Shell V-Power and equivalent premium performance fuels. Tracked separately from Regular and Premium for vehicles where you alternate between fuel grades.

Fuel analysis dashboard

The fuel analysis dashboard at /fuel-analysis/[alias] gives you a full picture of consumption and spending for a single vehicle.

Summary metrics

MetricDescription
Total refuelsNumber of refuel records logged for the vehicle.
Total spentSum of all cantidadGastada values.
Total gallonsSum of all galones values across records that include gallons.
Average price per gallontotalGastado ÷ totalGalones across all records with gallon data.

Breakdown by fuel type

The dashboard groups records by tipoCombustible and shows, for each type:
  • Count (cantidad) — number of refuels for that fuel type
  • Total spent (gasto) — cumulative cost
  • Total gallons (galones) — cumulative volume

Charts

  • Bar chart: cost by fuel type — compare spending across Regular, Premium, Diesel, and other types at a glance.
  • Line chart: efficiency over time — see how your km/gallon trend changes across refuel dates.

Fuel efficiency metrics

Efficiency is calculated using the combined totals of gallons and distance from your route records for the same vehicle and time period.
MetricFormula
km/litertotalDistancia ÷ (totalGalones × 3.785)
km/gallontotalDistancia ÷ totalGalones
cost/kmtotalGastoCombustible ÷ totalDistancia
Efficiency metrics require at least one refuel record with a galones value and at least one route record for the same vehicle. Records without gallons contribute to cost totals but not to efficiency calculations.

Filtering by date range

On the fuel efficiency endpoint, you can pass startDate and endDate (format YYYY-MM-DD) to scope the calculation to a specific period. This lets you compare efficiency across different seasons, drivers, or driving patterns. On the Refuels History page, you can filter records by vehicleAlias, tipoCombustible, startDate, and endDate.

Deleting a refuel

Refuel deletion is permanent. There is no undo — deleted records are removed immediately from all aggregations and efficiency calculations.
To delete a refuel, open Refuels History, find the record, and click the delete icon. Confirm the action in the dialog.

Routes & mileage

Fuel efficiency depends on route data — make sure you log trips regularly.

Vehicle statistics

See fuel costs as part of total cost of ownership for each vehicle.

Maintenance tracking

Pair refuel data with service records for a complete operating cost picture.

Expenses

Record insurance, taxes, and other non-fuel costs alongside your fuel spend.

Build docs developers (and LLMs) love