Connecteur Amazon pour Dolibarr : commandes, FBA, stock, suivi et règlements

Reliez Dolibarr à l'API Selling Partner d'Amazon et faites circuler l'information dans les deux sens. Les commandes expédiées par vous ou par Amazon deviennent des commandes, des expéditions et des factures ; le stock et les numéros de suivi repartent vers Amazon ; les règlements et les retours sont rapportés ligne à ligne. Chaque échange laisse une file d'attente dont les lignes en erreur se rejouent seules. Un mode simulation permet de tout régler et de tout démontrer sans compte Amazon. 

Pour qui ? Vendeurs Amazon qui gèrent leur activité dans Dolibarr : marques, distributeurs, revendeurs multi-pays, e-commerçants en FBM comme en FBA, et les intégrateurs qui les accompagnent. Une place de marché ou vingt, un compte vendeur ou plusieurs, le principe reste le même.

Comptes vendeurs et instances

• Un compte vendeur porte les identifiants d'une application Amazon, la région de l'API et les valeurs par défaut : client de repli, commercial, entrepôt, banque, produit de port.
• Une instance relie ce compte à une place de marché : c'est elle qui porte la devise, les entrepôts, le workflow, la politique de stock et la TVA.
• 23 places de marché installées avec leur identifiant réel, sur les trois régions : Amérique du Nord, Europe, Extrême-Orient.
• Plusieurs comptes vendeurs et autant d'instances que nécessaire, chacun avec ses propres réglages.
• Un test de connexion demande un jeton puis lit les places de marché du compte, et distingue un problème d'identifiants d'un problème de rôle ou de région.

Import des commandes

• Import des commandes expédiées par le vendeur (FBM) et des commandes expédiées par Amazon (FBA), pour que le chiffre d'affaires soit complet.
• L'acheteur, l'adresse de livraison, les lignes, les montants, la TVA, les frais de port et la fenêtre d'expédition sont rapportés.
• Le connecteur repart toujours de la dernière synchronisation. Une commande modifiée chez Amazon est reprise.
• Une commande annulée est close sans rien créer ; une commande en attente chez Amazon est laissée de côté puis reprise automatiquement.
• Recherche et filtres sur le numéro de commande, l'acheteur, la ville, le suivi, le statut, le canal d'expédition et l'état du workflow.
• La fiche montre en vis-à-vis ce qui vient d'Amazon et ce qui existe dans Dolibarr, avec des liens directs vers la commande, l'expédition et la facture.

Un workflow en dix interrupteurs

• Dix interrupteurs décident, instance par instance, de ce qui est créé : créer le client, valider la commande, créer l'expédition, la valider, créer la facture, la valider, enregistrer le règlement, envoyer le stock, envoyer le suivi.
• Une étape désactivée est simplement sautée : la commande reste au stade atteint et se termine à la main.
• Chaque étape franchie est écrite immédiatement : une exécution interrompue reprend où elle s'est arrêtée, jamais au début.
• Un acheteur inconnu devient un tiers, ou tombe sur le client de repli du compte, au choix.
• Une commande dont une ligne porte une offre non associée est mise en erreur plutôt que créée de travers : on associe, on relance, elle repart.
• Le règlement est enregistré sur le compte bancaire du compte vendeur, avec le numéro de commande Amazon en référence.

Offres et association aux produits

• Import des offres du vendeur : SKU, ASIN, titre, marque, code-barres, prix, quantité, canal d'expédition et statut.
• Association automatique au produit de Dolibarr par référence, code-barres, champ complémentaire Amazon SKU puis libellé.
• Une correspondance trouvée sur le seul libellé est marquée douteuse plutôt qu'appliquée en silence ; plusieurs produits homonymes n'associent rien.
• Association manuelle directement dans la liste, sans quitter l'écran, et bouton « associer tout ce qui peut l'être ».
• Une offre qui ne doit jamais être traitée se met en ignorée ; création automatique des produits manquants en option.
• La fiche produit de Dolibarr rappelle les offres Amazon qui lui sont rattachées.

Stock dans les deux sens

• Envoi du stock à Amazon avec cinq méthodes : quantité fixe, stock réel, stock virtuel, stock réel moins une marge, pourcentage du stock réel.
• Un plafond facultatif et un délai de traitement annoncé accompagnent chaque envoi.
• Un aperçu montre, offre par offre, la quantité qui serait envoyée : la règle se vérifie avant d'être déclenchée.
• Dans l'autre sens, l'inventaire détenu par Amazon est lu et recopié dans un entrepôt dédié, par mouvement de stock : le stock de Dolibarr devient complet.
• Les numéros de suivi des expéditions validées repartent vers Amazon, ce qui marque la commande comme expédiée et déclenche le paiement du vendeur.

Règlements et retours

• Import des mouvements financiers d'Amazon, regroupés par période : ventes, TVA, commissions, frais FBA, remboursements et abonnement.
• Cinq totaux par règlement — solde, ventes, frais, remboursements, autres — et le détail ligne à ligne, relié aux commandes connues.
• La réponse à la question des comptables : pourquoi le virement d'Amazon ne correspond pas au chiffre d'affaires.
• Import des retours clients traités par Amazon : identifiant, commande, SKU, état de la marchandise, motif, centre de traitement.
• Un retour revendable se remet en stock en un clic, par un mouvement dans l'entrepôt d'Amazon.

Files d'attente et rejeu

• Chaque échange ouvre une file d'attente avec une ligne par enregistrement rapporté et sa charge utile.
• Une ligne en erreur garde son contenu et son motif : on corrige la cause, puis on rejoue les erreurs sans rien redemander à Amazon.
• États clairs : en cours, terminée, partielle, en erreur, rien à faire. Avancement, durée et origine — manuelle, planifiée, automatique, rejeu.
• Neuf tâches planifiées installées : commandes, workflow, suivi, stock, inventaire Amazon, offres, règlements, retours, entretien.
• Un script en ligne de commande lance les mêmes traitements pour un ordonnanceur externe ou une reprise.
• Un journal des appels conserve l'opération, le code HTTP, la durée et un extrait de la requête et de la réponse.

Sécurité et données personnelles

• Les trois identifiants Amazon sont stockés chiffrés et ne sont jamais réaffichés en clair.
• Ils n'apparaissent jamais dans le journal : l'appel qui échange le jeton n'enregistre que sa nature. Le journal peut être ouvert à un support technique.
• Un identifiant laissé vide lors d'une modification conserve la valeur enregistrée ; toute modification invalide le jeton mis en cache.
• Les données des acheteurs sont effacées automatiquement après un délai que vous fixez, comme Amazon l'exige. Les montants et les pièces comptables sont conservés.
• Sept droits séparés : consulter, créer, supprimer, synchroniser, exécuter le workflow, consulter le journal, configurer.
• Le mode simulation fabrique localement commandes, offres, inventaire, mouvements financiers et retours à partir de vos propres produits : rien ne sort du serveur, et le résultat est reproductible.

Informations techniques

• Compatible Dolibarr 16 et supérieur (testé sur 23.x), PHP 7.4 à 8.4, MySQL/MariaDB, multi-société.
• Modules requis : Produits, Commandes, Factures, Tiers. Stock, Expéditions, Banques et Projets sont utilisés s'ils sont actifs.
• Installation par le dépôt de module standard, aucune modification du cœur de Dolibarr.
• 13 tables dédiées, client SP-API complet avec pagination, reprise sur limitation de débit, flux et rapports compressés.
• 5 langues : français, anglais, espagnol, allemand, italien. Documentation PDF incluse, support NextGestion.

Démo du module Amazon Connector
Login : demo
Mot de passe : demo