RUN-TIGER

Contexte

RUN-TIGER vend dans le monde entier via Amazon. Pour la tenue des comptes et le suivi des stocks, les ventes et remboursements doivent être représentés dans Minimax sous une forme structurée et auditable. Amazon fournit des rapports d'export, mais ils nécessitent une normalisation, une agrégation et une logique spécifique à la comptabilité avant de pouvoir être publiés en tant que documents ERP.

Problématique

• La facturation par commande n'est pas opérationnellement faisable au volume Amazon.
• La comptabilité nécessite une agrégation mensuelle et une séparation par pays/marché.
• L'OSS UE nécessite un filtrage strict et une gestion de TVA spécifique par pays.
• Les exports hors UE nécessitent un traitement à TVA nulle et des descriptions de facture conformes.
• Minimax nécessite des références client/article stables pour une publication déterministe.

Objectifs du projet

• Créer des factures récapitulatives mensuelles Minimax à partir des exports Amazon.
• Agréger les lignes par SKU (plus les lignes d'expédition le cas échéant).
• Gérer les remboursements comme documents séparés utilisant des quantités négatives.
• Provisionner les données de référence Minimax manquantes (clients, articles de substitution) si nécessaire.
• Prendre en charge plusieurs formats d'export (EU OSS, US, CA) avec un workflow léger.

Aperçu de la solution

Nous avons implémenté une petite application basée sur l'upload qui :

• Accepte les exports CSV Amazon spécifiques aux régions (EU/US/CA) via une interface minimale.
• Normalise et agrège les lignes de rapport par pays/marché et SKU.
• Crée ou réutilise des clients Minimax par marché (ex. `am_XX`).
• S'assure que les SKU existent comme articles Minimax (crée des substituts pour les SKU inconnus).
• Publie des factures émises Minimax pour le mois précédent avec devise/taux de change corrects et logique de TVA.

Architecture et approche technique

Entrées et analyse

• Export EU OSS : filtre selon le schéma éligible, exclut les acheteurs avec numéro de TVA, groupe par pays d'arrivée.
• Exports US/CA : analyse les lignes de type règlement et agrège ventes/remboursements par SKU.

Modèle d'agrégation

• Les ventes et remboursements sont séparés en différentes catégories.
• Les totaux de SKU sont agrégés en une seule ligne de facture Minimax par SKU.
• Les crédits d'expédition peuvent être mappés vers une ligne de SKU d'expédition dédiée.

Publication Minimax

• Crée/réutilise des clients par marché (`am_XX`).
• Récupère les taux de change pour la date de fin de période et applique le taux de change de facture.
• Publie des factures émises `InvoiceType = R` avec une fenêtre de période mensuelle (`DateTransactionFrom` → `DateTransaction`).
• Applique les règles de TVA par flux (OSS UE vs exports) et assigne un entrepôt pour le suivi d'inventaire.

Stack technologique

• PHP (interface upload, analyse CSV, agrégation)
• Minimax OAuth2 + REST API
• Dépendances Composer (PhpSpreadsheet disponible)
• Protection d'accès de base via `.htaccess` / `.htpasswd`

Résultats et impact

• Documents Minimax mensuels clairs au lieu du bruit par commande.
• Capture cohérente des ventes et remboursements à travers les régions.
• Comptabilité plus rapide et workflows de stock/comptabilité plus fiables.
• Les données de référence manquantes (client/SKU) ne bloquent plus la publication.

Résumé

Cet outil convertit les exports de marketplace Amazon en factures récapitulatives mensuelles Minimax, gérant les formats spécifiques aux régions, le filtrage OSS UE, la logique de devise/taux de change, les règles de TVA et le provisionnement de données de référence—conçu pour prendre en charge la comptabilité e-commerce mondiale et le suivi des stocks.