Intégration avec abby

À quoi sert l’intégration Abby ?

PomodoFlow se connecte à ton compte Abby pour importer automatiquement tes factures et devis dans le prévisionnel financier. Concrètement, tu peux :

  • Voir les factures payées et celles en attente sur le même tableau de bord que ton temps tracké
  • Créer des projets PomodoFlow à partir de factures Abby non payées (cycle de paiement déduit automatiquement de l’échéance)
  • Recevoir des relances de paiement aux bonnes dates (J-7, J-1, retard)

L’intégration est en lecture seule : PomodoFlow ne modifie jamais tes données Abby. Aucune facture n’est créée ni supprimée côté Abby.

Étape 1 — Récupérer ta clé d’API Abby

  1. Connecte-toi à ton espace Abby : app.abby.fr
  2. Ouvre les Réglages (icône engrenage)
  3. Va dans la section API (ou directement : app.abby.fr/settings/api)
  4. Clique sur Générer une nouvelle clé
  5. Donne-lui un nom évocateur, par exemple « PomodoFlow »
  6. Copie immédiatement la clé : elle ne sera plus affichée par la suite

⚠️ Garde cette clé confidentielle. Elle équivaut à un mot de passe : avec elle, n’importe quel outil peut lire tes factures Abby.

Étape 2 — Connecter Abby dans PomodoFlow

  1. Ouvre PomodoFlow puis Réglages → Intégrations
  2. Trouve la carte Abby dans la liste, déplie-la
  3. Colle ta clé d’API dans le champ
  4. Clique sur Connecter

PomodoFlow vérifie ta clé en temps réel. Si tout est OK, une coche verte apparaît et la première synchronisation démarre.

Étape 3 — Importer tes factures

Après la première synchronisation, PomodoFlow affiche une fenêtre récapitulative avec toutes les factures et devis détectés sur ton compte Abby.

Tu peux filtrer la liste par :

  • Année (par défaut, l’année en cours est sélectionnée)
  • Type : Facture ou Devis
  • Statut : Brouillon, Validé, Payé

Sélectionne ce que tu veux importer puis clique sur Importer la sélection.

Ce qui se passe ensuite

  • Toutes les factures sélectionnées sont stockées dans PomodoFlow pour le forecasting (prévisionnel de trésorerie).
  • Chaque facture non payée crée automatiquement un projet dans le domaine « Importé depuis Abby », avec :
    • Le client et le titre de la facture
    • Le budget HT en euros
    • La date d’émission et l’échéance
    • Le cycle de paiement (30, 45 ou 60 jours) déduit automatiquement de l’écart entre émission et échéance
  • Les factures payées ne créent pas de projet (elles sont juste comptabilisées dans les statistiques).

Synchronisation automatique

PomodoFlow vérifie ton compte Abby une fois par jour automatiquement. Tu peux aussi déclencher une synchronisation manuelle à tout moment via le bouton Synchroniser sur la carte Abby.

Les nouvelles factures apparaissent toujours dans la fenêtre de sélection : tu décides quoi importer, rien n’arrive à ton insu.

Déconnecter Abby

Sur la carte Abby, déplie-la puis clique sur Déconnecter. Cela :

  • Supprime ta clé d’API du Trousseau
  • Vide le cache local des factures Abby

Les projets déjà créés à partir de factures Abby restent intacts — PomodoFlow ne les supprime pas.

Problèmes fréquents

« Clé invalide ou erreur de connexion. » Vérifie que tu as bien collé la clé entière, sans espace au début ou à la fin. Si ça persiste, génère une nouvelle clé depuis Abby.

Mes factures n’apparaissent pas après la synchronisation. Vérifie le filtre « Année » dans la fenêtre d’import — par défaut, seule l’année en cours est affichée. Change l’année pour voir les factures plus anciennes.

Une facture déjà importée a été modifiée sur Abby. La synchronisation suivante mettra à jour automatiquement le titre, le statut, le montant et les dates côté PomodoFlow. Aucune action de ta part.