Configuración de una API de OTTO – Channable

Antes de empezar

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: Establecer una conexión

Una vez que llegues a "listo para vender" en el proceso de incorporación/registro, recibirás tus credenciales de API. Ten en cuenta que estas credenciales serán enviadas mediante un correo electrónico automático y no pueden ser obtenidas desde tu cuenta de OTTO Partner Connect. Si no puedes encontrar este correo electrónico, ponte en contacto con OTTO.

Una vez que hayas recibido tus credenciales, dirígete a APIs > Agregar nuevo API. Se abrirá una nueva pantalla con la configuración de la API en la que podrás dar clic en el botón "+ Agregar nueva conexión".

Serás redirigido a una vista general donde verás la conexión de OTTO. Selecciona esta conexión y rellena el nombre de usuario y la contraseña que has recibido en el correo electrónico mencionado anteriormente.

Después de hacer clic en Continuar, se establecerá la conexión y podrás empezar a rellenar la información de tu producto.

Paso 2: Crear tu lista de productos en Channable

Una vez que hayas creado un nuevo exportador de la API utilizando la conexión recién creada, puedes configurar los datos de tus productos siguiendo los pasos de la API.

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

2. Reglas
Crea diferentes reglas para optimizar los datos de tus productos. Para ver ejemplos, echa un vistazo a nuestro artículo de soporte de reglas comunes.

3. Crear
Aquí puedes encontrar nuestra plantilla preestablecida para los listados de productos. Todo lo que tienes que hacer es rellenarla haciendo clic en el propio campo y seleccionando lo que quieres que vaya allí. Por ejemplo, el campo "Título" debería mostrar el título de tu producto y así sucesivamente. Cuando hayas terminado de configurar los listados de productos, simplemente haz clic en "guardar" en la parte inferior de la pantalla.

¡Consejo! Fíjate en el signo de interrogación que hay detrás de cada campo, si pasas el cursor por encima del signo de interrogación verás la descripción del campo y sugerencias de posibles valores.

Nota: 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 de atributos de la API de OTTO en Channable.

Nota: 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.

4. Atributos
¡Ya casi hemos terminado! Lo siguiente es rellenar los campos en el paso de Atributos. Selecciona primero la categoría que deseas optimizar. En la captura de pantalla de más abajo, podrás ver un ejemplo de lo que tu pantalla debería mostrar. Puedes encontrar una explicación más detallada de lo que hay que hacer en el paso de Atributos en nuestro artículo de soporte de Atributos.

Paso 3: Envía los datos de tu producto a OTTO

Tus listados de productos ya están listos para ser enviados. Si no has activado tu proyecto, ve a Configuración > Configurar tienda en la parte izquierda de la pantalla y da clic en "Activar tienda". Después, vuelve a la pestaña de APIs y dirígete a "Tu nombre de API de OTTO" > Ajustes donde activarás la API seleccionando "Activar API".

¡Importante! Nuestra API elimina todos los listados existentes en tu cuenta de vendedor de OTTO cuando la API se activa por primera vez.

Una vez que hayas completado este paso, vuelve a la pestaña de APIs y haz clic en el botón azul "Actualizar" para comenzar a enviar tus listados de productos a OTTO.

Nota I: 'Exitoso' en la pestaña de Resultado no significa automáticamente que tus productos estén inmediatamente en vivo en OTTO o que no haya errores o advertencias en los datos enviados. 'Exitoso' significa que tus productos fueron enviados exitosamente al área de preparación de productos (en su GUI de OTTO bajo "Produktübersicht" visible). Aquí también se mostrarán los posibles errores por los que los productos no están publicados (todavía).

Nota II: Si eres nuevo en OTTO o si es la primera vez que vendes en OTTO y has enviado con éxito los productos de Channable a tu cuenta de vendedor de OTTO, entonces te encontrarás con una restricción de visualización. Por favor, lee aquí cómo puedes deshacerte de la Restricción de Visualización y ten en cuenta que hay diferentes flujos de trabajo (ver "Hinweis" en el artículo) dependiendo de cuándo se haya completado el Onboarding.

Tus productos e imágenes tardan al menos 24 horas en ser procesados. Si tus artículos no han sido procesados después de un par de días, te sugerimos que envíes un correo electrónico a la Ayuda al Vendedor de OTTO.

Paso 4: Resolviendo errores

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

Migrar a OTTO API v3

A partir del 31 de marzo de 2023, OTTO dejará de ser compatible con la V2 de la API V. Así que nos hemos asegurado de dar soporte completo a la V3 antes de esta fecha límite. Sólo hay una cosa a la que debes prestar atención después de haber actualizado la versión 3 de la API de OTTO, nos referimos a que con la nueva versión de la API, ahora tendrás que enviar a OTTO los IDs de marca en lugar de nombres de marca.

La mejor manera de configurar esto es a través de la regla encontrar valor dentro de la configuración de la API de OTTO. Recomendamos crear un nuevo campo brand_id para esto. La regla podría ser algo similar a esto:

Con esta regla, puedes agregar una lista de posibles marcas en la columna de la izquierda y los ID de marca correspondientes en la columna de la derecha.

Para saber qué IDs de marca puedes utilizar, tenemos disponible esta lista para ti aquí.

Si vendes muchas marcas diferentes, puedes ponerte en contacto con nuestro servicio de soporte y te ayudaremos a obtener todos los ID de marca correctos. Podemos utilizar las marcas que tienes agregadas actualmente y crear un archivo que contenga todos los ID de Marca correspondientes. Puedes luego importar ese ID de marca o copiar y pegar estos valores en las reglas. Recomendamos hacerlo en las reglas para no complicar aún más tu importación, pero la decisión es tuya.

Artículos en esta sección