Compagnon· Aide

Connecter mon compte TrackDéchets

OAuth 2.0 avec TrackDéchets, refresh automatique des tokens et résolution des erreurs courantes.

Mis à jour le 26 avril 2026

Compagnon s'appuie sur l'API officielle TrackDéchets du Ministère pour générer, signer et transmettre vos BSDs. La connexion se fait par OAuth 2.0 lors de votre première connexion, puis se renouvelle toute seule.

Prérequis

  • Un compte TrackDéchets actif avec accès à au moins un établissement
  • Vos rôles TD à jour (producteur, transporteur, exutoire, négociant…)

Si votre compte TrackDéchets n'a pas accès à l'établissement que vous voulez piloter dans Compagnon, contactez d'abord l'administrateur de cet établissement sur TrackDéchets.

Étape 1 — Lancer la connexion

Depuis l'écran d'accueil de Compagnon, cliquez sur Se connecter avec TrackDéchets. Vous êtes redirigé vers le portail TrackDéchets pour authentification.

Étape 2 — Autoriser Compagnon

TrackDéchets vous demande d'autoriser Compagnon à :

  • Lire votre profil utilisateur (nom, e-mail, établissements rattachés)
  • Lire et émettre des BSDs (BSDD, BSDA, BSDASRI, BSDF) sur les établissements que vous gérez
  • Recevoir les événements de signature et de mise à jour des bordereaux

Cliquez sur Autoriser. Vous êtes redirigé vers Compagnon, votre compte est provisionné automatiquement et vous arrivez sur l'onboarding.

Renouvellement automatique des tokens

Compagnon stocke vos tokens OAuth de manière chiffrée (AES-256, jamais en clair) et les renouvelle automatiquement 60 secondes avant expiration via le refresh_token. Vous n'avez rien à faire au quotidien.

Si TrackDéchets révoque vos tokens (changement de mot de passe, retrait d'agrément, révocation manuelle), la prochaine action sur Compagnon vous renvoie vers la page de connexion TrackDéchets.

Erreurs courantes

SymptômeCause probableQue faire
"Aucun établissement rattaché"Votre profil TD n'a aucun établissement avec rôle métierDemandez à l'admin TD de votre établissement de vous ajouter
"401 Unauthorized" sur une actionRefresh token révoqué côté TDReconnectez-vous depuis l'écran d'accueil
"Permission refusée" sur un BSDVotre rôle TD ne couvre pas cet établissementVérifiez vos rôles sur TrackDéchets
Redirection en boucle vers TrackDéchetsCookies tiers bloqués (Safari ITP, Brave Shields)Activez les cookies de landing.trdc.cloud

Bonnes pratiques

  • Un compte TD = un compte Compagnon. Ne partagez pas vos identifiants TrackDéchets.
  • Pour vos collègues, créez-leur un compte TrackDéchets dédié, puis invitez-les depuis Utilisateurs dans Compagnon : ils se connecteront avec leur propre SSO TD.
  • Auditez régulièrement les permissions accordées à Compagnon depuis votre profil TrackDéchets (section Applications connectées).

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).