DataFirefly Amazon Connector: conectar PrestaShop con Amazon Seller Central

Instalación

Instale el módulo desde Módulos > Gestor de módulos > Subir un módulo enviando el archivo ZIP. Se requiere la extensión PHP cURL.

Al instalarse, el módulo crea sus tablas, una pestaña Amazon Connector en el menú Vender, un transportista «Amazon» reservado a los pedidos importados (el cliente nunca lo ve) y dos estados de pedido: «Amazon: pendiente de envío» y «Amazon FBA: enviado».

Preparar su cuenta de Amazon

El módulo se conecta a su cuenta de vendedor con su propia aplicación privada de Selling Partner API. Necesita una cuenta profesional de Seller Central.

1. En Seller Central, abra Aplicaciones y servicios > Desarrollar aplicaciones y regístrese como desarrollador privado si aún no lo ha hecho.
2. Cree una aplicación y solicite los roles que necesitan las funciones que va a usar: Product Listing y Pricing para el catálogo, Inventory and Order Tracking para los pedidos, Direct-to-Consumer Shipping (Restricted) para recibir la dirección de entrega y el e-mail del comprador, Amazon Fulfillment para el stock FBA, Finance and Accounting para los reembolsos, Tax Invoicing para el envío de facturas.
3. Autorice la aplicación en su propia cuenta para obtener un refresh token y anote el ID de cliente LWA y el secreto de cliente.
4. Copie su Merchant Token desde Configuración > Información de la cuenta.

Conexión y marketplaces

En Amazon Connector > Ajustes, elija la región (Europa, Norteamérica o Lejano Oriente), introduzca el cliente LWA, el secreto, el refresh token y el Merchant Token y guarde. Los secretos se cifran en la base de datos; deje los campos vacíos para conservar los valores guardados.

En el panel, haga clic en Probar la conexión. Los marketplaces de su cuenta aparecen en la pestaña Marketplaces, desactivados por defecto. Para cada uno, ajuste:

• la activación;
• el idioma de los contenidos enviados (título, descripción);
• los precios con o sin IVA, según el país;
• la sincronización de precios, que debe desactivar si usa un repricer de Amazon;
• el recargo en porcentaje, el importe fijo y el redondeo (ninguno, x,99, x,90, entero).

Tarea cron

La sincronización funciona con una tarea cron, idealmente cada 5 a 15 minutos. El panel muestra la URL protegida por token y la línea de comandos:

php /ruta/a/modules/dfamazonconnector/cron.php --shop=1

En cada ejecución, el módulo importa los pedidos, confirma los envíos, envía facturas y cancelaciones, lee los reembolsos y el stock FBA y después envía los anuncios, el stock y los precios pendientes en feeds agrupados. Aparece un aviso en rojo en el módulo si la tarea no se ha ejecutado desde hace más de una hora. El botón Nuevo token invalida la URL anterior.

Correspondencia de categorías

La correspondencia solo es necesaria para crear fichas nuevas en Amazon. Un producto vendido sobre un ASIN existente, o vinculado por su EAN, solo necesita una oferta.

En la pestaña Correspondencia de categorías, elija una categoría de PrestaShop y un tipo de producto de Amazon (búsqueda por palabras clave integrada). Un producto usa la correspondencia de su categoría por defecto o, si no existe, la del padre más cercano.

• Browse node: el nodo de navegación de Amazon, opcional según el tipo de producto.
• Tema de variación: por ejemplo SIZE_NAME/COLOR_NAME. Si se indica, las combinaciones se agrupan en familia padre-hijo; si está vacío, cada combinación se publica como un producto independiente.
• Atributos de las combinaciones y Características: asocian un atributo de Amazon a un grupo de atributos o a una característica de PrestaShop.
• Atributos fijos: valores enviados tal cual, en formato Listings Items. Variables disponibles: {marketplace_id}, {language_tag}, {currency}, {reference}, {ean13}, {mpn}, {brand}.

El botón Atributos obligatorios lee el esquema del tipo de producto en Amazon y enumera los atributos que el módulo no rellena por sí solo. Para cada uno, elija un origen (valor fijo, característica, atributo de combinación) y después Aplicar: los campos JSON se completan automáticamente.

Publicar los productos

Desde la ficha de producto

La pestaña Módulos de la ficha de producto contiene un bloque Amazon:

• Vender en Amazon activa el producto.
• Modo de publicación: automático, oferta sobre un producto existente (ASIN o EAN) o creación de la ficha completa.
• Gestión logística: por usted (FBM) o por Amazon (FBA).
• ASIN, tipo de producto, estado y precio fijo en Amazon sustituyen los valores por defecto para este producto.
• Atributos adicionales: JSON fusionado tras los atributos fijos de la categoría; un valor null elimina un atributo.
• Marketplaces: desmarque un país para retirar el producto de ese marketplace.

La tabla «Lo que se enviará a Amazon» muestra, por combinación y país, el precio, el precio de oferta y sus fechas, el precio mínimo, el precio Business y la cantidad. Hay cuatro acciones: Verificar con Amazon (validación sin publicar, errores mostrados atributo por atributo), Enviar ahora, Añadir a la próxima sincronización y Actualizar estado.

En masa

La pestaña Productos lista el catálogo con el estado de cada producto por país (activo, en curso, inactivo, error). Filtre por nombre, categoría o estado, marque los productos o la opción «Todos los productos que coinciden con el filtro» y aplique una acción: activar y publicar, volver a publicar, enviar precios, enviar cantidades, desactivar (cantidad 0) o eliminar de Amazon.

Anuncios ya presentes en Amazon

El botón Vincular los anuncios de Amazon existentes del panel solicita a Amazon el informe de sus anuncios. En la siguiente ejecución del cron, cada SKU se vincula al producto de PrestaShop con el mismo SKU, la misma referencia o el mismo EAN. Los SKU no encontrados aparecen en el registro.

SKU de Amazon

El SKU se crea en la primera publicación según el ajuste elegido: referencia, EAN13 o patrón (por defecto PS{id_product}-{id_product_attribute}). Un SKU existente nunca cambia, aunque cambie la referencia.

Precios

El precio se calcula en la moneda del marketplace con el grupo de precios elegido y después se aplican el recargo, el importe fijo y el redondeo del país. Opciones de la pestaña Ajustes:

• Aplicar los descuentos de la tienda: precios específicos y reglas de catálogo incluidos en el precio de Amazon.
• Enviar los descuentos como precios de oferta de Amazon: el precio normal sigue siendo el de referencia y el descuento pasa a ser un precio de oferta con las fechas del descuento de PrestaShop. Un descuento creado, modificado o eliminado actualiza Amazon al instante; las ofertas con fechas y las reglas de catálogo se revisan cada noche.
• Margen mínimo sobre el precio de coste: envía un precio mínimo (precio de coste convertido más el margen, IVA del país incluido) que impide a un repricer vender por debajo.
• Precios Amazon Business: el precio del grupo de clientes elegido pasa a ser el precio Business y sus descuentos por cantidad se convierten en niveles (5 como máximo). Solo para vendedores inscritos en Amazon Business.

Las actualizaciones de precio solo afectan a las ofertas gestionadas por el módulo: una oferta creada a mano en Seller Central para otra audiencia se conserva.

Stock y FBA

Cada movimiento de stock en PrestaShop pone el SKU en cola de envío. Ajustes disponibles: stock de seguridad (unidades que no se ofrecen en Amazon), cantidad máxima, plazo de preparación, cantidad 0 para los productos desactivados y resincronización completa cada noche después de las 3 h.

Los productos FBA no reciben cantidad desde PrestaShop. La opción Leer el stock FBA recupera cada hora la cantidad disponible en los almacenes de Amazon, visible en la ficha de producto; Copiar el stock FBA en PrestaShop la aplica al stock de la tienda de los productos FBA.

Pedidos

Los pedidos se leen con la API Orders v2026-01-01 desde la fecha de inicio configurada. Un pedido pendiente de pago se memoriza sin crearse; se importa en cuanto Amazon lo libera para su envío.

Cada pedido importado crea o reutiliza un cliente invitado (uno por comprador o un cliente único, a elegir), una dirección «Amazon + número de pedido» y un pedido de PrestaShop con el transportista Amazon, los precios y gastos de envío de Amazon, el número de pedido de Amazon como identificador de transacción y, opcionalmente, la fecha de compra de Amazon. El stock se descuenta como en una venta de la tienda.

Los pedidos FBA se importan una vez enviados, con el estado «Amazon FBA: enviado». La opción «Los pedidos FBA no cambian el stock de la tienda» devuelve las cantidades al stock tras la creación.

La pestaña Pedidos lista todos los pedidos de Amazon con los filtros «Por enviar», «Solicitudes de cancelación», «Reembolsados» y «No importados». Un pedido no importado (SKU desconocido, moneda o país no configurados) muestra la causa y un botón Reintentar.

Envíos

Elija en los ajustes los estados que confirman el envío (por ejemplo Enviado). Cuando un pedido de Amazon pasa a uno de esos estados, el módulo envía a Amazon el código de transportista, el número de seguimiento y la fecha de envío. Si aún no se ha introducido el número de seguimiento, espera hasta una hora antes de confirmar sin seguimiento.

La tabla de correspondencia de transportistas asocia cada transportista de PrestaShop a un código de transportista de Amazon. Los pedidos importados usan el transportista Amazon: cambie el transportista del pedido antes del envío para que se transmita el código correcto. El bloque Amazon de la ficha del pedido incluye también un botón Confirmar el envío ahora.

Facturas

Si está inscrito en el servicio de cálculo del IVA de Amazon con la opción de subir sus propias facturas, active Subir las facturas de PrestaShop a Amazon. Tras la confirmación del envío, la factura PDF del pedido se envía con su número, el total y el importe del IVA. El estado (enviada, pendiente, rechazada) aparece en la lista y en la ficha del pedido.

Cancelaciones

Cuando un comprador pide cancelar un pedido no enviado, el pedido se marca en rojo en la lista y en su ficha, con el motivo indicado por el comprador. No lo envíe: cancele el pedido desde el bloque Amazon eligiendo el motivo, o active la opción Cancelar en Amazon cuando el pedido se cancela en PrestaShop. Una cancelación pedida por el comprador se envía con el motivo BuyerCanceled y no penaliza su tasa de cancelación.

A la inversa, un pedido cancelado en Amazon pasa al estado de cancelación elegido en PrestaShop, sin e-mail al cliente.

Reembolsos

Con la opción Leer los reembolsos de Amazon, los reembolsos hechos en Seller Central se leen mediante la API Finances. Cada uno se anota en la nota privada del pedido con la fecha, los artículos y el importe neto. Cuando todas las unidades están reembolsadas, el pedido pasa al estado elegido (Reembolsado por defecto). El importe mostrado es el importe neto cargado en su cuenta de Amazon, tras las comisiones reembolsadas.

Panel, alertas y registro

El panel muestra los anuncios activos y con error, los pedidos de las últimas 24 horas y de los últimos 30 días, las tareas pendientes, la última sincronización, los errores de Amazon más frecuentes agrupados por código y los últimos feeds enviados.

El e-mail de alerta diario se envía después de las 8 h a los destinatarios elegidos, solo cuando hay que actuar: solicitudes de cancelación, pedidos sin confirmar más de 2 días después de la compra, pedidos no importados, facturas rechazadas, anuncios con error, feeds rechazados, cron detenido. El botón Enviar un e-mail de prueba comprueba la configuración.

La pestaña Registros guarda cada operación (feeds, pedidos, envíos, reembolsos, FBA, errores) con el detalle técnico, filtrable por nivel y por canal. La duración de conservación se ajusta en los ajustes.

Solución de problemas

La prueba de conexión falla

Revise la región elegida, el cliente LWA, el secreto y el refresh token. Un refresh token corresponde a una aplicación y a una cuenta: vuelva a generarlo después de cambiar los roles de la aplicación.

Un anuncio tiene un error

Abra la ficha de producto: los errores de Amazon aparecen bajo cada anuncio. El código 90220 indica que falta un atributo obligatorio, que debe completar en la correspondencia de categoría o en los atributos adicionales del producto. Use Verificar con Amazon para validar la corrección antes del envío.

Un pedido no se importa

El motivo aparece en la pestaña Pedidos. El caso más frecuente es un SKU de Amazon que no corresponde a ningún producto: vincule los anuncios existentes o corrija la referencia y haga clic en Reintentar. Compruebe también que la moneda y el país de entrega están activos en PrestaShop.

El stock o los precios no se actualizan

Revise la última sincronización en el panel y en el registro. Las actualizaciones salen en la siguiente ejecución del cron y Amazon las procesa en pocos minutos. Para forzar un envío completo, use Reenviar todas las cantidades.

Compatibilidad

• PrestaShop 8.0 a 9.x, el mismo ZIP cubre las dos ramas.
• Multitienda y multiidioma.
• Regiones de Amazon Europa, Norteamérica y Lejano Oriente.
• Arquitectura ModuleAdminController, sin dependencias Composer.
• Interfaz disponible en francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.