Conectar Amazon SP-API: recibir pedidos y enviar fulfillment

Obtenga Seller ID, credenciales LWA y refresh token en Seller Central, añada las claves de firma de AWS IAM, pegue los ocho campos en Integration, pruebe, mapee y active.

El conector de Amazon SP-API trae sus pedidos de Amazon a OMS y devuelve fulfillment, productos e inventario a Amazon; también puede traer devoluciones. Es para pedidos con envío del vendedor (MFN). Una conexión cubre una cuenta de vendedor y un marketplace.

Requisitos previos#

• Una cuenta de vendedor de Amazon con acceso a Seller Central y pedidos MFN.
• Permiso en Seller Central para desarrollar apps y autorizar su app (Apps & Services → Develop apps).
• Una cuenta AWS con acceso a IAM para crear una clave de acceso y adjuntar la política IAM de SP-API para firmar.
• Sepa a qué marketplace pertenece su tienda: el Marketplace ID debe coincidir con ese sitio (EE. UU.: ATVPDKIKX0DER).

Obtener credenciales#

1. Paso 1 — Seller ID: en Seller Central, vaya a Settings → Account info y copie el Merchant token. Ese es su Seller ID; empieza con A.
2. Paso 1 — Credenciales de la app: en Seller Central, vaya a Apps & Services → Develop apps, abra su app y copie el LWA Client Identifier (empieza con amzn1.application-oa2-client.) y el LWA Client secret.
3. Paso 1 — Refresh token: autorice su app para su cuenta de vendedor y copie el refresh token recibido. Es un token de larga duración y empieza con Atzr|.

1. Paso 2 — Clave de acceso AWS: en la consola de AWS, vaya a IAM → Security credentials y cree una clave de acceso. El ID empieza con AKIA.
2. Paso 2 — Clave secreta: copie la AWS secret access key de la misma página. Se muestra una sola vez.
3. Paso 2 — Política IAM: asegúrese de que el usuario o rol IAM de la clave tenga adjunta la política IAM de SP-API; sin ella, la firma funciona pero Amazon devuelve 403.
4. Paso 2 — Role ARN (opcional): si firma mediante un rol IAM entre cuentas, anote su role ARN. Omítalo si firma directamente con la clave de acceso.

Completar en Integration#

1. Abra Integration → Marketplace → Amazon SP-API → Nueva conexión.
2. Seller ID (Merchant token) — obligatorio: el Merchant token de Seller Central → Settings → Account info. Empieza con A.
3. Marketplace ID — obligatorio: el ID del sitio de su tienda. Para EE. UU. use ATVPDKIKX0DER; para otros sitios, consulte la documentación de Amazon SP-API.
4. LWA Client ID — obligatorio: el LWA Client Identifier de Seller Central → Apps & Services → Develop apps. Empieza con amzn1.application-oa2-client.
5. LWA Client secret — obligatorio: el secret de la misma página de Develop apps. Cifrado en reposo, nunca se muestra.
6. Refresh token — obligatorio: el token de actualización de larga duración recibido al autorizar la app. Empieza con Atzr|.
7. AWS access key ID — obligatorio: el ID de clave de acceso IAM usado para la firma SigV4. Empieza con AKIA.
8. AWS secret access key — obligatorio: el secret asociado a esa clave de acceso, copiado de IAM → Security credentials. Se mostró una sola vez.
9. IAM role ARN — opcional: el ARN de un rol IAM entre cuentas. Si lo completa, la firma primero asume ese rol vía STS para credenciales temporales; si lo deja vacío, la clave de acceso firma directamente.

Probar la conexión#

La prueba tiene dos niveles: conectividad (autorización LWA y firma SigV4) y vista previa de un pedido real. Si aún no hay pedidos, haga un pedido de prueba en Amazon primero. Si falla, anote el error exacto y revise las preguntas frecuentes.

Mapping / elegir plantilla#

Elija la plantilla estándar de Amazon SP-API. Mapea número de pedido, SKU de línea, cantidades, dirección de envío y estado de fulfillment para pedidos MFN. Revise la vista previa con un pedido real antes de activar, sobre todo el emparejamiento de SKU.

Activar#

Tras activar, Integration trae nuevos pedidos MFN y devoluciones según la frecuencia definida, y devuelve fulfillment con tracking, además de actualizaciones de productos e inventario, a Amazon.

Preguntas frecuentes#

La prueba falla con 403

Por qué: suele ser un problema de firma. La clave de acceso AWS o el secret son incorrectos, o el usuario o rol IAM de la clave no tiene adjunta la política IAM de SP-API, y Amazon rechaza la solicitud firmada.

Solución: vuelva a copiar el AWS access key ID (empieza con AKIA) y el secret desde IAM → Security credentials, y confirme en IAM que la política de SP-API está adjunta a ese usuario o rol. Si completó un role ARN, confirme que el rol existe y puede asumirse. Luego pruebe de nuevo.

El refresh token es rechazado o la autorización está incompleta

Por qué: el refresh token no coincide con el LWA Client ID y el secret, o la autorización de la app para su cuenta de vendedor nunca se completó, y Amazon no puede canjear el token por acceso.

Solución: en Seller Central → Apps & Services → Develop apps, complete la autorización de la app para su cuenta de vendedor, copie el refresh token nuevo (empieza con Atzr|) y asegúrese de que el LWA Client ID y el secret sean de esa misma app. Pegue los tres juntos y pruebe de nuevo.

Pedidos de otro sitio, o ningún pedido

Por qué: el Marketplace ID no coincide con el sitio en el que su tienda vende realmente. La conexión puede pasar la prueba, pero Amazon solo devuelve pedidos del marketplace indicado.

Solución: confirme el sitio de su tienda y complete el Marketplace ID de ese sitio: ATVPDKIKX0DER para EE. UU.; para otros sitios, búsquelo en la documentación de Amazon SP-API. Guarde y ejecute una extracción manual para confirmar.

El Seller ID no es aceptado

Por qué: el valor ingresado no es el Merchant token; por ejemplo, un nombre de tienda, un correo u otro ID de cuenta. Amazon espera como Seller ID el Merchant token de la información de su cuenta.

Solución: en Seller Central, vaya a Settings → Account info, copie el Merchant token exactamente como se muestra (empieza con A), péguelo como Seller ID y pruebe de nuevo.