Integrar PrestaShop con Amazon: módulos, configuración y errores

Integrar PrestaShop con Amazon consiste en conectar el catálogo, el stock y los pedidos de tu tienda con tu cuenta de vendedor para no gestionar dos inventarios a mano. Hay tres vías: un módulo de PrestaShop, un conector de terceros o una integración propia contra las API de ambas plataformas. La elección importa menos que el trabajo previo, que es el mismo en las tres: decidir qué dato de PrestaShop alimenta cada atributo de Amazon.

Para una tienda con catálogo propio, el riesgo real no es que la sincronización falle el primer día, sino que funcione con datos incompletos y genere rechazos de fichas, roturas de stock o pedidos duplicados semanas después. En esta guía explicamos cómo se piensa la integración, qué documentan ambas plataformas, cómo mapear el catálogo y qué errores revisar. Es parte del trabajo operativo que hacemos en nuestra agencia especializada en Amazon.

¿Cómo se conecta PrestaShop con Amazon?

Se conecta por una de estas tres vías, y cada una cambia el coste de mantenimiento más que el resultado visible. La tabla recoge los criterios con los que la comparamos:

No recomendamos un módulo concreto desde aquí: los módulos los mantienen terceros, cambian de versión y de condiciones, y lo que sirve a una tienda de cien referencias no sirve a una de diez mil. Lo que sí podemos darte son los criterios para evaluarlo: que soporte tu versión de PrestaShop, que gestione combinaciones, que permita reglas de precio por canal y que tenga registro de errores legible.

¿Qué datos de PrestaShop necesita Amazon?

Amazon no pide una lista fija de campos: la define cada tipo de producto. Según la documentación para desarrolladores de Amazon, la API de definiciones de tipos de producto devuelve el esquema JSON con los requisitos de atributos y datos de cada tipo, y ese esquema se usa después con las API de listados, de catálogo y de feeds. Dicho de otro modo, los campos obligatorios de una funda de móvil no son los de una silla, y es Amazon quien los marca.

Por eso el primer paso de cualquier integración es consultar el esquema del tipo de producto de tus categorías y comparar con lo que tienes en PrestaShop. Este mapeo es un método de Avafa, no una regla de Amazon:

El campo EAN-13 de PrestaShop existe y se valida con un formato propio, según la documentación para desarrolladores de PrestaShop. Si tu catálogo tiene productos sin EAN, no los des por listos: antes de subirlos comprueba qué exige el esquema de su tipo de producto.

¿Cómo se sincronizan el stock y los pedidos?

El stock se sincroniza por producto y por combinación, y los pedidos viajan en sentido contrario, de Amazon a PrestaShop. La API de servicio web de PrestaShop, que cuelga de la ruta /api/, expone para esto recursos como productos, combinaciones, pedidos, detalles de pedido y stock disponible.

El recurso de stock disponible (stock_availables) enlaza cada registro con un producto y con una combinación, y su cantidad es un campo obligatorio. Según la documentación de PrestaShop, el recurso admite lectura y modificación. Lo que esto implica: el stock de una camiseta con tres tallas son tres cifras, no una, y la integración debe actualizar la cifra de la combinación correcta.

Para los pedidos, define desde el principio estas decisiones:

1. Qué estado de PrestaShop se asigna a un pedido nuevo de Amazon.
2. Si el pedido descuenta stock al importarse o al confirmarse el envío.
3. Cómo se informa a Amazon del envío y del número de seguimiento.
4. Qué ocurre con los pedidos cancelados o con devolución.
5. Qué transportista de PrestaShop equivale a cada servicio de Amazon.

Cada respuesta debe quedar escrita. Una integración sin ese documento acaba decidiendo estos puntos por defecto, y los valores por defecto casi nunca coinciden con tu operativa.

¿Cómo se publica y se actualiza una ficha desde la API?

Se hace con la API de listados de Amazon, cuyas operaciones documentadas son crear o reemplazar un listado, modificarlo parcialmente, borrarlo, consultarlo y buscar listados. Esa API se usa junto con la de definiciones de tipos de producto, que dice qué atributos lleva cada ficha. En una integración propia, la secuencia sensata es: leer el esquema del tipo, construir el listado desde PrestaShop, enviarlo y revisar los problemas que devuelva Amazon antes de dar el producto por publicado.

¿Qué errores aparecen con más frecuencia?

Los errores se repiten porque casi todos nacen en el catálogo, no en el conector. Esta es la lista de comprobación que usamos antes de activar una sincronización:

• Referencias duplicadas. Si dos combinaciones comparten referencia, Amazon no sabe a cuál asignar el stock.
• Productos sin identificador. Fichas sin EAN válido que el esquema del tipo exige.
• Categorías sin equivalente. Un producto de una categoría de PrestaShop que no encaja en ningún tipo de producto de Amazon.
• Stock de combinaciones mal actualizado. Se actualiza el producto padre y no la talla o el color.
• Precios sin regla por canal. El mismo precio de la web en Amazon, sin contar comisiones.
• Textos pensados para la web. Títulos y descripciones que no cumplen los límites del esquema.
• Pedidos importados sin estado definido. Se acumulan en un estado intermedio y nadie los prepara.

Si vas a vender con promociones, ten claro el calendario antes de tocar precios; tienes el detalle en nuestra guía de promociones en Amazon Seller y en el calendario de Q4 para vendedores.

¿Qué más hay que conectar además del catálogo?

La contabilidad y el ERP. Una venta en Amazon debe acabar en tu sistema de facturación, y para eso conviene mirar la integración de Holded con Amazon, la de Odoo con Amazon o la de SAP Business One con Amazon. Si además quieres atraer tráfico de pago al catálogo, hablamos de ello en nuestra agencia especializada en Amazon Ads.

¿Cómo se prueba la integración antes de abrir todo el catálogo?

Con un lote piloto de entre diez y veinte referencias que cubran los casos difíciles. Es una recomendación de método nuestra, no de ninguna plataforma. Elige al menos un producto simple, uno con combinaciones, uno sin EAN y uno de una categoría poco habitual, y comprueba durante una semana estos puntos:

1. La ficha se publica sin problemas pendientes en Seller Central.
2. Una venta de prueba descuenta stock en la combinación correcta.
3. El pedido llega a PrestaShop con el estado, el transportista y los impuestos previstos.
4. El envío informado en PrestaShop aparece en Amazon.
5. Una cancelación devuelve el stock al sitio correcto.

Solo cuando el piloto sale limpio tiene sentido ampliar. Abrir el catálogo entero de golpe convierte cualquier fallo de mapeo en cientos de fichas rechazadas a la vez.

Cómo lo trabajamos en Avafa

Empezamos por el catálogo, no por el módulo: exportamos tus productos, los contrastamos con el esquema de cada tipo de producto de Amazon y marcamos qué falta. Después elegimos la vía de conexión según el volumen y los canales, y probamos con un grupo pequeño de referencias antes de abrir todo el catálogo. Si quieres que miremos tu caso, solicita la auditoría gratuita de tu cuenta de Amazon desde nuestra página de agencia especializada en Amazon.

Preguntas frecuentes

¿Hay un módulo oficial de PrestaShop para Amazon?

No lo hemos podido confirmar en la documentación oficial, por eso no recomendamos uno concreto. Evalúa cualquier módulo con los criterios de la tabla de vías y pruébalo con pocas referencias.

¿Se puede sincronizar el stock en tiempo real?

Depende de la vía elegida y de los límites de las API. Lo que sí puedes definir es la frecuencia de actualización y qué ocurre si falla una.

¿Qué pasa con los productos con combinaciones?

En PrestaShop cada combinación tiene su propio registro de stock, así que la integración debe actualizar a ese nivel y no solo el del producto.

¿Necesito EAN para todos mis productos?

Depende del tipo de producto: Amazon define los atributos obligatorios de cada tipo en su esquema. Consúltalo antes de subir referencias sin identificador.

¿Es mejor una integración propia o un conector?

Un conector suele bastar con varios canales y reglas estándar. La integración propia compensa con catálogos grandes o procesos que un conector no cubre.

¿Cuánto tarda una integración?

Lo marca la calidad del catálogo más que la herramienta. Un catálogo limpio se conecta en poco tiempo; uno con referencias duplicadas y sin identificadores obliga a limpiarlo antes.