Sincronización Etsy para PrestaShop — Documentación
Instala y configura Sincronización Etsy: conexión OAuth a Etsy, exportación de productos, sincronización de stock, importación de pedidos y cron.
Sincronización Etsy conecta tu tienda PrestaShop con tu shop de Etsy: exporta tus productos como anuncios, mantiene tu stock sincronizado e importa automáticamente tus pedidos de Etsy en PrestaShop. Esta guía cubre la instalación, la conexión con Etsy, los ajustes y el funcionamiento diario.
Compatible con PrestaShop 8.0 a 9.x, multitienda. El módulo usa la API oficial Etsy Open v3 y una conexión OAuth 2.0 (con PKCE): nunca introduces tu contraseña de Etsy en PrestaShop.
Requisitos
- Una tienda PrestaShop 8 o 9 operativa, con acceso al back office.
- Un shop de Etsy activo.
- Una aplicación registrada en el portal de desarrolladores de Etsy (gratuita) — ver el paso siguiente.
- Un cron de servidor (o un servicio de cron externo) para automatizar la sincronización de stock y la importación de pedidos.
Instalación
- En el back office de PrestaShop, ve a Módulos > Gestor de módulos.
- Haz clic en Subir un módulo y suelta el archivo
dfetsy.zip. - Una vez instalado, haz clic en Configurar. Llegas a la página de administración del módulo, organizada en pestañas: Conexión, Productos, Pedidos, Ajustes, Cron, Registros.
Crea tu aplicación de Etsy
El módulo se conecta a Etsy a través de tu propia aplicación de desarrollador. El proceso es gratuito y tarda unos minutos.
- Ve al portal de desarrolladores de Etsy (etsy.com/developers) y crea una nueva aplicación.
- Etsy te da una clave de API llamada keystring (es tu Client ID).
- En la configuración de tu aplicación de Etsy, declara la URL de redirección (Callback URL) exactamente como se muestra en la pestaña Conexión del módulo.
La URL de redirección debe copiarse de forma idéntica. Cualquier diferencia (http/https, presencia o ausencia de una barra final) hará que falle la conexión OAuth.
Conexión con Etsy
En la pestaña Conexión:
- Pega tu keystring en el campo correspondiente y haz clic en Guardar.
- Haz clic en Conectar mi tienda Etsy. Se abre una pestaña de Etsy que te pide autorizar la aplicación.
- Tras autorizar, se te redirige a una página de confirmación. Vuelve al back office y recarga la página: el banner debe mostrar Conectado con el nombre y el ID de tu shop.
- Usa el botón Probar la conexión para comprobar que todo funciona.
El token de acceso se renueva automáticamente. El botón Desconectar elimina los tokens y la asociación con el shop.
Ajustes
La pestaña Ajustes reúne el comportamiento de sincronización y los atributos Etsy por defecto.
Sincronización
- Enviar el stock de PS a Etsy: cada cambio de cantidad se pone en cola y se envía en el siguiente paso del cron.
- Actualizar el anuncio en cada guardado de producto: reexporta automáticamente el anuncio cuando editas un producto vinculado.
- Importar los pedidos de Etsy: activa la importación automática de los pedidos pagados.
- Enviar las imágenes del producto: adjunta las imágenes del producto al anuncio en la exportación.
- Sincronizar los precios: envía el precio de PrestaShop a Etsy.
- Incremento de precio Etsy (%): aplica un porcentaje al precio exportado para absorber las comisiones de Etsy, sin tocar tu precio de PrestaShop.
- Idioma de exportación: idioma usado para el título y la descripción de los anuncios.
Atributos Etsy por defecto
- Quién lo hizo / Cuándo: valores obligatorios de Etsy (who_made / when_made) aplicados a los nuevos anuncios.
- Taxonomy ID: categoría Etsy por defecto de los anuncios (consulta la Seller Taxonomy de Etsy).
- Perfil de envío y Política de devolución: listas cargadas automáticamente desde tu shop de Etsy una vez conectado.
- Estado del anuncio en la exportación: Borrador (recomendado — revisas antes de publicar) o Activo (publicación inmediata, se aplican comisiones de publicación de Etsy).
Importación de pedidos
- Estado del pedido: estado de PrestaShop asignado a los pedidos importados.
- Transportista: transportista asociado por defecto.
- Enviar los correos de PrestaShop en la importación: desactivado por defecto, porque Etsy ya notifica al comprador. Déjalo desactivado en la mayoría de los casos.
Exportar productos a Etsy
En la pestaña Productos, busca un artículo por nombre, referencia o ID.
- Exportar a Etsy crea un anuncio con el título, la descripción, las etiquetas, las imágenes y el precio del producto. El anuncio se crea como borrador (o activo según tus ajustes) y después se envía el inventario (SKU, precio, cantidad).
- Actualizar reenvía la información a un anuncio ya vinculado.
- Vincular (listing ID) asocia manualmente un producto PrestaShop a un anuncio Etsy existente, introduciendo el ID del anuncio.
- Desvincular elimina la asociación (el anuncio de Etsy no se elimina).
En la versión 1.0, un producto se exporta como referencia única: se usan la cantidad total y el precio base. Los productos con combinaciones se gestionan, por tanto, como un único SKU. Las variaciones nativas de Etsy están previstas para una versión posterior.
Sincronización del stock
Cuando la cantidad de un producto vinculado cambia en PrestaShop, se añade un trabajo de sincronización a una cola deduplicada. No se hace ninguna llamada a Etsy durante la navegación: la cola la procesa el cron, lo que evita cualquier ralentización del front y del back office. También puedes ejecutar el procesamiento manualmente desde la pestaña Cron.
Importación de pedidos
Los pedidos de Etsy pagados se importan como pedidos PrestaShop:
- Se crea un cliente invitado (o se reutiliza si ya existe para ese correo).
- Se recoge la dirección de envío de Etsy. Si el país no se reconoce, el pedido se omite y aparece un mensaje en los registros.
- El importe pagado se aplica al céntimo: el total del pedido PrestaShop coincide con el importe pagado en Etsy.
- La nota dejada por el comprador se adjunta como mensaje en el hilo de asistencia del pedido.
- La deduplicación por ID de pedido Etsy (receipt) evita cualquier importación duplicada.
Un pedido de Etsy sobre un anuncio no vinculado a un producto PrestaShop se omite (se escribe un aviso en los registros). Asegúrate de que los productos que vendes en Etsy están correctamente vinculados en el lado de PrestaShop.
Configurar el cron
La pestaña Cron muestra una URL protegida por un token. Llámala cada 5 a 15 minutos para procesar la cola (stock y productos) e importar los nuevos pedidos.
*/10 * * * * curl -s "https://tu-tienda/index.php?fc=module&module=dfetsy&controller=cron&token=TU_TOKEN" > /dev/nullEl botón Ejecutar la cola ahora permite lanzar un procesamiento manual para probar.
Sin un paso regular del cron durante varias semanas, el token de renovación de Etsy puede caducar. Basta con volver a conectar desde la pestaña Conexión para regenerarlo.
Registros y diagnóstico
La pestaña Registros muestra el registro de eventos (exportación, stock, importación, errores). Si una sincronización falla, consúltalo primero: cada error de Etsy queda registrado con su mensaje. Las entradas de más de 30 días se purgan automáticamente.
Limitaciones de la versión 1.0
- Un producto = un anuncio de referencia única (sin variaciones nativas de Etsy).
- Un solo shop de Etsy (un shop conectado a la vez).
- El seguimiento de envío aún no se devuelve a Etsy.
- El desglose detallado de los gastos de envío por línea no se reconstruye (el total pagado en Etsy prevalece).
Preguntas frecuentes
¿Mis anuncios se publican automáticamente?
Por defecto no: se crean como borrador para que los revises antes de publicarlos en Etsy. Puedes elegir el estado «Activo» en los ajustes para publicar de inmediato.
¿Cómo evito la sobreventa entre los dos canales?
Activa la sincronización de stock y un cron regular: cada venta o cambio de cantidad en PrestaShop actualiza la cantidad de Etsy en el siguiente paso del cron.
¿Dónde está el código fuente?
El código completo está incluido en el ZIP, sin cifrar (PSR-4, autoloader SPL), para auditoría o personalización.