Formats d’export

Tous les formats partagent le même moteur : parcours des écritures, contrôle d’équilibre, numérotation. Chaque format ne définit que son séparateur, ses colonnes et la mise en forme d’une ligne.

Le FEC est inclus dans la version gratuite ; les 12 autres formats, marqués Premium, demandent la version Premium (ou l’essai de 14 jours).

Fichiers d’exemple

Fichiers d’exemple générés par le plugin à partir d’une boutique de démonstration : un mois de commandes (septembre 2025), avec factures, règlements par passerelle, commissions, avoirs et plusieurs taux de TVA. Clients fictifs. Chaque fichier est équilibré : 54 157,21 € au débit comme au crédit. Les libellés sont dans la langue associée à chaque format (réglage automatique) : français pour FEC, Sage, EBP, Ciel et Pennylane, allemand pour DATEV, néerlandais pour Exact Online, anglais pour Xero, QuickBooks, SAP FI/CO et Zoho Books, espagnol pour Holded. Les noms des taux de TVA et des moyens de paiement viennent de la configuration de la boutique et ne sont pas traduits. L’exemple Xero dépasse 300 lignes : il est livré en ZIP de trois fichiers, comme par le plugin.

Télécharger les 13 exemples (zip, 104 Ko), ou chaque fichier avec le lien « Exemple » placé sous le nom du format dans le tableau ci-dessus. Utilisez-les pour tester l’import dans votre logiciel avant d’installer le plugin.

FEC : numéro d’écriture

Dans un FEC, chaque transaction reçoit un numéro d’écriture (EcritureNum) qui démarre au « Numéro de la première écriture » saisi au lancement (1 par défaut). Le plugin ne mémorise pas le dernier numéro d’un export à l’autre : pour enchaîner, saisissez le dernier numéro de l’export précédent + 1. Il est rappelé dans l’historique (« n° 251 → 312 »). Pour un FEC légal, exportez de préférence l’exercice entier en une seule fois.

DATEV : montants TTC, la TVA calculée par DATEV

Dans DATEV, le montant d’une écriture est toujours brut : c’est DATEV qui calcule la TVA, grâce au compte de vente à TVA automatique ou à la clé de taxe (BU-Schlüssel). Le plugin exporte donc chaque facture et chaque avoir au TTC, avec une ligne par compte de vente et par taux, sans ligne de TVA : les comptes de TVA (1776, 1771…) sont des comptes collectifs que DATEV refuse de mouvementer.

La table des comptes automatiques se modifie avec le filtre woo_accounting_export_datev_accounts. Belegfeld 1 ne garde que les lettres, chiffres et $ & % * + - / (36 caractères au plus) : DATEV refuse sinon la ligne.

DATEV : numéros de conseiller et de mandant

Le plugin ne connaît pas vos numéros DATEV. Valeurs par défaut : conseiller 1001, mandant 1, exercice au 1er janvier, comptes sur 4 chiffres. DATEV refuse un fichier dont les numéros ne sont pas ceux du mandant ouvert : renseignez-les avec le filtre woo_accounting_export_datev_header. La désignation du lot (« Bezeichnung ») vaut par défaut le nom de votre site.

add_filter( 'woo_accounting_export_datev_header', function ( array $header ) {
    $header['consultant_number'] = 12345;
    $header['client_number']     = 678;
    $header['fiscal_year_start'] = '20260101'; // AAAAMMJJ
    $header['account_length']    = 4;          // 4 à 8
    return $header;
} );

Xero : date, taux de taxe et fichiers de 300 lignes

Les lignes d’une même transaction partagent un intitulé unique, ce qui permet à Xero de les regrouper en un journal. La date est au format JJ/MM/AAAA par défaut (filtre woo_accounting_export_xero_date_format) ; la TVA étant déjà écrite sur ses comptes, le taux vaut « No VAT » (filtre woo_accounting_export_xero_tax_rate, selon la région de votre organisation Xero).

L’import de Xero accepte 300 lignes par fichier. Au-delà, l’export est découpé en fichiers …-1.csv, …-2.csv… livrés dans une archive ZIP, sans jamais couper un journal : importez-les l’un après l’autre.

QuickBooks : numéro et date

La colonne No. porte le numéro de l’écriture : QuickBooks regroupe en une écriture les lignes de même numéro, la facture et le règlement d’une commande restent donc distincts. La date est au format JJ/MM/AAAA ; pour un compte américain, passez-la en m/d/Y avec le filtre woo_accounting_export_quickbooks_date_format. QuickBooks rapproche les comptes par leur nom : vérifiez-les au premier import.

Zoho Books et Holded

Zoho Books : les lignes d’une même écriture partagent le même Journal Number, ce qui permet à Zoho de les regrouper. Lors du premier import, faites correspondre les colonnes dans l’assistant d’import des écritures manuelles.

Holded : les montants sont écrits avec une virgule décimale, comme l’attend Holded. Les colonnes facultatives Notes, Type of entry et Dotted sont laissées vides ou à 0. Les libellés sont en espagnol par défaut.

Logiciels qui importent directement le FEC

Le FEC, inclus dans la version gratuite, est accepté tel quel par plusieurs logiciels sans format dédié :

• Pennylane : import d’un FEC, en plus du format Pennylane dédié. L’outil de Pennylane attend la colonne ValidDate vide, alors que le FEC du plugin la remplit (une écriture datée compte comme validée). Si le rendu ne vous convient pas, videz cette colonne avant l’import ou utilisez le format Pennylane.
• Tiime Expert : import d’un FEC, à condition qu’un exercice soit ouvert sur la période.
• Cegid Loop : import d’un FEC en direct.

Odoo n’a pas de format de fichier unique pour l’import d’écritures : utilisez un export CSV simple (Sage ou EBP par exemple) et faites correspondre les colonnes dans l’assistant d’import d’Odoo.

Formats en bêta

DATEV, Xero, QuickBooks, SAP FI/CO, Pennylane, Zoho Books et Holded suivent les spécifications d’import publiées par ces éditeurs. Comme pour toute mise en place d’un nouvel import comptable, faites un premier essai avec un fichier de test avant la mise en production.

Protection des fichiers

• Un libellé commençant par =, +, - ou @ est préfixé d’une apostrophe pour ne pas être exécuté comme formule à l’ouverture dans un tableur.
• Les fichiers sont stockés dans wp-content/uploads/woo-accounting-export/, protégé par .htaccess, avec des noms non devinables, et ne se téléchargent que depuis l’historique (capacité et jeton de sécurité vérifiés).
• Sur un serveur Nginx, .htaccess est sans effet : ajoutez la règle location ~* /uploads/woo-accounting-export/ { deny all; }.