SAP / Teledec / Services externes (Webhook Teledec, Yousign, Chorus)
SAP / Teledec / Services externes
Webhooks Teledec, Yousign, Chorus Pro — recevoir, traiter et finaliser des opérations
Gérez facilement les intégrations externes pour envoyer et recevoir fichiers, valider des signatures et suivre l’état des transmissions. Centralisez les logs, relancez les opérations en erreur et téléchargez les pièces reçues.
Capacités principales
Recevoir et traiter des webhooks
Réception automatique des notifications (Teledec, Yousign, Stripe, Chorus Pro). Le système enregistre l’événement, met à jour l’état lié (facture, déclaration TVA, devis) et stocke les pièces jointes reçues.
Configurer les services partenaires
Ajoutez vos identifiants et secrets pour Teledec, Yousign, Chorus Pro et Stripe depuis les paramètres. Copiez l’URL et la clef affichées pour les coller côté service partenaire.
Visualiser les logs et erreurs
Consultez les événements reçus avec le payload, l’heure, le statut et le message d’erreur. Filtrez par service, référence ou statut pour diagnostiquer rapidement.
Relancer ou corriger des opérations
Relancez un webhook en échec, corrigez les informations manquantes (référence, document) et refaites le traitement sans perdre l’historique.
Gérer les pièces jointes
Téléchargez et attachez automatiquement les PDF (déclarations Teledec, documents signés Yousign) aux factures, devis ou déclarations concernées.
Sécurité et validation
Le système vérifie la présence de secrets/webhook-keys et affiche les erreurs de signature. Vous êtes alerté quand la vérification échoue pour éviter les traitements non sûrs.
How to use it
Configurer l’intégration d’un service (ex. Teledec)
Ouvrir les paramètres d’intégration
Allez dans Paramètres → Intégrations (ou Services externes). Repérez la section Teledec, Yousign, Chorus Pro ou Stripe selon ce que vous voulez connecter.
Renseigner les identifiants
Saisissez les champs demandés : identifiant/clé, secret webhook et choisissez l’environnement (test/staging ou production). Sauvegardez. Le système affiche une URL de réception et un secret générés.
Enregistrer l’URL côté partenaire
Copiez l’URL de webhook affichée et collez-la dans le tableau de bord du service partenaire (Teledec / Yousign / Chorus Pro / Stripe). Collez aussi le secret webhook si demandé.
Tester la connexion
Utilisez le bouton Tester (ou envoyez un test depuis le partenaire). Vérifiez que le test apparaisse dans les logs avec statut “succès”.
Consulter et diagnostiquer les webhooks reçus
Accéder aux journaux
Allez dans Paramètres → Webhooks / Journaux d’événements (ou Tableau de bord → Événements). La liste montre chaque événement reçu avec date, service, référence et statut.
Filtrer et ouvrir un événement
Filtrez par service (Teledec/Yousign/Stripe/Chorus), par référence ou par statut. Cliquez sur une ligne pour ouvrir le détail : payload reçu, en-têtes, erreur si existante, et fichiers éventuellement attachés.
Télécharger le contenu
Si un PDF ou un fichier est présent (par ex. déclaration Teledec ou document signé Yousign), utilisez Télécharger pour vérifier le contenu et l’attacher manuellement si besoin.
Relancer ou corriger une opération en erreur
Repérer l’erreur
Dans le détail du log, lisez le message d’erreur. Les problèmes courants : signature incorrecte, référence manquante, payload mal formé ou PDF absent.
Corriger les données
Si certaines informations manquent (référence facture, numéro de déclaration…), utilisez l’action Corriger / Éditer du journal pour compléter les champs nécessaires.
Relancer le traitement
Cliquez Relancer. Le système reprend le traitement : mise à jour de l’objet lié (facture / déclaration), création d’un attachement si fichier présent et journalisation du résultat.
Vérifier l’état final
Après relance, vérifiez que l’objet (ex. facture) a bien changé d’état et que le fichier a été attaché. Contrôlez aussi le log pour confirmer l’absence d’erreurs.
Gérer les fichiers reçus (PDF Teledec / documents Yousign)
Ouvrir la facture / déclaration
Dans la liste des documents (factures, devis, déclarations TVA), ouvrez l’élément concerné. La section Pièces jointes affiche les fichiers reçus automatiquement.
Télécharger ou renvoyer
Téléchargez la pièce jointe, renommez-la si nécessaire, ou renvoyez-la par e-mail au client depuis l’interface de document.
Archiver ou supprimer
Si un fichier est incorrect, supprimez-le depuis la liste des pièces jointes puis relancez un nouvel envoi ou attachez manuellement la bonne version.
Astuce pro
Associez toujours un identifiant externe clair (ex. numéro de facture ou id externe) lors de l’envoi vers Yousign/Teledec. Cela facilite la recherche et évite les erreurs d’association lorsque le webhook revient.
Règles importantes et limites
- Toujours configurer et stocker le secret webhook côté service et dans vos paramètres pour garantir la vérification des messages.
- Le traitement d’un webhook peut modifier l’état d’un document (export, import, validation) : vérifiez les logs avant de relancer plusieurs fois pour éviter les doublons.
- Validez le contenu du payload (référence, montant, présence de PDF) avant de marquer une opération comme traitée.
- Les fichiers reçus peuvent écraser des pièces déjà attachées si vous relancez sans vérifier ; sauvegardez une copie si nécessaire.
FAQ
Frequently Asked Questions
Besoin d'aide pour configurer une intégration ?
Si vous hésitez sur le secret à utiliser ou si un webhook ne s’exécute pas correctement, contactez notre support avec la référence d’événement visible dans vos logs.