Passer au contenu principal

Automatiser la récupération des exports de fichiers plats

COMPTABILITÉ - Fini les exports manuels : déclenchez et récupérez automatiquement vos fichiers ACD et Agiris directement depuis Pennylane.

Comment cet article peut-il vous aider ?

Cet article vous guide à travers deux approches selon la maturité technique de votre cabinet d’expertise comptable :

  • Option A : Un script pour les cabinets équipés d'un serveur Windows, sans équipe de développement.

  • Option B : Une intégration via l'API REST pour les cabinets disposant d'une équipe IT ou d'un éditeur tiers.

Les scripts et exemples fournis par Pennylane sont adaptables à vos cas d’usage.

Les exports automatisés fonctionnent en mode incrémental : seules les écritures non encore exportées (manuellement ou via automatisation) sont incluses dans chaque export. À noter : les exports réalisés via l'API de Chift sont exclus de cette logique incrémentale, les écritures concernées seront donc réexportées.

Pour savoir précisément ce que contiennent ces exports, consultez l’article Exporter les écritures et les pièces jointes vers un logiciel comptable.

ℹ️ Les exports automatisés n’apparaissent pas dans la page Historique des exports de Pennylane, afin de ne pas surcharger l’interface.

Que faut-il savoir avant de commencer ?

Quelle que soit l’option choisie, vous aurez besoin de trois éléments :

  1. Un token API cabinet, généré depuis les Paramètres du cabinet sur Pennylane, dans la section Tokens API (en bas de page). Cliquez sur Générer un nouveau token, cochez le périmètre exports:software_specific_entries, définissez la durée de validité et validez. Seuls les utilisateurs avec un rôle admin ou accountant_all_companies peuvent générer ce token.

  2. L’identifiant de l’entreprise (company_id), visible directement dans l’URL de la page de l’entreprise sur Pennylane, depuis votre navigateur.

  3. Un chemin de destination valide sur votre serveur, dans lequel les fichiers exportés seront déposés. Exemple : C:\Imports_ACD.
    ​

⚠️ Conservez votre token en lieu sûr : il donne accès à vos exports et ne doit pas être partagé.


Privilégiez une durée de validité limitée dans le temps, et programmez un rappel pour générer un nouveau token avant son expiration. Une durée illimitée reste possible, mais l’accès demeure alors valide jusqu’à sa révocation manuelle, ce qui augmente fortement l’impact d’une fuite de données. Cette option reste sous la responsabilité du cabinet.

Option A : Script PowerShell

Cette option convient aux cabinets d’expertise comptable disposant d'un serveur Windows. Un script s'exécute automatiquement (par exemple chaque nuit) et dépose le fichier exporté directement dans le dossier d'import de votre logiciel comptable.

⚠️ Ce script est conçu pour tourner sur Windows Server (version ≥ 2016). Il peut également s’exécuter sur une machine personnelle, à condition que celle-ci soit allumée à l’heure prévue. Éteindre la machine ne réinitialise pas la configuration.

Installer le script

  1. Contactez votre référent Pennylane pour obtenir le script.

  2. Téléchargez le fichier de script PowerShell fourni par Pennylane : download_fec.ps1.

  3. Ouvrez le fichier dans un éditeur de texte (Bloc-notes, VS Code, etc.) et renseignez les quatre variables suivantes :

    • $API_TOKEN = "Votre_Token_Pennylane"

    • $COMPANY_ID = "Identifiant_de_l_entreprise"

    • $DESTINATION_PATH = "C:\Imports" : le dossier dans lequel le fichier exporté sera déposé.

    • $EXPORT_TYPE = "acd" : le logiciel de destination. Pour un export Agiris, remplacez acd par agiris.

  4. Lancez PowerShell en mode Administrateur (si les droits d’écriture sur le serveur l’exigent).

  5. Exécutez le script download_fec.ps1. Le fichier est automatiquement téléchargé dans votre dossier cible.

Si vous n’avez pas les droits nécessaires pour exécuter le script, autorisez son exécution pour la session en cours : copiez-collez la commande ci-dessous dans PowerShell, puis appuyez sur la touche Entrée.

Set-ExecutionPolicy Unrestricted -Scope Process

⚠️ L’exécution de cette commande relève de la seule responsabilité du cabinet. Modifier les règles d’exécution PowerShell abaisse temporairement le niveau de sécurité de votre système et peut exposer votre environnement à l’exécution de scripts non autorisés. Ne la lancez que dans un environnement maîtrisé.

Automatiser l'exécution avec le Planificateur de tâches Windows

  1. Téléchargez le second script fourni par Pennylane : register-fec-task.ps1.

  2. Placez-le dans le même dossier que download_fec.ps1 (sans renommer aucun des deux fichiers).

  3. Exécutez register-fec-task.ps1. La tâche planifiée est créée : votre export s'exécutera désormais automatiquement chaque jour à 14h00.

  4. Pour modifier l’heure d’exécution, ouvrez register-fec-task.ps1 et remplacez la valeur "2pm" (ligne 4) par l’horaire souhaité.

⚠️ Une fois register-fec-task.ps1 exécuté, ne déplacez pas et ne supprimez pas le script download_fec.ps1 : la tâche planifiée ne fonctionnerait plus.

Vous pouvez aussi modifier la récurrence, en remplaçant la ligne du déclencheur ($trigger) dans register-fec-task.ps1. Exemples :

  • tous les lundis à 14h00 : New-ScheduledTaskTrigger -Weekly -DaysOfWeek Monday -At 2pm ;

  • les lundis et les jeudis à 14h00 : New-ScheduledTaskTrigger -Weekly -DaysOfWeek Monday,Thursday -At 2pm ;

  • une semaine sur deux, le lundi à 14h00 : New-ScheduledTaskTrigger -Weekly -WeeksInterval 2 -DaysOfWeek Monday -At 2pm.

Pour supprimer la tâche planifiée à tout moment, exécutez cette commande dans un terminal PowerShell :

Unregister-ScheduledTask -TaskName "fec_download" -Confirm:$false

Option B : Intégration via l'API REST

Cette option s'adresse aux cabinets d’expertise comptable disposant d'une direction des systèmes d’information (DSI), de compétences en développement ou d'un éditeur tiers. Elle repose sur les endpoints REST v2 de Pennylane.

Exporter les données d'un dossier

L'export se déroule en deux étapes :

a. Déclencher l’export (POST)

Documentation technique de l’endpoint : Export Accounting Entries for external software.

  1. Appelez l'endpoint dédié en fournissant dans l'URL le company_id de l'entreprise concernée.

  2. Dans le corps de la requête, renseignez les champs obligatoires :

    • export_type : acd ou agiris

    • period_start : date de début de période

    • period_end : date de fin de période

  3. En option, affinez votre requête avec les paramètres suivants : journal_codes (filtrer par codes journaux), include_attachments (désactivé par défaut), account_numbers_type (original ou pennylane).

  4. L'API retourne immédiatement un statut 201 Created contenant l'identifiant de l'export (id) et son statut initial (pending).

b. Récupérer le fichier (GET)

Documentation technique de l’endpoint : Get Accounting Entries external software export.

  1. Interrogez l'endpoint de suivi en passant le company_id et l'id de l'export obtenus à l'étape précédente.

  2. Répétez l'appel (polling) jusqu'à ce que le statut indique que le traitement est terminé.

  3. Récupérez alors le champ file_url et téléchargez l'archive générée.

⚠️ Le lien de téléchargement (file_url) expire après 30 minutes. Téléchargez le fichier immédiatement après réception du lien. Si le lien a expiré, relancez un GET sur l’endpoint pour en obtenir un nouveau.

ℹ️ Ce fichier est conçu pour la compatibilité avec vos logiciels de production. Il ne remplace pas le fichier FEC officiel requis par la DGFIP lors des contrôles fiscaux.

Exporter les données de plusieurs dossiers

La méthode est la même que pour un seul dossier. Pennylane fournit deux variantes du script download_fec.ps1 :

  • une variante pour tous les dossiers du cabinet ;

  • une variante pour certains dossiers uniquement.

Remplacez le script download_fec.ps1 téléchargé à l’étape d’installation par la variante souhaitée. Toutes les autres étapes restent identiques.

Automatiser l'import dans votre logiciel comptable

Une fois le fichier téléchargé sur votre serveur, il reste à l'injecter dans votre logiciel de production.

Import dans ACD

ACD ne dispose pas d'un dossier racine surveillé unique capable de trier et d'intégrer automatiquement les flux pour l'ensemble des dossiers du cabinet. La solution recommandée consiste à automatiser l'outil d'import ACD via le Planificateur de tâches Windows.

Import dans Agiris (Isacompta)

Agiris propose un dossier racine de transfert partagé au niveau du serveur du cabinet :

  • Chemin par défaut : isagiwf\Transfert\MajDossier, répertoire de transfert partagé au niveau serveur.

  • IsaCowp.gi\Maj, répertoire de mise à jour au niveau de l’application ou du poste utilisateur (pour les imports manuels ou locaux).

À chaque ouverture d'un dossier dans Isacompta, le système scanne automatiquement ce répertoire pour importer les mises à jour disponibles.

Que faire si l’export automatisé ne fonctionne plus ?

Le script ne parvient pas à écrire le fichier

Vérifiez que l'utilisateur Windows qui exécute le script dispose bien des droits de lecture et d'écriture sur le dossier de destination.

Le lien de téléchargement ne fonctionne plus

Les URL pré-signées expirent après 30 minutes. Relancez un GET sur l’endpoint de l’export pour obtenir un nouveau lien valide.

Le script ne fonctionne plus du tout

Votre token API est probablement arrivé à expiration. Générez un nouveau token depuis les Paramètres du cabinet > section Tokens API, puis mettez à jour la variable $API_TOKEN dans le fichier .ps1.
​

ℹ️ Les logiciels Cegid Expert et Quadratus seront prochainement pris en charge dans ce dispositif d’automatisation.

Articles connexes
Avez-vous trouvé la réponse à votre question ?