Guía de integración con Trendyol 2026: API REST, conexión XML & gestión centralizada de tiendas

1. Arquitectura de la API de Trendyol 2026

La API Marketplace de Trendyol es una interfaz RESTful, JSON-sobre-HTTPS, publicada en una única URL base de producción — https://api.trendyol.com — con un entorno de staging aparte en https://stageapi.trendyol.com. Cada llamada a la API se autentica mediante autenticación HTTP Basic Auth: la cabecera Authorization lleva un par ApiKey:ApiSecret codificado en base64, y el Supplier ID se pasa como parámetro de ruta en cada endpoint asociado a un proveedor. No hay un intercambio de token de acceso aparte para los vendedores propios — el Basic Auth se comprueba en cada solicitud — lo que mantiene la integración simple pero implica que unas credenciales filtradas deben rotarse de inmediato a través del panel Partner.

URL base, autenticación, cabeceras

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products
Authorization: Basic BASE64(ApiKey:ApiSecret)
User-Agent: {supplierId} - SelfIntegration
Content-Type: application/json
Accept: application/json

La cabecera User-Agent no es cosmética: el modelado de tráfico y la contabilidad de rate-limit de Trendyol se basan en ella. Los integradores (como Zunapro) envían {supplierId} - Zunapro; los vendedores propios envían {supplierId} - SelfIntegration. Unas cabeceras User-Agent mal marcadas pueden provocar respuestas 401/403 incluso con credenciales válidas.

Límites de tasa y cuotas

Trendyol aplica límites de tasa por endpoint y por proveedor. Los techos publicados para 2026 son:

• Endpoints de producto — normalmente 60 solicitudes/minuto por Supplier ID, con tolerancia a ráfagas de hasta 90/min durante 30 segundos
• Endpoints de pedido — normalmente 600 solicitudes/minuto (pedidos es un endpoint de alto tráfico y baja latencia por diseño)
• Endpoints de actualización de precio & stock — normalmente 100 solicitudes/minuto, con cada solicitud llevando hasta 1000 SKU en un solo lote
• Consultas de categorías & atributos — normalmente 30 solicitudes/minuto (cambian lentamente, por lo que se espera un almacenamiento en caché agresivo)

Cada respuesta incluye las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y, en los 429, Retry-After. Una integración bien construida usa una cola de tipo token-bucket por Supplier ID y aplica contrapresión ante los 429 con retroceso exponencial; Zunapro lo implementa por defecto para que incluso los envíos masivos de varios miles de SKU nunca superen los límites.

OAuth 2.0 para integradores independientes

Para los integradores independientes de capa intermedia (Zunapro y plataformas SaaS similares que actúan en nombre de muchos proveedores), Trendyol ofrece un flujo OAuth 2.0 de tipo authorization-code en lugar de Basic Auth directo. El integrador registra un client_id / client_secret con el equipo de relaciones con desarrolladores de Trendyol, el proveedor autoriza al integrador desde el panel Partner, y el integrador recibe un token de acceso válido durante 1 hora más un refresh token para su reemisión. Esto evita tener que manejar la ApiKey / ApiSecret en bruto del proveedor y es la vía apta para auditorías para clientes empresariales que gestionan muchas tiendas de Trendyol.

Webhooks

Trendyol envía los eventos del ciclo de vida del pedido a la URL de tu webhook registrado: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. La carga útil del webhook es un sobre JSON que lleva el ID del pedido y el nuevo estado; tu endpoint debe responder con un HTTP 200 en menos de 3 segundos. En caso de fallo, Trendyol reintenta 5 veces con retroceso exponencial y luego aparta el evento — por eso una descarga de reconciliación cada 5 minutos contra /sapigw/suppliers/{id}/orders es una red de seguridad no opcional.

2. Conexión mediante la API REST — paso a paso

La ruta oficial ideal para conectarse a la API REST de Trendyol en 2026 es corta y está bien documentada — pero el orden de las operaciones importa, porque algunos requisitos legales están aguas arriba de la propia API.

2.1 Abrir una cuenta de vendedor de Trendyol

Visita partner.trendyol.com y envía una solicitud de «Abrir una cuenta de Trendyol». Necesitarás:

• VKN (Vergi Kimlik Numarası) — número fiscal turco (o registro mercantil equivalente en el extranjero para Trendyol International)
• Boletín del registro mercantil (Ticaret Sicil Gazetesi) para sociedades de responsabilidad limitada o anónimas
• Circular de firmas (imza sirküleri)
• Recibo de registro ETBİS (Elektronik Ticaret Bilgi Sistemi) — obligatorio para cualquier operador de e-commerce turco desde 2018
• Cuenta bancaria (IBAN TR) a nombre de la entidad jurídica para los pagos del marketplace

La aprobación suele tardar de 2 a 5 días hábiles. Una vez aprobado, el vendedor recibe un Supplier ID y acceso al panel Partner de Trendyol.

2.2 Generar la clave API y el secreto

Desde el panel Partner, abre Configuración de la cuenta → Información de integración y haz clic en «Crear clave API». Trendyol genera una clave API de 40 caracteres y un secreto API de 40 caracteres. Ambos valores se muestran una sola vez — no se pueden recuperar después. Guárdalos en un gestor de contraseñas o, mejor, pégalos directamente en el mosaico de integración de Zunapro, que los almacena como secretos enmascarados y cifrados con AES-256.

2.3 Primera solicitud de comprobación (smoke-test)

Confirma que las credenciales están activas consultando el endpoint de información del proveedor:

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \
  -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \
  -H "User-Agent: {supplierId} - SelfIntegration" \
  -H "Accept: application/json"

Una respuesta correcta devuelve las direcciones de almacén y de devolución registradas del proveedor en JSON. Un 401 significa que la cabecera Basic Auth es incorrecta; un 403 significa que el Supplier ID no coincide con las credenciales; un 404 significa que la ruta del endpoint está mal formada.

2.4 Variante OAuth (para integradores multiproveedor)

Para los integradores independientes, el flujo OAuth 2.0 tiene este aspecto:

1. El integrador redirige al proveedor a:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. El proveedor aprueba el acceso; Trendyol redirige de vuelta con ?code={authCode}

3. El integrador intercambia el código por tokens:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Respuesta: { access_token, refresh_token, expires_in: 3600 }

Los tokens de acceso son válidos durante 1 hora y renovables durante 30 días. Zunapro gestiona los cuatro pasos de forma transparente, de modo que el proveedor solo ve un único botón «Conectar con Trendyol».

2.5 Publicar tu primer producto

Usa POST /sapigw/suppliers/{supplierId}/v2/products con un array JSON de artículos. El objeto de producto mínimo requiere barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (normalmente TRY), listPrice, salePrice, vatRate, cargoCompanyId, un array images (1 a 8 URL) y un array attributes de ID de atributos específicos de la categoría.

3. Sincronización de productos a escala

Carga masiva — 1000 SKU por lote

El endpoint POST /v2/products de Trendyol acepta hasta 1000 SKU por solicitud JSON. Para vendedores con catálogos de más de 10 000 SKU, esta es la diferencia entre un onboarding de una hora y uno de varios días. El lote devuelve un batchRequestId por llamada; Trendyol procesa cada lote de forma asíncrona y expone el éxito / fallo por SKU una vez completado el procesamiento (normalmente en 1 a 15 minutos según la profundidad de la cola de validación).

Mapeo de categorías — el único paso más difícil

El árbol de categorías de Trendyol es profundo y estricto. A partir de 2026 hay aproximadamente 12 000 categorías hoja, cada una con su propio conjunto de atributos obligatorios y opcionales. Unos vaqueros listados bajo «Hombre → Pantalones → Casual» requieren los atributos gender, size, color, material y fit-type; un smartphone bajo «Electrónica → Móvil → Teléfonos» requiere brand, model, memory, guaranteeType y warrantyPeriod. Publicar un producto en una categoría hoja incorrecta, o en la categoría correcta pero omitiendo un atributo obligatorio, produce un rechazo silencioso en el resultado del lote.

El enfoque recomendado es:

1. Extraer el árbol de categorías en vivo desde GET /sapigw/product-categories (cachear 24 h)
2. Para cada categoría hoja, extraer los atributos obligatorios + opcionales desde GET /sapigw/product-categories/{categoryId}/attributes
3. Emparejar los SKU de tu catálogo maestro con las categorías hoja de Trendyol — Zunapro usa un mapeador ML entrenado con millones de anuncios históricos de Trendyol para sugerir categorías a partir del título + la marca + tu taxonomía, con una tasa de coincidencia al primer intento superior al 92 %
4. Validar cada SKU contra los atributos obligatorios antes de llamar al endpoint POST, para evitar malgastar rate-limit en solicitudes condenadas al fracaso

Lista blanca de marcas y brandId

Cada producto debe referenciar un brandId que exista en el registro de marcas de Trendyol. Las marcas nuevas no se pueden crear sobre la marcha — pasan por un proceso manual de aprobación de marca a través del panel Partner (normalmente de 1 a 3 días hábiles). Usa GET /sapigw/brands?name={brandName} para buscar un brandId existente antes de crear productos.

Reglas de carga de imágenes

• 1 a 8 imágenes por producto
• URL HTTPS públicas (Trendyol rastrea y realoja las imágenes en su CDN)
• Mínimo 1200×1800 px, fondo blanco para las categorías de moda
• JPG o PNG, máx. ~10 MB por imagen
• La primera imagen se convierte en la miniatura de los resultados de búsqueda — inviértele

Consulta del estado del lote

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}

Response:
{
  "batchRequestId": "abc-def-...",
  "status": "COMPLETED",
  "itemCount": 1000,
  "items": [
    { "requestItem": {...}, "status": "SUCCESS" },
    { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] }
  ]
}

4. Gestión de pedidos — webhooks y el flujo de estados

El ciclo de vida del pedido 2026

Un pedido de Trendyol pasa por un flujo de estados fijo:

Created → Picking → Invoiced → Shipped → Delivered

Flujos derivados:
  Cancelled (en cualquier momento antes de Shipped)
  Returned (después de Delivered, dentro de la ventana de 14 días)
  UnDelivered (excepción del transportista)

Cada transición dispara tanto un evento de webhook (push) como se refleja en la siguiente descarga GET /orders (poll). El vendedor es responsable de las transiciones Picking → Invoiced → Shipped; los socios logísticos de Trendyol controlan Shipped → Delivered.

Recepción de webhooks e idempotencia

Cada webhook lleva un shipmentPackageId único. Procésalo de forma idempotente — Trendyol sí reintenta los eventos ante una respuesta distinta de 200, y el procesamiento duplicado por tu parte (doble facturación, doble preparación) es un riesgo real. El patrón pragmático es:

POST /webhook/trendyol
{
  "supplierId": 123456,
  "shipmentPackageId": 987654321,
  "status": "Picking",
  "timestamp": 1717930000000
}

Handler:
1. Adquirir un bloqueo sobre shipmentPackageId
2. Comprobar el estado almacenado; si ya es >= "Picking", devolver 200 (no-op)
3. Persistir el nuevo estado, planificar las acciones posteriores (factura electrónica, tarea de preparación)
4. Devolver un HTTP 200 en menos de 3 segundos

Flujo de cancelación y reembolso

Las cancelaciones iniciadas por el comprador llegan como webhooks Cancelled; las cancelaciones iniciadas por el vendedor se envían mediante POST /sapigw/suppliers/{id}/orders/{orderId}/cancel con un código de motivo de cancelación (OUT_OF_STOCK, OTHER, etc.). Los reembolsos de artículos entregados + devueltos los gestiona Trendyol automáticamente; la única obligación del vendedor es confirmar la recepción de la mercancía devuelta dentro de las 48 horas siguientes al escaneo del transportista.

Etiqueta de envío de Trendyol Express

Una vez que un paquete pasa al estado Picking, solicita la etiqueta de envío mediante GET /sapigw/suppliers/{id}/orders/{orderId}/labels — Trendyol devuelve un PDF (y opcionalmente ZPL para impresoras térmicas) que contiene el código de barras de Trendyol Express, la dirección del comprador y el número de seguimiento del envío. El código de barras es el único artefacto de enrutamiento del transportista — imprímelo, pégalo, escanéalo en tu WMS, déjalo en un punto de recogida de Trendyol Express (o programa una recogida por mensajero para vendedores de alto volumen).

5. Actualizaciones de stock & precio en tiempo real

El patrón de envío stock-precio

Trendyol expone un endpoint dedicado a las actualizaciones de stock y precio: POST /sapigw/suppliers/{id}/products/price-and-inventory. Cada llamada acepta hasta 1000 artículos, con barcode, quantity, salePrice y, opcionalmente, listPrice por artículo. Las actualizaciones se aplican en segundos para el stock, y en 2 a 5 minutos para el precio (Trendyol cachea el precio para la coherencia del feed de compras).

POST /sapigw/suppliers/{id}/products/price-and-inventory
{
  "items": [
    { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 },
    { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 }
  ]
}

La arquitectura de sincronización Maestro → Local → Destinos

Para los vendedores que operan varios canales de venta (Trendyol + Hepsiburada + Çiçeksepeti + tienda propia), la única arquitectura sensata es un inventario maestro en Zunapro que envía a cada marketplace de destino. La pila de producción de Zunapro 2026 ejecuta un cron cada 15 minutos más un envío orientado a eventos: cualquier cambio de stock en el maestro dispara un envío inmediato price-and-inventory a Trendyol, mientras que el cron garantiza la coherencia final para cualquier envío que se haya escapado. Los SKU se emparejan por barcode (primario) o stockCode (alternativo) — nunca por el ID de producto interno de Trendyol, que puede cambiar al reasignar categorías.

Reglas de IVA y de visualización de precios

Los precios de Trendyol son con IVA incluido. El régimen de IVA (KDV) 2026 de Turquía es del 20 % estándar, 10 % reducido (alimentación, libros, medicamentos, bienes básicos) y 1 % especial (productos alimenticios esenciales, ciertos productos agrícolas). El vendedor especifica el vatRate por producto y es responsable de elegir la tasa correcta; los errores se señalan a posteriori como rechazo de factura electrónica por parte del GİB, lo que es caro de subsanar.

Trendyol Fast Sale y sincronización de campañas

Las campañas insignia de Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Mercado del miércoles) — son campañas de elegibilidad obligatoria que aumentan la visibilidad de los anuncios pero conllevan una comisión de campaña adicional del 1 al 3 %. Los vendedores inscriben SKU en las campañas mediante POST /sapigw/suppliers/{id}/products/campaigns con anulaciones de precio con descuento; Zunapro valida automáticamente los precios mínimos de campaña contra tus reglas de margen maestras para evitar compromisos por debajo del coste.

6. Alternativa XML / CSV — cuándo (y cuándo no) usarla

El modelo de pull XML

Trendyol admite un modelo de feed XML como alternativa al flujo POST REST. El vendedor aloja un archivo XML en una URL HTTPS pública que describe el catálogo; Trendyol lo extrae con una cadencia configurable (normalmente cada 1 a 4 horas). El esquema XML se publica en el panel Partner y refleja la forma del objeto de producto del endpoint REST — barcode, title, brandId, categoryId, attributes, images, precio, stock.

El mismo patrón se admite mediante CSV (una fila por SKU) para los vendedores cuyo ERP exporta CSV de forma más natural que XML.

Comparación: API REST vs XML / CSV

Cuándo XML / CSV es realmente la opción correcta

• ERP heredado sin capacidad de cliente HTTP que ya exporta XML / CSV cada noche
• Catálogos de baja rotación (menos de 500 SKU, cambios de precio semanales, altas de catálogo mensuales)
• Migración inicial desde otro marketplace, donde una exportación CSV única acelera la primera sincronización

Para todo lo demás — webhooks de pedido, stock en tiempo real, inscripciones en campañas, sincronización multicanal — REST es la única vía viable en 2026. Zunapro admite ambos modos, pero usa REST por defecto y el XML / CSV estrictamente como fuente de ingesta ETL desde los ERP heredados.

7. Trendyol Express & FBA Trendyol

Trendyol Express — la capa logística

Trendyol Express es la rama logística de propiedad íntegra de Trendyol — lanzada en 2018 y que opera hoy la red de paquetería nativa de e-commerce más densa de Turquía. Para 2026 cubre más de 50 000 casilleros de autoservicio y puntos de recogida junto con su propia flota de mensajería, llegando a 81 provincias con entrega el mismo día en Estambul, Ankara, Esmirna, Bursa y Antalya, y entrega al día siguiente al resto de la Turquía continental. Los compradores ven insignias «Hızlı Teslimat» (entrega rápida) en los anuncios elegibles, y el ranking de búsqueda de Trendyol las pondera con fuerza.

FBA Trendyol — el almacén logístico de Trendyol

FBA Trendyol (a veces llamado «Trendyol Lojistik Deposu» o «Trendyol Mağaza Plus») es el equivalente a Amazon-FBA: los vendedores envían su inventario a los centros de fulfillment de Trendyol en Çorlu (la instalación insignia, 250 000 m² cerca de Estambul), Sancaktepe y Ankara, y Trendyol se encarga del almacenamiento, la preparación, el empaquetado, la entrega de última milla mediante Trendyol Express y las devoluciones. Los anuncios FBA llevan una insignia distinta «Trendyol'dan Gönderim» y reciben una ponderación de visibilidad prioritaria en la búsqueda.

Tarifas y elegibilidad de FBA Trendyol

• Onboarding — solicítalo a través del panel Partner; el equipo comercial de Trendyol revisa el volumen mensual, las dimensiones de los SKU y la adecuación de la categoría
• Tarifa de almacenamiento — facturada mensualmente por metro cúbico de espacio de almacén ocupado; varía según la temporada (el almacenamiento cuesta más en el Q4)
• Tarifa de preparación y empaquetado (pick-and-pack) — tarifa plana por pedido, variable según la banda de peso del paquete (menos de 500 g, 500 g–2 kg, 2–5 kg, 5–10 kg, 10 kg+)
• Gestión de devoluciones — incluida en la tarifa de pick-and-pack para las devoluciones estándar; las condiciones marcadas se facturan aparte

Cuándo tiene sentido FBA Trendyol

El punto de equilibrio de FBA Trendyol frente al autoenvío se sitúa en torno a 800–1200 unidades al mes por SKU de almacén para consumibles, electrónica o moda por tallajes de rotación rápida. Por debajo de eso, el autoenvío mediante el depósito en Trendyol Express más tu propio contrato con Aras / Yurtiçi / DHL suele ser más barato. Por encima, el aumento de conversión de la insignia «Trendyol'dan Gönderim» más la promesa de entrega el mismo día casi siempre supera el coste de fulfillment por unidad.

8. Integración de factura electrónica GİB (e-Fatura / e-Arşiv)

El mandato del GİB

La Gelir İdaresi Başkanlığı (GİB — Administración Tributaria) de Turquía ha hecho obligatoria la e-Fatura para cualquier empresa con una facturación anual por encima del umbral publicado por el GİB (revisado anualmente; ~3 M TRY en 2026) y la e-Arşiv Fatura obligatoria para todas las facturas B2C por encima de ~30 000 TRY (revisado anualmente). Para los vendedores activos de Trendyol en 2026, la cobertura de e-Fatura / e-Arşiv es de hecho universal — prácticamente cada pedido del marketplace debe producir una factura electrónica sellada por el GİB dentro de la ventana de estado del pedido, so pena de sanciones.

Los cinco integradores certificados por el GİB

Los vendedores pueden usar directamente el portal del GİB (impracticable a los volúmenes de un marketplace) o contratar con un Özel Entegratör (integrador especial) certificado por el GİB. Los cinco actores dominantes en 2026 son:

• Logo Yazılım — el mayor proveedor de ERP turco; e-Logo para la emisión de facturas
• Mikro Yazılım — proveedor de ERP y factura electrónica de gama media, fuerte en el segmento pyme
• Uyumsoft — integrador independiente con una API REST robusta y la mayor base de vendedores de marketplace
• Foriba — proveedor de nivel empresarial (adquirido por Sovos en 2019), fuerte en sectores regulados
• Veriban — alternativa de rápido crecimiento con precios competitivos y una API amigable para desarrolladores

El flujo de factura electrónica del marketplace

1. Webhook de Trendyol: estado del pedido -> "Picking"
2. Zunapro extrae el detalle del pedido (nombre del comprador, VKN/TCKN, dirección, artículos)
3. Zunapro hace POST del borrador de factura al integrador (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. El integrador firma con el certificado de firma electrónica, lo envía al GİB
5. El GİB devuelve el ETTN (Número Único de Documento Electrónico)
6. Zunapro almacena el ETTN, adjunta el PDF al pedido de Trendyol
7. Zunapro pasa el pedido de Trendyol de Picking -> Invoiced mediante la API

Elección práctica en 2026

Para los vendedores nuevos, Uyumsoft y Veriban son los más fáciles de integrar (registro web, API REST, sin dependencia on-premise). Los vendedores que ya usan un ERP de Logo o Mikro deberían quedarse con el producto de factura electrónica del mismo proveedor para la conciliación contable. Foriba es la opción para grandes empresas con flujos fiscales complejos. Zunapro incluye las cinco integraciones detrás de una única pantalla de configuración — elige el integrador, pega las credenciales de API, y cada pedido de Trendyol genera su factura automáticamente.

9. Errores comunes y cómo diseñar tu sistema para evitarlos

Discordancia de categoría

Síntoma: el resultado del lote muestra INVALID_CATEGORY o CATEGORY_NOT_LEAF. Causa: publicar en una categoría no-hoja, o en una categoría hoja cuyo conjunto de atributos el SKU no cumple. Solución: publica siempre solo en categorías hoja (la API rechaza las no-hoja), y prevalida los atributos contra el conjunto required: true de la categoría antes del POST.

Atributos obligatorios ausentes

Síntoma: MANDATORY_ATTRIBUTE_MISSING en SKU por lo demás válidos. Causa: Trendyol marca ~30 % de los atributos como obligatorios según la categoría (género para moda, garantía para electrónica, etc.). Solución: cachea el mapa de requisitos de atributos por categoría y bloquea los POST según la completitud; Zunapro autocompleta a partir de tu taxonomía maestra donde es posible.

Retrasos en la sincronización de stock

Síntoma: un SKU agotado sigue apareciendo en stock en Trendyol durante varios minutos, provocando sobreventas. Causa: los envíos price-and-inventory son de coherencia final, con una latencia mediana de ~5–8 segundos, y durante los picos de tráfico (Black Friday, Trendyol Week) la cola puede alargarse a 30–60 segundos. Solución: implementa un búfer de seguridad local (reserva las últimas 1–2 unidades como búfer de agotado por SKU de alta velocidad) y envía los cambios de stock de forma síncrona en el evento de confirmación del pedido, no solo en el cron.

Webhooks perdidos

Síntoma: el webhook de pedido nunca llega o llega con horas de retraso. Causa: normalmente un cambio de firewall del lado del vendedor, una renovación de certificado TLS que rompió la URL del webhook, o una breve caída que superó el presupuesto de 5 reintentos de Trendyol. Solución: ejecuta siempre una descarga de reconciliación paralela cada 5 minutos contra /sapigw/suppliers/{id}/orders?status=Created&startDate=...; Zunapro lo hace por defecto y fusiona de forma idempotente cualquier pedido extraído que el webhook también entregó.

Varios anuncios, mismo código de barras (Mükerrer Listing)

Síntoma: un solo SKU aparece como varios anuncios de Trendyol, y el stock se decrementa de forma distinta en cada uno. Causa: fusiones históricas, entradas duplicadas de código de barras, o dispersión de un mismo producto entre varias tiendas. Solución: la política de deduplicación al stock MIN de Zunapro (introducida en nuestra actualización de producción del 06/06/2026) agrupa todos los anuncios duplicados bajo un mismo código de barras y rastrea el valor de stock mínimo entre ellos, evitando el clásico desastre de «vendido dos veces en dos anuncios, una sola entrega prometida».

10. Comisión de Trendyol y tarifas de vendedor 2026

El esquema de comisiones 2026 de Trendyol se escalona por categoría, con tres bandas amplias y sin tarifa fija por artículo. La participación en campañas (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) añade un 1 al 3 % adicional sobre la tasa de categoría.

Tarifas de vendedor / de suscripción

Trendyol no cobra una suscripción mensual. No existe un nivel «Vendedor profesional» al estilo de Amazon. Los vendedores pagan:

• Comisión de categoría en cada venta (8–22 %)
• Comisión de campaña al participar en Trendyol Fast Sale / Week (+1–3 %)
• Trendyol Express tarifa por envío (pagada por el comprador, pero que fluye a través de la cuenta de resultados del vendedor)
• FBA Trendyol almacenamiento + pick-and-pack (solo si está inscrito)
• Trendyol Ads CPC (opcional, controlado por el vendedor)

Ciclo de pago

Los vendedores estándar cobran en un ciclo T+14 (14 días después de la entrega del pedido), reducido a T+7 para los vendedores con una puntuación de vendedor de primer nivel. Los pedidos en disputa, las devoluciones dentro de la ventana de 14 días y los contracargos se retienen del pago. Los pagos llegan al IBAN TR registrado.

Marco jurídico turco 2026 — lo que los vendedores de marketplace deben saber

KDV (IVA) y bandas de tasa de KDV

El IVA turco — KDV (Katma Değer Vergisi) — tiene tres tasas en 2026: 20 % estándar, 10 % reducido (alimentación, libros, medicamentos, hostelería), 1 % especial (productos alimenticios básicos, agricultura). Los vendedores de marketplace domiciliados en Turquía se registran en el KDV a través de su oficina tributaria local; los vendedores transfronterizos por encima del umbral de servicios digitales usan el régimen de KDV para no residentes. El campo vatRate de cada POST de producto de Trendyol debe coincidir con la tasa legalmente correcta — los errores se propagan a las facturas electrónicas y pueden requerir declaraciones rectificativas.

e-Fatura / e-Arşiv (obligatorio GİB)

Ya cubierto en detalle en la sección 8. En resumen para 2026: cada pedido de marketplace produce una factura electrónica sellada por el GİB (e-Fatura para B2B / destinatarios de e-Fatura registrados, e-Arşiv para B2C). El vendedor es responsable de la emisión dentro de la ventana de estado del pedido. La emisión manual es impracticable a los volúmenes de un marketplace — elige uno de los cinco integradores del GİB y automatiza.

KVKK — el RGPD turco

La KVKK (Kişisel Verilerin Korunması Kanunu — Ley n.º 6698) es el régimen turco de protección de datos, estructuralmente similar al RGPD y aplicado por la KVKK Kurumu. Los marketplaces gestionan el consentimiento y el tratamiento del lado del comprador, pero los vendedores siguen siendo corresponsables del tratamiento para cualquier contacto de atención al cliente directo, marketing o comunicación posterior a la compra. Las sanciones por incumplimiento van de 60 K TRY a más de 3 M TRY según la clase de infracción.

ETBİS — registro de e-commerce obligatorio

ETBİS (Elektronik Ticaret Bilgi Sistemi) es el registro obligatorio del Ministerio de Comercio para cualquier operador de e-commerce en Turquía, en vigor desde 2018. Los vendedores deben registrarse antes de listar en Trendyol y declarar los volúmenes de transacciones anuales. Los datos de ETBİS alimentan la aplicación de la protección al consumidor, el cribado antifraude y la analítica competitiva.

Protección al consumidor — desistimiento de 14 días, garantía de 2 años

• Derecho de desistimiento de 14 días — los consumidores turcos pueden devolver cualquier producto comprado a distancia dentro de los 14 días, sin motivo (Tüketicinin Korunması Hakkında Kanun, Ley n.º 6502)
• Garantía legal de 2 años — obligatoria en las ventas B2C, independiente de cualquier garantía del fabricante
• Información del producto obligatoria en idioma turco — título, descripción, garantía, política de devoluciones, todo en turco

Logística & envíos en Turquía — Trendyol Express primero

Trendyol Express — la capa dominante

Trendyol Express es el transportista por defecto en aproximadamente el 70 %+ de los pedidos de Trendyol en 2026. El comprador ve envío gratuito o de bajo coste con entrega el mismo día o al día siguiente en las grandes metrópolis, más de 50 000 casilleros de autoservicio (Trendyol Hızlı Teslimat Noktaları) donde los compradores recogen los paquetes 24/7. Los vendedores dejan los paquetes en un punto de recogida de Trendyol Express o programan una recogida por mensajero; el albarán de enrutamiento lleva el código de barras de Trendyol Express obtenido mediante la API de etiqueta de pedido.

Los otros transportistas integrados

• Yurtiçi Kargo — mensajero turco veterano, red B2C y B2B sólida, integrado para los pedidos de Trendyol
• Aras Kargo — competidor con fuerte cobertura anatolia, a menudo usado para pedidos de Trendyol autoenviados
• DHL Kargo — tercer gran mensajero turco, alternativa habitual para vendedores de alto volumen
• PTT Kargo — operador postal estatal, el mayor alcance rural, SLA más lentos
• Sürat Kargo — actor regional, competitivo en las regiones de Mármara y el Egeo

Pila de envíos práctica 2026

La pila pragmática 2026 para un vendedor de Trendyol: Trendyol Express por defecto (es lo que los compradores esperan), Yurtiçi o Aras como alternativa del lado del vendedor para los pedidos autoenviados que pierden la ventana de recogida de Trendyol Express, PTT Kargo para los códigos postales únicamente rurales donde ningún otro transportista es económico, y FBA Trendyol para los SKU de rotación rápida una vez que el volumen justifica el compromiso de almacenamiento.

Cómo empezar a vender en Trendyol — onboarding en 5 pasos

1. Cuenta de vendedor de Trendyol

Solicítala en partner.trendyol.com. Aporta el VKN, el Boletín del registro mercantil, la circular de firmas, el recibo de registro ETBİS y el IBAN TR. Aprobación en 2 a 5 días hábiles.

2. ETBİS + registro fiscal

Registra la entidad jurídica en ETBİS a través del portal del Ministerio de Comercio (etbis.gtb.gov.tr) y confirma el registro de KDV con la oficina tributaria local. Los vendedores extranjeros que operan mediante Trendyol International designan un representante turco o usan el programa de importador oficial de Trendyol.

3. Generar la clave API + el secreto

Desde el panel Partner → Configuración de la cuenta → Información de integración, haz clic en «Crear clave API». Copia inmediatamente la clave API (40 caracteres) y el secreto API (40 caracteres) — solo se muestran una vez. Pégalos en el mosaico de Trendyol de Zunapro, donde se almacenan cifrados con AES-256 y enmascarados.

4. Conectar a través del panel de Zunapro

1. Inicia sesión en Zunapro y abre el módulo de Turquía
2. Pega el Supplier ID + API Key + API Secret en el mosaico de integración de Trendyol
3. Ejecuta la comprobación de estado automática (credenciales, endpoint de direcciones, información del proveedor)
4. Confirma los mapeos de categorías sugeridos por el ML para tus 100 SKU principales
5. Elige tu integrador de factura electrónica (Logo, Mikro, Uyumsoft, Foriba o Veriban) y pega esas credenciales
6. Activa «Trendyol Express» + «FBA Trendyol» (si estás inscrito)

5. Realizar un pedido de prueba

Coloca de 3 a 5 pedidos de staging contra stageapi.trendyol.com para ejercitar de principio a fin los flujos de pick-pack, impresión de etiquetas, transición de estados y reembolso. Una vez en verde, cambia la integración a producción con un solo interruptor. La primera sincronización de producción de un catálogo de 5000 SKU se completa en unos 30 a 60 minutos dados los límites de tasa de Trendyol.

Las tres vías de integración con Trendyol — comparadas

Antes de comprometerte con una arquitectura de integración, conviene comparar en paralelo las tres vías legítimas.

FAQ de integración con Trendyol 2026