Integración de la API de Hepsiburada con Odoo: guía de configuración completa
El panorama del comercio electrónico de Turquía presenta dos plataformas dominantes, y Hepsiburada es la que todo vendedor serio debe dominar. Fundada en 2000, Hepsiburada es el mercado en línea más antiguo y confiable de Turquía, con más de 100 millones de visitas mensuales, más de 65 000 vendedores y un catálogo de productos que abarca todas las categorías de consumidores, desde electrónica y moda hasta repuestos para automóviles y suministros industriales. Para los vendedores que ejecutan sus operaciones en Odoo ERP, la integración con Hepsiburada a través de su sólida API es el camino hacia una venta eficiente y escalable en el mercado turco.
La integración de Hepsiburada con Odoo a través de su API permite a los vendedores automatizar la gestión de listados de productos, el procesamiento de pedidos, la sincronización de inventario en tiempo real, la integración de carga y la conciliación de liquidaciones financieras. Esto elimina los procesos manuales que ralentizan el cumplimiento, provocan errores y limitan la capacidad del vendedor para escalar en la plataforma de comercio electrónico más establecida de Turquía.
Conclusiones clave
- Hepsiburada recibe más de 100 millones de visitas mensuales y es el mercado más visitado de Turquía
- La plataforma alberga más de 65.000 vendedores con más de 50 millones de listados de productos.
- Hepsiburada salió a bolsa en NASDAQ en 2021, demostrando una infraestructura de mercado de nivel institucional
- La API de HepsiBurada (HBAPI) proporciona puntos finales de integración integrales para productos, pedidos, inventario y reclamos.
- El conector de ECOSIRE se encarga de la localización turca, el cumplimiento fiscal de KDV y la integración de cargas múltiples
- Los vendedores integrados en API logran un procesamiento de pedidos un 40 % más rápido y un 90 % menos de errores de inventario
Por qué es importante Hepsiburada
Mientras que Trendyol lidera en moda y volumen de pedidos diarios, Hepsiburada tiene claras ventajas en las categorías de electrónica, electrodomésticos, automoción e industrial. La reputación de confianza de los consumidores de la plataforma, construida a lo largo de 25 años de operación, le otorga una base de clientes leales que se superpone pero difiere de la audiencia de Trendyol. Los vendedores de comercio electrónico turcos más exitosos operan en ambas plataformas, lo que hace que la integración de Hepsiburada con Trendyol sea un requisito estándar.
Estadísticas de Hepsiburada (2025-2026)
| Métrica | Valor |
|---|---|
| Visitas mensuales | 100 millones+ |
| Vendedores activos | 65.000+ |
| Listados de productos | 50 millones+ |
| GMV anual | ~$5 mil millones |
| Categorías clave | Electrónica, electrodomésticos, moda, automoción, cosmética, hogar |
| Tarifas de comisión | 6-18% (dependiente de la categoría) |
| Ciclo de pago | Liquidaciones quincenales |
| Modelo de cumplimiento | FBM (barcos vendedores) + HepsiJet + transportistas aprobados |
| Cuota de mercado en Turquía | ~25% |
| Usuarios de aplicaciones móviles | 30 millones+ |
| Fundado | 2000 (más de 25 años de funcionamiento) |
Posición competitiva de Hepsiburada
Hepsiburada se diferencia por:
- Confianza: 25 años de funcionamiento han generado una profunda confianza en los consumidores, especialmente en compras de alto valor.
- Fortalecimiento de la electrónica: participación de mercado líder en electrónica de consumo, informática y dispositivos móviles
- Logística HepsiJet: red logística interna con entrega el mismo día en las principales ciudades
- HepsiPay: sistema de pago integrado con opciones de pago a plazos (crítico en el mercado de pagos a plazos de Turquía)
- Ventas corporativas: segmento del mercado B2B para compras empresariales
- Hepsiglobal: Programa de venta transfronteriza que llega a mercados internacionales
Análisis profundo de la API de Hepsiburada (HBAPI)
Hepsiburada proporciona una API REST bien estructurada que permite una integración integral del vendedor. La documentación de la API está disponible en inglés (a diferencia de algunas API de plataformas turcas), lo que la hace accesible para los equipos de desarrollo internacionales.
Arquitectura API
La HBAPI está organizada en dominios de servicio:
Servicio de listado
- Crear listados de productos con conjuntos de atributos completos
- Gestionar variantes (color, tamaño, modelo, capacidad)
- Manejar la carga y el pedido de imágenes.
- Mapa de la taxonomía de categorías de Hepsiburada.
- Administrar el estado del listado (activo, pasivo, bloqueado)
- Manejar los requisitos de códigos de barras (GTIN/EAN)
Servicio de pedidos
- Recuperar nuevos pedidos (pedidos empacables)
- Acceder a los detalles del pedido (artículos en línea, cantidades, direcciones)
- Actualizar el estado de la línea del pedido (recogida, facturado, enviado)
- Crear paquetes y asignar empresas de carga.
- Manejar el cumplimiento parcial (enviar primero los artículos disponibles)
Servicio de inventario
- Actualizar cantidades de stock por listado por almacén
- Establecer estado de disponibilidad
- Manejar la asignación de stock de múltiples almacenes.
Servicio de Reclamaciones
- Procesar reclamos del comprador (artículo incorrecto, dañado, faltante)
- Enviar respuestas a reclamos con evidencia.
- Seguimiento de los resultados de las reclamaciones y el impacto financiero
Servicio financiero
- Acceder a informes de liquidación
- Ver desgloses de comisiones
- Seguimiento de sanciones y deducciones de ajuste.
- Descargar facturas y documentos financieros.
Autenticación
HBAPI utiliza autenticación básica HTTP con una identificación de comerciante, un nombre de usuario y una contraseña proporcionados a través del Panel de comerciantes de Hepsiburada. Algunos puntos finales requieren una lista blanca de IP adicional por motivos de seguridad.
Límites de tarifas y mejores prácticas
- Límites de velocidad estándar: 100 solicitudes por minuto por punto final
- Actualizaciones de inventario: se recomiendan operaciones por lotes (hasta 100 SKU por solicitud)
- Encuesta de pedidos: Recomendado cada 10 minutos
- Creación de productos: limitado a 500 nuevos listados por hora durante los períodos pico
Arquitectura de integración
Canal de procesamiento de pedidos
El ciclo de vida de los pedidos de Hepsiburada difiere ligeramente del de otros mercados. Las órdenes pasan por una máquina de estados específica:
New → Picking → Invoiced → Packaged → Shipped → Delivered
↓ ↓ ↓ ↓
Cancel Re-stock [Skip if Tracking
digital] Push
La integración debe respetar esta máquina de estados: omitir estados o actualizar fuera de secuencia provoca errores de API y posibles fallas en el procesamiento de pedidos.
Componente 1: Integración del listado de productos
La creación y gestión de listados en Hepsiburada requiere atención a los requisitos específicos de la plataforma:
- Atributos de categoría: Cada categoría tiene atributos obligatorios y opcionales. Los productos electrónicos requieren marca, modelo, especificaciones técnicas y período de garantía. La moda requiere tabla de tallas, materiales e instrucciones de cuidado.
- Requisito de código de barras: todos los productos físicos deben tener códigos de barras GTIN/EAN válidos. La integración debe validar el formato del código de barras antes del envío.
- Requisitos de imagen: Mínimo 500x500 píxeles, fondo blanco para la imagen principal, hasta 8 imágenes por listado
- Verificación de marca: las marcas deben aprobarse en Hepsiburada antes de que se puedan publicar productos. La integración debe verificar el estado de aprobación de la marca antes de intentar crear una lista.
- Idioma del contenido: todo el contenido del listado debe estar en turco para el mercado nacional.
El conector asigna datos de productos Odoo al formato de listado de Hepsiburada, valida los atributos obligatorios y maneja la conversión del formato de imagen.
Componente 2: Importación de pedidos y gestión de estados
El conector sondea HBAPI en busca de nuevos pedidos empaquetables y crea pedidos de venta de Odoo con:
- Mapeo completo de productos y variantes.
- Dirección de envío del cliente
- ID de nivel de pedido y de línea para el seguimiento de actualizaciones de estado
- Información del método de pago.
- Requisitos de entrega SLA
Las actualizaciones estatales siguen la secuencia requerida por Hepsiburada:
- Recogida: Confirma la recepción del pedido e inicia el procesamiento del almacén.
- Facturado: genera y registra la factura (requerido antes del embalaje)
- Empaquetado: Crear paquete con dimensiones, peso y empresa de carga asignada.
- Enviado: número de seguimiento de carga push
Cada transición de estado llama a HBAPI con los datos apropiados y el conector maneja los reintentos en caso de fallas transitorias.
Componente 3: Gestión de inventario
La disponibilidad de stock se envía desde Odoo a Hepsiburada mediante llamadas API por lotes:
- Las cantidades de existencias por SKU se actualizan cada 15 a 30 minutos.
- Colchones de seguridad aplicados para vendedores multicanal.
- Artículos de stock cero desactivados automáticamente en Hepsiburada
- La restauración del stock activa la reactivación automática
Coordinar el inventario de Hepsiburada con otros canales de ventas requiere el enfoque centralizado descrito en nuestra guía de sincronización de inventario en tiempo real.
Componente 4: Carga y Logística
Hepsiburada admite múltiples opciones de carga:
- HepsiJet: red logística propia de Hepsiburada (entrega el mismo día en las principales ciudades)
- Yurtic Kargo: el mayor transportista de carga de Turquía
- Aras Kargo: Cobertura a nivel nacional con precios competitivos
- MNG Kargo: Fuerte en entrega de artículos corporativos y voluminosos
- Surat Kargo: opción económica para entregas estándar
- UPS Turquía: para entregas internacionales y premium
El conector se integra con el módulo de envío de Odoo para asignar el transportista apropiado según reglas configurables (categoría de producto, destino, peso, urgencia) y envía información de seguimiento a Hepsiburada.
Componente 5: Reclamos y Postventa
El sistema de reclamaciones de Hepsiburada gestiona las disputas de los compradores:
- Artículo incorrecto: el comprador recibió un producto diferente al solicitado
- Dañado: El producto llegó dañado
- Artículos faltantes: entrega del pedido incompleta
- Calidad: el producto no coincide con la descripción del listado
El conector importa reclamos al módulo de asistencia técnica de Odoo, lo que permite a su equipo de servicio al cliente revisar evidencia, enviar respuestas y realizar un seguimiento de los resultados, todo desde Odoo. La calidad de la resolución de reclamos afecta la puntuación del vendedor, lo que hace que el manejo eficiente sea fundamental.
Componente 6: Liquidación Financiera
Las liquidaciones quincenales incluyen:
- Ingresos brutos por ventas por línea de pedido
- Comisiones específicas de categoría (6-18%)
- Tarifas de logística de HepsiJet
- Cargos por servicio (listado, transacción)
- Deducciones por penalizaciones (retraso en el envío, cancelación, pérdidas por reclamaciones)
- Contribuciones promocionales
El conector crea asientos de diario detallados para cada componente de liquidación, lo que permite un análisis preciso de la rentabilidad por producto y por categoría en Odoo.
Guía de configuración
Paso 1: Cuenta Mercantil de Hepsiburada
- Regístrese en el Panel de Comerciantes de Hepsiburada
- Completar verificación de identidad y impuestos.
- Solicite acceso a la API y reciba credenciales (ID de comerciante, nombre de usuario, contraseña)
- Envíe la lista blanca de IP para acceder a la API
- Solicite aprobaciones de marca para las marcas de sus productos.
Paso 2: Configuración de Odoo
- Localización turca: instale módulos de contabilidad, impuestos y documentos específicos de Turquía
- Moneda: configure TRY con actualizaciones automáticas del tipo de cambio
- Configuración de KDV (IVA): configure las tasas impositivas (1%, 10%, 20%) por categoría de producto
- Canal de ventas: Crear equipo de ventas "Hepsiburada"
- Cliente: Crear registro de cliente "Hepsiburada Marketplace"
- Transportistas: Configure HepsiJet y las compañías de carga aprobadas en el módulo de entrega de Odoo
- Cuentas: cree cuentas de gastos para comisiones, tarifas de logística y sanciones.
Paso 3: Instale el conector ECOSIRE
Implemente el conector ECOSIRE Hepsiburada:
- Instalar a través de aplicaciones Odoo
- Vaya a Configuración > Integración de Hepsiburada
- Ingrese el ID del comerciante, el nombre de usuario de API y la contraseña.
- Configure la lista blanca de IP si es necesario
- Establezca intervalos de sincronización:
- Órdenes: cada 10 minutos
- Inventario: cada 15 minutos
- Productos: cada 4 horas o manual
- Asigne categorías de productos a la taxonomía de Hepsiburada.
Paso 4: Configuración del listado de productos
- Asigne productos Odoo a categorías de Hepsiburada con atributos obligatorios
- Verifique los códigos de barras GTIN/EAN para todos los productos
- Prepare el contenido del producto en turco
- Cargue imágenes de productos compatibles
- Establezca precios de TRY con márgenes que tengan en cuenta las comisiones
- Sincronizar el catálogo inicial y monitorear la aprobación del listado
Paso 5: Configuración del flujo de trabajo del pedido
- Configurar la importación de pedidos y la gestión del estado.
- Establecer reglas de asignación de almacén para pedidos de Hepsiburada
- Configurar la generación de facturas (requerido antes del empaquetado en flujo Hepsiburada)
- Configurar reglas de asignación de carga
- Pruebe el procesamiento de pedidos de un extremo a otro
Paso 6: Configuración financiera
- Mapear las tasas de comisión por categoría de producto
- Configurar el cronograma de importación de liquidaciones
- Configure cuentas de gastos con tarifas específicas
- Definir la tolerancia de conciliación para variaciones menores.
Desafíos específicos de Hepsiburada
Desafío 1: Requisito de facturar antes del paquete
Hepsiburada requiere que los vendedores generen una factura antes de crear un paquete de envío, una secuencia que difiere de la mayoría de los mercados donde la facturación se realiza después o simultáneamente al envío.
Solución: El conector automatiza el paso de generación de facturas en Odoo, creando y registrando la factura tan pronto como se confirma la recolección. Esto garantiza que siempre se siga la secuencia de estado correcta (Recogida > Facturado > Empaquetado > Enviado).
Desafío 2: Cultura de pago a plazos
Turquía tiene una fuerte cultura de pago a plazos: los consumidores suelen pagar sus compras en 3, 6, 9 o 12 plazos mensuales. Mientras Hepsiburada y HepsiPay gestionan la relación de pago a plazos del consumidor, los vendedores reciben el pago completo (menos las comisiones) según los términos de liquidación normales.
Solución: El conector registra correctamente el monto total del pago en Odoo independientemente del plan de pagos del consumidor. La estructura de cuotas se registra con fines informativos pero no afecta el tratamiento contable del vendedor.
Desafío 3: Complejidad transfronteriza hepsiglobal
El programa Hepsiglobal de Hepsiburada permite la venta transfronteriza, introduciendo precios en múltiples monedas, logística de envío internacional y requisitos de documentación aduanera.
Solución: El conector admite Hepsiglobal con configuraciones de precios separadas por mercado objetivo, integración de operadores internacionales y generación de documentación aduanera a través de Odoo.
Desafío 4: Alta competencia en electrónica
La electrónica es la categoría más fuerte de Hepsiburada, pero también la más competitiva. La sensibilidad al precio es extrema y la competencia de Buy Box requiere capacidad de respuesta de precios en tiempo real.
Solución: El conector admite reglas de precios que se ajustan según la posición competitiva y los márgenes mínimos. Las actualizaciones de precios se pueden activar con mayor frecuencia para categorías de alta competencia, manteniendo al mismo tiempo los límites de rentabilidad.
Desafío 5: picos de demanda estacionales
El comercio electrónico turco experimenta importantes picos de demanda durante el 11.11 (Día de los Solteros), el Viernes Negro y los períodos de compras previos al Ramadán. Los volúmenes de pedidos pueden aumentar entre 3 y 5 veces durante estos eventos.
Solución: El conector admite configuraciones de modo pico con mayor frecuencia de sincronización, buffers de seguridad más grandes y alertas de capacidad automatizadas. Las listas de verificación previas al evento garantizan que el inventario, los precios y la capacidad de cumplimiento estén preparados antes de que aumente la demanda.
Conector manual frente a ECOSIRE
| Operación | Proceso manual | Conector ECOSIRE |
|---|---|---|
| Importación de pedidos | Consulte el Panel de Comerciantes cada hora | Automático cada 10 minutos |
| Actualizaciones de estado | Actualizar estado manualmente por pedido | Progresión automatizada de la máquina de estados |
| Generación de facturas | Crear en portal por pedido | Generado automáticamente en la confirmación de recogida |
| Asignación de carga | Seleccionar transportista en el portal | Asignación automática basada en reglas de Odoo |
| Empuje de seguimiento | Ingresar seguimiento manualmente | Empuje automático desde la entrega de Odoo |
| Actualización de inventario | Actualización manual por SKU | Empuje por lotes cada 15 minutos |
| Tramitación de reclamaciones | Monitorear el portal, responder por separado | Integrado en el servicio de asistencia técnica de Odoo |
| Conciliación de liquidación | Coincidencia de hojas de cálculo | Automatizado con marcado de variación |
| Tiempo por día (150 pedidos) | 4-6 horas | 30-40 minutos |
| Tasa de envío a tiempo | 80-85% | 96%+ |
Estrategia de doble plataforma: Hepsiburada + Trendyol
Los vendedores de comercio electrónico turcos más exitosos operan tanto en Hepsiburada como en Trendyol simultáneamente. Las dos plataformas tienen diferentes puntos fuertes:
- Hepsiburada: Más fuerte en electrónica, electrodomésticos, B2B. Grupos demográficos de mayor edad y mayores ingresos
- Trendyol: Más fuerte en moda, belleza, alimentación. Grupo demográfico más joven y que prioriza los dispositivos móviles
Ejecutar ambos desde Odoo requiere:
- Inventario unificado: conjunto de existencias único asignado en ambas plataformas con reservas de seguridad
- Precios específicos de cada plataforma: diferentes tasas de comisión y dinámica competitiva por plataforma
- Seguimiento del rendimiento independiente: cada plataforma tiene su propio algoritmo de puntuación del vendedor
- Informes consolidados: comparación de ingresos, márgenes y rendimiento entre plataformas
El conector ECOSIRE admite la configuración multiplataforma de Odoo y nuestra guía de gestión de mercados múltiples cubre la estrategia operativa en detalle.
Servicios de integración de ECOSIRE
Los servicios de integración de Odoo de ECOSIRE brindan soporte completo para los vendedores de Hepsiburada:
- Implementación y configuración de conectores de extremo a extremo
- Localización turca (KDV, contabilidad, factura electrónica)
- Diseño de flujo de trabajo de cumplimiento personalizado
- Integración y optimización de transportistas de carga.
- Configuración de plataforma dual (Hepsiburada + Trendyol de un Odoo)
- Capacitación del personal y soporte continuo.
Explore el catálogo de conectores del mercado de ECOSIRE para ver todas las integraciones disponibles.
Preguntas frecuentes
¿Cómo funciona la máquina de estado de pedidos de Hepsiburada con Odoo?
Hepsiburada requiere que los pedidos avancen a través de estados específicos en secuencia: selección, facturación, empaquetado y envío. El conector ECOSIRE automatiza esta máquina de estados dentro del flujo de trabajo de procesamiento de pedidos de Odoo. Cuando el personal del almacén confirma la recolección, el conector genera automáticamente la factura y cuando la entrega se crea con un número de seguimiento, el conector avanza a través de los estados Empaquetado y Enviado en Hepsiburada.
¿Puedo ejecutar Hepsiburada y Trendyol desde la misma instancia de Odoo?
Sí. El conector ECOSIRE admite la operación en múltiples mercados desde una única instancia de Odoo. El inventario se gestiona de forma centralizada con reglas de asignación por plataforma. Los pedidos de ambas plataformas fluyen hacia el flujo de trabajo unificado de procesamiento de pedidos de Odoo, y la conciliación financiera mantiene las comisiones y tarifas de cada plataforma separadas para un análisis preciso de la rentabilidad.
¿Cómo maneja la integración el sistema de reclamos y disputas de Hepsiburada?
Los reclamos de los compradores de Hepsiburada se importan al módulo de asistencia técnica de Odoo con todos los detalles relevantes (información del pedido, tipo de reclamo, evidencia del comprador). Su equipo puede revisar reclamos, enviar respuestas con evidencia y realizar un seguimiento de los resultados de la resolución, todo dentro de Odoo. Las métricas de reclamaciones se incorporan a su panel de rendimiento del vendedor para identificar y abordar problemas recurrentes.
¿El conector es compatible con HepsiJet y otras empresas de carga turcas?
Sí. El conector se integra con HepsiJet, Yurtic Kargo, Aras Kargo, MNG Kargo, Surat Kargo y UPS Turquía. La asignación de transportistas se basa en reglas (usted configura reglas para categoría de producto, peso, destino y urgencia), y los números de seguimiento se envían a Hepsiburada automáticamente desde el módulo de entrega de Odoo.
¿Cómo se manejan los impuestos turcos (KDV)?
El conector asigna las categorías de productos de Hepsiburada a la tasa KDV correcta (1%, 10% o 20%). Las facturas generadas en Odoo llevan los cálculos de impuestos apropiados y la conciliación de liquidación valida los montos de los impuestos con los registros de Hepsiburada. El formato de factura electrónica turca (e-Fatura) es compatible para el cumplimiento normativo.
¿Qué sucede si la llamada API falla durante la actualización del estado del pedido?
El conector implementa una lógica de reintento con retroceso exponencial para fallas transitorias de API. Si una actualización de estado falla después de los reintentos, la orden se marca en Odoo para atención manual y se envía una alerta al contacto de operaciones configurado. El sistema rastrea las métricas de confiabilidad de API para identificar problemas sistémicos.
¿Qué versiones de Odoo son compatibles?
El conector ECOSIRE Hepsiburada es compatible con Odoo 17, 18 y 19 (ediciones Community y Enterprise). Las funciones de localización turca están incluidas con el módulo.
Conclusión
La combinación de Hepsiburada de tráfico masivo, confianza del consumidor construida durante 25 años y fuerte posicionamiento en categorías de alto valor lo convierte en un canal de ventas esencial para cualquier vendedor dirigido al mercado turco. La API estructurada de la plataforma proporciona una base sólida para la automatización, pero la integración debe respetar los requisitos específicos de Hepsiburada: la máquina de estado de los pedidos, el flujo de trabajo de facturación antes del paquete, la integración de la carga y el manejo de reclamos tienen matices específicos de la plataforma.
Los vendedores que invierten en una integración adecuada de Hepsiburada-Odoo obtienen una ventaja adicional: un procesamiento de pedidos más rápido mejora las puntuaciones de los vendedores, lo que aumenta la visibilidad, lo que genera más pedidos: un círculo virtuoso impulsado por la eficiencia operativa. Quienes dependen de procesos manuales descubren lo contrario: el procesamiento lento conduce a una degradación de la puntuación, una visibilidad reducida y una disminución de las ventas.
El camino a seguir está claro. Ya sea que esté estableciendo su primera presencia en Hepsiburada o ampliando una operación existente, conectar la plataforma a su Odoo ERP a través del conector especialmente diseñado de ECOSIRE elimina la fricción operativa que limita el crecimiento y erosiona los márgenes.
Escrito por
ECOSIRE TeamTechnical Writing
The ECOSIRE technical writing team covers Odoo ERP, Shopify eCommerce, AI agents, Power BI analytics, GoHighLevel automation, and enterprise software best practices. Our guides help businesses make informed technology decisions.
Artículos relacionados
Generación de contenido de IA para comercio electrónico: descripciones de productos, SEO y más
Escale el contenido del comercio electrónico con IA: descripciones de productos, metaetiquetas SEO, textos de correo electrónico y redes sociales. Marcos de control de calidad y guía de coherencia de la voz de marca.
Precios dinámicos impulsados por IA: optimice los ingresos en tiempo real
Implemente precios dinámicos de IA para optimizar los ingresos con modelos de elasticidad de la demanda, monitoreo de la competencia y estrategias de precios éticos. Guía de arquitectura y ROI.
Detección de fraude mediante IA para el comercio electrónico: proteja los ingresos sin bloquear las ventas
Implemente una detección de fraude mediante IA que detecte más del 95 % de las transacciones fraudulentas y mantenga las tasas de falsos positivos por debajo del 2 %. Puntuación de ML, análisis de comportamiento y guía de ROI.