Connecter Amazon SP-API : recevoir les commandes, renvoyer le fulfillment

Obtenez Seller ID, identifiants LWA et refresh token dans Seller Central, ajoutez les clés de signature AWS IAM, collez les huit champs dans Integration, testez, mappez, activez.

Le connecteur Amazon SP-API importe vos commandes Amazon dans OMS et renvoie fulfillment, produits et stock vers Amazon ; il peut aussi importer les retours. Il vise les commandes expédiées par le vendeur (MFN). Une connexion couvre un compte vendeur et un marketplace.

Prérequis#

• Un compte vendeur Amazon avec accès à Seller Central et des commandes MFN.
• Droit dans Seller Central de développer des apps et d’autoriser votre app (Apps & Services → Develop apps).
• Un compte AWS avec accès IAM, pour créer une clé d’accès et attacher la politique IAM SP-API de signature.
• Sachez à quel marketplace appartient votre boutique : le Marketplace ID doit correspondre à ce site (États-Unis : ATVPDKIKX0DER).

Obtenir les identifiants#

1. Étape 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. Étape 1 — Identifiants de l’app : dans Seller Central, allez à Apps & Services → Develop apps, ouvrez votre app et copiez le LWA Client Identifier (commence par amzn1.application-oa2-client.) et le LWA Client secret.
3. Étape 1 — Refresh token : autorisez votre app pour votre compte vendeur et copiez le refresh token reçu. C’est un token longue durée, qui commence par Atzr|.

1. Étape 2 — Clé d’accès AWS : dans la console AWS, allez à IAM → Security credentials et créez une clé d’accès. L’ID commence par AKIA.
2. Étape 2 — Clé secrète : copiez la AWS secret access key sur la même page. Elle n’est affichée qu’une fois.
3. Étape 2 — Politique IAM : vérifiez que l’utilisateur ou le rôle IAM de la clé a la politique IAM SP-API attachée ; sans elle, la signature passe mais Amazon renvoie 403.
4. Étape 2 — Role ARN (facultatif) : si vous signez via un rôle IAM inter-compte, notez son role ARN. Laissez de côté si vous signez directement avec la clé d’accès.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Amazon SP-API → 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 de votre boutique. Pour les États-Unis, ATVPDKIKX0DER ; pour les autres sites, consultez la documentation Amazon SP-API.
4. LWA Client ID — requis : le LWA Client Identifier de Seller Central → Apps & Services → Develop apps. Il commence par amzn1.application-oa2-client.
5. LWA Client secret — requis : le secret de la même page Develop apps. Chiffré au repos, jamais réaffiché.
6. Refresh token — requis : le token de rafraîchissement longue durée reçu lors de l’autorisation de l’app. Il commence par Atzr|.
7. AWS access key ID — requis : l’ID de clé d’accès IAM utilisé pour la signature SigV4. Il commence par AKIA.
8. AWS secret access key — requis : le secret associé à cette clé d’accès, copié depuis IAM → Security credentials. Il n’a été affiché qu’une fois.
9. IAM role ARN — facultatif : l’ARN d’un rôle IAM inter-compte. Renseigné, la signature assume d’abord ce rôle via STS pour des identifiants temporaires ; vide, la clé d’accès signe directement.

Tester la connexion#

Le test a deux niveaux : connectivité (autorisation LWA et signature SigV4) et aperçu d’une commande réelle. S’il n’y a pas encore de commande, passez d’abord une commande test sur Amazon. En cas d’échec, notez l’erreur exacte et consultez la FAQ.

Mapping / choisir un modèle#

Choisissez le modèle standard Amazon SP-API. Il mappe numéro de commande, SKU de ligne, quantités, adresse de livraison et statut de fulfillment pour les commandes MFN. Vérifiez l’aperçu avec une commande réelle avant l’activation, surtout l’appariement des SKU.

Activer#

Après activation, Integration récupère les nouvelles commandes MFN et les retours selon la fréquence définie, et renvoie le fulfillment avec suivi, ainsi que les mises à jour produits et stock, vers Amazon.

FAQ#

Le test échoue avec 403

Pourquoi : c’est le plus souvent un problème de signature. La clé d’accès AWS ou le secret est incorrect, ou l’utilisateur / le rôle IAM de la clé n’a pas la politique IAM SP-API attachée ; Amazon rejette la requête signée.

Solution : recopiez le AWS access key ID (commence par AKIA) et le secret depuis IAM → Security credentials, puis confirmez dans IAM que la politique SP-API est attachée à cet utilisateur ou rôle. Si vous avez renseigné un role ARN, vérifiez que le rôle existe et peut être assumé. Puis retestez.

Le refresh token est rejeté ou l’autorisation est incomplète

Pourquoi : le refresh token ne correspond pas au LWA Client ID et au secret, ou l’autorisation de l’app pour votre compte vendeur n’a jamais été terminée ; Amazon ne peut pas échanger le token contre un accès.

Solution : dans Seller Central → Apps & Services → Develop apps, terminez l’autorisation de l’app pour votre compte vendeur, copiez le nouveau refresh token (commence par Atzr|) et vérifiez que le LWA Client ID et le secret viennent de cette même app. Collez les trois ensemble, puis retestez.

Commandes d’un autre site, ou aucune commande

Pourquoi : le Marketplace ID ne correspond pas au site sur lequel votre boutique vend vraiment. La connexion peut passer le test, mais Amazon ne renvoie que les commandes du marketplace indiqué.

Solution : confirmez le site de votre boutique 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 et lancez une extraction manuelle pour confirmer.

Le Seller ID n’est pas accepté

Pourquoi : la valeur saisie n’est pas le Merchant token — par exemple un nom de boutique, un e-mail ou un autre ID de compte. Amazon attend comme Seller ID le Merchant token des informations de votre compte.

Solution : dans Seller Central, allez à Settings → Account info, copiez le Merchant token exactement comme affiché (il commence par A), collez-le comme Seller ID et retestez.