Comment fonctionne la facturation

Vibes to Bucks suit les coûts de tes tokens Cursor AI et les convertit en heures facturables dans ton logiciel de suivi du temps (Moneybird ou Harvest). La conversion se base sur ton taux horaire — l’extension calcule donc combien d’heures de ton temps représentent les coûts de l’AI, et crée une entrée de temps pour ce montant.

Pour chaque client, tu contrôles trois éléments :

• Facturable ou non — coche Facturable pour générer une entrée de temps pour le client. Décoche-le pour suivre les coûts en interne sans facturer le client (pratique pour tes propres projets ou les frais généraux absorbés).
• Comment calculer le temps facturable — choisis entre Multiplier le coût AI (ajoute ta marge) ou Passer au prix coûtant (uniquement récupération des coûts).
• Taux horaire — le taux client utilisé pour convertir le coût en euros en heures.

Multiplier le coût AI (recommandé)

Utilise cette option quand tu veux facturer le travail assisté par AI avec une marge bénéficiaire. Tu définis un Multiplicateur de Coût à Profit qui ajuste le coût brut de l’AI avant de convertir en heures. Cela capture la vraie valeur que tu apportes — création de prompts, révision et itération sur les résultats, intégration du résultat, et responsabilité du produit final.

Le calcul :

cost_eur = cost_usd × multiplier × fx_rate
hours    = cost_eur / hourly_rate

Exemple : 10 € de coût AI, multiplicateur 5, taux horaire 120 €/h :

cost_eur = €10 × 5 = €50
hours    = €50 / €120 = 0.42h (≈ 25 minutes billed)

Un multiplicateur de 5 signifie que chaque 1 € dépensé en AI devient 5 € de revenu facturable — une marge qui reflète l’expertise et le temps que tu investis autour du résultat AI. Commence à 5 et ajuste selon tes accords clients.

Passer au prix coûtant

Utilise cette option pour une facturation de récupération des coûts — le coût brut de l’AI est transféré au client au prix coûtant, converti en heures à ton taux horaire. Aucune marge n’est ajoutée.

Le calcul :

cost_eur = cost_usd × fx_rate
hours    = cost_eur / hourly_rate

Exemple : 12,00 $ de coût AI, taux EUR/USD 0,92, taux horaire 120 €/h :

cost_eur = $12.00 × 0.92 = €11.04
hours    = €11.04 / €120  = 0.092h (≈ 6 minutes billed)

Non facturable

Décoche Facturable sur une correspondance pour suivre les coûts AI pour ce client ou projet sans générer d’entrée de temps. Les coûts apparaissent dans ton tableau de bord pour que tu puisses voir les dépenses, mais rien n’est synchronisé avec Moneybird ou Harvest. Pratique pour les projets internes, la R&D, ou tout travail où tu absorbes toi-même le coût de l’AI.

Taux de change

La conversion USD→EUR utilise l’API Frankfurter, qui fournit les taux de référence de la Banque centrale européenne publiés quotidiennement vers 16h00 CET. Les taux sont mis en cache localement pour éviter les appels API redondants. Lorsque l’API est inaccessible, l’extension utilise le fallback_rate de ta config.

Pour le remplissage rétroactif, l’extension récupère le taux historique pour chaque jour spécifique, afin que tu obtiennes des conversions précises même pour les dates passées.

Arrondis et minimums

Les entrées de temps sont stockées sous forme de timestamps de début/fin. L’extension convertit les heures en minutes et arrondit à la minute entière la plus proche, avec un minimum de 1 minute :

• 0,001h → 1 minute (minimum)
• 0,092h → 6 minutes
• 2,25h → 2 heures 15 minutes

Toutes les entrées commencent à 09:00 UTC. L’heure de fin est calculée à partir de la durée arrondie. Ces timestamps sont une exigence API et ne reflètent pas les heures de travail réelles.

Une entrée par client par projet par jour

Le moteur de synchronisation produit au maximum une entrée de temps par client par projet par jour. Si d’autres événements arrivent plus tard le même jour, la prochaine synchronisation met à jour l’entrée existante plutôt que d’en créer une nouvelle. Cela garde ta feuille de temps propre et évite les entrées fragmentées.

Synchronisation idempotente

Avant de créer une entrée, l’extension vérifie si une entrée existe déjà pour la même combinaison (jour, contact, projet) :

• Aucune entrée existante → créer
• Entrée existante, totaux modifiés → mettre à jour
• Entrée existante, totaux inchangés → ignorer (pas d’appel API)

Exécuter “Synchroniser maintenant” deux fois de suite ne produit pas de doublons.

Plafond budgétaire hebdomadaire

Définis une limite de coût AI hebdomadaire par correspondance (Pro). L’extension suit les dépenses par dépôt et envoie des notifications Cursor aux jalons : 25%, 50%, 75%, 85%, 95% comme alertes d’information, en escaladant à un avertissement à 100% et tous les 10% au-delà. Chaque jalon est déclenché une fois par semaine par dépôt.

C’est un plafond souple — il ne bloque jamais l’utilisation de l’AI, il te tient simplement informé avant que tu ne dépasses. Le statut budgétaire est également visible sur le tableau de bord d’utilisation avec des jauges montrant les dépenses par rapport à la limite.