Connecter mon compte TrackDéchets

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

Bordoly 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 Bordoly, contactez d'abord l'administrateur de cet établissement sur TrackDéchets.

Étape 1 — Lancer la connexion

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

Étape 2 — Autoriser Bordoly

TrackDéchets vous demande d'autoriser Bordoly à :

  • 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 Bordoly, votre compte est provisionné automatiquement et vous arrivez sur l'onboarding.

Renouvellement automatique des tokens

Bordoly 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 Bordoly 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 bordoly.fr

Bonnes pratiques

  • Un compte TD = un compte Bordoly. 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 Bordoly : ils se connecteront avec leur propre SSO TD.
  • Auditez régulièrement les permissions accordées à Bordoly depuis votre profil TrackDéchets (section Applications connectées).

Et après ?

Vous êtes bloqué ? Écrivez-nous à support@bordoly.fr — engagement Standard : réponse sous 4h ouvrées (lun-ven 9h-18h CET). Entreprise : sous 1h ouvrées (8h-20h CET).

Cet article vous a-t-il aidé ?