Conectar Etsy: recibir pedidos y enviar fulfillment
Encuentre su Shop ID numérico en la URL de administración de su tienda Etsy, copie la clave API en Etsy Developers, pegue ambas junto con su token de acceso OAuth en Integration, pruebe, mapee y active.
El conector de Etsy trae pedidos de su tienda Etsy a OMS y devuelve fulfillment a Etsy. También puede enviar productos e inventario, para que anuncios, stock y envíos se mantengan sincronizados en ambos lados.
Requisitos previos#
- Una tienda Etsy, con acceso a su administración para poder ver la URL de administración de la tienda.
- Acceso a Etsy Developers → Your apps, donde se muestra la clave API (KEYSTRING) de su aplicación.
- Posibilidad de completar el flujo de autorización OAuth para esa tienda: el token de acceso solo se obtiene tras finalizar ese flujo.
Obtener credenciales#
- Encuentre su Shop ID: abra la administración de su tienda Etsy y mire la URL de administración: el Shop ID es el ID numérico de esa URL, por ejemplo 12345678. Copie solo el número, no el nombre de la tienda.
- Copie la clave API: vaya a Etsy Developers → Your apps → copie la clave API (KEYSTRING) de su aplicación. Guárdela en un lugar seguro: la pegará en el campo API key de Integration.
- Obtenga el token de acceso OAuth: complete el flujo de autorización OAuth para su tienda y copie el token de acceso obtenido tras el flujo. Lo pegará en el campo OAuth access token de Integration.
Completar en Integration#
- Abra Integration → Marketplace → Etsy → Nueva conexión.
- Shop ID: complete el ID numérico de la URL de administración de su tienda Etsy, por ejemplo 12345678. No complete el nombre de la tienda: el campo solo toma el número.
- API key, obligatorio: pegue la clave API (KEYSTRING) que copió de Etsy Developers → Your apps. Se cifra en reposo y nunca se muestra.
- OAuth access token: pegue el token de acceso obtenido tras el flujo de autorización OAuth. Debe ser de la misma tienda que el Shop ID anterior: un token de otra tienda no coincidirá.
Probar la conexión#
Haga clic en Probar la conexión. La prueba verifica juntos el Shop ID, la clave API y el token de acceso OAuth, y luego muestra una vista previa a nivel de documento con un pedido real, con los campos de la plataforma junto al pedido estándar. Si la tienda aún no tiene pedidos, haga primero un pedido de prueba en Etsy: la vista previa necesita un documento real. Si la prueba falla, anote el error y revise la FAQ antes de cambiar otra cosa.
Mapping / elegir plantilla#
Elija la plantilla estándar de Etsy. Mapea número de pedido, SKU de línea, cantidades, dirección de envío y estado de fulfillment. Revise la vista previa de mapping con un pedido real antes de activar, sobre todo que cada SKU de Etsy esté vinculado a un producto de OMS, para que pedidos, productos e inventario coincidan en ambos lados.
Activar#
Tras activar, Integration trae pedidos nuevos según la frecuencia definida, devuelve fulfillment con números de rastreo a Etsy y envía cambios de productos e inventario a Etsy. Vigile los primeros pedidos en Runs / Logs antes de dejarlo sin supervisión.
Preguntas frecuentes#
La prueba falla: tienda no encontrada
El Shop ID es incorrecto. Lo más frecuente es que se haya completado el nombre de la tienda en lugar del ID numérico, así que la conexión busca una tienda que no coincide con ningún Shop ID real.
Abra la administración de su tienda Etsy, lea el ID numérico en la URL de administración (por ejemplo 12345678), reemplace el campo Shop ID solo con ese número y pruebe de nuevo.
La prueba falla con un error de credencial API
La clave API no coincide con su aplicación. Se copió incompleta, con un espacio extra, o es la clave de otra aplicación en Etsy Developers, así que Etsy rechaza la llamada.
Vaya a Etsy Developers → Your apps, copie de nuevo la clave API (KEYSTRING) de la aplicación correcta tal cual se muestra, péguela en el campo API key sin espacios extra y pruebe de nuevo.
La autorización ha caducado
El token de acceso OAuth ya no es válido. La autorización detrás de él ha caducado, así que las llamadas que necesitan ese token se rechazan hasta que la tienda se autorice de nuevo.
Complete de nuevo el flujo de autorización OAuth para la misma tienda, copie el nuevo token de acceso obtenido tras el flujo, reemplace el campo OAuth access token y pruebe de nuevo.
Conectado pero no llegan pedidos
La conexión está bien. La tienda simplemente no tiene pedidos nuevos en el rango de extracción, así que aún no hay nada que importar.
Haga un pedido de prueba en su tienda Etsy, verifique que su hora esté dentro del rango de extracción, ejecute una extracción manual y confirme que el pedido aparece en la vista previa o en Runs / Logs.