Aller au contenu
Floweet
Accès pro

Coût carburant et carbone d'une flotte

Le surcoût annuel à la pompe d'une flotte par type de véhicule, comparé à l'enseigne la moins chère, et son coût carbone ETS2 à partir de 2028.

api.floweet.com/v1 · Contrat 1.0.0-beta.1 · Bêta

Sections · Coût d'une flotte
Sur cette page
  1. À savoir
  2. Le calcul
  3. L'objet FleetCost
  4. Surcoût carburant annuel d'une flotte par type de véhicule, et son coût carbone ETS2 dès 2028

Combien une flotte paie-t-elle de trop à la pompe ? Décrivez-la par type de véhicule (voitures, utilitaires légers, poids lourds), avec le kilométrage annuel et l'enseigne où elle fait le plein : l'API rend le surcoût annuel par rapport à l'enseigne la moins chère, ligne par ligne, et son coût carbone ETS2 à partir de 2028. Rien n'est enregistré.

À savoir

  • La comparaison se fait sur le classement national de la semaine du carburant choisi (fuel), stations d'autoroute exclues. La référence est l'enseigne la moins chère (reference: "cheapest") ou la moyenne simple des six enseignes de grande distribution — E.Leclerc, Intermarché, Auchan, Carrefour, Système U, Netto ("supermarkets").
  • currentBrand doit être un nom d'enseigne du baromètre. Une enseigne inconnue donne currentPrice: null et aucun surcoût.
  • Les montants sont en centimes, mais le surcoût est calculé à l'euro près : 1013800 se lit 10 138 €. Les prix sont en millièmes d'euro par litre.
  • ETS2 : hypothèse de 45 € la tonne de CO₂ à partir de 2028 (ets2 rappelle le prix retenu et le coût par litre). replaceFirst désigne le type de véhicule qui coûte le plus par véhicule, carburant et carbone compris.
  • Prix affichés à la pompe : ni les remises ni les frais des cartes carburant ne sont pris en compte. L'économie réelle dépend du contrat.

Le calcul

Pour chaque ligne de la flotte :

litres par an = véhicules × kilomètres par an × consommation ÷ 100
surcoût par an = litres par an × (prix de l'enseigne actuelle − prix de référence)

Le même calcul sert le calculateur des pages Flottes et Commerciaux du site, et l'espace Flotte de l'application.

L'objet FleetCost

ChampTypeDescription
fueltoujours présent"gazole" | "sp95-e10" | "sp98" | "e85" | "gpl"
pricesFromtoujours présentstring (date-time)
pricesTotoujours présentstring (date-time)
vehiclestoujours présentinteger
currentBrandtoujours présentstring
currentPricetoujours présentinteger | nullPrix moyen de l'enseigne actuelle ; null si elle est inconnue (aucun surcoût calculé).
referenceBrandtoujours présentstring | null
referencePricetoujours présentinteger | nullPrix en millièmes d'euro par litre (2372 = 2,372 €/L).
linestoujours présentobject[]
lines[].typetoujours présent"car" | "lcv" | "hgv"
lines[].vehiclestoujours présentinteger
lines[].consumptionL100toujours présentnumber
lines[].litersPerYeartoujours présentinteger
lines[].overspendPerYeartoujours présentintegerCentimes par an.
lines[].overspendPerVehicletoujours présentintegerCentimes par véhicule et par an.
lines[].co2Tonnestoujours présentnumber
lines[].ets2PerYeartoujours présentintegerCoût carbone ETS2, centimes par an dès 2028.
totaltoujours présentobject
total.litersPerYeartoujours présentinteger
total.overspendPerYeartoujours présentinteger
total.co2Tonnestoujours présentnumber
total.ets2PerYeartoujours présentinteger
replaceFirsttoujours présent"car" | "lcv" | "hgv" | nullType de véhicule qui coûte le plus par véhicule (carburant + ETS2).
ets2toujours présentobject
ets2.startYeartoujours présentinteger
ets2.pricePerTonnetoujours présentintegerCentimes par tonne de CO2 (hypothèse).
ets2.costPerLitertoujours présentintegerMillièmes d'euro par litre.
FleetCost
{
  "fuel": "gazole",
  "pricesFrom": "2026-10-19T11:35:43.000Z",
  "pricesTo": "2026-10-26T11:00:00.000Z",
  "vehicles": 15,
  "currentBrand": "Esso",
  "currentPrice": 2428,
  "referenceBrand": "Total Access",
  "referencePrice": 2252,
  "lines": [
    {
      "type": "lcv",
      "vehicles": 12,
      "consumptionL100": 8.5,
      "litersPerYear": 30600,
      "overspendPerYear": 538600,
      "overspendPerVehicle": 44900,
      "co2Tonnes": 75.9,
      "ets2PerYear": 341500
    },
    {
      "type": "hgv",
      "vehicles": 3,
      "consumptionL100": 30,
      "litersPerYear": 27000,
      "overspendPerYear": 475200,
      "overspendPerVehicle": 158400,
      "co2Tonnes": 67,
      "ets2PerYear": 301300
    }
  ],
  "total": {
    "litersPerYear": 57600,
    "overspendPerYear": 1013800,
    "co2Tonnes": 142.8,
    "ets2PerYear": 642800
  },
  "replaceFirst": "hgv",
  "ets2": {
    "startYear": 2028,
    "pricePerTonne": 4500,
    "costPerLiter": 112
  }
}

Surcoût carburant annuel d'une flotte par type de véhicule, et son coût carbone ETS2 dès 2028

POST/v1/fleet-costsScope fleet-costs:read

Rien n'est enregistré. Le surcoût compare l'enseigne actuelle à l'enseigne la moins chère (ou à la moyenne des grandes surfaces) du baromètre national, stations d'autoroute exclues.

Paramètres

ChampOùTypeDescription
Idempotency-Keyfacultatifen-têtestringau plus 255 caractèresClé unique de cette requête (un UUID v4 neuf, gardé pour ses nouvelles tentatives) : la première réponse est rejouée pendant 24 heures.

Corps de la requête FleetInput

ChampTypeDescription
fuelfacultatif"gazole" | "sp95-e10" | "sp98" | "e85" | "gpl"défaut "gazole"
currentBrandobligatoirestring1 à 60 caractèresEnseigne où la flotte fait le plein aujourd'hui (un nom d'enseigne de /v1/barometer).
referencefacultatif"cheapest" | "supermarkets"défaut "cheapest"Comparer à l'enseigne la moins chère ou à la moyenne des grandes surfaces.
kmPerVehicleobligatoireintegerde 0 à 500000
linesobligatoireobject[]1 à 3 éléments
lines[].typeobligatoire"car" | "lcv" | "hgv"car (voiture), lcv (véhicule utilitaire léger), hgv (poids lourd).
lines[].vehiclesobligatoireintegerde 0 à 100000
lines[].consumptionL100obligatoirenumberde 0 à 100Litres aux 100 km.

Réponse 200

Succès — Un objet FleetCost

Erreurs

HTTPSignification
400Requête invalide
401Clé d'API absente, invalide ou révoquée
403Accès refusé (scope, plan ou statut du compte)
404Ressource introuvable
429Trop de requêtes
500Erreur interne
Requête
curl -X POST "https://api.floweet.com/v1/fleet-costs" \
  -H "Authorization: Bearer $FLOWEET_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87" \
  -H "Content-Type: application/json" \
  -d '{
  "fuel": "gazole",
  "currentBrand": "Esso",
  "reference": "cheapest",
  "kmPerVehicle": 30000,
  "lines": [
    {
      "type": "lcv",
      "vehicles": 12,
      "consumptionL100": 8.5
    },
    {
      "type": "hgv",
      "vehicles": 3,
      "consumptionL100": 30
    }
  ]
}'
Réponse 200
{
  "fuel": "gazole",
  "pricesFrom": "2026-10-19T11:35:43.000Z",
  "pricesTo": "2026-10-26T11:00:00.000Z",
  "vehicles": 15,
  "currentBrand": "Esso",
  "currentPrice": 2428,
  "referenceBrand": "Total Access",
  "referencePrice": 2252,
  "lines": [
    {
      "type": "lcv",
      "vehicles": 12,
      "consumptionL100": 8.5,
      "litersPerYear": 30600,
      "overspendPerYear": 538600,
      "overspendPerVehicle": 44900,
      "co2Tonnes": 75.9,
      "ets2PerYear": 341500
    },
    {
      "type": "hgv",
      "vehicles": 3,
      "consumptionL100": 30,
      "litersPerYear": 27000,
      "overspendPerYear": 475200,
      "overspendPerVehicle": 158400,
      "co2Tonnes": 67,
      "ets2PerYear": 301300
    }
  ],
  "total": {
    "litersPerYear": 57600,
    "overspendPerYear": 1013800,
    "co2Tonnes": 142.8,
    "ets2PerYear": 642800
  },
  "replaceFirst": "hgv",
  "ets2": {
    "startYear": 2028,
    "pricePerTonne": 4500,
    "costPerLiter": 112
  }
}