Utiliser le CLI de Cord
Le CLI de Cord (@flouviahq/cli) est l’outil en ligne de commande pour intégrer Cord à votre projet. Il ne fonctionne qu’en mode test : rien de ce que vous faites avec lui ne touche à des données réelles.
Le moyen le plus rapide : l’assistant
npx @flouviahq/cliIl vous guide pas à pas à l’aide de menus : il connecte votre terminal, configure votre compte avec l’IA, intègre votre projet (installe le SDK, crée les routes et enregistre les clés dans votre .env.local) et laisse les webhooks à l’écoute. À la fin, il affiche un récapitulatif de ce qui est prêt.
Installer et se connecter
npm install -g @flouviahq/cli
cord logincord login ouvre votre navigateur avec un code de confirmation. Vérifiez qu’il est identique à celui affiché dans le terminal et cliquez sur Autoriser. Vous devez disposer du droit Paramètres dans l’entreprise. Le terminal reçoit automatiquement une clé de test restreinte : elle peut utiliser les simulateurs, lire les événements et proposer des configurations, et elle expire au bout de 90 jours. Elle apparaît dans l’onglet Clés API du Workbench Développeurs sous le nom CLI · <votre machine>, où vous pouvez la révoquer.
- Vous travaillez en SSH sans navigateur ?
cord login --no-browseraffiche l’adresse pour l’ouvrir sur un autre appareil. - Vous préférez coller votre propre clé ?
cord login --api-key.
Les principales commandes
| Commande | À quoi elle sert |
|---|---|
cord setup |
Propose la configuration de votre compte à partir de votre site et de votre liste de prix. Vous l’approuvez dans le navigateur. |
cord init |
Détecte votre framework et ajoute la route des webhooks avec vérification de la signature. |
cord listen --forward-to http://localhost:3000/api/webhooks/cord |
Transfère les webhooks de test vers votre serveur local. |
cord trigger quote.approved |
Déclenche un événement de test. |
cord simulate fiscal pac_caido |
La prochaine facture de test échoue comme si le PAC ne répondait pas. |
cord events tail |
Affiche les événements au fur et à mesure qu’ils se produisent. |
cord whoami / cord logout |
Affiche l’entreprise connectée / supprime la clé enregistrée. |
Problèmes fréquents
- « Le code a expiré » : le code est valable 10 minutes. Relancez
cord login. - « C’est une clé live » : le CLI refuse volontairement les clés
sk_live_. Utilisez une clé de test. - Vous ne voyez pas l’écran d’autorisation : votre utilisateur doit disposer du droit Paramètres dans l’entreprise. Demandez-le à votre administrateur.
Plus de détails dans le guide du CLI.