Guía de integración de Hepsiburada 2026: API REST, HepsiJet & gestión centralizada de vendedores

1. Arquitectura de la API de Hepsiburada 2026

REST en mpop.hepsiburada.com

La API de vendedor de Hepsiburada es un puro servicio REST/JSON alojado bajo el host paraguas mpop.hepsiburada.com (mpop = «Merchant Platform Open API»). No existe una variante GraphQL ni gRPC. Todo el tráfico autenticado se realiza sobre HTTPS, vinculado a un Merchant ID emitido durante el onboarding de HMS. La superficie de la API se divide en subdominios lógicos en lugar de una única raíz monolítica:

• listing-external.hepsiburada.com — CRUD de anuncios (precio, stock, estado del anuncio)
• mpop.hepsiburada.com/product/api/products — creación de productos y atributos de categoría
• oms-external.hepsiburada.com — gestión de pedidos (pedidos, paquetes, envíos)
• returns-external.hepsiburada.com — devoluciones y reembolsos
• integration.hepsiburada.com/finance — carga de facturas y conciliación financiera

Cada subdominio comparte el mismo esquema de autenticación HTTP Basic pero expone sus propios límites de tasa y convenciones de paginación. El conector HB de Zunapro abstrae esta dispersión tras una única interfaz normalizada.

Autenticación: HTTP Basic sobre HTTPS

A diferencia de la API algo más permisiva de Trendyol o el flujo OAuth SP-API de Amazon, Hepsiburada usa un esquema HTTP Basic auth deliberadamente simple: la cabecera Authorization lleva Basic base64(username:password), donde username es tu clave API y password el secreto emparejado. Cada petición debe llevar además una cabecera User-Agent que incluya tu Merchant ID. Los valores de User-Agent faltantes o malformados son con diferencia la causa más común de 401 Unauthorized en producción.

GET /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
Host: listing-external.hepsiburada.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
User-Agent: {MERCHANT_ID} - SelfIntegration
Accept: application/json

HMS — El panel Hepsiburada Marketplace Service

El panel HMS en merchant.hepsiburada.com es la consola web operativa emparejada con la API. Cada capacidad de la API tiene un equivalente en HMS — edición de anuncios, aceptación de pedidos, emisión de reembolsos, conciliación financiera — y HMS es el único lugar donde aprovisionas las claves API, configuras las direcciones de recogida de HepsiJet y gestionas los permisos de usuario. El rediseño de HMS 2024–2026 aportó una navegación izquierda unificada, informes de liquidación en tiempo real y un nuevo panel «API Health» que expone las tasas 4xx/5xx por endpoint, lo cual es inestimable al depurar una integración.

Límites de tasa e idempotencia

Hepsiburada aplica límites de tasa generosos pero exigidos — normalmente ~30 peticiones/segundo por comerciante en actualizaciones de anuncios y menores (~10/s) en endpoints de pedidos. Las importaciones masivas de productos se limitan por separado y devuelven 202 Accepted con un trackingId; luego consultas /import/{trackingId} hasta que se completa. La API de pedidos admite idempotencia mediante los IDs de paquete y de pedido, que permanecen estables entre lecturas.

2. Conexión vía API REST — paso a paso

Requisitos previos: cuenta HMS & ETBİS

Antes de cualquier llamada a la API, una empresa registrada en Turquía con un vergi numarası (número fiscal), un registro en ETBİS (Elektronik Ticaret Bilgi Sistemi — el registro de empresas de comercio electrónico del Ministerio de Comercio) y un IBAN turco (TR…) debe hacer el onboarding a través de HMS. La revisión KYC suele completarse en 1–3 días hábiles para las entidades registradas en ETBİS; los vendedores no-ETBİS se dirigen a una cola de revisión manual que puede tardar 1–2 semanas.

Onboarding de la API paso a paso

1. Crea una cuenta HMS en merchant.hepsiburada.com con tu vergi numarası e IBAN. Sube tu certificado ETBİS, tu circular de firma (imza sirküleri) y tu documento de la agencia tributaria.
2. Genera las credenciales API en Hesabım → Entegrasyon Bilgileri → API Anahtarı. El sistema devuelve un nombre de usuario, una contraseña y tu Merchant ID estable. Almacena los secretos en un vault — Hepsiburada no volverá a mostrar la contraseña.
3. Autoriza las IP salientes si tu plataforma de integración lo requiere. Zunapro publica un rango fijo de IP de egress para que los vendedores puedan fijarlo en la lista de permitidos de HMS.
4. Haz una prueba con una lectura de anuncio — llama a GET /listings/merchantid/{MERCHANT_ID} y confirma un 200 OK con tu inventario existente.
5. Suscríbete a los webhooks para eventos de pedido: POST /webhook-subscriptions con tu URL de callback y los tipos de evento (order.created, order.cancelled, return.created).
6. Envía tu primer producto con POST /product/api/products/import — Hepsiburada devuelve un trackingId; consúltalo hasta status:DONE.
7. Pasa a producción — cambia la integración a «Aktif» en HMS una vez que las pruebas pasen.

Cabeceras y errores comunes

La regresión de integración más frecuente es un User-Agent faltante o malformado. Hepsiburada exige estrictamente el formato {MERCHANT_ID} - {AppName}; un User-Agent por defecto axios/1.6 u okhttp/4 devuelve 401 Unauthorized sin cuerpo descriptivo. Establece siempre el User-Agent explícitamente y regístralo en el middleware de tus peticiones.

3. Sincronización de productos — árbol de categorías, atributos, variantes

El árbol de categorías

El catálogo de Hepsiburada está organizado como un árbol de categorías estricto de tres a cinco niveles expuesto vía GET /product/api/categories/get-all-categories. Cada producto debe mapearse a un ID de categoría de nivel hoja; los nodos intermedios se rechazan con VALIDATION_ERROR. La renovación de categorías de 2024 fusionó varios nodos heredados (los «Bluetooth Kulaklık» y «Kablosuz Kulaklık» listados por separado se fusionaron en «Kablosuz Kulaklık & Bluetooth»), por lo que cualquier integración anterior a eso necesita una actualización del mapeo de categorías.

Los atributos obligatorios bloquean la aprobación

Cada categoría expone una lista de atributos obligatorios y opcionales vía GET /product/api/categories/{categoryId}/attributes. A diferencia de Trendyol, Hepsiburada trata los atributos obligatorios faltantes como un bloqueo estricto del anuncio — el producto pasa al estado WAITING_FOR_APPROVAL y nunca alcanza «Active» hasta que cada atributo requerido se rellena con un valor de búsqueda válido. Causantes habituales:

• Marca — debe coincidir exactamente con el registro de marcas de Hepsiburada; «Apple» y «APPLE» son IDs diferentes
• Color, talla, capacidad — extraídos de vocabularios controlados, no texto libre
• Periodo de garantía — requerido para la electrónica, expresado en meses como enumeración
• País de origen (Menşei) — requerido para cosmética, alimentación, suplementos

Variantes: separación de anuncio & producto

Hepsiburada usa una separación producto vs anuncio más estricta que la mayoría de los competidores. Un solo producto (HB-SKU, identificador interno) puede tener muchos anuncios (merchantSku) — uno por vendedor, con su propio precio, stock, condición (nuevo/reacondicionado) y garantía. Para productos con variantes (p. ej. una camiseta en S/M/L × Rojo/Azul/Negro), cada combinación es un nodo de producto distinto, opcionalmente agrupado bajo un varyantGroupID para que la página del producto muestre las muestras de color y talla.

Importación masiva vía trackingId

Los envíos de catálogo en producción usan POST /product/api/products/import con un array de hasta 100 productos por petición. La API devuelve un trackingId; los integradores deben consultar GET /product/api/products/import/{trackingId} hasta que el estado sea DONE y luego recorrer los resultados fila por fila en busca de errores de validación. Zunapro agrupa las importaciones en lotes de 100 filas, reintenta los fallos leves y expone informes de errores a nivel de fila dentro del panel del vendedor.

POST /product/api/products/import
Host: mpop.hepsiburada.com
Authorization: Basic ...
User-Agent: {MERCHANT_ID} - Zunapro

{
  "merchant": "{MERCHANT_ID}",
  "items": [{
    "merchantSku": "ZP-TSHIRT-RED-M",
    "categoryId": 18021982,
    "productName": "Premium Pamuklu T-Shirt — Kırmızı M",
    "brand": "Zuna",
    "attributes": [
      {"name":"Renk","value":"Kırmızı"},
      {"name":"Beden","value":"M"}
    ],
    "price": 249.90,
    "availableStock": 87,
    "varyantGroupID": "ZP-TSHIRT-2026"
  }]
}

4. Gestión de pedidos — webhooks, flujo de estados, etiquetas

El ciclo de vida del pedido

Un pedido de Hepsiburada recorre una máquina de estados fija que toda integración debe implementar. Los estados importan — las transiciones prematuras disparan puntos de penalización contra tu puntuación de vendedor:

• Open — pedido recibido, a la espera de aceptación (SLA de 24 horas en la mayoría de categorías, 48 h en muebles)
• InProgress / Picking — vendedor ha confirmado, preparación y embalaje
• Packaged — paquete creado vía API, a la espera de la entrega al transportista
• Shipped — el transportista escaneó el paquete; número de seguimiento activo
• Delivered — entrega de última milla confirmada
• Cancelled / Returned — portal de devolución iniciado por el cliente o el comerciante

Webhook vs polling

Hepsiburada admite tanto webhooks (preferido) como polling. Los webhooks se configuran por Merchant ID en HMS o vía POST /webhook-subscriptions; la plataforma envía eventos JSON a tu endpoint HTTPS con firmas HMAC en la cabecera X-HB-Signature. El polling recurre a GET /orders?status=Open&offset=0&limit=100 con un cron de 30–60 segundos. Zunapro usa por defecto los webhooks con un reconciliador de polling de 5 minutos que captura cualquier evento perdido — un patrón de doble seguridad que mantiene la exhaustividad de pedidos por encima del 99,99 %.

Etiquetas de envío: generación automática de HepsiJet

Cuando marcas un pedido como Packaged con HepsiJet seleccionado, la API genera automáticamente una etiqueta de envío PDF imprimible y devuelve una URL de descarga más un número de seguimiento. No hay una petición de etiqueta separada — la etiqueta viene incluida en la respuesta de creación del paquete:

POST /packages
Host: oms-external.hepsiburada.com

{
  "orderId": "HB-72184",
  "lineItems": [{"id": "HB-72184-1", "qty": 1}],
  "cargoCompany": "HepsiJet"
}

→ 201 Created
{
  "packageId": "PKG-998812",
  "trackingNumber": "HJ73219840TR",
  "labelUrl": "https://mpop.hepsiburada.com/labels/PKG-998812.pdf",
  "status": "Packaged"
}

El portal de devolución

Las devoluciones las inicia el cliente a través del portal de devolución estándar de Hepsiburada (Iade Talepleri) y llegan a los vendedores vía GET /returns?status=Open. Los vendedores tienen 3 días hábiles para aprobar o impugnar la devolución; después se activa la aprobación automática. Las devoluciones aprobadas disparan un reembolso a través del rail de pagos de Hepsiburada (que el vendedor verá en la siguiente liquidación financiera), y el inventario debe reacreditarse vía PUT /listings/{merchantSku}/stock.

5. Sincronización de stock & precio — tiempo real, Buy Box, repricer

El endpoint de stock

El stock se actualiza a través de la API de anuncios con una carga útil consciente del delta:

PUT /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
{
  "availableStock": 42,
  "price": 299.90
}

El endpoint acepta precio y stock en la misma llamada, pero la caché interna de Hepsiburada puede tardar 30–90 segundos en propagarse al escaparate. Las actualizaciones masivas usan POST /listings/import con el mismo patrón de trackingId que la importación de productos.

Sincronización en tiempo real vs cron

Los vendedores de nivel producción usan sincronización basada en eventos (cada cambio de stock en tu ERP dispara un PUT a Hepsiburada en segundos) en lugar de un cron de 15 minutos. El riesgo de una sincronización solo por cron es la sobreventa durante los periodos de alta demanda (Ramazan kampanyası, Black Friday, Efsane Cuma). El modelo híbrido de Zunapro dispara PUT inmediatos y un reconciliador de 15 minutos por si hay eventos perdidos — el mismo patrón documentado en nuestra arquitectura de auto-sincronización de precio & stock master→local→targets.

Ganar la Buy Box

La Buy Box de Hepsiburada (oferta por defecto «Sepete Ekle» en una página de producto compartida) se otorga mediante una fórmula ponderada que combina:

• Precio — competitivo dentro del 1–2 % de la oferta válida más baja
• Salud del stock — profundidad, frescura, sin roturas de stock recientes
• Promesa de entrega — HepsiJet gana en igualdad de condiciones
• Valoración del vendedor — mínimo 9,0+ en los KPI de entrega y servicio
• Tasa de defectos de pedido — cancelaciones, envíos tardíos, devoluciones penalizadas

Un repricer bien afinado que reevalúa los precios de la competencia cada 5–10 minutos suele elevar la cuota de Buy Box en un 15–30 % en los SKU disputados.

6. HepsiJet — red de mensajería propia

La última milla verticalmente integrada de Hepsiburada

HepsiJet es la red de mensajería de última milla propia de Hepsiburada, lanzada en 2017 para romper la dependencia de Yurtiçi y Aras Kargo en los SKU sensibles al tiempo. Para 2026, HepsiJet opera 1500+ puntos de recogida en 81 provincias, realiza entregas el mismo día en Estambul, Ankara e Izmir, y utiliza su propia flota de más de 2500 vehículos además de una red de shubeleri en franquicia.

Estándar de código de barras y formato de etiqueta

Cada etiqueta de envío de HepsiJet lleva un código de barras Code-128 que codifica un número de seguimiento de 12 caracteres con el prefijo HJ (por ejemplo HJ73219840TR). La etiqueta PDF generada por la API usa un diseño A6 apto para impresoras térmicas; las etiquetas pueden imprimirse directamente a través de la cola ZPL integrada.

El mismo día & Yarın Kapında

HepsiJet ofrece dos niveles de entrega premium visibles en la página del producto:

• «Yarın Kapında» — entrega al día siguiente en 81 provincias cuando el pedido se envía antes de las 14:00 hora local
• «Bugün Kapında» — entrega el mismo día en Estambul, Ankara, Izmir, Bursa, Adana para pedidos realizados antes de las 11:00

Ambos distintivos elevan notablemente la conversión — los propios datos de Hepsiburada apuntan a un aumento de conversión del 15–25 % en los anuncios que llevan los distintivos, aproximadamente equivalente al efecto «Hızlı Teslimat» de Trendyol.

Recogida vs Şubeye Bırak

Los vendedores eligen entre la recogida HepsiJet (el mensajero recoge en el almacén, cobrado por paquete) y Şubeye Bırak (el vendedor deja los paquetes en la sucursal de HepsiJet más cercana, más barato por paquete pero operativamente más pesado). La API de integración admite ambos — la respuesta del paquete incluye un campo pickupAddressId que determina el enrutamiento.

7. HepsiLojistik — el modelo FBA

Qué es HepsiLojistik

HepsiLojistik es el servicio de fulfillment-by-marketplace de Hepsiburada — el análogo turco de Amazon FBA, Trendyol TFC y Allegro One Fulfillment. Los vendedores envían inventario a granel a los centros de fulfillment de Hepsiburada; Hepsiburada gestiona el almacenamiento, la preparación, el embalaje, la entrega de última milla (vía HepsiJet) y las devoluciones. Los pedidos de HepsiLojistik llevan un distintivo específico «Hepsiburada Garanti» y se benefician de la mayor ponderación de visibilidad en la fórmula de la Buy Box.

La red de centros de fulfillment

• Gebze (Kocaeli) — centro de fulfillment insignia, ~150 000 m², sirve a Estambul + Mármara
• Çorlu (Tekirdağ) — añadido en 2023, enfocado en el oeste de Turquía + transfronterizo balcánico
• Kemalpaşa (Izmir) — cobertura del Egeo, abierto en 2024 para el suroeste de Turquía
• Ankara (Polatlı) — hub de Anatolia central, optimizado para la entrega en la región de la capital

La estructura de tarifas

Los precios de HepsiLojistik se publican como una tarifa de fulfillment por unidad más un almacenamiento mensual:

• Tarifa de fulfillment por unidad — normalmente ₺25–₺75 según la banda de peso y la categoría
• Almacenamiento mensual — facturado por m³ al mes, escalonado por velocidad (los SKU de cola larga pagan más)
• Envío de entrada — el vendedor paga el envío de entrada al centro de fulfillment
• Gestión de devoluciones — incluida en la tarifa de fulfillment para las devoluciones dentro de política

Solicitud & onboarding

HepsiLojistik no está abierto por defecto. Los vendedores solicitan a través de HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru, aportando 6 meses de historial de ventas y una lista de SKU objetivo. Hepsiburada prioriza a los vendedores por encima de ~500 pedidos mensuales con patrones de demanda predecibles; los vendedores de menor volumen suelen quedarse en el modelo de recogida HepsiJet independiente.

8. Integración de e-factura (e-Fatura) — GİB & ERP

La GİB e-Fatura es obligatoria

La GİB turca (Gelir İdaresi Başkanlığı — Administración de Ingresos) exige la e-Fatura (facturas XML estructuradas enviadas al portal de la GİB) a todas las empresas por encima del umbral de facturación anual (actualmente ~₺3 M, reducido para los vendedores de comercio electrónico bajo las enmiendas de 2026). Por debajo del umbral, se aplica la e-Arşiv Fatura — igualmente electrónica, algo más ligera en la firma. Los pedidos de marketplace no están exentos: cada pedido de marketplace B2C y B2B requiere una factura electrónica emitida dentro de los 7 días siguientes al evento de expedición.

El endpoint de facturas de Hepsiburada

Hepsiburada expone un endpoint financiero para las cargas de facturas — los vendedores (o sus integradores de e-Fatura) envían el UUID de la GİB y el renderizado PDF de la factura emitida, que luego se muestra al cliente a través del enlace estándar «Faturayı İndir» en la página del pedido:

POST /finance/invoices
Host: integration.hepsiburada.com

{
  "orderId": "HB-72184",
  "invoiceNumber": "ZUN2026000087421",
  "invoiceUuid": "f8e7d6c5-1234-5678-9abc-def012345678",
  "invoiceDate": "2026-06-09",
  "pdfBase64": "JVBERi0xLjQKJ..."
}

Proveedores de ERP & e-Fatura compatibles

La mayoría de los vendedores turcos emiten la factura subyacente a través de su ERP / entegratör de e-Fatura y canalizan el resultado a Hepsiburada. Zunapro incluye conectores nativos para:

• Logo Tiger 3 / Logo Wings — el ERP más desplegado de Türkiye
• Mikro Yazılım — fuerte en el comercio minorista pyme
• Netsis (socio de SAP) — para vendedores empresa
• Foriba, Uyumsoft, Digital Planet, izibiz — integradores puros de GİB e-Fatura

La capa KVKK

Los datos personales de los clientes que fluyen por el pipeline de facturación se rigen por la KVKK turca (Kişisel Verilerin Korunması Kanunu — Ley de Protección de Datos Personales), la regulación local equivalente al RGPD aplicada por la KVKK Kurumu (Autoridad de Protección de Datos). Los vendedores son corresponsables de los datos personales del lado del pedido y deben registrar las actividades de tratamiento en VERBİS cuando corresponda.

9. Errores comunes y soluciones

Principales errores de producción

HTTP / Código	Síntoma	Causa raíz	Solución
401 Unauthorized	Todas las peticiones rechazadas	Cabecera User-Agent faltante o malformada	Establecer User-Agent: {MERCHANT_ID} - {AppName} explícitamente
403 Forbidden	Endpoint específico bloqueado	A la clave API le falta scope; comerciante no aprobado para el módulo	Reemitir la clave en HMS con scopes completos, contactar con el Merchant Support
VALIDATION_ERROR	Producto atascado en WAITING_FOR_APPROVAL	Atributo de categoría obligatorio faltante o valor de búsqueda inválido	Obtener /categories/{id}/attributes, rellenar los campos requeridos con valores de enumeración válidos
BRAND_NOT_FOUND	Importación de producto rechazada	La cadena de marca no coincide exactamente con el registro de marcas de HB	Consultar /brands?name=..., usar el ID devuelto, solicitar la creación de la marca si falta
429 Too Many Requests	Tráfico en ráfaga limitado	Superadas ~30 pet/s en anuncios o ~10/s en pedidos	Implementar back-off exponencial con soporte de la cabecera Retry-After
STOCK_UPDATE_DELAY	El escaparate muestra stock obsoleto durante 30–90 s	Latencia de propagación de la caché, no un bug	Reducir preventivamente el stock ante riesgo de sobreventa; conciliar tras el retardo
HEPSIJET_PICKUP_FAIL	Paquete creado pero sin recogida del mensajero	pickupAddressId incorrecto o dirección fuera de la cobertura de HepsiJet	Verificar la dirección de recogida en HMS, recurrir a Yurtiçi/Aras para los códigos postales excluidos
INVOICE_UPLOAD_REJECTED	La carga de la e-Fatura devuelve 400	Formato de UUID inválido o corrupción del base64 del PDF	Validar el formato UUID v4, recodificar el PDF, reintentar con un número de factura idempotente

Flujo de diagnóstico

Cuando una integración de Hepsiburada empieza a comportarse de forma extraña, el orden de diagnóstico que sigue Zunapro es:

1. Revisar el panel HMS → API Health para las tasas de error a nivel de endpoint
2. Validar el User-Agent y las credenciales Basic-auth con una prueba curl
3. Inspeccionar la cabecera X-Request-Id de una respuesta fallida — el Merchant Support de Hepsiburada la necesita para rastrear un ticket
4. Comparar con el changelog de developers.hepsiburada.com por cambios de esquema recientes

10. Comisión de Hepsiburada 2026 — del 8 % al 22 %

El calendario de comisiones 2026 de Hepsiburada está escalonado por categoría, se publica trimestralmente en HMS bajo Hesabım → Komisyon Oranları y se divide en tres grandes bandas más algunas categorías atípicas (oro, automoción, grandes electrodomésticos).

Comparativa de comisiones 2026 — Hepsiburada vs Trendyol vs Amazon TR

Marketplace	Tramo bajo	Tramo medio	Tramo alto	Suscripción / Otros
Hepsiburada	8 % – 12 %	12 % – 17 %	15 % – 22 %	Cuenta gratuita · HepsiAd opcional · tarifas HepsiLojistik si se usa
Trendyol	9 % – 13 %	13 % – 18 %	16 % – 24 %	Cuenta gratuita · tarifas TFC si se usa · Trendyol Ads opcional
Amazon TR	5 % – 12 %	12 % – 17 %	15 % – 22 %	Professional Seller ~₺99 / mes · tarifas FBA si se usa
n11	6 % – 10 %	10 % – 15 %	13 % – 18 %	Cuenta gratuita · nivel de suscripción n11 Pro opcional
Çiçeksepeti	10 % – 14 %	14 % – 18 %	16 % – 22 %	Cuenta gratuita · especialización en flores/regalos el mismo día

Lectura de la tabla: Hepsiburada está aproximadamente a la par con Amazon TR y algo más barato que Trendyol en todas las bandas. El diferenciador no es la comisión sino la logística — la última milla propia de HepsiJet da a Hepsiburada una ventaja estructural en las promesas de entrega en las grandes metrópolis, mientras que la base de usuarios más amplia de Trendyol compensa sus tarifas ligeramente más altas.

Marco legal turco 2026 — IVA, e-Fatura, KVKK, ETBİS

Tipos de IVA (KDV) 2026

El IVA turco — KDV (Katma Değer Vergisi) — utiliza tres tipos legales en 2026:

• Tipo general del 20 % — la mayoría de los bienes de consumo, electrónica, moda, hogar & decoración
• Tipo reducido del 10 % — alimentos básicos, textiles de ciertas categorías, libros, hostelería
• Tipo superreducido del 1 % — alimentos de primera necesidad (pan, leche, huevos), insumos agrícolas, ciertos productos médicos

Los vendedores de marketplace se registran para el KDV a través del Vergi Dairesi (oficina tributaria) regional; los vendedores transfronterizos pueden usar, después de 2024, el régimen especial de IVA para comercio electrónico recientemente ampliado de Türkiye.

e-Fatura & e-Arşiv — mandato GİB

• e-Fatura — facturas XML estructuradas enviadas a la GİB, obligatorias por encima del umbral de facturación anual y para todos los vendedores de comercio electrónico bajo las enmiendas de 2026
• e-Arşiv Fatura — igualmente electrónica pero más ligera; para B2C por debajo del umbral de e-Fatura
• Ventana de emisión de 7 días — cada pedido de marketplace requiere una factura electrónica dentro de los 7 días siguientes al envío
• e-İrsaliye, e-Müstahsil, e-Smm — documentos complementarios para los flujos logísticos, agrícolas y de autónomos

KVKK — el equivalente al RGPD de Türkiye

La KVKK (Kişisel Verilerin Korunması Kanunu), en vigor desde 2016 y reforzada en 2024 en alineación con el RGPD, regula el tratamiento de datos personales. Los vendedores de marketplace son corresponsables de los datos personales del lado del pedido (nombre, dirección, teléfono, IBAN cuando corresponda) y deben:

• Registrarse en VERBİS (Veri Sorumluları Sicil Bilgi Sistemi) si superan los umbrales
• Mantener una política de privacidad escrita (Aydınlatma Metni) accesible a los clientes
• Atender los derechos de los interesados (acceso, rectificación, supresión) en un plazo de 30 días
• Notificar las violaciones a la KVKK Kurumu en un plazo de 72 horas

ETBİS — el registro de empresas de comercio electrónico

ETBİS (Elektronik Ticaret Bilgi Sistemi), gestionado por el Ministerio de Comercio (Ticaret Bakanlığı), es el registro obligatorio para toda empresa de comercio electrónico que opera en Türkiye. El registro es gratuito y en línea; el número ETBİS debe mostrarse en los perfiles de vendedor de los marketplaces y en los pies de página de las tiendas propias. El KYC de Hepsiburada verifica ETBİS automáticamente durante el onboarding.

Logística & envío — HepsiJet primero, Yurtiçi/Aras de respaldo

La opción por defecto: HepsiJet

HepsiJet es el transportista por defecto para los pedidos de Hepsiburada y el único que activa automáticamente los distintivos «Yarın Kapında» / «Bugün Kapında». Para la mayoría de los vendedores de las grandes metrópolis, canalizar el 80–100 % del volumen a través de HepsiJet es la elección correcta.

Transportistas de terceros integrados

Hepsiburada también integra a los transportistas nacionales establecidos de Türkiye, generando las etiquetas de envío a través del mismo endpoint de creación de paquetes simplemente cambiando el valor cargoCompany:

• Yurtiçi Kargo — la cobertura rural más densa, fuerte en los códigos postales de Anatolia oriental que HepsiJet excluye
• Aras Kargo — SLA B2B competitivos, popular para muebles y bienes voluminosos
• DHL Kargo — franjas de entrega el mismo día flexibles en corredores seleccionados
• PTT Kargo — operador postal estatal, alcance rural, SLA más lentos
• UPS Türkiye / DHL — rutas transfronterizas internacionales

Lógica de enrutamiento en Zunapro

El enrutador logístico de Zunapro evalúa cada pedido frente a una matriz configurable — peso, código postal de destino, valor declarado, clase de SKU — y selecciona HepsiJet por defecto, recurriendo a Yurtiçi para los códigos postales excluidos y a Aras para paquetes de más de 30 kg. El transportista elegido se envía a través del mismo endpoint de paquetes de Hepsiburada, de modo que el cliente ve una experiencia de seguimiento única.

Cómo empezar a vender en Hepsiburada — 2026 paso a paso

El lanzamiento en 5 pasos

1. Regístrate en ETBİS & HMS — abre tu registro ETBİS vía etbis.ticaret.gov.tr, luego haz el onboarding en merchant.hepsiburada.com con vergi numarası, IBAN y circular de firma. El KYC se completa en 1–3 días hábiles.
2. Genera las credenciales API — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Guarda el nombre de usuario/contraseña en tu vault; anota el Merchant ID para las cabeceras User-Agent.
3. Configura la e-Fatura — elige tu integrador GİB (Logo, Mikro, Foriba, izibiz) y confirma que el endpoint de carga de facturas de Hepsiburada es accesible. Prueba con un pedido B2C.
4. Elige tu stack logístico — recogida HepsiJet vs Şubeye Bırak, más respaldo Yurtiçi/Aras para los códigos postales excluidos. Prepara de antemano las etiquetas y el material de embalaje.
5. Conéctate vía Zunapro (10 minutos) — pega las credenciales API en la casilla de Hepsiburada, mapea tu catálogo master, activa las etiquetas automáticas de HepsiJet y la e-Fatura, y pasa el interruptor a producción.

El flujo de conexión de Zunapro

1. Inicia sesión en Zunapro y abre el módulo de Turquía
2. Haz clic en «Connect Hepsiburada» — pega el nombre de usuario API, la contraseña y el Merchant ID
3. Mapeo automático de categorías — el ML de Zunapro propone mapeos de categorías hoja para cada SKU master; confirma con unos pocos clics
4. Activa las etiquetas automáticas de HepsiJet + la e-Fatura — un solo interruptor para cada una
5. Pasa a producción — la primera sincronización de anuncios de un catálogo de 1000 SKU se completa en unos 10 minutos; los webhooks se registran automáticamente

FAQ integración de Hepsiburada 2026