Conectar Amazon FBA: sincronizar solo el inventario FBA

Una conexión distinta de Amazon SP-API que reutiliza las mismas credenciales: pegue los mismos ocho campos en Integration, pruebe, revise el mapeo de SKU y active: solo entra el inventario FBA.

Es una segunda conexión, distinta de la de Amazon SP-API: misma cuenta de vendedor, mismas credenciales, otra tarea. La conexión de Amazon FBA solo sincroniza a su vista de inventario el stock que Amazon almacena y despacha por usted (inventario FBA). No trae pedidos ni envía fulfillment: los pedidos y envíos quedan en la conexión de Amazon SP-API. Si ya tiene esa conexión, no necesita credenciales nuevas: reutilice aquí el mismo Seller ID, el par LWA, el refresh token y las claves AWS.

Requisitos previos#

• Una cuenta de vendedor de Amazon con acceso a Seller Central y stock ya enviado a FBA (Fulfillment by Amazon).
• Requisito obligatorio: su app de SP-API debe estar autorizada con el rol Amazon Fulfillment. Sin ese rol, las llamadas de inventario FBA son rechazadas: es el fallo más frecuente, así que revise el rol antes de completar ningún campo.
• Las mismas credenciales que la conexión de Amazon SP-API: Seller ID, Marketplace ID, LWA Client ID y secret, refresh token y un par de claves de acceso AWS para la firma SigV4. Si ya tiene una conexión de Amazon SP-API, ese conjunto ya existe: reutilícelo.
• Sepa a qué marketplace pertenece su stock FBA: el Marketplace ID debe coincidir con ese sitio (EE. UU.: ATVPDKIKX0DER).

Obtener credenciales#

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. Rol Fulfillment: en Seller Central, abra su app de SP-API (Apps & Services → Develop apps) y confirme que la app está autorizada para el rol Amazon Fulfillment. Si falta el rol, añádalo y autorícelo ahora: sin él no se puede leer el inventario FBA.
3. Credenciales LWA: en la misma página de la app, copie el LWA Client ID (empieza con amzn1.application-oa2-client.) y el LWA Client Secret.
4. Refresh token: autorice la app para su cuenta de vendedor (Seller Central → Apps & Services → Authorize) y copie el refresh token recibido. Empieza con Atzr|.
5. Claves AWS: en la consola de AWS (IAM), cree o copie el par de claves de acceso usado para la firma SigV4: el ID de clave de acceso (empieza con AKIA) y su secret access key.
6. Role ARN (opcional): solo si firma mediante un rol IAM asumido vía STS, anote el ARN de ese rol (arn:aws:iam::…:role/…). Si firma directamente con el par de claves, no lo necesita.

Completar en Integration#

1. Abra Integration → Marketplace → Amazon FBA → 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 al que pertenece su stock FBA. Para EE. UU. use ATVPDKIKX0DER; para otros sitios, consulte la documentación de Amazon SP-API.
4. LWA Client ID — obligatorio: el LWA Client ID de su app de SP-API, de Seller Central → Apps & Services → Develop apps. Empieza con amzn1.application-oa2-client.
5. LWA Client Secret — obligatorio: el secret asociado a ese Client ID, de la misma página de la app. Se guarda como secreto y nunca se muestra.
6. Refresh Token — obligatorio: el refresh token obtenido al autorizar la app para su cuenta de vendedor. Empieza con Atzr|.
7. AWS Access Key ID — obligatorio: el ID de clave de acceso usado para la firma SigV4. Empieza con AKIA.
8. AWS Secret Access Key — obligatorio: el secret asociado a esa clave de acceso. Se guarda como secreto y nunca se muestra.
9. IAM Role ARN (optional) — opcional: complételo solo si la firma pasa por un rol IAM asumido vía STS (ejemplo: arn:aws:iam::123456789012:role/…). Déjelo vacío para firmar directamente con el par de claves: vacío es lo normal.

Probar la conexión#

Lea el resultado con atención: hay dos tipos de «aprobado». Sin credenciales, la prueba usa un inventario simulado (un conjunto fijo y pequeño de SKU de ejemplo) y reporta un éxito de simulación: eso solo prueba que las pantallas funcionan, no que Amazon sea alcanzable. Con credenciales, la prueba intercambia su refresh token por acceso, firma la solicitud y comprueba de verdad su participación en el marketplace con Amazon. Solo un aprobado sin la nota de simulación cuenta como conexión real: complete las credenciales y pruebe de nuevo antes de activar.

Mapping / elegir plantilla#

En esta conexión no hay mapeo de pedidos: aquí el mapeo es solo de inventario. El inventario FBA se empareja por SKU del vendedor: cada SKU de Amazon en los resúmenes de inventario FBA se vincula al producto con el mismo SKU entre sus productos en stock, y sus cantidades FBA se registran en ese producto en la vista de inventario compartida. Antes de activar, revise la vista previa de mapeo: un SKU de Amazon sin producto vinculado no tiene dónde registrar sus cantidades, así que vincule primero esos SKU al producto correcto. No renombre SKU en un solo lado, o el vínculo se romperá en la próxima sincronización.

Activar#

Tras activar, Integration sincroniza sus resúmenes de inventario FBA según la frecuencia definida y mantiene actualizadas las cantidades FBA en la vista de inventario compartida, para que la visibilidad de stock y los avisos de reposición incluyan lo que Amazon guarda por usted. Nada más cambia: no se traen pedidos FBA ni se envía fulfillment; ese tráfico sigue en la conexión de Amazon SP-API. Vigile las primeras sincronizaciones en Runs / Logs y contraste algunos SKU con Seller Central antes de fiarse de las cifras.

Preguntas frecuentes#

Las llamadas de inventario FBA son rechazadas: a la app le falta el rol Amazon Fulfillment

Por qué: es el fallo número uno de esta conexión. Las credenciales pueden ser perfectamente válidas — el mismo conjunto funciona en la conexión de Amazon SP-API — pero la app de SP-API nunca fue autorizada para el rol Amazon Fulfillment, y Amazon rechaza las lecturas de inventario FBA sin ese rol.

Solución: en Seller Central, abra su app de SP-API (Apps & Services → Develop apps), añada el rol Amazon Fulfillment y complete la autorización para su cuenta de vendedor. Si la autorización emite un refresh token nuevo, péguelo también en esta conexión. Luego pruebe de nuevo.

La prueba pasó, pero el stock FBA real nunca aparece

Por qué: el aprobado que vio fue el simulado. Sin credenciales, la prueba usa un inventario simulado — un conjunto fijo y pequeño de SKU de ejemplo — y reporta éxito sin contactar con Amazon, así que de ahí no puede salir stock real.

Solución: complete todos los campos de credenciales (de Seller ID a AWS Secret Access Key), guarde y pruebe de nuevo. Solo un aprobado con credenciales reales — y sin nota de simulación — significa que Amazon fue contactado de verdad. Después active y revise la primera sincronización en Runs / Logs.

Algunos SKU no sincronizan cantidades

Por qué: el inventario FBA se registra por SKU del vendedor. Si un SKU de Amazon no está vinculado a un producto de sus productos en stock — o el SKU se renombró en un solo lado — sus cantidades no tienen producto donde registrarse y se omiten.

Solución: abra la vista previa de mapeo, localice los SKU de Amazon sin vincular y vincule cada uno al producto correcto. Mantenga después los nombres de SKU idénticos en ambos lados, vuelva a sincronizar y compruebe que las cantidades se registran.

El inventario viene de otro marketplace

Por qué: el Marketplace ID ingresado no coincide con el sitio al que pertenece realmente su stock FBA. La conexión puede pasar la prueba, pero Amazon solo devuelve inventario FBA del marketplace indicado.

Solución: confirme el sitio de su stock FBA 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, ejecute una sincronización y confirme que llega el stock correcto.