Vérifie la connexion à l'API Pennylane et retourne les infos de l'utilisateur et de la société connectée. Utilisez cet outil en premier pour valider que le token est fonctionnel.

Returns: str: JSON avec les informations du compte connecté.

Liste les comptes du plan comptable avec filtres et pagination. Utile pour consulter le plan comptable, chercher un compte par préfixe (411=clients, 401=fournisseurs, 512=banque, 6=charges, 7=produits).

Récupère le détail d'un compte comptable par son identifiant.

Crée un nouveau compte dans le plan comptable. Un numéro commençant par 401 crée automatiquement un fournisseur, par 411 un client.

Modifie le libellé ou le statut lettrable d'un compte existant.

Liste tous les journaux comptables (ventes, achats, banque, OD, paie...) avec filtres optionnels par type.

Récupère le détail d'un journal comptable par son identifiant.

Crée un nouveau journal comptable. Codes classiques : VE (ventes), HA (achats), BQ (banque), OD (opérations diverses), PA (paie), RB (reprise de balance).

Liste les écritures comptables (pièces) avec filtres par journal et période. Chaque écriture contient des lignes équilibrées (débit = crédit).

Récupère le détail complet d'une écriture comptable avec toutes ses lignes.

Crée une nouvelle écriture comptable avec ses lignes. RÈGLE FONDAMENTALE : total débits = total crédits. Les montants sont des strings (ex: '1500.00').

Modifie une écriture existante. Permet de changer l'en-tête et de créer/modifier/supprimer des lignes. L'écriture doit rester équilibrée.

Liste les lignes d'écriture d'une pièce comptable spécifique.

Liste toutes les lignes d'écriture comptable avec filtres par journal, compte et période. Utile pour analyser les mouvements d'un compte ou d'un journal sur une période.

Récupère le détail d'une ligne d'écriture comptable.

Lettre (rapproche) des lignes d'écriture entre elles. Permet de pointer des factures avec des règlements. Les lignes doivent appartenir au même compte (ex: 411xxx client). Par défaut, débit total = crédit total.

Supprime le lettrage de lignes d'écriture. Utile pour corriger un rapprochement erroné.

Associe des catégories analytiques à une ligne d'écriture. Chaque catégorie a un poids (0 à 1, somme = 1).

Liste les catégories analytiques associées à une ligne d'écriture.

Liste les lignes lettrées (rapprochées) avec une ligne donnée. Permet de voir quels règlements sont pointés avec quelles factures.

Récupère la balance générale pour une période donnée. Retourne chaque compte avec ses totaux débit/crédit. Essentiel pour les travaux de clôture, la vérification des soldes, et la préparation des états financiers.

L'outil pagine automatiquement pour récupérer TOUS les comptes (classes 1 à 7) afin de garantir des totaux exacts.

Liste les exercices fiscaux avec leurs dates et statuts (open, closed, frozen). Utile pour connaître les périodes comptables.

Liste les clients (entreprises et particuliers) avec filtres et pagination. Utile pour consulter la base clients, rechercher un client par nom ou type.

Récupère le détail d'un client par son identifiant. Retourne les informations complètes (adresse, contacts, conditions de paiement).

Crée un nouveau client de type entreprise (société). Le nom (raison sociale) est obligatoire.

Crée un nouveau client de type particulier (personne physique). Le prénom et le nom sont obligatoires.

Modifie un client entreprise existant. Seuls les champs fournis sont mis à jour.

Modifie un client particulier existant. Seuls les champs fournis sont mis à jour.

Liste les fournisseurs avec filtres et pagination. Utile pour consulter la base fournisseurs, rechercher un fournisseur par nom.

Récupère le détail d'un fournisseur par son identifiant. Retourne les informations complètes (adresse, SIRET, IBAN, conditions de paiement).

Crée un nouveau fournisseur. Le nom est obligatoire.

Modifie un fournisseur existant. Seuls les champs fournis sont mis à jour.

Liste les factures clients (et avoirs, montant négatif), en mode compact par défaut.

Filtré côté Pennylane : customer_id, date_from, date_to. L'API ne filtre ni par statut, ni par échéance, ni par montant. Filtré localement : status, unpaid_only, deadline_before. Dans ce cas l'outil pagine seul (plafond 1 000 documents), renvoie toutes les correspondances et indique is_complete ; limit et cursor sont ignorés.

« Payé » : le champ paid ne fait pas foi (les factures annulées ont paid=true). Seuls status et remaining_amount_with_tax comptent. « Impayée » veut dire « non rapprochée dans Pennylane » : pour savoir si l'argent est arrivé, voir Qonto.

Récupère le détail complet d'une facture client par son identifiant, en un appel. Les lignes (invoice_lines), les paiements (payments) et les transactions bancaires rapprochées (matched_transactions) sont intégrés, au lieu de leurs URL. Listes payments et matched_transactions vides = facture non rapprochée dans Pennylane ; pour savoir si l'argent est arrivé, voir Qonto.

Crée une nouvelle facture client (brouillon par défaut). Nécessite un client, une date, une échéance et au moins une ligne.

Modifie une facture client (brouillon uniquement). Seuls les champs fournis sont mis à jour.

Liste les lignes (articles) d'une facture client spécifique.

Transforme un brouillon de facture client en facture finalisée. Attention : cette action est irréversible. La facture reçoit un numéro définitif.

Marque une facture client finalisée comme payée.

Liste les factures fournisseurs avec filtres et pagination. Utile pour consulter les factures reçues, filtrer par statut ou fournisseur.

Récupère le détail complet d'une facture fournisseur. Retourne toutes les informations : montants, lignes, statut, fournisseur.

Modifie une facture fournisseur. Seuls les champs fournis sont mis à jour.

Liste les lignes (articles) d'une facture fournisseur spécifique.

Met à jour le statut de paiement d'une facture fournisseur.

Liste les produits/services du catalogue avec filtres et pagination. Utile pour consulter le catalogue, rechercher un produit par nom.

Récupère le détail d'un produit par son identifiant. Retourne : libellé, prix HT, TVA, unité, compte comptable associé.

Crée un nouveau produit/service dans le catalogue. Le libellé, le prix HT et le taux de TVA sont obligatoires.

Modifie un produit existant. Seuls les champs fournis sont mis à jour.

Liste les devis avec filtres et pagination, en mode compact par défaut. Utile pour consulter les devis émis, filtrer par statut ou client.

Récupère le détail complet d'un devis par son identifiant. Retourne toutes les informations : montants, lignes, statut, client.

Crée un nouveau devis. Nécessite un client, une date, une échéance et au moins une ligne.

Modifie un devis existant. Seuls les champs fournis sont mis à jour.

Met à jour le statut d'un devis (accepté, refusé, facturé, etc.).

Envoie un devis par email au client ou à des destinataires spécifiques.

Liste les lignes (articles) d'un devis spécifique.

Liste les sections de lignes d'un devis.

Liste tous les groupes de catégories analytiques. Chaque groupe contient des catégories utilisées pour la ventilation analytique.

Récupère le détail d'un groupe de catégories par son identifiant.

Liste les catégories analytiques avec filtres et pagination. Utile pour consulter les axes analytiques disponibles.

Récupère le détail d'une catégorie analytique par son identifiant.

Liste les catégories appartenant à un groupe spécifique.

Crée une nouvelle catégorie analytique dans un groupe. Le libellé et l'ID de groupe sont obligatoires.

Modifie une catégorie analytique existante. Seuls les champs fournis sont mis à jour.

Crée un export FEC (Fichier des Écritures Comptables) pour une période. L'export est asynchrone : utilisez pennylane_get_fec_export pour récupérer le fichier une fois le statut 'ready'.

Récupère le détail d'un export FEC. Retourne le statut (pending/ready/error) et l'URL de téléchargement si prêt (expire dans 10 minutes).

Crée un export Grand Livre Analytique (AGL) pour une période. L'export est asynchrone : utilisez pennylane_get_agl_export pour récupérer le fichier.

Récupère le détail d'un export Grand Livre Analytique. Retourne le statut et l'URL de téléchargement si prêt.

Liste les abonnements de facturation récurrente avec filtres et pagination. Utile pour consulter les abonnements actifs, filtrer par client ou statut.

Récupère le détail complet d'un abonnement de facturation.

Crée un nouvel abonnement de facturation récurrente. Nécessite un client, une date de début, une règle de récurrence et des lignes.

Modifie un abonnement de facturation existant. Seuls les champs fournis sont mis à jour.

Liste les lignes de facturation d'un abonnement.

Liste les sections de lignes d'un abonnement de facturation.

Liste tous les dossiers comptables configurés avec leur statut. Les tokens sont masqués pour la sécurité.

Affiche le dossier comptable actuellement actif avec les informations de connexion Pennylane (via /me).

Bascule vers un autre dossier comptable. Toutes les requêtes suivantes utiliseront ce dossier par défaut. Vérifie la connexion avec l'endpoint /me après le switch.

Ajoute un nouveau dossier comptable à la configuration. Le token est vérifié avec l'endpoint /me avant l'ajout. Si c'est le premier dossier, il devient automatiquement actif.

Supprime un dossier comptable de la configuration. Si le dossier supprimé était actif, le premier dossier restant devient actif automatiquement.

Exécute une requête GET en parallèle sur plusieurs dossiers. Utile pour comparer des données entre clients ou consolider des informations (ex: balances, comptes, exercices).