Conector Odoo Etsy: integración de comercio hecho a mano

Etsy alberga a más de 9 millones de vendedores activos y atiende a un nicho que ningún otro mercado replica: productos hechos a mano, vintage y de suministros para manualidades. Para los vendedores de Etsy que han crecido más allá del seguimiento básico de hojas de cálculo, Odoo 19 Enterprise proporciona las capacidades de gestión de inventario, contabilidad financiera y planificación de producción que necesita un negocio de artesanía en expansión.

El conector ECOSIRE Odoo Etsy conecta tu tienda de Etsy con Odoo, sincronizando listados, pedidos, inventario y datos de clientes. Esta guía cubre la integración completa desde la configuración de credenciales API de Etsy hasta la gestión de pedidos de producción y los informes de vendedores de Etsy.

Conclusiones clave

• El conector utiliza Etsy API v3 con autenticación OAuth 2.0
• Los listados se sincronizan en ambas direcciones: crear en Odoo, publicar en Etsy
• La importación de pedidos incluye detalles del comprador, notas de personalización de artículos e indicadores de envoltura de regalos
• El inventario se envía a Etsy dentro de los 5 minutos posteriores a los cambios de stock en Odoo
• La integración de órdenes de producción (MRP) rastrea los productos hechos a mano hechos a pedido
• Las tarifas de Etsy y las tarifas de procesamiento de pagos se concilian automáticamente con las facturas de Odoo.
• Se admiten múltiples tiendas: administre varias tiendas de Etsy desde una instancia de Odoo
• La renovación del listado de Etsy (renovación automática de 20¢ por listado) se rastrea en los costos de Odoo

---

Por qué los vendedores de Etsy necesitan la integración de Odoo

El administrador de tienda integrado de Etsy maneja el seguimiento básico de pedidos, pero carece de la profundidad que necesitan las empresas artesanales en crecimiento:

Para los vendedores que obtienen ingresos mensuales superiores a 10.000 dólares o que gestionan más de 50 SKU activos en materiales y hechos a mano, Odoo ofrece capacidades operativas que escalan con el negocio.

---

Configuración de la API de Etsy

Paso 1: crea una cuenta de desarrollador de Etsy

1. Ve a developers.etsy.com e inicia sesión con tu cuenta de vendedor de Etsy.
2. Haga clic en Crear aplicación en Mis aplicaciones.
3. Asigne un nombre a su aplicación (por ejemplo, "Integración de Odoo") y describa su propósito.
4. Acepte los Términos de servicio de la API de Etsy
5. Etsy revisará tu solicitud (normalmente entre 1 y 3 días hábiles)

Paso 2: Configurar ámbitos de OAuth

Su aplicación necesita los siguientes ámbitos de OAuth 2.0:

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

Paso 3: Generar credenciales API

Después de la aprobación:

• Clave API (cadena de claves): el identificador de su aplicación
• Secreto compartido: utilizado para el flujo OAuth PKCE
• URI de redireccionamiento: https://your-odoo.com/etsy/oauth/callback

Paso 4: completar la autorización de OAuth

Desde la configuración del conector en Odoo:

1. Haz clic en Conectar tienda de Etsy
2. Autoriza el conector en la ventana emergente de Etsy OAuth.
3. El conector recibe y almacena su token de acceso y token de actualización.

Los tokens OAuth de Etsy no caducan con un límite de tiempo fijo (a diferencia de los tokens de actualización de 18 meses de Amazon). Siguen siendo válidos hasta que los revoques.

---

Instalación y configuración del conector

Instalar desde el mercado ECOSIRE:

Disponible en Productos ECOSIRE. Después de la compra:

1. Cargue e instale el módulo Etsy Connector a través de Aplicaciones
2. Navega a Inventario → Etsy o Ventas → Tiendas de Etsy

Configuración de la tienda:

Mapeo de secciones de la tienda de Etsy:

Etsy organiza los anuncios en secciones de la tienda (equivalentes a categorías). Asigne secciones de Etsy a categorías de productos de Odoo:

---

Gestión de listados

Creación de listados de Etsy a partir de productos Odoo:

1. Abra un formulario de producto → pestaña Etsy → Crear listado
2. Configure campos específicos del listado:

• Título: 140 caracteres como máximo, rico en palabras clave para Etsy SEO
• Descripción: descripción completa con materiales, dimensiones e instrucciones de cuidado.
• Etiquetas: hasta 13 etiquetas, fundamental para el algoritmo de búsqueda de Etsy
• Categoría: explora el árbol de taxonomía de Etsy
• Quién lo hizo: yo lo hice, un miembro de mi tienda, alguien más
• Cuando se fabrica: Hecho por encargo, 2020–2025, 2010–2019, etc.
• Tipo: Artículo físico, Descarga digital
• Precio: precio de lista (puede diferir del precio de lista de Odoo)
• Cantidad: inventario disponible para listar
• Materiales: hasta 13 etiquetas de material
• Fotos: hasta 10 fotos (la primera imagen se convierte en la imagen principal del listado)

3. Haz clic en Publicar en Etsy

Listados de variaciones (variantes de productos):

Etsy admite "variaciones": Odoo las asigna a los atributos del producto:

Ejemplo: un anillo vendido en oro/plata con tallas 5 a 10 crea un listado único de Etsy con 12 combinaciones de variaciones, cada una con su propio precio y seguimiento de existencias.

Listados de pedidos personalizados y personalizados:

Etsy es famosa por sus artículos personalizados. Configurar la personalización en el conector:

• Habilite Personalización requerida/opcional en el listado
• El comprador ingresa el texto de personalización (nombre, fecha, monograma) al finalizar la compra
• Este texto aparece en el campo de notas del cliente del pedido de venta de Odoo.
• El equipo de producción ve la personalización al realizar el artículo.

---

Sincronización de pedidos

Detalles de importación del pedido:

Los pedidos de Etsy incluyen campos críticos para los vendedores hechos a mano:

Ruta de pedido para fabricación sobre pedido:

Los vendedores de Etsy suelen fabricar artículos después de recibir un pedido (MTO). Configurar el conector:

1. En configuración del producto → pestaña Ventas → Bajo demanda: "Hecho a pedido"
2. Cuando se importa un pedido de Etsy, Odoo crea:

• Orden de venta (confirmada)
• Orden de fabricación (borrador) vinculada a la venta.
• La orden de fabricación muestra los materiales necesarios y el tiempo de mano de obra.

3. El equipo de producción trabaja a través de la orden de fabricación.
4. Cuando finaliza el MO, los productos llegan a stock → se confirma la entrega
5. Detalles del envío enviados a Etsy

Manejo de pedidos personalizados:

Para comisiones personalizadas (no incluidas en Etsy):

1. Acepta el pedido personalizado en Etsy
2. En Odoo, cree manualmente una orden de venta de "Producto personalizado" con el precio acordado.
3. Enlace a la conversación de Etsy en notas de pedido.
4. Marcar como enviado en Etsy manualmente o mediante la herramienta de pedido personalizado del conector.

---

Sincronización de inventario

Para productos físicos:

La sincronización del inventario se ejecuta cada 5 minutos de forma predeterminada. Cuando las acciones de Odoo cambian:

1. Cantidad disponible recalculada (disponible menos reservada)
2. Cantidad enviada a Etsy a través de la API de inventario de listado
3. Si la cantidad llega a 0: el listado está agotado (mantiene el listado activo)
4. Cuando se repone: el listado se reactiva automáticamente

Para productos hechos a pedido:

Los productos MTO no rastrean el inventario físico en el sentido tradicional. Configura la cantidad del anuncio de Etsy como indicador de capacidad de producción:

• Establecer una "cantidad disponible" fija (por ejemplo, 5) que represente la capacidad del pedido actual
• Ajuste manualmente a medida que se llena su cola de producción

Para descargas digitales:

Los productos digitales tienen un inventario infinito. El conector establece la cantidad de Etsy en 999 y nunca sincroniza los cambios de inventario. La entrega de archivos digitales se maneja mediante el sistema de descarga digital nativo de Etsy: el conector no toca la entrega de archivos.

---

Conciliación financiera

El procesamiento de pagos y la estructura de tarifas de Etsy requieren una configuración contable cuidadosa.

Estructura de tarifas de Etsy Payments (como referencia):

• Tarifa de listado: $0.20 por listado (se cobra cuando se incluye y cada 4 meses en caso de renovación automática)
• Tarifa de transacción: 6,5% del precio del artículo + envío
• Tarifa de procesamiento de pagos: 3% + $0,25 por transacción (EE.UU.)
• Tarifa de anuncios externos: 12-15 % cuando Etsy anuncia tu artículo (si estás inscrito)

Configurar la conciliación de tarifas en Odoo:

1. Cree un diario dedicado de Pagos de Etsy (tipo banco)
2. Crear cuentas:

• Etsy Listing Fees (gasto)
• Etsy Transaction Fees (gasto)
• Etsy Payment Processing Fees (gasto)
• Etsy Payments Receivable (activo corriente)

3. Importar extractos de pago de Etsy:

• Navega a Etsy → Pagos → Estado de cuenta mensual → Descargar CSV
• Importar a la herramienta de reconciliación del conector.
• El conector crea asientos de diario para cada tipo de transacción.

Proceso de conciliación de fin de mes:

1. Descargar CSV de pago mensual de Etsy
2. Importar mediante conector: Etsy → Conciliación → Importar declaración
3. Revisar las entradas coincidentes automáticamente
4. Haga coincidir manualmente cualquier transacción no reconocida
5. Confirmar conciliación → entradas de diario publicadas en Odoo
6. Concilie la cuenta bancaria de Etsy Payments con el saldo de Odoo

---

Seguimiento del rendimiento y SEO de Etsy

Sincronización del rendimiento del listado:

El conector importa estadísticas de la tienda de Etsy a Odoo:

• Vistas por listado por día
• Los favoritos cuentan
• Tasa de conversión (vistas a ventas)
• Ingresos por listado

Estos datos aparecen en el panel de análisis de Etsy en Odoo, lo que te permite identificar los anuncios con mejor rendimiento y los de bajo rendimiento sin tener que cambiar a la interfaz de estadísticas de Etsy.

Seguimiento de etiquetas y palabras clave:

Realice un seguimiento de qué términos de búsqueda generan tráfico en Etsy obteniendo estadísticas de la API de estadísticas de tienda de Etsy. Utilice estos datos para:

• Identifique etiquetas de alta conversión para agregar a listados similares
• Encuentre listados con muchas vistas pero baja conversión (problemas con precios o fotografías)
• Detecte tendencias estacionales en su categoría de producto

---

Preguntas frecuentes

¿Puede el conector manejar Pattern de Etsy (sitio web personalizado) además del mercado de Etsy?

No. El conector se integra específicamente con el mercado de Etsy. Etsy Pattern (su creador de sitios web alojado) comparte el mismo inventario pero utiliza procesamiento de pago y pago por separado. Los pedidos de patrones deberían gestionarse por separado. Para una integración de sitio web con todas las funciones, se recomienda el módulo de sitio web de Odoo o una integración de Shopify.

¿Cómo maneja el conector la reserva de Etsy para transacciones (retenciones de pagos de Etsy)?

A veces, Etsy coloca una reserva sobre los pagos de nuevos vendedores para la gestión de riesgos. El conector rastrea el estado de pago de cada pedido. Los importes reservados aparecen en el saldo de Etsy Payments pero no están disponibles para su retiro. El conector marca estas facturas como "pago pendiente" hasta que se libere la reserva, luego las actualiza a "pagadas" cuando se liberan los fondos a su banco.

¿Puedo administrar varias tiendas de Etsy (por ejemplo, una de joyería y otra de decoración del hogar) desde una instancia de Odoo?

Sí. Crea configuraciones de tienda de Etsy independientes con credenciales OAuth independientes para cada tienda. Cada tienda tiene sus propias configuraciones de importación de pedidos, asignación de inventario y conciliación de pagos. Los productos se pueden publicar en varias tiendas con anulaciones de precios específicas de cada tienda.

¿El conector es compatible con la funcionalidad mayorista/B2B de Etsy?

Etsy no tiene un programa nativo mayorista/B2B. Si usas Etsy para consultas mayoristas pero manejas la transacción real fuera de línea, el conector la maneja de la misma manera que cualquier pedido personalizado: crearías el pedido de venta de Odoo manualmente con el precio acordado y lo cumplirías mediante tu proceso estándar.

¿Cómo maneja el conector las ventas internacionales de Etsy y los requisitos de IVA/GST?

Etsy recauda y remite el IVA/GST en nombre de los vendedores para los compradores en la UE, el Reino Unido, Australia y otras jurisdicciones donde Etsy actúa como facilitador del mercado. El conector importa estos pedidos con $0 de impuestos (ya que Etsy los cobra). Para los mercados donde usted es responsable de recaudar impuestos, configure posiciones fiscales apropiadas en Odoo según el país del comprador.

---

Próximos pasos

ECOSIRE Etsy Connector transforma Etsy de un mercado independiente a un canal de ventas totalmente integrado dentro de Odoo 19 Enterprise. Para las empresas hechas a mano que van más allá de la gestión básica de la tienda, esta integración ofrece la columna vertebral operativa para un crecimiento sostenible.

Obtenga el conector ECOSIRE Etsy para Odoo 19 →

El conector incluye documentación de configuración, herramientas de importación para datos históricos de pedidos y soporte de implementación para integrar tu tienda de Etsy con Odoo de forma rápida y correcta.