Connecter Amazon FBA : synchroniser le stock FBA uniquement

Une connexion distincte d’Amazon SP-API qui réutilise les mêmes identifiants : collez les mêmes huit champs dans Integration, testez, vérifiez l’appariement des SKU, activez — seul le stock FBA entre.

C’est une deuxième connexion, distincte de la connexion Amazon SP-API : même compte vendeur, mêmes identifiants, autre tâche. La connexion Amazon FBA synchronise uniquement le stock qu’Amazon stocke et expédie pour vous (stock FBA) dans votre vue de stock. Elle n’importe pas de commandes et ne renvoie pas de fulfillment : commandes et expéditions restent du côté de la connexion Amazon SP-API. Si vous avez déjà cette connexion, aucun nouvel identifiant n’est nécessaire : réutilisez ici le même Seller ID, la paire LWA, le refresh token et les clés AWS.

Prérequis#

• Un compte vendeur Amazon avec accès à Seller Central, et du stock déjà envoyé en FBA (Fulfillment by Amazon).
• Prérequis impératif : votre app SP-API doit être autorisée avec le rôle Amazon Fulfillment. Sans ce rôle, les appels de stock FBA sont rejetés — c’est l’échec le plus fréquent, vérifiez donc le rôle avant de remplir quoi que ce soit.
• Les mêmes identifiants que la connexion Amazon SP-API : Seller ID, Marketplace ID, LWA Client ID et secret, refresh token, et une paire de clés d’accès AWS pour la signature SigV4. Si une connexion Amazon SP-API existe déjà, cet ensemble existe déjà : réutilisez-le.
• Sachez à quel marketplace appartient votre stock FBA : le Marketplace ID doit correspondre à ce site (États-Unis : ATVPDKIKX0DER).

Obtenir les identifiants#

1. Seller ID : dans Seller Central, allez à Settings → Account info et copiez le Merchant token. C’est votre Seller ID ; il commence par A.
2. Rôle Fulfillment : dans Seller Central, ouvrez votre app SP-API (Apps & Services → Develop apps) et confirmez qu’elle est autorisée pour le rôle Amazon Fulfillment. Si le rôle manque, ajoutez-le et autorisez-le maintenant : sans lui, le stock FBA est illisible.
3. Identifiants LWA : sur la même page de l’app, copiez le LWA Client ID (commence par amzn1.application-oa2-client.) et le LWA Client Secret.
4. Refresh token : autorisez l’app pour votre compte vendeur (Seller Central → Apps & Services → Authorize) et copiez le refresh token reçu. Il commence par Atzr|.
5. Clés AWS : dans la console AWS (IAM), créez ou copiez la paire de clés d’accès utilisée pour la signature SigV4 — l’ID de clé d’accès (commence par AKIA) et sa secret access key.
6. Role ARN (facultatif) : uniquement si vous signez via un rôle IAM assumé par STS, notez l’ARN de ce rôle (arn:aws:iam::…:role/…). Si vous signez directement avec la paire de clés, il n’en faut pas.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Amazon FBA → Nouvelle connexion.
2. Seller ID (Merchant token) — requis : le Merchant token de Seller Central → Settings → Account info. Il commence par A.
3. Marketplace ID — requis : l’ID du site auquel appartient votre stock FBA. Pour les États-Unis, ATVPDKIKX0DER ; pour les autres sites, consultez la documentation Amazon SP-API.
4. LWA Client ID — requis : le LWA Client ID de votre app SP-API, depuis Seller Central → Apps & Services → Develop apps. Il commence par amzn1.application-oa2-client.
5. LWA Client Secret — requis : le secret associé à ce Client ID, depuis la même page de l’app. Stocké comme secret, jamais réaffiché.
6. Refresh Token — requis : le refresh token obtenu en autorisant l’app pour votre compte vendeur. Il commence par Atzr|.
7. AWS Access Key ID — requis : l’ID de clé d’accès utilisé pour la signature SigV4. Il commence par AKIA.
8. AWS Secret Access Key — requis : le secret associé à cette clé d’accès. Stocké comme secret, jamais réaffiché.
9. IAM Role ARN (optional) — facultatif : à remplir uniquement si la signature passe par un rôle IAM assumé via STS (exemple : arn:aws:iam::123456789012:role/…). Laissez vide pour signer directement avec la paire de clés — vide est le cas normal.

Tester la connexion#

Lisez le résultat attentivement — il y a deux sortes de « réussi ». Sans identifiants, le test utilise un stock simulé (un petit ensemble fixe de SKU d’exemple) et annonce un succès de simulation : cela prouve seulement que les écrans fonctionnent, pas qu’Amazon est joignable. Avec les identifiants, le test échange votre refresh token contre un accès, signe la requête et vérifie réellement votre participation au marketplace auprès d’Amazon. Seul un succès sans la mention de simulation compte comme une vraie connexion — remplissez les identifiants et retestez avant d’activer.

Mapping / choisir un modèle#

Sur cette connexion, il n’y a pas de mapping de commandes — le mapping ne concerne que le stock. Le stock FBA est apparié par SKU vendeur : chaque SKU Amazon des récapitulatifs de stock FBA est associé au produit portant le même SKU parmi vos produits en stock, et ses quantités FBA se rattachent à ce produit dans la vue de stock partagée. Avant d’activer, vérifiez l’aperçu du mapping : un SKU Amazon sans produit associé n’a nulle part où enregistrer ses quantités — associez d’abord ces SKU aux bons produits. Ne renommez pas les SKU d’un seul côté, sinon l’appariement se casse à la prochaine synchronisation.

Activer#

Après activation, Integration synchronise vos récapitulatifs de stock FBA selon la fréquence définie et tient les quantités FBA à jour dans la vue de stock partagée, pour que la visibilité du stock et les rappels de réassort incluent ce qu’Amazon stocke pour vous. Rien d’autre ne change : aucune commande FBA n’est importée et aucun fulfillment n’est renvoyé — ce trafic reste sur la connexion Amazon SP-API. Surveillez les premières synchronisations dans Runs / Logs et contrôlez quelques SKU dans Seller Central avant de faire confiance aux chiffres.

FAQ#

Les appels de stock FBA sont rejetés — le rôle Amazon Fulfillment manque à l’app

Pourquoi : c’est l’échec numéro un de cette connexion. Les identifiants peuvent être parfaitement valides — le même ensemble fonctionne pour la connexion Amazon SP-API — mais l’app SP-API n’a jamais été autorisée pour le rôle Amazon Fulfillment, et Amazon refuse les lectures de stock FBA sans ce rôle.

Solution : dans Seller Central, ouvrez votre app SP-API (Apps & Services → Develop apps), ajoutez le rôle Amazon Fulfillment et terminez l’autorisation pour votre compte vendeur. Si l’autorisation émet un nouveau refresh token, collez-le aussi dans cette connexion. Puis retestez.

Le test a réussi, mais le stock FBA réel n’apparaît jamais

Pourquoi : le succès que vous avez vu était celui de la simulation. Sans identifiants, le test utilise un stock simulé — un petit ensemble fixe de SKU d’exemple — et annonce un succès sans contacter Amazon ; aucun stock réel ne peut en découler.

Solution : remplissez tous les champs d’identifiants (de Seller ID à AWS Secret Access Key), enregistrez et retestez. Seul un succès avec de vrais identifiants — et sans mention de simulation — signifie qu’Amazon a réellement été joint. Activez ensuite et vérifiez la première synchronisation dans Runs / Logs.

Certains SKU ne synchronisent aucune quantité

Pourquoi : le stock FBA se rattache par SKU vendeur. Si un SKU Amazon n’est pas associé à un produit parmi vos produits en stock — ou si le SKU a été renommé d’un seul côté — ses quantités n’ont aucun produit où se rattacher et sont ignorées.

Solution : ouvrez l’aperçu du mapping, repérez les SKU Amazon non associés et associez chacun au bon produit. Gardez ensuite des noms de SKU identiques des deux côtés, relancez une synchronisation et vérifiez que les quantités se rattachent.

Le stock vient d’un autre marketplace

Pourquoi : le Marketplace ID saisi ne correspond pas au site auquel appartient réellement votre stock FBA. La connexion peut passer le test, mais Amazon ne renvoie que le stock FBA du marketplace indiqué.

Solution : confirmez le site de votre stock FBA et saisissez le Marketplace ID de ce site — ATVPDKIKX0DER pour les États-Unis ; pour les autres sites, cherchez l’ID dans la documentation Amazon SP-API. Enregistrez, lancez une synchronisation et vérifiez que le bon stock arrive.