Saltar al contenido principal

Etsy

Disponible

Esta integración está disponible en Frihet. Configúrala en Settings → Integraciones → Etsy.

Conecta tu tienda de Etsy a Frihet para importar automáticamente pedidos, productos y datos de compradores. Etsy es el marketplace líder para productos artesanales, vintage y creativos, con más de 90 millones de compradores activos. Con esta integración, cada venta en tu tienda Etsy se registra como ingreso en Frihet, las comisiones de Etsy se contabilizan como gastos, y las ventas internacionales se gestionan con conversión automática de divisa.

¿Para qué sirve?

  • Importar pedidos — Cada venta en Etsy se convierte automáticamente en un ingreso registrado en Frihet con todos los detalles del pedido
  • Comisiones y fees como gastos — Las comisiones de listado, transacción y procesamiento de Etsy se registran automáticamente como gastos
  • Catálogo sincronizado — Tus productos de Etsy se reflejan en el catálogo de Frihet
  • Multidivisa — Las ventas internacionales se importan con su divisa original y tipo de cambio
  • Clientes importados — Los compradores de Etsy se añaden como clientes en Frihet con sus datos de envío

Requisitos

  • Cuenta de vendedor activa en Etsy
  • Plan Frihet Pro o Business
  • API Key de Etsy (se obtiene desde el Etsy Developer Portal)

Cómo conectar

Paso 1: Crear una aplicación en Etsy

  1. Ve al Etsy Developer Portal
  2. Inicia sesión con tu cuenta de vendedor
  3. Haz clic en Create a New App
  4. Rellena el nombre ("Frihet ERP") y la descripción
  5. Una vez aprobada la aplicación, copia la API Key (Keystring)

Paso 2: Configurar en Frihet

  1. En Frihet, ve a Settings → Integraciones
  2. Busca Etsy y haz clic en el card
  3. Pega tu API Key en el campo correspondiente
  4. Haz clic en Conectar con Etsy para autorizar el acceso mediante OAuth
  5. Acepta los permisos solicitados en la ventana de Etsy
  6. Haz clic en Guardar

Paso 3: Importación inicial

  1. Una vez conectado, haz clic en Importar pedidos para traer el historial de ventas
  2. Selecciona el rango de fechas que quieres importar
  3. Revisa los pedidos importados y verifica que los datos son correctos

Datos que se sincronizan

DatoDirecciónDetalles
PedidosEtsy → FrihetID, importe, fecha, productos, dirección de envío
ProductosEtsy → FrihetNombre, precio, cantidad, variantes
ClientesEtsy → FrihetNombre del comprador, email (si disponible), dirección
ComisionesEtsy → FrihetListing fees, transaction fees, payment processing fees como gastos
DivisaEtsy → FrihetDivisa original de la venta con tipo de cambio
Estado del pedidoEtsy → FrihetPagado, enviado, completado, reembolsado

Casos de uso

Artesano con ventas internacionales

Vendes joyería artesanal en Etsy a compradores de todo el mundo. Cada venta se importa a Frihet con la divisa original (USD, GBP, EUR) y el tipo de cambio real. Las comisiones de Etsy se registran automáticamente como gastos, dándote una visión clara del margen real de cada venta. Al final del trimestre, tienes todos los datos para tu declaración fiscal.

Vendedor de productos vintage

Gestionas un catálogo grande de productos vintage en Etsy. Cada venta actualiza tu catálogo en Frihet y registra el ingreso. Puedes generar informes de rentabilidad por producto y ver qué categorías de productos tienen mejor margen una vez descontadas las comisiones de Etsy.

Creador digital con descargas

Vendes plantillas, ilustraciones o recursos digitales en Etsy. Las ventas se importan automáticamente sin intervención manual. Como no hay costes de envío en productos digitales, puedes hacer seguimiento preciso del margen neto: precio de venta menos comisiones de Etsy.

Solución de problemas

Error de conexión

  • Verifica que la API Key es correcta y que la aplicación está activa en el Etsy Developer Portal
  • Comprueba que la autorización OAuth no ha expirado — reconecta desde Settings si es necesario
  • Asegúrate de que tu cuenta de Etsy está en buen estado (no suspendida o restringida)

No se importan pedidos

  • Confirma que tienes ventas en el rango de fechas seleccionado
  • Solo se importan pedidos con pago completado — los pendientes de pago se excluyen
  • Si tienes muchos pedidos, la importación puede tardar unos minutos — espera a que complete

Comisiones no registradas

  • Las comisiones se importan como gastos separados, asociados al pedido correspondiente
  • Verifica que la importación de comisiones está activada en la configuración de la integración
  • Las comisiones de publicidad de Etsy (Etsy Ads) se importan por separado

Divisa incorrecta

  • Frihet usa la divisa de la transacción original en Etsy
  • Si tu contabilidad es en EUR y la venta fue en USD, Frihet aplica el tipo de cambio del día de la transacción
  • Puedes ajustar manualmente el tipo de cambio desde el detalle del gasto/ingreso

Siguientes pasos