DataFirefly Amazon Connector : connecter PrestaShop à Amazon Seller Central

Installation

Installez le module depuis Modules > Gestionnaire de modules > Installer un module en envoyant le fichier ZIP. L’extension PHP cURL est requise.

À l’installation, le module crée ses tables, un onglet Amazon Connector dans le menu Vendre, un transporteur « Amazon » réservé aux commandes importées (il n’apparaît jamais au client) et deux statuts de commande : « Amazon : en attente d’expédition » et « Amazon FBA : expédiée ».

Préparer votre compte Amazon

Le module se connecte à votre compte vendeur avec votre propre application privée Selling Partner API. Il vous faut un compte Seller Central professionnel.

1. Dans Seller Central, ouvrez Applications et services > Développer des applications et inscrivez-vous comme développeur privé si ce n’est pas déjà fait.
2. Créez une application et demandez les rôles nécessaires aux fonctions que vous utiliserez : Product Listing et Pricing pour le catalogue, Inventory and Order Tracking pour les commandes, Direct-to-Consumer Shipping (Restricted) pour recevoir l’adresse de livraison et l’e-mail de l’acheteur, Amazon Fulfillment pour le stock FBA, Finance and Accounting pour les remboursements, Tax Invoicing pour l’envoi des factures.
3. Autorisez l’application sur votre propre compte pour obtenir un refresh token, et notez l’identifiant client LWA et le secret client.
4. Relevez votre Merchant Token dans Paramètres > Informations sur le compte.

Connexion et marketplaces

Dans Amazon Connector > Réglages, choisissez la région (Europe, Amérique du Nord ou Extrême-Orient), saisissez le client LWA, le secret, le refresh token et le Merchant Token, puis enregistrez. Les secrets sont chiffrés en base ; laissez les champs vides pour conserver les valeurs enregistrées.

Dans le tableau de bord, cliquez sur Tester la connexion. Les marketplaces de votre compte apparaissent dans l’onglet Marketplaces, désactivées par défaut. Pour chacune, réglez :

• l’activation ;
• la langue des contenus envoyés (titre, description) ;
• les prix TTC ou HT, selon l’usage du pays ;
• la synchronisation des prix, à désactiver si vous utilisez un repricer Amazon ;
• la majoration en pourcentage, le montant fixe et l’arrondi (aucun, x,99, x,90, entier).

Tâche cron

La synchronisation tourne par tâche cron, idéalement toutes les 5 à 15 minutes. Le tableau de bord affiche l’URL sécurisée par jeton et la commande en ligne de commande :

php /chemin/vers/modules/dfamazonconnector/cron.php --shop=1

À chaque passage, le module importe les commandes, confirme les expéditions, envoie les factures et annulations, lit les remboursements et le stock FBA, puis envoie les annonces, stocks et prix en attente sous forme de flux groupés. Un bandeau rouge s’affiche dans le module si la tâche n’a pas tourné depuis plus d’une heure. Le bouton Nouveau jeton invalide l’ancienne URL.

Correspondance des catégories

La correspondance n’est utile que pour créer de nouvelles fiches sur Amazon. Un produit vendu sur un ASIN existant, ou rattaché par son EAN, n’a besoin que d’une offre.

Dans l’onglet Correspondance des catégories, choisissez une catégorie PrestaShop et un type de produit Amazon (recherche par mots-clés intégrée). Un produit utilise la correspondance de sa catégorie par défaut ou, à défaut, celle du parent le plus proche.

• Browse node : le nœud de navigation Amazon, facultatif selon les types de produit.
• Thème de variation : par exemple SIZE_NAME/COLOR_NAME. Renseigné, il regroupe les déclinaisons en famille parent-enfant ; vide, chaque déclinaison est publiée comme un produit indépendant.
• Attributs de déclinaison et Caractéristiques : associent un attribut Amazon à un groupe d’attributs ou à une caractéristique PrestaShop.
• Attributs fixes : valeurs envoyées telles quelles, au format Listings Items. Variables disponibles : {marketplace_id}, {language_tag}, {currency}, {reference}, {ean13}, {mpn}, {brand}.

Le bouton Attributs obligatoires lit le schéma du type de produit chez Amazon et liste les attributs que le module ne remplit pas seul. Pour chacun, choisissez une source (valeur fixe, caractéristique, attribut de déclinaison) puis Appliquer : les champs JSON sont complétés automatiquement.

Publier les produits

Depuis la fiche produit

L’onglet Modules de la fiche produit contient un bloc Amazon :

• Vendre sur Amazon active le produit.
• Mode de publication : automatique, offre sur un produit existant (ASIN ou EAN) ou création de la fiche complète.
• Expédition : par vous (FBM) ou par Amazon (FBA).
• ASIN, type de produit, état et prix Amazon fixe remplacent les valeurs par défaut pour ce produit.
• Attributs supplémentaires : JSON fusionné après les attributs fixes de la catégorie ; une valeur null retire un attribut.
• Marketplaces : décochez un pays pour retirer le produit de ce marketplace.

Le tableau « Ce qui sera envoyé à Amazon » montre, par déclinaison et par pays, le prix, le prix promo et ses dates, le prix minimum, le prix Business et la quantité. Quatre actions sont disponibles : Vérifier avec Amazon (validation sans publication, erreurs affichées attribut par attribut), Envoyer maintenant, Ajouter à la prochaine synchro et Actualiser le statut.

En masse

L’onglet Produits liste le catalogue avec le statut de chaque produit par pays (actif, en cours, inactif, erreur). Filtrez par nom, catégorie ou état, cochez les produits ou l’option « Tous les produits correspondant au filtre », puis appliquez une action : activer et publier, republier, envoyer les prix, envoyer les quantités, désactiver (quantité 0) ou supprimer d’Amazon.

Annonces déjà présentes sur Amazon

Le bouton Relier les annonces Amazon existantes du tableau de bord demande à Amazon le rapport de vos annonces. Au passage suivant du cron, chaque SKU est rattaché au produit PrestaShop qui porte le même SKU, la même référence ou le même EAN. Les SKU non trouvés sont listés dans le journal.

SKU Amazon

Le SKU est créé à la première publication selon le réglage choisi : référence, EAN13 ou modèle (par défaut PS{id_product}-{id_product_attribute}). Un SKU existant ne change jamais, même si la référence évolue.

Prix

Le prix est calculé dans la devise du marketplace avec le groupe de prix choisi, puis la majoration, le montant fixe et l’arrondi du pays sont appliqués. Options de l’onglet Réglages :

• Appliquer les réductions de la boutique : prix spécifiques et règles catalogue intégrés au prix Amazon.
• Envoyer les réductions en prix promo Amazon : le prix normal reste le prix de référence et la réduction devient un prix promo avec les dates de la réduction PrestaShop. Une réduction créée, modifiée ou supprimée met à jour Amazon immédiatement ; les promotions datées et les règles catalogue sont revérifiées chaque nuit.
• Marge minimale sur prix d’achat : envoie un prix minimum (prix d’achat converti, plus la marge, TVA du pays incluse) qui empêche un repricer de vendre en dessous.
• Prix Amazon Business : le prix du groupe client choisi devient le prix Business, et ses réductions par quantité deviennent des paliers (5 au maximum). Réservé aux vendeurs inscrits à Amazon Business.

Les mises à jour de prix ne touchent que les offres gérées par le module : une offre créée à la main dans Seller Central pour une autre audience est conservée.

Stock et FBA

Chaque mouvement de stock PrestaShop met le SKU en file d’envoi. Réglages disponibles : stock de sécurité (unités gardées hors d’Amazon), quantité maximale, délai de préparation, quantité 0 pour les produits désactivés et resynchronisation complète chaque nuit après 3 h.

Les produits en FBA ne reçoivent pas de quantité depuis PrestaShop. L’option Lire le stock FBA récupère chaque heure la quantité disponible dans les entrepôts Amazon, visible dans la fiche produit ; Copier le stock FBA dans PrestaShop l’applique au stock de la boutique pour les produits en FBA.

Commandes

Les commandes sont lues avec l’API Orders v2026-01-01 depuis la date de départ configurée. Une commande en attente de paiement est mémorisée sans être créée ; elle est importée dès qu’Amazon la passe à expédier.

Chaque commande importée crée ou réutilise un client invité (un par acheteur ou un client unique, au choix), une adresse « Amazon + numéro de commande » et une commande PrestaShop avec le transporteur Amazon, les prix et frais de port Amazon, le numéro de commande Amazon en identifiant de transaction et, en option, la date d’achat Amazon. Le stock est décrémenté comme pour une vente de la boutique.

Les commandes FBA sont importées une fois expédiées, au statut « Amazon FBA : expédiée ». L’option « Les commandes FBA ne modifient pas le stock boutique » remet les quantités en stock après la création.

L’onglet Commandes liste toutes les commandes Amazon avec filtres « À expédier », « Demandes d’annulation », « Remboursées », « Non importées ». Une commande non importée (SKU inconnu, devise ou pays non configuré) affiche la cause et un bouton Réessayer.

Expéditions

Choisissez dans les réglages les statuts qui confirment l’expédition (par exemple Expédié). Quand une commande Amazon passe à l’un de ces statuts, le module envoie à Amazon le code transporteur, le numéro de suivi et la date d’expédition. Si le numéro de suivi n’est pas encore saisi, il attend jusqu’à une heure avant de confirmer sans suivi.

Le tableau de correspondance des transporteurs associe chaque transporteur PrestaShop à un code transporteur Amazon. Les commandes importées utilisent le transporteur Amazon : changez le transporteur de la commande avant l’expédition pour que le bon code soit envoyé. Le bloc Amazon de la fiche commande propose aussi un bouton Confirmer l’expédition maintenant.

Factures

Si vous êtes inscrit au service de calcul de TVA d’Amazon avec l’option d’envoi de vos propres factures, activez Envoyer les factures PrestaShop à Amazon. Après la confirmation d’expédition, la facture PDF de la commande est envoyée avec son numéro, le total et le montant de TVA. Le statut (envoyée, en attente, rejetée) apparaît dans la liste et dans la fiche commande.

Annulations

Quand un acheteur demande l’annulation d’une commande non expédiée, la commande est marquée en rouge dans la liste et dans sa fiche, avec le motif donné par l’acheteur. N’expédiez pas : annulez la commande depuis le bloc Amazon en choisissant le motif, ou activez l’option Annuler sur Amazon quand la commande est annulée dans PrestaShop. Une annulation demandée par l’acheteur part avec le motif BuyerCanceled et ne pénalise pas votre taux d’annulation.

À l’inverse, une commande annulée côté Amazon passe au statut d’annulation choisi dans PrestaShop, sans e-mail au client.

Remboursements

Avec l’option Lire les remboursements Amazon, les remboursements effectués dans Seller Central sont lus via l’API Finances. Chacun est noté dans la note privée de la commande avec la date, les articles et le montant net. Quand toutes les unités sont remboursées, la commande passe au statut choisi (Remboursé par défaut). Le montant affiché est le montant net imputé sur votre compte Amazon, après les frais remboursés.

Tableau de bord, alertes et journal

Le tableau de bord présente les annonces actives et en erreur, les commandes des dernières 24 heures et des 30 derniers jours, les tâches en attente, la dernière synchronisation, les erreurs Amazon les plus fréquentes regroupées par code et les derniers flux envoyés.

L’e-mail d’alerte quotidien est envoyé après 8 h aux destinataires choisis, uniquement s’il y a une action à mener : demandes d’annulation, commandes non confirmées plus de 2 jours après l’achat, commandes non importées, factures rejetées, annonces en erreur, flux rejetés, cron arrêté. Le bouton Envoyer un e-mail de test vérifie la configuration.

L’onglet Journal conserve chaque opération (flux, commandes, expéditions, remboursements, FBA, erreurs) avec le détail technique, filtrable par niveau et par canal. La durée de conservation se règle dans les réglages.

Dépannage

Le test de connexion échoue

Vérifiez la région choisie, le client LWA, le secret et le refresh token. Un refresh token correspond à une application et à un compte : régénérez-le après toute modification des rôles de l’application.

Une annonce est en erreur

Ouvrez la fiche produit : les erreurs Amazon s’affichent sous chaque annonce. Le code 90220 signale un attribut obligatoire manquant, à compléter dans la correspondance de catégorie ou dans les attributs supplémentaires du produit. Utilisez Vérifier avec Amazon pour valider la correction avant l’envoi.

Une commande n’est pas importée

Le motif est affiché dans l’onglet Commandes. Le cas le plus fréquent est un SKU Amazon qui ne correspond à aucun produit : reliez les annonces existantes ou corrigez la référence, puis cliquez sur Réessayer. Vérifiez aussi que la devise et le pays de livraison sont actifs dans PrestaShop.

Le stock ou les prix ne se mettent pas à jour

Contrôlez la dernière synchronisation dans le tableau de bord et le journal. Les mises à jour partent au passage suivant du cron et Amazon les traite en quelques minutes. Pour forcer un envoi complet, utilisez Renvoyer toutes les quantités.

Compatibilité

• PrestaShop 8.0 à 9.x, le même ZIP couvre les deux branches.
• Multiboutique et multilingue.
• Régions Amazon Europe, Amérique du Nord et Extrême-Orient.
• Architecture ModuleAdminController, sans dépendance Composer.
• Interface disponible en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais.