Planifica un traspaso controlado de tu catálogo de Trendyol a una tienda propia, con la correspondencia de campos, variantes, precios, inventario, recursos multimedia y validación.
Trasladar productos de Trendyol a un canal de comercio electrónico propio no consiste en copiar títulos y precios de un archivo a otro. Una migración fiable concilia la identidad de los productos, los atributos de categoría, las relaciones entre variantes, el inventario, los impuestos, los derechos sobre los recursos multimedia y las operaciones posteriores al pedido dentro de un mismo modelo de datos. El objetivo no es cerrar las ventas en marketplaces, sino abrir un canal adicional en el que la marca controle su catálogo.
La documentación oficial para desarrolladores de Trendyol presenta V2 como el área de integración actual. Los endpoints y los requisitos de los campos pueden cambiar, por lo que la implementación debe ajustarse siempre a la documentación V2 vigente y a los permisos asignados a la cuenta del vendedor. El scraping, la copia automatizada desde la interfaz de usuario o la extracción de datos sin autorización no son métodos de integración sostenibles.
Determina primero qué se puede transferir
Separa los datos en tres categorías:
- Datos maestros de marca: el SKU propio de la marca, el código de barras, el nombre y la descripción del producto, el coste, el tipo impositivo y los recursos multimedia sobre los que tiene derechos de uso.
- Datos del canal: identificadores de producto o vendedor de Trendyol, correspondencia de categorías, precio del canal y códigos de estado específicos del marketplace.
- Datos que pueden pertenecer a la plataforma o a terceros: opiniones de clientes, valoraciones, distintivos, diseño de página y recursos creados por la plataforma.
Construye la nueva tienda en torno a la primera categoría. Conserva la segunda solo para la correspondencia y la conciliación. Verifica expresamente los derechos antes de trasladar cualquier elemento de la tercera. En particular, no des por sentado que las valoraciones y opiniones de clientes son contenido de catálogo que la marca pueda reproducir libremente.
Crea un diccionario de correspondencias entre origen y destino
Antes de la migración, prepara un diccionario de datos aprobado por todas las partes responsables:
| Concepto de origen | Campo de destino | Regla de transformación | Gestión de errores |
|---|---|---|---|
| merchantSku | canonicalSku | Eliminar espacios en blanco; conservar mayúsculas y minúsculas | Poner en cuarentena si falta |
| barcode | barcode | Conservar como texto; mantener los ceros iniciales | Detener si está duplicado |
| productMainId | productGroupKey | Agrupar las variantes bajo un mismo producto | Notificar las variantes sin producto padre |
| categoryId | targetCategoryId | Usar una tabla de correspondencias aprobada | Mantener como borrador si no hay correspondencia |
| attributes | attributes | Normalizar código, valor y unidad | No publicar si faltan datos obligatorios |
| salePrice | channelPrice | Aplicar las reglas de impuestos y margen | Solicitar aprobación si está por debajo del umbral |
| quantity | sourceInventory | Descontar el stock de seguridad; establecer un mínimo de cero | Generar una alerta de anomalía |
| imageUrls | mediaAssets | Comprobar el acceso HTTPS, el formato y los derechos | No publicar si falla algún recurso multimedia |
Incluso el título de un producto requiere criterio. Un título de marketplace repleto de palabras clave puede no encajar con el estilo editorial de la tienda propia. Mantén un nombre neutro en el catálogo canónico y genera títulos específicos para cada canal. Aplica el mismo principio a las descripciones, los textos SEO y las promesas de entrega.
El modelo de variantes es el punto clave
Las opciones de color, talla y volumen pueden aparecer como filas de producto independientes en el origen, mientras que la tienda de destino las presenta como opciones en una misma página de producto. Conserva el SKU, el código de barras, el stock, el precio y la relación con los recursos multimedia de cada variante.
Por ejemplo, reducir una variante «Negro / 38» a «38» aumenta el riesgo de preparar un pedido con el artículo equivocado. Una clave de variante puede ser una combinación determinista de los códigos de color y talla, pero debe mantenerse estable. Comprueba el producto padre y la matriz de variantes para verificar lo siguiente:
- ¿Hay dos variantes del mismo grupo con la misma combinación de opciones?
- ¿Está asociado un mismo código de barras a varios SKU activos?
- ¿Tienen todas las variantes stock disponible para la venta y un precio?
- ¿Una imagen corresponde al producto padre o a un color concreto?
- ¿Se ha reactivado por error en el destino una variante inactiva en el origen?
Una arquitectura de integración más segura
Una canalización directa de «leer de Trendyol y escribir en la tienda activa» es frágil. Añade una capa de preparación observable:
Conexión autorizada al origen → zona de datos sin procesar → transformación y correspondencia → validación → catálogo canónico → publicación en la tienda
Una respuesta sin procesar con marca de tiempo ayuda a investigar incidentes, pero no deben conservarse datos personales o secretos innecesarios y el acceso debe estar restringido. Las transformaciones deben poder repetirse: procesar dos veces la misma versión del origen no debe crear productos duplicados. Una combinación de la identidad del vendedor en el origen, el SKU y la versión de los datos puede servir como clave de idempotencia.
El conector debe respetar los límites oficiales, reintentar los fallos transitorios con intervalos cada vez mayores y evitar reintentos indefinidos ante errores 4xx permanentes. Las credenciales no deben incluirse en el código ni en una URL de feed; guárdalas en un sistema de gestión de secretos y concede los permisos mínimos necesarios. La cuenta del vendedor que utilice la integración debe estar expresamente autorizada para hacerlo.
Separa la migración inicial de la sincronización continua
El primer traspaso del catálogo es un proyecto; las actualizaciones de inventario y precios son operaciones continuas.
- Carga inicial: incorpora la información de los productos, las variantes, los atributos y los recursos multimedia como borradores.
- Sincronización del inventario: actualiza las unidades disponibles para la venta a intervalos breves y aplica un margen de seguridad por canal.
- Sincronización de precios: designa una fuente de precios aprobada por finanzas; los cambios automatizados no deben vulnerar el margen mínimo.
- Sincronización de contenido: envía los cambios a revisión en lugar de sobrescribir automáticamente el contenido enriquecido de la tienda propia.
- Desactivación: no elimines un artículo cuando desaparezca o se cierre en el origen; márcalo como inactivo y conserva los vínculos con los pedidos abiertos y los informes.
Cuando ambos canales venden el mismo stock físico, la «última cantidad conocida» no es suficiente. Se necesita una reserva entre el momento de añadir al carrito y el pago, una liberación tras la cancelación y una política para gestionar las ventas por encima del stock disponible. Para los productos clave, la protección más sencilla consiste en asignar stock por canal o aplicar un margen de seguridad.
Tres puntos de control de validación
Control 1 — esquema: campos obligatorios, tipo, longitud, valores permitidos, unicidad y relaciones de referencia.
Control 2 — comercial: IVA, precio de lista y de venta, margen de contribución mínimo, inventario, aptitud para la venta y derechos sobre los recursos multimedia.
Control 3 — experiencia: visualización en dispositivos móviles, selección de variantes, añadir al carrito, búsqueda y filtros, información de entrega y proceso de pago.
El informe automatizado de conciliación debería mostrar, como mínimo, el número de productos de origen frente al de filas incorporadas; el número de SKU y códigos de barras únicos; el total de productos padre y variantes; los productos publicados, en borrador y en cuarentena; las imágenes inaccesibles; y las anomalías de precio o inventario. Añade una revisión manual por muestreo para cada categoría.
Ejemplo práctico de migración
Pensemos en una marca de hogar y decoración con 600 filas de productos en Trendyol. El análisis inicial revela que corresponden a 420 productos padre y 180 variantes. La primera fase se limita a 80 productos padre con ventas en los últimos 90 días e inventario fiable. La correspondencia de categorías define 12 categorías de destino, 46 atributos obligatorios y siete conversiones de unidades. Los productos se incorporan a una tienda de prueba; 11 códigos de barras que faltan, ocho SKU duplicados y 17 imágenes inaccesibles se ponen en cuarentena. No se publica nada hasta resolver estos problemas. La aprobación permite publicar primero 10 productos y luego los 80; 20 pedidos de prueba verifican de principio a fin el inventario, los envíos y las devoluciones.
RACI: ¿quién es responsable de cada decisión de migración?
| Área de trabajo | Responsable de la ejecución | Responsable último | Consultados | Informados |
|---|---|---|---|---|
| Conexión oficial y seguridad | Integración/tecnología | Responsable de tecnología | Responsable de la cuenta de Trendyol | Comercio electrónico |
| Correspondencia de campos y categorías | Operaciones de catálogo | Responsable de comercio electrónico | Producto, SEO | Atención al cliente |
| Precio e impuestos | Finanzas | Responsable de finanzas | Comercio electrónico | Dirección |
| Derechos sobre recursos multimedia y textos | Marca/contenido | Responsable de marca | Asesoría jurídica | Equipo de catálogo |
| Inventario y pedidos | Operaciones | Responsable de operaciones | Tecnología, finanzas | Atención al cliente |
| Decisión de puesta en marcha | Responsable del proyecto | Responsable de comercio electrónico | Responsables de todas las áreas de trabajo | Empresa |
Lista de comprobación para la puesta en marcha
- ¿Se han confirmado la documentación oficial V2 vigente y los permisos de la cuenta?
- ¿La identidad de origen y el SKU de marca están separados y se pueden rastrear?
- ¿Las correspondencias de categorías y atributos están versionadas y aprobadas?
- ¿Se han validado la matriz de variantes, la unicidad de los códigos de barras y la relación con los recursos multimedia?
- ¿Se han probado las reglas de precio, impuestos, margen mínimo y stock de seguridad del inventario?
- ¿Puede volver a ejecutarse la integración sin generar productos duplicados?
- ¿Hay una persona responsable identificada para la cola de errores, las alertas, los reintentos y las correcciones manuales?
- ¿Se ha probado al menos un escenario de cancelación, devolución y falta de stock con un pedido realista?
Cuando la migración del catálogo sea estable, no te limites a publicar productos en la nueva tienda. Vincula colecciones seleccionadas a escaparates de creadores para generar demanda para el nuevo canal. Consulta la guía de feeds de escaparates de creadores para dar ese siguiente paso.
Inicia el proceso de alta como vendedor de comercio electrónico o crea una cuenta de marca para incorporar tu catálogo a un canal propio y a una red de ventas con influencers mediante un proceso controlado.