Comment exporter les factures PrestaShop au format CSV sans module ?

Utilisez le gestionnaire SQL intégré au back-office (Paramètres avancés → Base de données → Gestionnaire SQL). Créez une requête SELECT joignant les tables ps_order_invoice, ps_orders, ps_order_detail, ps_customer et ps_address, puis cliquez sur Exporter en CSV. Cette méthode fonctionne de PrestaShop 1.6 à 8.x sans installer de module tiers.

La requête SQL d'extraction de factures fonctionne-t-elle sur PrestaShop 8 ?

Oui. La structure des tables de facturation (ps_order_invoice, ps_orders, ps_order_detail) est restée stable depuis PrestaShop 1.6. Seul le préfixe de table peut différer si vous l'avez personnalisé à l'installation. Vérifiez votre préfixe dans app/config/parameters.php et adaptez la requête si nécessaire.

Comment filtrer l'export de facturation par date ou par statut de commande ?

Ajoutez une clause WHERE à la requête. Pour filtrer par date : WHERE oi.date_add BETWEEN '2026-01-01' AND '2026-03-31'. Pour n'inclure que les commandes payées : WHERE o.current_state IN (SELECT id_order_state FROM ps_order_state WHERE paid = 1). Les deux filtres peuvent être combinés avec AND.

Pourquoi certaines lignes apparaissent en double dans l'export SQL des factures ?

Les doublons proviennent généralement du LEFT JOIN sur ps_order_cart_rule : si une commande a plusieurs codes promo, chaque réduction génère une ligne supplémentaire par produit. Pour éviter cela, vous pouvez regrouper les réductions avec GROUP_CONCAT(ocr.name) et ajouter un GROUP BY sur les colonnes principales, ou retirer la jointure sur ps_order_cart_rule si les remises ne vous intéressent pas.

Est-il possible d'automatiser l'export des données de facturation PrestaShop ?

Oui, via un script PHP exécuté en cron qui se connecte à la base de données, exécute la requête et génère un fichier CSV. Vous pouvez aussi développer un module PrestaShop exposant un endpoint sécurisé par token et restriction IP, que votre logiciel comptable interroge automatiquement. Dans tous les cas, sécurisez l'accès aux fichiers générés car ils contiennent des données personnelles soumises au RGPD.

Comment inclure le pays et la devise dans l'export de facturation PrestaShop ?

Pour le pays, joignez la table ps_country_lang sur a.id_country avec la condition id_lang correspondant à votre langue. Pour la devise, ajoutez o.id_currency dans le SELECT et joignez ps_currency sur o.id_currency pour récupérer le code ISO (EUR, USD). C'est particulièrement important pour les boutiques multidevises ou à l'international.

Extraire les données de facturation PrestaShop via requête SQL

Pourquoi extraire les données de facturation par SQL

Le back-office PrestaShop permet d'exporter les commandes au format CSV, mais ce fichier reste limité : il ne croise pas les informations de facturation, les détails produits, les adresses clients et les remises en une seule vue. Pour alimenter un logiciel comptable, produire un reporting fiscal ou simplement auditer vos ventes, une requête SQL sur mesure est souvent la solution la plus rapide et la plus flexible.

PrestaShop intègre un gestionnaire de requêtes SQL directement dans le back-office (*Paramètres avancés → Gestionnaire SQL*), ce qui permet d'exécuter ces extractions sans accéder à phpMyAdmin ni ouvrir un terminal.

Structure des tables de facturation PrestaShop

Avant d'écrire la requête, il est essentiel de comprendre comment PrestaShop organise les données de facturation. Voici les tables principales impliquées :

TableRôle `ps_order_invoice`Facture : numéro, date, totaux HT/TTC, frais de port `ps_orders`Commande : référence, moyen de paiement, statut `ps_order_detail`Lignes de commande : produit, quantité, prix unitaire `ps_customer`Client : nom, prénom, email `ps_address`Adresse de facturation complète `ps_order_cart_rule`Codes promo et remises appliquées

Note : Le préfixe ps_ est celui par défaut. Si vous avez personnalisé le préfixe lors de l'installation (recommandé pour la sécurité), adaptez la requête en conséquence.

Requête SQL complète d'extraction

Cette requête joint l'ensemble des tables nécessaires pour obtenir une vue complète de chaque ligne de facturation :


SELECT
    oi.id_order_invoice       AS N_facture,
    oi.date_add               AS Date_facture,
    oi.id_order               AS N_commande,
    o.reference               AS Ref_commande,
    c.lastname                AS Nom,
    c.firstname               AS Prenom,
    c.email                   AS Email,
    CONCAT(
        a.address1,
        IF(a.address2 != '', CONCAT(' ', a.address2), ''),
        ' ', a.postcode,
        ' ', a.city
    )                         AS Adresse_facturation,
    a.country                 AS Pays,
    o.payment                 AS Moyen_paiement,
    od.product_name           AS Nom_produit,
    od.product_reference      AS Ref_produit,
    od.product_ean13          AS EAN13_produit,
    od.product_quantity       AS Quantite,
    od.unit_price_tax_excl    AS Prix_unitaire_HT,
    od.total_price_tax_incl   AS Total_ligne_TTC,
    oi.total_products         AS Total_produits_HT,
    (oi.total_paid_tax_incl
     - oi.total_paid_tax_excl) AS Montant_TVA,
    (oi.total_paid_tax_incl
     - oi.total_shipping_tax_incl) AS Total_produits_TTC,
    oi.total_shipping_tax_excl AS Frais_expedition_HT,
    oi.total_shipping_tax_incl AS Frais_expedition_TTC,
    oi.total_paid_tax_incl    AS Total_paye_TTC,
    ocr.name                  AS Nom_reduction,
    ocr.value                 AS Montant_reduction
FROM ps_order_invoice oi
LEFT JOIN ps_orders o
    ON oi.id_order = o.id_order
LEFT JOIN ps_order_detail od
    ON o.id_order = od.id_order
LEFT JOIN ps_customer c
    ON o.id_customer = c.id_customer
LEFT JOIN ps_address a
    ON o.id_address_invoice = a.id_address
LEFT JOIN ps_order_cart_rule ocr
    ON o.id_order = ocr.id_order
ORDER BY oi.date_add DESC;

Explications des jointures

**`ps_order_invoice → ps_orders`** : Lie chaque facture à sa commande. Une commande peut générer plusieurs factures (livraisons partielles).
**`ps_orders → ps_order_detail`** : Récupère chaque ligne produit de la commande. C'est une relation 1-N, donc la requête produit une ligne par produit commandé.
**`ps_orders → ps_customer`** : Identifie le client via `id_customer`.
**`ps_orders → ps_address`** : Utilise `id_address_invoice` (et non `id_address_delivery`) pour obtenir l'adresse de facturation.
**`LEFT JOIN ps_order_cart_rule`** : Récupère les éventuelles réductions. `LEFT JOIN` car toutes les commandes n'ont pas de code promo.

Utilisation dans le gestionnaire SQL du back-office

Rendez-vous dans **Paramètres avancés → Gestionnaire SQL**
Cliquez sur **Ajouter une nouvelle requête SQL**
Donnez un nom explicite (ex : *Export facturation complet*)
Collez la requête ci-dessus
Cliquez sur **Enregistrer** puis **Lancer**
Utilisez le bouton **Exporter en CSV** pour récupérer le fichier

Astuce : Le gestionnaire SQL de PrestaShop n'autorise que les requêtes SELECT. Aucun risque de modifier vos données par erreur.

Filtrer par période

Pour extraire uniquement les factures d'une période donnée (typiquement pour une déclaration trimestrielle de TVA), ajoutez une clause WHERE :


WHERE oi.date_add BETWEEN '2026-01-01 00:00:00'
                      AND '2026-03-31 23:59:59'
ORDER BY oi.date_add DESC;

Filtrer par statut de commande

Pour n'exporter que les commandes effectivement payées et éviter les paniers abandonnés ou les commandes annulées :


WHERE o.current_state IN (
    SELECT id_order_state
    FROM ps_order_state
    WHERE paid = 1
)
ORDER BY oi.date_add DESC;

Cette approche est plus robuste que de coder en dur les identifiants de statut, car elle s'adapte automatiquement aux statuts personnalisés marqués comme « payé ».

Adaptation pour PrestaShop 8.x

La structure des tables de facturation est restée stable de PrestaShop 1.6 à 8.x. Les principales différences à connaître :

**Préfixe de tables** : En PS 8.x, le préfixe personnalisé est encore plus recommandé. Vérifiez votre préfixe dans `app/config/parameters.php` (clé `database_prefix`).
**Champ `product_ean13`** : Renommé en `ean13` dans certaines versions intermédiaires de PS 1.7, puis toujours présent dans `ps_order_detail` en 8.x. Vérifiez avec `DESCRIBE ps_order_detail` si la colonne existe.
**Symfony et le nouveau back-office** : Le gestionnaire SQL est toujours disponible en 8.x, mais il se trouve désormais dans *Paramètres avancés → Base de données → Gestionnaire SQL*.
**Multidevise** : Si votre boutique gère plusieurs devises, ajoutez `o.id_currency` et joignez `ps_currency` pour afficher le code devise (EUR, USD…) dans votre export.

Bonnes pratiques pour l'export comptable

Automatiser l'extraction

Pour les boutiques à fort volume, l'export manuel devient fastidieux. Deux approches :

**Cron + script PHP** : Exécutez la requête via un script CLI qui génère un CSV déposé sur un espace sécurisé.
**Module dédié** : Développez un module PrestaShop qui expose un endpoint sécurisé (token + IP whitelistée) retournant le CSV, consommable par votre logiciel comptable.

Sécurité des données

Ne stockez jamais les exports contenant des données personnelles (noms, adresses, emails) dans un répertoire accessible publiquement.
Respectez le RGPD : les données de facturation doivent être conservées 10 ans (obligation légale française), mais les données personnelles associées peuvent être pseudonymisées après ce délai.
Dans le gestionnaire SQL, seuls les profils administrateurs y ont accès par défaut. Vérifiez vos permissions dans *Administration → Profils*.

Cohérence des montants

Attention aux arrondis TVA : PrestaShop peut calculer la TVA ligne par ligne ou sur le total. Le mode de calcul se configure dans *Commandes → Factures → Options de taxes*. Votre requête SQL reflète le résultat stocké, pas le mode de calcul. Si les montants ne correspondent pas à vos attentes, vérifiez ce paramètre.