# Sincronización Etsy para PrestaShop — Documentación > 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… - Página: - Idioma: es - Actualizado el: 2026-07-06 - Otros idiomas: [fr](https://www.datafirefly.com/documentation/sync-etsy-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/sync-etsy-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/sync-etsy-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/sync-etsy-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/sync-etsy-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/sync-etsy-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/sync-etsy-prestashop/index.md) - Índice: 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 1. En el back office de PrestaShop, ve a **Módulos > Gestor de módulos**. 2. Haz clic en **Subir un módulo** y suelta el archivo `dfetsy.zip`. 3. 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. 1. Ve al portal de desarrolladores de Etsy (etsy.com/developers) y crea una nueva aplicación. 2. Etsy te da una clave de API llamada **keystring** (es tu Client ID). 3. 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**: 1. Pega tu **keystring** en el campo correspondiente y haz clic en **Guardar**. 2. Haz clic en **Conectar mi tienda Etsy**. Se abre una pestaña de Etsy que te pide autorizar la aplicación. 3. 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. 4. 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/null ``` El 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.