Release Notes

L'extraction de tarifs de facture a ses propres versions. Elle partageait jusqu'ici celles de l'API Switchgrid, ce qui voulait dire deux choses désagréables : sa forme ne pouvait bouger qu'au rythme d'une API qui ne parle pas des factures, et un changement ici forçait une version sur des endpoints qui n'avaient pas changé. Les deux produits avancent maintenant chacun à son rythme.

Comment lire ces versions

La version se choisit avec l'en-tête x-api-version sur POST https://api.switchgrid.tech/extraction-tarifs-facture. Absent, il vaut v0 : un appel qui ne dit rien reçoit ce qu'il recevait hier. Les deux orthographes valent (v0.1 comme 0.1). Envoyez-le toujours : un exemple recopié sans l'en-tête reçoit la v0.

Versions publiées

0.1

• Une facture s'envoie en photos, une image par page. Répétez le champ file dans l'ordre des pages (-F file=@page-1.jpg -F file=@page-2.jpg) : les images, PNG, JPEG, WebP ou HEIC, sont assemblées en un seul document et lues comme une facture scannée, 20 pages au plus. Voir le guide.

• Les photos HEIC sont acceptées (le format des photos d'iPhone), seules ou une par page.

• prix_HT décompose le prix en plusieurs composantes. Chaque prix est accompagné de ses parts — un montant et les composantes qu'il couvre. Un prix au kWh se décompose en fourniture, acheminement.soutirage_variable, capacite, cee, garanties_origine et aide ; un abonnement en fourniture, acheminement.gestion, acheminement.comptage et acheminement.soutirage_fixe. Une facture à prix tout compris a une seule part portant toutes ses composantes, là où l'ancienne forme sortait cee: null, qui se lisait « pas de CEE ». Le prix est la somme de ses parts (aide exceptée, c'est un crédit), et le drapeau decomposition disparaît.

• Le TURPE fixe rejoint l'abonnement. Les composantes fixes que certaines factures impriment sur leurs propres lignes sont converties en €/mois, une part par ligne imprimée, et comptées dans abonnement[].prix_EUR_par_mois (seule la ligne échue est retenue, voir le guide). prix_TTC.part_fixe les ajoute aussi, au lieu de sous-évaluer de plusieurs centaines d'euros par mois le prix tout compris d'un site professionnel.

• L'option « électricité verte » est publiée comme composante garanties_origine quand elle est facturée au kWh. Elle était ignorée, alors que la facture la compte : le total était inférieur de jusqu'à 5,6 % à ce que paie le client. Corrigé y compris en v0 — une version fige une forme, pas une valeur.

• L'option « électricité verte » au forfait rejoint l'abonnement, comme part garanties_origine : un abonnement se décompose désormais aussi en garanties_origine. Elle était ignorée : sur une facture ENGIE pro, l'abonnement publié était inférieur de 92,75 €/mois à ce que paie le client. Une offre qui inclut l'option (« Elec Verte » chez ENGIE) le dit par une part ["fourniture", "garanties_origine"]. Le total est corrigé y compris en v0.

• Tous les champs sont en français, jusqu'aux valeurs de statut : createdAt → cree_le, deliveryPointId → point_de_livraison, supplier → fournisseur, PENDING → EN_COURS… C'est tout l'objet de cette version ; la v0 garde ses noms.

• Une puissance illisible se lit d'un coup d'œil : puissance_souscrite vaut directement "Indisponible" au lieu de { "_tag": "constant", "puissance_souscrite_kVA": "Indisponible" }. La forme periodes ne change pas, même toute en sentinelles : elle dit que la puissance a changé en cours de facture.

0

La forme d'ouverture : prix_HT.abonnement[].prix_EUR_par_mois et prix_HT.consommation[].prix_EUR_par_kWh portent un prix, et rien d'autre. Elle reste servie telle quelle — une version ne se corrige pas, elle se remplace.