ZEMA

Contexte

ZEMA gère deux boutiques en ligne et a besoin d'exports comptables cohérents. Le workflow requis était un fichier CSV avec un schéma stable, délimiteur point-virgule et encodage compatible Excel, plus des liens d'accès direct vers WooCommerce, Minimax et les processeurs de paiement.

Problématique

• La comptabilité a besoin d'un CSV consolidé avec des colonnes et un encodage prévisibles.
• Les exports doivent être filtrables par plage de dates payées, statut de commande et méthode de paiement.
• Les références de facture Minimax doivent être incluses lorsque les commandes ont déjà été exportées.
• Les transactions doivent être traçables vers les tableaux de bord des fournisseurs (Stripe/PayPal/Bankart).
• Les volumes de commandes importants nécessitent une pagination déterministe.

Aperçu de la solution

Nous avons construit un outil interne sécurisé qui :

• Sélectionne l'une des deux boutiques WooCommerce et une période d'export.
• Récupère toutes les commandes payées via l'API REST WooCommerce avec support de pagination.
• Extrait les métadonnées d'export Minimax depuis les méta de commande (ex. `_minimax_exported`, `f_IssuedInvoiceId`).
• Génère un CSV prêt pour la comptabilité (UTF-8 BOM, délimiteur `;`) diffusé via `php://output`.

Architecture et approche technique

Récupération WooCommerce

• Utilise le client PHP WooCommerce (`automattic/woocommerce`) contre `wc/v3`.
• Filtre par fenêtre de date payée (`paid_after`, `paid_before`).
• Itère les pages selon l'en-tête de réponse `x-wp-totalpages`.

Mapping d'export

• Mappe id/statut de commande, détails de facturation, totaux, horodatages et méthode de paiement.
• Construit l'URL d'édition admin WooCommerce par commande.
• Si l'id de facture Minimax existe, construit un lien direct vers l'interface Minimax.
• Si l'id de transaction existe, construit un lien fournisseur (Stripe/PayPal/Bankart) le cas échéant.

Sortie CSV

• Écrit l'UTF-8 BOM pour la compatibilité tableur.
• Utilise le délimiteur point-virgule pour les imports comptables.
• Diffuse les lignes pour éviter une utilisation mémoire élevée.

Stack technologique

• PHP
• WooCommerce REST API + client PHP WooCommerce
• Protection d'accès de base

Résultats et impact

• La comptabilité obtient un CSV cohérent et prêt à l'import depuis n'importe quelle boutique sur demande.
• Rapprochement plus rapide grâce aux liens d'accès direct (WooCommerce, Minimax, tableau de bord paiement).
• Réduction du travail manuel et diminution des erreurs de comptabilité.

Résumé

Une petite application d'export interne qui récupère les commandes WooCommerce payées, les enrichit avec des références Minimax et de paiement, et génère un CSV prêt pour la comptabilité—conçu pour les opérations multi-boutiques et les workflows de rapprochement.