Comprendre quotas et dépassements
Compteurs BSDs/users, fenêtre de grâce 14 jours en cas d'impayé, et comment réagir.
Mis à jour le 26 avril 2026
Compagnon gère 3 quotas par établissement (BSDs/mois, utilisateurs) et un mécanisme de fenêtre de grâce 14 jours en cas d'impayé. Cet article explique ce qui se passe quand un seuil est franchi, et ce que vous pouvez faire.
Les 3 quotas suivis
| Métrique | Décompte | Reset |
|---|---|---|
| BSDs/mois | BSDs émis via Compagnon (transition IN_PROGRESS) | 1er du mois UTC |
| Utilisateurs | Tous comptes actifs (admin + technicien + chauffeur) sur l'étab | Pas de reset |
| Établissements | Nombre de SIRETs membres du compte de facturation | Pas de reset |
Les plafonds sont par plan :
| Plan | BSDs/mois/étab | Users/étab | Établissements |
|---|---|---|---|
| Starter | 10 | 11 | Illimité |
| Pro | 30 | 16 | Illimité |
| Business | 100 | 55 | Illimité |
| Enterprise | Illimité | Illimité | Illimité |
Les établissements sont illimités sur tous les plans — vous pouvez ajouter autant de SIRETs que vous voulez à votre compte de facturation.
Étape 1 — Suivre votre consommation
Depuis Facturation → Consommation, Compagnon affiche pour chaque établissement :
- BSDs/mois : compteur en cours / plafond, jauge colorée
- Utilisateurs : compteur / plafond
- Une alerte quand vous franchissez les 80 % du plafond
Si vous êtes systématiquement à 90 %+ d'un plafond, upgradez avant le mois prochain.
Étape 2 — Que se passe-t-il en cas de dépassement
Trois cas distincts :
Cas 1 — Quota atteint (write blocked)
Quand vous atteignez le plafond d'une métrique pour un établissement :
- Les mutations bloquées renvoient une erreur 402 Payment Required
- Le payload contient
reason: "quota_exceeded",metric,current/max,suggestedPlan - L'UI propose un bouton Upgrader vers [plan supérieur] qui calcule le prorata
Les lectures ne sont jamais bloquées : vous gardez accès à toutes vos données et vos exports.
Cas 2 — Pas d'abonnement actif
Si votre billing account n'a pas d'abonnement actif (post-résiliation, jamais souscrit) :
- Mutations bloquées avec
reason: "no_subscription" - L'UI propose Souscrire à un plan
- Aucune limite de durée — tant que vous ne souscrivez pas, l'écriture reste bloquée
Cas 3 — Impayé (fenêtre de grâce 14 jours)
Si une facture Stripe échoue (carte refusée, prélèvement KO) :
- Jour J — Stripe envoie
invoice.payment_failed, Compagnon stamppast_due_since = now() - J → J+14 — fenêtre de grâce de 14 jours : tout fonctionne normalement, vous recevez des relances e-mail automatiques (J, J+3, J+7, J+11)
- Pendant la fenêtre — Stripe retente automatiquement le paiement plusieurs fois
- J+14 si toujours non payée — l'écriture est verrouillée avec
reason: "past_due_locked". Lectures et exports restent accessibles. - Paiement réussi (à tout moment) —
past_due_sinceest effacé, accès rétabli immédiatement
Pendant la fenêtre de grâce, vos opérations terrain ne s'arrêtent pas. C'est un design volontaire : une carte expirée un jour férié ne doit pas bloquer un chauffeur. Mais si rien n'est fait sous 14 jours, l'écriture est coupée pour protéger l'intégrité du compte.
Étape 3 — Débloquer la situation
| Symptôme | Action |
|---|---|
| Quota BSDs/mois atteint | Upgrader le plan (effet immédiat) ou attendre le 1er du mois |
| Quota users atteint | Désactiver des comptes inactifs OU upgrader |
| Pas d'abonnement | Souscrire depuis Facturation → Choisir un plan |
| Past due (carte refusée) | Mettre à jour la carte depuis Facturation → Méthode de paiement |
| Past due > 14 j (locked) | Mettre à jour la carte → déverrouillage immédiat sur prochain webhook |
| Doute sur compteur | Contacter support — exports brut et compteur reconcillés |
Cas d'usage
Pic de production saisonnier — vous savez que vous allez dépasser 30 BSDs en mai (habituellement 25). Upgradez préventivement vers Business début mai, downgradez vers Pro en juin (préavis 30 jours sur le downgrade).
Carte CB refusée pendant les vacances — Stripe vous écrit, vous voyez l'e-mail le J+5. Vous mettez à jour la carte, paiement passe, situation rétablie sans interruption opérationnelle.
Compte non payé depuis 20 jours — vos chauffeurs essaient de signer un BSD, ça plante avec "402 past_due_locked". Le BO met à jour la carte, retente, ça repasse.
Bonnes pratiques
- Activez les notifications facturation dans Réglages → Notifications pour ne rien rater des relances Stripe
- Désignez un BO joignable en vacances (ou un BO de remplacement temporaire) — éviter les coupures opérationnelles évitables
- Auditez les utilisateurs inactifs chaque trimestre — un ancien Operator qui ne se connecte plus consomme un slot user inutile
- Pour des gros écarts saisonniers récurrents, demandez un devis Enterprise — quotas illimités, plus de stress
Et après ?
Vous êtes bloqué ? Écrivez-nous à support@trdc.cloud — engagement Standard : réponse sous 4h ouvrées (lun-ven 9h-18h CET). Enterprise : sous 1h ouvrées (8h-20h CET).