A la página principal
  1. Help Center - Channable
  2. APIs
  3. Configuración de otros canales

Artículos en esta sección

Más información

Configuración de una API de OTTO

Tabla de contenido

Preparación

  • Si eres nuevo en OTTO, primero tendrás que pasar por un proceso de incorporación/registro. Puedes leer más sobre este proceso aquí. 
  • OTTO tiene un par de requisitos para los socios interesados en vender en su marketplace, que puedes encontrar aquí. Te recomendamos leerlos detenidamente antes de configurar la API de OTTO. Si cumples estos requisitos y te has registrado para obtener una cuenta de OTTO Partner Connect, ¡podemos empezar a configurar la API!
  • Si deseas hacer uso de una conexión de pedidos para OTTO, te recomendamos encarecidamente que leas nuestro artículo sobre cómo configurar una conexión de pedidos para OTTO. 
  • ¡Atención! Nuestra API elimina todos los listados existentes en tu cuenta de vendedor de OTTO cuando la API se activa por primera vez.

Paso 1: Crea una nueva conexión

Ve a APIs > Añadir nueva API. Se abrirá una nueva pantalla con la configuración de la API donde podrás hacer clic en el botón "+ Añadir nueva conexión".

Serás redirigido a una vista general donde verás la conexión OTTO OAuth.

Haz clic en el botón 'Conectar con OTTO OAuth'. Una vez que hayas hecho clic en este botón, serás dirigido al entorno de OTTO donde podrás iniciar sesión con tu cuenta de OTTO.

Después de autorizar, serás redirigido a Channable para confirmar y nombrar la conexión. Recomendamos darle un nombre reconocible para identificar fácilmente la conexión.

Paso 2: Crea la API 

Ahora puedes empezar a crear tus listados de productos. Elige tu nueva conexión con OTTO y continúa configurando tu API.

  1. Configura los ajustes de la API:
    • Nombra tu API
    • Elige el ID único por ítem. (recomendamos el campo 'id')

2. Crear API: Haz clic en «Continuar» para crear la nueva API de OTTO.

Paso 3: Crear tu lista de productos

Nota: En los próximos meses iremos desplegando gradualmente Marketplaces V2. Si tu API está en Marketplaces V1, estos pasos pueden ser diferentes. Consulta este artículo para obtener más información. 

Para configurar tu API, sigue los pasos que se describen a continuación. Haz clic en cada paso para ampliar y ver las instrucciones detalladas, que te guiarán a través de todo el proceso.

1. Categorización

Para que se creen los datos de tus productos, estos necesitan una categoría. Añade categorías a tus productos utilizando la función de generar categorías, o crea nuevas categorías desde cero.

  • Smart Categorization: Esta función asigna automáticamente categorías a tus productos basándose en criterios predefinidos, simplificando el proceso de categorización.
  • Categorización manual: Asigna manualmente categorías a tus productos estableciendo reglas específicas. Puedes crear filtros detallados para mapear cada producto a la categoría correcta.
  • Productos sin Categorizar: Revisa y categoriza cualquier ítem que permanezca sin categorizar para asegurar que todos los productos estén organizados correctamente.

Haz clic aquí para leer más sobre la Categorización en APIs.

2. Reglas

Crea diferentes reglas para optimizar los datos de tus productos. Para obtener ejemplos, consulta nuestro artículo de ayuda sobre reglas comunes.

  • Configuración de reglas: Configura varias reglas para refinar los datos de tus productos. Esto puede incluir filtrar, modificar o mejorar los campos de datos para cumplir con los requisitos del Marketplace

Haz clic aquí para leer más sobre las Reglas en las API.

3. Paso Crear

El paso Crear en Channable te permite configurar todos los atributos necesarios para tus ítems, asegurando que los datos de tu producto se alinean con los requisitos del Marketplace. Este paso es crucial para el éxito de los listados de productos y para evitar errores.

3.1 Visión general

  1. Accede al paso Crear: Comienza accediendo a la interfaz centralizada del paso Crear. Aquí es donde gestionarás y mapearás todos los atributos del producto.
  2. Identifica los campos obligatorios y opcionales: Los campos obligatorios están resaltados en rosa, lo que indica que son esenciales para listar tus productos. Los campos opcionales están marcados en naranja y pueden rellenarse en función de las necesidades específicas.

3.2 Rellenar atributos compartidos

  1. Rellenar atributos compartidos: Introduce detalles comunes que se aplican a todos los productos, como EAN, precios y títulos. Este paso garantiza la uniformidad de la información básica del producto en todos tus listados.
    • Utiliza Valores estáticos o dinámicos:
      • Valores estáticos: Introduce directamente valores que permanecen constantes, como la marca o el fabricante.
      • Valores dinámicos: Utiliza campos que se actualizan automáticamente en función de los datos vinculados, ideales para variables como los niveles de stock o los precios.

Una vez introducidos los valores deseados para los atributos compartidos, procede a los atributos específicos de la categoría.

3.3 Especificar atributos específicos de la categoría

  1. Selecciona la categoría del producto: Elige la categoría relevante para tu producto, como ropa o muebles.
  2. Introducir atributos específicos de la categoría: Rellena los atributos específicos de la categoría seleccionada, como la talla para la ropa o las dimensiones para los muebles. Este paso ayuda a afinar tus listados de acuerdo con los requisitos de la categoría. Aquí también puedes utilizar valores estáticos o dinámicos.

Haz clic aquí para leer más sobre el Paso Crear

 

4. Paso Calidad

El paso de Calidad proporciona información instantánea sobre la calidad de la configuración, destacando los errores obligatorios y opcionales para garantizar que los datos de tus productos cumplen las condiciones de los Marketplaces.

Acciones:

  • Ver ítems: Ver productos con problemas específicos.
  • Ver en Crear: Redirecciona al paso Crear para mapear la información que falta.
  • Establecer categorías: Dirige al paso de categorías para categorizar los artículos.
  • Mostrar fuente: Disponible para campos ID, redirige al paso de configuración.

Haz clic aquí para leer más sobre el paso Calidad

5. Paso Vista Previa

El paso de vista previa muestra los atributos mapeados para múltiples ítems, resaltando los errores antes de exportar al Marketplace.

Características

  • Búsqueda y filtrado: Encuentra productos específicos o filtra por mensaje de error/categoría.
  • Resumen de ítems: Muestra todos los ítems a exportar; puedes filtrar para mostrar sólo los ítems con errores
  • Vista previa detallada del producto: Muestra la información que falta y las acciones dinámicas para corregir errores.

Lista de verificación para finalizar los atributos

  • Revisa los atributos compartidos: Comprueba que se han rellenado todos los atributos compartidos obligatorios.
  • Revisar los atributos específicos de la categoría: Asegúrate de que se han rellenado todos los atributos obligatorios específicos de la categoría.
  • Comprueba si hay errores: Corrige los campos marcados en rojo.

Haz clic aquí para leer más sobre el paso Vista previa.

6. Paso de Resultados

La pestaña de resultados proporciona una visión general de los resultados de la configuración de la API, incluidas las cargas correctas, los errores y una vista previa de los productos que se mostrarán. Esta pestaña garantiza que los datos de tus productos se procesan correctamente e identifica cualquier problema que deba resolverse.

  • Visión general: La pestaña de resultados muestra el estado de tus listados de productos, resaltando errores y problemas para obtener información detallada.
  • Vista previa de productos: Muestra una visión general de los productos que se enviarán al Marketplace, permitiendo la verificación de los atributos rellenados correctamente.
  • Exitosos: Enumera los productos procesados correctamente y listos para su inclusión en el listado, confirmando el cumplimiento de los requisitos del Marketplace.
  • Errores: Identifica los errores durante el procesamiento, proporcionando información detallada para solucionar y resolver los problemas.

Las pestañas opcionales, como errores de repricer, historial de eventos de repricer, actualizaciones de stock y actualizaciones de cumplimiento, sólo aparecen si son relevantes para la API que estás utilizando. Haz clic aquí para leer más sobre el paso Resultado. 

Requisitos GPSR y DSA

La Unión Europea (UE) ha introducido nuevos requisitos GPSR y DSA para plataformas en línea, incluidos los Marketplaces.

Para tu API de OTTO en Channable, asegúrate de completar estas secciones en la pestaña de "Atributos compartidos" en el paso de "Crear":

Seguridad del producto (información del fabricante)
En "Seguridad del producto (información del fabricante)", debes agregar la siguiente información:

  • Fabricante o importador: Ingresa el nombre de la empresa del fabricante o importador.
  • Dirección: Proporciona la dirección completa, incluyendo: Nombre y número de la calle, código postal, ciudad, país. Asegúrate de usar comas para separar los elementos de la dirección y no incluir ningún formato adicional o saltos de línea.
  • Región: Ingresa el código de país único de los miembros del Área Económica Europea (EEE) (por ejemplo, "NL", "DE").
  • Correo electrónico: Ingresa la dirección de correo electrónico del fabricante o importador.
  • URL: Ingresa una URL con la información de contacto del fabricante o importador. Esto es obligatorio si no se proporciona un correo electrónico.
  • Número de teléfono: Proporciona un número de teléfono válido del fabricante o importador.

Imágenes adicionales
En "Imágenes adicionales" en la sección "Imágenes", debes agregar un campo que contenga una URL de imagen con la información de seguridad del producto. Por ejemplo, la URL de la imagen podría contener una imagen de la hoja de datos de seguridad del producto o de la etiqueta de advertencia (consulta las opciones disponibles en "Tipo").

Requisitos adicionales para OTTO

  • Información GPSR: Como se menciona en este artículo, la UE ha introducido nuevos requisitos para las plataformas en línea, incluidos los Marketplaces. Para OTTO, asegúrate de rellenar los siguientes campos en la pestaña Item del paso Crear:
    • Fabricante o importador: Introduce el nombre de la empresa del fabricante o importador.
    • Dirección: Indica la dirección completa, incluyendo: Nombre y número de la calle, Código postal, Ciudad, País. Asegúrate de utilizar comas para separar los datos de la dirección y no incluyas ningún formato adicional ni saltos de línea.
    • Correo electrónico: Introduce la dirección de correo electrónico completa del fabricante o importador.
    • Número de teléfono: Indica un número de teléfono válido del fabricante o importador.
  • Referencia del producto:  La referencia del producto en el paso Crear agrupa todas las variaciones que quieras combinar en un solo producto. Esto no es visible para tus clientes. La referencia del producto se puede asignar libremente y puede tener un máximo de 50 caracteres. OTTO reconoce entonces qué productos tienen la misma referencia de producto y crea automáticamente variantes de, por ejemplo, diferentes tamaños, colores, etc. Puedes definir qué distingue a las variantes en el paso Crear de la API de OTTO en Channable.
  • MOIN: Después de crear los productos, OTTO asigna un MOIN (Número de Integración de Mi OTTO) a un producto. Este es un identificador único utilizado únicamente en OTTO. Si tu cargas la información de un producto que ya existe en OTTO, OTTO mostrará un error indicando que se debe utilizar la información del producto existente. Para aceptar el uso de esta información de producto existente, ajusta el campo "Aceptar sugerencia de MOIN" a "Verdadero". Si no deseas aceptar la información de producto sugerida por OTTO, ponte en contacto con OTTO Partner Help.

Paso 4: Envía tus listados de productos a OTTO

Ya casi está, tus listados de productos están listos para ser enviados. Si no has activado tu proyecto, ve a la configuración de tu proyecto en la parte izquierda de la pantalla y haz clic en "Activar tienda".

Después, vuelve a la vista general de APIs y ve a [Tu OTTO API] > Configuración, allí activa la API haciendo clic en «Activar API».

Una vez que hayas activado la API, vuelve a la vista general de la API y haz clic en el botón azul «Actualizar» para enviar tus listados de productos a OTTO.

Notas importantes

  • Eliminación de listados existentes: La primera vez que utilices nuestra API para enviar productos, se eliminarán todos los listados existentes en tu cuenta de vendedor de OTTO.
  • Restricción de visualización: Si es la primera vez que vendes en OTTO es posible que te encuentres con una restricción de visualización. Por favor, sigue los lineamientos proporcionados aquí para resolver este problema en función de tu estado de integración.
  • Verificación del resultado: Un estado 'Exitoso' en la pestaña Resultados indica que tus productos han sido enviados con éxito al área de preparación de productos de OTTO («Produktübersicht» en tu OTTO GUI). Ten en cuenta que esto no garantiza la visibilidad inmediata en OTTO ni la ausencia de errores o advertencias en el envío de datos.
  • Tiempo de procesamiento: OTTO tarda al menos 24 horas en procesar tus productos e imágenes. Si el procesamiento tarda más, considera ponerte en contacto con OTTO Seller Help transcurridos unos días.

Paso 5: Comprueba si hay errores en tus listados de productos

Si has enviado tus listados de productos a OTTO, ve a la pestaña Vista previa de tu API de OTTO y luego establece el filtro en 'error' para ver qué listados de productos tienen errores y no están publicados. Haz clic en un error específico para ver más información sobre la causa del error.