Integration Amazon SP-API - Products Manager APP

Connectez Products Manager a Amazon Seller Central via la Selling Partner API pour publier vos produits, synchroniser les stocks et recuperer le catalogue.

Vue d'ensemble

L'integration Amazon SP-API remplace l'ancienne MWS API et permet une synchronisation bidirectionnelle entre Products Manager et votre compte Amazon Seller Central.

Fonctionnalites

Push via Feeds API : Publication de produits et mises a jour de prix/stock
Pull catalogue : Recuperation des fiches produit et ASIN
Multi-marketplace : Support de tous les marketplaces Amazon (EU, NA, FE)
Reports : Recuperation des rapports de ventes et d'inventaire

Prerequis

Compte Amazon Seller Central professionnel
Application developpeur enregistree sur Amazon SP-API
Credentials LWA (Login With Amazon)
Products Manager v5.0.0 minimum

1. Enregistrer l'application

Connectez-vous a Amazon Seller Central
Allez dans Applications > Developper des applications
Cliquez sur Enregistrer une application
Configurez les parametres :

Champ	Valeur
Nom application	Products Manager
URL OAuth Redirect	`https://api.productsmanager.app/api/v1/integrations/amazon/callback`
Type	SP API

2. Recuperer les credentials LWA

Apres approbation, notez :

Client ID : amzn1.application-oa2-client.xxx
Client Secret : amzn1.oa2-cs.v1.xxx
Refresh Token : Obtenu via le flux OAuth

3. Configurer dans Products Manager

Allez dans Parametres > Integrations > Amazon SP-API :

Champ	Description
Client ID	Client ID LWA
Client Secret	Client Secret LWA
Refresh Token	Token de rafraichissement OAuth
Marketplace ID	Identifiant du marketplace cible
Seller ID	Identifiant vendeur Amazon
Region	`eu-west-1` (Europe), `us-east-1` (NA), `us-west-2` (FE)

Marketplace IDs Europe

Marketplace	ID	Region
France	`A13V1IB3VIYZZH`	eu-west-1
Allemagne	`A1PA6795UKMFR9`	eu-west-1
Espagne	`A1RKKUPIHCS9HS`	eu-west-1
Italie	`APJ6JRA9NG5V4`	eu-west-1
Pays-Bas	`A1805IZSGTT6HS`	eu-west-1
Royaume-Uni	`A1F83G8C2ARO7P`	eu-west-1

Push produits via Feeds API

La publication de produits sur Amazon utilise l'API Feeds (XML ou JSON). Products Manager genere automatiquement le feed au format requis.

POST /api/v1/connectors/{connector_id}/sync/push
{
  "product_ids": ["uuid-1", "uuid-2"],
  "feed_type": "POST_PRODUCT_DATA",
  "marketplace_ids": ["A13V1IB3VIYZZH"]
}

Types de feeds

Feed Type	Description	Usage
`POST_PRODUCT_DATA`	Creation/mise a jour fiches produit	Titre, description, bullet points
`POST_INVENTORY_AVAILABILITY_DATA`	Mise a jour des stocks	Quantite disponible
`POST_PRODUCT_PRICING_DATA`	Mise a jour des prix	Prix de vente
`POST_PRODUCT_IMAGE_DATA`	Ajout/modification images	URLs images

Suivi du feed

GET /api/v1/connectors/{connector_id}/sync/jobs/{job_id}

Le traitement d'un feed Amazon prend generalement 15 minutes a 2 heures. Le statut est mis a jour automatiquement.

Amazon impose des quotas stricts sur les feeds : 30 feeds/heure maximum. Products Manager gere automatiquement la file d'attente et les retries.

Pull catalogue

Recuperez les fiches produit et ASIN depuis Amazon :

POST /api/v1/connectors/{connector_id}/sync/pull
{
  "marketplace_ids": ["A13V1IB3VIYZZH"],
  "filters": {
    "identifiers_type": "ASIN",
    "identifiers": ["B08N5WRWNW", "B09V3KXJPB"]
  }
}

Donnees recuperees

ASIN, titre, description, bullet points
Images (URLs Amazon CDN)
Prix de vente, prix barre
Categorie Amazon (browse node)
Dimensions et poids
Statut de la fiche (active, supprimee)

Authentification et tokens

L'authentification SP-API utilise le flux OAuth 2.0 LWA :

Products Manager utilise le refresh_token pour obtenir un access_token
L'access_token est valide 1 heure
Le renouvellement est automatique et transparent

Refresh Token (permanent) → Access Token (1h) → Appel API

Le refresh_token n'expire jamais sauf revocation manuelle. Conservez-le de maniere securisee. Il est chiffre (Fernet) dans Products Manager.

Rate Limits

Type d'appel	Limite
Catalog Items	2 req/s, burst 2
Feeds (submit)	30/h
Feeds (status)	2 req/s, burst 15
Reports	0.0167 req/s (1/min)

Products Manager gere automatiquement le throttling avec backoff exponentiel.

Troubleshooting

Erreur "Access denied"

Verifiez que :

Le Refresh Token est valide et non revoque
L'application est approuvee dans Seller Central
Les roles IAM sont correctement configures

Feed en erreur

Consultez le rapport de traitement du feed pour identifier les erreurs produit par produit. Les erreurs courantes :

8541 : EAN/UPC invalide ou non reconnu
8572 : Titre trop long (max 200 caracteres)
99010 : Categorie produit incorrecte

Produits non visibles apres push

Le delai de publication Amazon est de 15 min a 24h. Verifiez le statut du feed et l'absence d'erreurs de validation.