Rapprochement

L'écran Rapprochement vous permet d'importer l'export de facturation d'un fournisseur, de lancer le rapprochement qui écrit le coût facturé sur les événements d'usage, et de lire le rapport d'écarts d'un mois. Chemin dans le portail : /finops/reconciliation (menu FinOps > Rapprochement). Les analystes FinOps et les administrateurs de tenant importent et lancent ; les auditeurs lisent le rapport.

Ce que montre l'écran

L'écran a deux onglets : Rapport d'écarts (par défaut) et Imports (/finops/reconciliation?tab=imports).

Zone	Contenu
Importer un export fournisseur (administrateurs FinOps seulement)	Source (OpenAI, Anthropic, AWS CUR, Azure, Google Cloud, CSV générique), Période (mois, le mois en cours par défaut), Fichier d'export (.csv ou .json), et les boutons Importer et Lancer le rapprochement.
Cartes du Rapport d'écarts	Totaux Estimé, Mesuré, Facturé, Importé, Non rapproché du mois dans la devise du tenant, et Écart %.
Tableau du Rapport d'écarts	Une ligne par fournisseur, modèle et jour : Fournisseur, Identifiant de modèle, Jour, Événements, Estimé, Mesuré, Facturé, Écart %, Au-dessus du seuil.
Réponse brute	JSON dépliable du rapport, avec les alertes d'écart (alert_items).
Onglet Imports	Source, Fournisseur, Fichier, Lignes, Total, Début de période, Fin de période, Créé.
États vides	Aucun rapprochement (importez un fichier d'export puis lancez le rapprochement) ; Aucun import.

Une ligne facturée qui porte l'identifiant de requête du fournisseur va à cet événement d'usage ; les autres lignes sont réparties au prorata du coût mesuré entre les événements du même fournisseur, modèle et jour. Les lignes sans événement correspondant sont comptées en Non rapproché.

Actions

Bouton ou action	Ce qu'il fait	Appel API	Rôles
Importer (actif dès qu'un fichier est choisi)	Lit le fichier dans le navigateur et envoie son contenu avec la source et le nom du fichier. Affiche Export importé, puis recharge les imports et le rapport.	POST /v1/finops/reconciliation/imports	finops, tenant_admin, platform_admin
Lancer le rapprochement	Rapproche les lignes importées des événements d'usage du mois choisi dans Période, puis recharge le rapport. Aussi proposé dans l'état vide.	POST /v1/finops/reconciliation/run (from, to du mois)	finops, tenant_admin, platform_admin
Période	Change le mois du rapport.	GET /v1/finops/reconciliation/report (from, to)	finops, tenant_admin, platform_admin
Réessayer (encadré d'erreur)	Recharge le rapport.	GET /v1/finops/reconciliation/report	Lecteurs de la section FinOps
Actualiser (icône flèche ronde, onglet Imports)	Recharge les imports.	GET /v1/finops/reconciliation/imports	Lecteurs de la section FinOps

Rôles

Rôle	Accès
finops, tenant_admin	Importent, lancent et lisent (ADMIN_ROLES de services/control-plane/src/eai/domains/finops/__init__.py).
platform_admin	Mêmes droits, dans un tenant (sinon tenant_required).
auditor	Lit le rapport et les imports. La section d'import, avec son champ Période, est masquée : le rapport montre le mois en cours.
developer, viewer, security_officer	Autorisés en lecture par l'API, mais la section FinOps du menu du portail ne s'ouvre pas pour eux.

Tâches courantes

Rapprocher la facture du mois dernier

1. Récupérer l'export du fournisseur. Téléchargez l'export de facturation du mois depuis la console du fournisseur (CSV ou JSON). Résultat attendu : vous avez un fichier tel que <fichier-export>.csv. En cas d'échec : pour un fournisseur absent de Source, utilisez CSV générique.
2. Choisir la source et le mois. Sélectionnez le fournisseur dans Source et le mois dans Période. Résultat attendu : le rapport en dessous montre le mois choisi. En cas d'échec : si la section d'import est absente, demandez le rôle finops.
3. Importer le fichier. Choisissez-le dans Fichier d'export et cliquez sur Importer. Résultat attendu : Export importé apparaît et l'onglet Imports liste le fichier avec son nombre de lignes. En cas d'échec : import_invalid donne la raison pour laquelle le fichier n'a pas pu être lu ; vérifiez la source choisie.
4. Lancer le rapprochement. Cliquez sur Lancer le rapprochement pour que les lignes facturées soient écrites sur les événements d'usage. Résultat attendu : les cartes et le tableau montrent le coût Facturé et l'Écart %. En cas d'échec : une erreur fx_rate_missing signifie qu'un taux de change manque ; chargez-le dans Réglages FinOps.

Analyser un écart

1. Trouver les lignes au-dessus du seuil. Les lignes avec Au-dessus du seuil coché dépassent le seuil d'écart du tenant. Résultat attendu : vous connaissez le fournisseur, le modèle et le jour concernés. En cas d'échec : si aucune ligne n'est signalée, le seuil est peut-être trop haut ; vérifiez-le dans Réglages FinOps.
2. Regarder les événements de ce jour. Ouvrez Événements d'usage filtré sur le modèle et le jour. Résultat attendu : vous voyez le coût mesuré et facturé de chaque appel. En cas d'échec : regardez la carte Non rapproché : des lignes facturées sans événement désignent des appels que la passerelle n'a pas remontés.

Dépannage

Symptôme	Cause	Correction
Erreur import_invalid (HTTP 422) : « L'export du fournisseur n'a pas pu être lu : ... »	Le fichier ne correspond pas au format de la source choisie.	Choisissez la bonne Source, ou CSV générique.
Erreur fx_rate_missing (HTTP 422) : « Aucun taux de change de ... vers ... n'est disponible au ... »	La devise de l'export diffère de celle du tenant et aucun taux ne couvre la date.	Chargez le taux dans l'onglet Taux de change de Réglages FinOps.
Erreur validation_error (HTTP 422)	Le début de la période est après sa fin (appels par l'API).	Choisissez un mois valide.
Importer reste désactivé	Aucun fichier choisi.	Choisissez un fichier .csv ou .json.
Total Non rapproché élevé	Des lignes facturées sans événement d'usage du même fournisseur, modèle et jour.	Vérifiez que la passerelle remonte l'usage de chaque appel.
Erreur forbidden (HTTP 403) à l'import ou au lancement	Pas administrateur FinOps.	Demandez le rôle finops.

Pages liées

• Événements d'usage
• Alertes
• Réglages FinOps
• Synthèse
• Brique rapprochement des coûts
• Brique registre des coûts