Astuces, dépannage & erreurs courantes
Astuces, dépannage & erreurs courantes — ce que vous allez apprendre
Dans cette page vous trouverez des actions concrètes et faciles à suivre pour : sauvegarder la configuration d’onboarding, activer la 2FA, utiliser la fusion de doublons et les règles bancaires, gérer IBAN/mandats SEPA, générer des exports SEPA, configurer Teledec/URSSAF, et dépanner les webhooks (Stripe, Yousign, Teledec). Vous saurez aussi où lire les logs, voir les toasts/modales d’erreur et comment relancer des jobs ou réessayer un export.
Sauvegarder la configuration d'onboarding et sécurité
Sauvegarder la configuration d'onboarding
Allez dans Paramètres > Onboarding (ou Configuration initiale) et cliquez sur “Sauvegarder la configuration” après avoir finalisé les options (rôles, préférences, modèles d’emails). Si vous avez des écrans à plusieurs étapes, terminez chaque étape puis utilisez le bouton “Enregistrer” avant de passer à la suivante.
Activer l'authentification à deux facteurs (2FA)
Allez dans Paramètres > Sécurité > 2FA. Activez la 2FA pour votre compte administrateur, suivez l’assistant (scannez le QR code avec une application d’authentification ou recevez SMS selon l’option) et conservez les codes de secours. Demandez aux autres administrateurs de faire de même.
::step{title=“Protéger vos clés API” icon=“lucide:key”} Paramètres > API & Webhooks : donnez un nom à votre clé, copiez-la (afficher/cacher est disponible) et stockez-la en lieu sûr. Supprimez les clés non utilisées après confirmation. :: :::
Astuce rapide
Sauvegardez la configuration d’onboarding AVANT d’ajouter des intégrations (Stripe, Teledec, Bankin) — cela évite des réglages répétés si vous faites des tests.
Gagner du temps : doublons et règles bancaires
Fusionner les doublons (contacts / organisations)
Contacts > Gérer doublons (ou Contacts > Doublons). Sélectionnez les enregistrements détectés, comparez les champs affichés et cliquez sur “Fusionner”. Le système conserve l’historique et vous montre les différences avant la fusion.
Créer des règles bancaires
Banque > Règles bancaires : créez des règles basées sur le libellé du mouvement (ex : « ULTRASHOP » → catégorie “Achats”, compte fournisseur X). Les règles appliquées automatiquement accélèrent le rapprochement.
::step{title=“Exemple pratique : règle pour abonnement” icon=“lucide:workflow”} Créez une règle : libellé contient “PAYMENT SUBSCRIPTION” → Tag = “Abonnements” → Compte comptable = 706. Lors du prochain import bancaire, les mouvements correspondant seront automatiquement catégorisés. :: :::
Astuce pour les doublons
Avant fusionner, exportez une copie CSV des contacts concernés (bouton Export) pour un backup rapide si vous voulez restaurer une donnée manuellement.
Banque, IBAN, mandats SEPA et exports
Ajouter ou modifier IBAN/BIC
Aller sur la fiche du compte bancaire (Contacts > Fiches > Banque) et ouvrir le dialogue d’ajout/modification de coordonnées bancaires. Saisissez IBAN, BIC et nom du titulaire puis validez. L’UI indique les champs requis.
Créer un mandat SEPA depuis une fiche contact
Contacts > Fiche client > Paiements/SEPA > Nouveau mandat. Remplissez : client, IBAN, BIC, type de mandat, date de signature (ou joignez la signature électronique). Enregistrez : le mandat apparaît dans l’historique du contact.
Générer un export SEPA pour factures/prélèvements
Documents (Factures/Achats) : sélectionnez les factures à inclure → Actions > Export SEPA (ou Paiements > SEPA > Nouveau fichier). Choisissez le type (Core/B2B), validez les informations du créancier puis téléchargez le fichier XML à importer dans votre banque.
Marquer / retravailler un export
Si l’import bancaire échoue, retournez à Exports > Historique SEPA et utilisez “Regénérer” ou “Rétablir” pour corriger la sélection (retirer une facture problématique) puis regénérez le fichier.
Erreur courante : mandat SEPA invalide
Si un prélèvement est refusé pour mandat invalide : vérifiez que l’IBAN et le BIC sont corrects, que le mandat existe et qu’il est signé (date/électronique). Si le mandat a changé, créez un nouveau mandat et marquez l’ancien comme remplacé (old_mandate_id).
Teledec & URSSAF — config et résolution d'erreurs
Configurer Teledec (identifiants & paramètres)
Paramètres > Integrations > Teledec : saisissez login, mot de passe, IBAN, et activez le paramètre de télétransmission. Sauvegardez avant d’essayer une télé-déclaration.
Préparer et envoyer une déclaration TVA
Comptabilité > TVA : choisissez la période (mois/trimestre/année) → Exécuter calcul → vérifier le détail par ligne (hovercards montrent les lignes TVA). Cliquez “Soumettre à Teledec” pour construire et envoyer la payload.
Relancer une télé-déclaration échouée
Si l’envoi retourne une erreur (ex. paramètres manquants), corrigez Paramètres > Teledec (SIRET/adresse/identifiants), puis cliquez “Réessayer” sur l’historique d’envoi.
Erreur fréquente Teledec/URSSAF
Échecs souvent causés par paramètres manquants (SIRET, adresse, IBAN ou option de télétransmission non activée). Vérifiez ces champs avant de retransmettre.
Dépanner les synchronisations bancaires et OTP Bankin
OTP Bankin échoue (code expiré)
Si Bankin renvoie une erreur OTP : recommencez la connexion Bankin depuis Paramètres > Intégrations > Bankin et générez un nouveau code OTP dans votre appli Bankin. Vérifiez que l’heure du téléphone est correcte (codes basés sur l’heure).
Autoriser à nouveau Bankin
Si la connexion reste instable, révoquez l’autorisation existante et reconnectez le compte bancaire (Paramètres > Intégrations > Bankin > Déconnecter puis Connecter).
Webhooks (Stripe, Yousign, Teledec) — config et debug
Configurer un webhook
Paramètres > Webhooks : ajoutez l’URL de votre endpoint, cochez les événements souhaités (paiements, signatures, télé-déclarations) puis sauvegardez. Pour Stripe, copiez aussi l’URL webhook fournie (Paramètres > Stripe) et collez-la dans le dashboard Stripe.
Vérifier réception d'un webhook
Système > Événements (ou Paramètres > Webhooks > Événements reçus) : utilisez la liste paginée pour voir les événements entrants. Cliquez sur un événement pour voir le payload et le response code de votre endpoint.
Relancer un envoi webhook échoué
Si statut = error, cliquez sur l’événement puis sur “Réessayer” (Retry). Le job SendWebhook sera relancé. Copiez le payload et l’error_message pour le support si nécessaire.
Pourquoi je ne reçois pas les webhooks ?
Vérifiez : 1) l’URL est accessible publiquement (pas de firewall ou IP bloquée), 2) le serveur retourne HTTP 200 rapidement, 3) la clé/secret utilisé côté expéditeur est correct (ex. Stripe keys). Si l’endpoint répond avec 5xx, les retries automatiques peuvent être limités.
Astuce debug webhooks
Copiez le payload depuis l’UI Événements et testez-le localement avec un outil comme RequestBin ou Postman pour reproduire l’erreur. Utilisez la fonction “Afficher le response” pour voir le status_code et le message renvoyé.
Toasts, modales d'erreur et où trouver les logs
Toasts et modales
En cas d’action réussie/échouée, l’application affiche un toast (coin supérieur/droit) pour confirmation rapide. Pour erreurs bloquantes, une modale apparaît avec le message d’erreur et souvent un bouton “Voir les logs” ou “Télécharger le détail”.
Consulter les logs d'événements
Système > Événements / Logs : cherchez par date, type (webhook, teledec, sepa) ou ID d’entité. Les entrées montrent payloads, status_code et error_message. Pour erreurs de traitement internes, regardez l’outil de centralisation des erreurs (ex. Sentry) si votre organisation l’a activé.
Relancer jobs asynchrones
Dans la page d’un événement/job, utilisez le bouton “Retry” ou “Relancer job”. Pour un export SEPA, utilisez “Regénérer l’export” depuis Exports > Historique SEPA.
Récupérer un export après échec
Si un export SEPA a été marqué “exporté” par erreur, contactez le support ou utilisez l’option “Rétablir” sur l’export si disponible pour repasser les enregistrements en statut non-exporté, puis regénérez le fichier.
Erreur courante : webhooks Yousign/Stripe non reçus
Souvent causé par l’URL webhook incorrecte, environnement (sandbox vs prod) mal configuré, ou une clé Stripe/secret non copiée. Vérifiez le tableau d’événements pour voir si l’expéditeur a tenté d’envoyer l’événement.
Récapitulatif des actions disponibles
Gestion SEPA
Ajouter/modifier IBAN/BIC, créer/supprimer mandats, générer exports SEPA et télécharger le fichier pour la banque.
Teledec & URSSAF
Configurer identifiants, générer la payload Cerfa, envoyer la télé-déclaration et consulter l’historique.
Webhooks & Events
Configurer URL, choisir événements, voir payloads reçus, copier erreurs et relancer envois.
Next steps
- Vérifiez vos paramètres critiques : Paramètres > Sécurité (2FA) et Paramètres > Intégrations (Stripe, Bankin, Teledec).
- Testez un petit flux complet : ajouter IBAN → créer mandat → générer un petit export SEPA → importer côté banque.
- Configurez un webhook test pour Stripe ou Yousign et envoyez un événement de test ; utilisez la page Événements pour inspecter le payload et faire un retry.
- Consultez les autres pages du guide pour approfondir : Banque & rapprochement, SEPA, Teledec & TVA, et Webhooks & intégrations.
Si vous bloquez, copiez le message d’erreur (depuis la modale ou l’événement) et contactez le support avec l’ID d’événement et la capture du payload — cela accélère la résolution. :::