¶ Remboursement d'énergie au tarif d'achat
¶ Présentation
La fonctionnalité Remboursement au tarif d'achat permet de rembourser l'énergie consommée par les sessions de recharge en se basant sur le contrat d'énergie réel entre le fournisseur d'électricité et l'aménageur du site.
Jusqu'ici, le remboursement se faisait à un tarif fixe par kWh (AC ou DC). Ce mode reste disponible, mais le tarif d'achat offre une alternative plus juste : le remboursement reflète exactement le prix que l'aménageur paie à son fournisseur, tranche horaire par tranche horaire.
Résultat : l'aménageur reçoit chaque mois un avoir transparent, détaillé par session et par tranche tarifaire, alignée sur son contrat fournisseur.
¶ Concepts clés
¶ Contrat d'énergie tiers
Le contrat d'énergie tiers est le document qui décrit la grille tarifaire du fournisseur d'électricité (EDF, Engie, etc.) applicable à un site de recharge. Il contient :
- Le fournisseur et le client (aménageur)
- La référence du contrat fournisseur
- Les dates de validité (début / fin)
- La structure tarifaire organisée en périodes, types de jours et tranches horaires
¶ Structure tarifaire : 3 niveaux
La grille tarifaire d'un contrat d'énergie s'organise en 3 niveaux hiérarchiques :
| Niveau | Description | Exemple |
|---|---|---|
| Période | Découpage saisonnier avec des dates de début et fin | Hiver (1er nov. → 28 fév.), Été (1er mars → 31 oct.) |
| Type de jour | Règle de récurrence au sein d'une période | Tous les jours, Jours ouvrés, Week-end, Dates exceptionnelles |
| Tranche horaire | Plage horaire avec un prix au kWh | 06h00–22h00 Heures Pleines 0,1540 €/kWh |
¶ Priorité de résolution des types de jours
Lorsque plusieurs types de jours s'appliquent à une même date, le système applique cet ordre de priorité :
- Dates exceptionnelles (jours rouges du contrat fournisseur, par ex. jours de forte demande sur le réseau) — priorité maximale
- Jours spécifiques (jours ouvrés, week-end)
- Tous les jours — règle par défaut
Exemple : le 15 janvier est un mercredi (jour ouvré), mais il est marqué comme jour rouge dans le contrat fournisseur. Si une date exceptionnelle est définie pour le 15/01, c'est son tarif spécifique qui s'applique, et non celui des jours ouvrés.
¶ Workflow
¶ Étape 1 — Créer le contrat d'énergie tiers
Depuis le menu Contrats > Contrats d'énergie, créez un nouveau contrat en renseignant :
- Informations générales : fournisseur, aménageur (client), référence du contrat, dates de validité, type de contrat (fixe)
- Périodes tarifaires : définissez les périodes saisonnières (ex. Hiver, Été) avec leurs dates
- Types de jours et tranches horaires : pour chaque période, configurez les tranches horaires avec leurs prix au kWh
Le formulaire valide automatiquement la cohérence de la saisie :
- Pas de chevauchement entre les périodes
- Pas de trou dans la couverture 24h des tranches horaires
- Pas de doublon sur les dates exceptionnelles
- Cohérence entre les types de jours (pas de conflit "Tous les jours" + "Jours spécifiques" sur la même période)
¶ Étape 2 — Associer au contrat B2B
Dans le contrat B2B de l'aménageur, à l'étape Transaction > Remboursement d'énergie :
- Activez le service de remboursement d'énergie
- Sélectionnez le mode Tarif d'achat
- Choisissez le contrat d'énergie tiers à associer
Le système utilisera automatiquement ce contrat pour calculer le remboursement de toutes les sessions de recharge sur les sites de cet aménageur.
¶ Étape 3 — Facturation automatique
À chaque échéance mensuelle, le système :
- Récupère toutes les sessions du mois pour cet aménageur
- Pour chaque session, applique la grille tarifaire du contrat d'énergie
- Génère un avoir (crédit) avec le détail par tranche
- Envoie par e-mail la facture PDF et l'export Excel détaillé
¶ Comment le remboursement est calculé
¶ Principe général
Pour chaque session de recharge, le système :
- Identifie les frontières temporelles traversées par la session : changements de tranche horaire, passages à minuit, transitions de période tarifaire
- Découpe la session en segments à chaque frontière
- Répartit l'énergie consommée sur chaque segment proportionnellement aux relevés de compteur (meter values OCPP)
- Applique le tarif correspondant à chaque segment selon le contrat d'énergie
- Calcule le montant de chaque segment :
kWh × prix €/kWh
Le total du remboursement est la somme de tous les segments.
¶ Exemple concret
Contexte : une session de recharge nocturne sur un site dont le contrat d'énergie prévoit trois tranches tarifaires :
| Tranche | Plage horaire | Prix |
|---|---|---|
| Heures Pleines (HP) | 06h00 – 22h00 | 0,154 €/kWh |
| Heures Creuses soir (HC soir) | 22h00 – 00h00 | 0,1064 €/kWh |
| Heures Creuses nuit (HC nuit) | 00h00 – 06h00 | 0,0864 €/kWh |
Session : du 21/02 à 23h30 au 22/02 à 11h52 — consommation totale : 54 494 Wh
La borne transmet des relevés de compteur réguliers pendant la charge. Le système dispose donc de plusieurs points de mesure intermédiaires :
| Horodatage | Énergie cumulée |
|---|---|
| 23h30 (début) | 0 Wh |
| 23h55 | 4 743 Wh |
| 00h00 | 5 696 Wh |
| 06h00 | 54 492 Wh |
| 11h52 (fin) | 54 494 Wh |
La session traverse deux frontières tarifaires : le passage à minuit (HC soir → HC nuit) et le passage à 06h00 (HC nuit → HP). Grâce aux relevés intermédiaires proches de ces frontières, le système peut répartir l'énergie avec précision — par interpolation entre les relevés les plus proches de chaque frontière, et non par simple répartition uniforme.
Découpage et calcul :
| Segment | Plage | Tranche | Énergie | Prix unitaire | Montant |
|---|---|---|---|---|---|
| 1 | 23h30 → 00h00 | HC soir | 5 639 Wh | 0,1064 €/kWh | 0,60 € |
| 2 | 00h00 → 06h00 | HC nuit | 48 853 Wh | 0,0864 €/kWh | 4,22 € |
| 3 | 06h00 → 11h52 | HP | 2 Wh | 0,154 €/kWh | 0,00 € |
| Total | 54 494 Wh | 4,82 € |
Session 23h30 ──────────────────────────────────────────── 11h52
│ │ │
HC soir HC nuit HP
23h30→00h00 00h00→06h00 06h00→11h52
5 639 Wh 48 853 Wh 2 Wh
× 0,1064 € × 0,0864 € × 0,154 €
= 0,60 € = 4,22 € = 0,00 €
│ │ │
└───────────┴────────────────────┘
Total = 4,82 €
On constate que la quasi-totalité de l'énergie a été consommée durant la nuit (HC nuit), au tarif le plus avantageux. La somme des segments est toujours égale à la consommation totale de la session — aucune énergie n'est perdue dans le découpage.
Note : lorsque la borne ne transmet que les relevés de début et de fin de session (pas de relevé intermédiaire), le système répartit l'énergie au prorata du temps passé dans chaque tranche.
¶ Comportement de repli
Si le contrat d'énergie ne couvre pas une session (contrat expiré, période manquante, contrat inactif), le système applique automatiquement le tarif fixe AC/DC défini dans le contrat B2B. Il n'y a jamais de session sans remboursement.
¶ La facture détaillée (export Excel)
L'aménageur reçoit chaque mois un export Excel joint à sa facture. Cet export détaille chaque session de recharge ligne par ligne.
¶ Format
- Une session simple (une seule tranche horaire traversée) = 1 ligne
- Une session multi-tranches (traversant plusieurs tranches horaires ou minuit) = plusieurs lignes, regroupées par identifiant de session
Pour les sessions multi-lignes, chaque ligne contient les mêmes informations complètes (métadonnées de la session + données du segment tarifaire), ce qui facilite la lecture et le traitement du fichier.
¶ Colonnes clés
| Colonne | Description |
|---|---|
| ID Transaction | Identifiant unique de la session |
| Site | Nom du site de recharge |
| Borne | Identifiant de la borne |
| Début / Fin | Dates de début et fin de la session |
| Consommation (Wh) | Énergie du segment |
| Prix remboursé (€/kWh) | Tarif appliqué au segment |
¶ Règles importantes
¶ Verrouillage des périodes tarifaires
Le verrouillage d'une période tarifaire du contrat d'énergie dépend du statut de l'avoir associé :
- Avoir ouvert ou en brouillon : la période tarifaire reste modifiable. Si l'avoir est annulé, le contrat peut être corrigé et la facturation relancée.
- Avoir payé : la période tarifaire devient verrouillée en lecture seule. Cela garantit la cohérence entre les montants facturés et la grille tarifaire utilisée pour le calcul.
Les périodes futures (non encore utilisées dans un avoir) restent toujours modifiables.
¶ Gestion du changement d'heure (heure d'été / heure d'hiver)
Toutes les sessions sont enregistrées en UTC. Le système convertit automatiquement en heure locale (Europe/Paris) pour déterminer la tranche tarifaire applicable. Les transitions d'heure d'été et d'heure d'hiver sont gérées nativement — aucune intervention manuelle n'est nécessaire.
¶ Questions fréquentes
Puis-je avoir plusieurs contrats d'énergie actifs ?
Oui, vous pouvez créer un contrat par aménageur et par fournisseur. Chaque contrat B2B peut être associé à un contrat d'énergie différent.
Que se passe-t-il si le contrat d'énergie expire en cours de mois ?
Les sessions couvertes par le contrat sont remboursées au tarif d'achat. Les sessions hors couverture basculent automatiquement sur le tarif fixe AC/DC du contrat B2B.
Puis-je modifier un contrat d'énergie en cours ?
Vous pouvez modifier les périodes tarifaires tant que l'avoir associé n'est pas passé au statut "Payé". Une fois l'avoir payé, la période est verrouillée. Si un avoir est encore ouvert ou annulé, le contrat reste modifiable.
Les sessions très courtes (quelques minutes) sont-elles aussi découpées ?
Oui, le même algorithme s'applique quelle que soit la durée. Une session de 10 minutes qui ne traverse aucune frontière tarifaire produira simplement une seule ligne dans l'export.
Comment sont gérées les coupures réseau pendant une session ?
Si des relevés de compteur intermédiaires sont manquants (perte de connectivité du chargeur), l'énergie est répartie uniformément sur la période sans relevé. Le calcul reste fiable — la consommation totale est toujours correcte.
Quels types de contrats fournisseur sont supportés ?
La version actuelle supporte les contrats à tarif fixe (prix définis par tranche horaire). Les contrats indexés (prix variable selon un indice marché) et les contrats sur mesure sont prévus dans une version ultérieure.