Configuración de una API Obelink

Obelink es una de las mayores tiendas de camping con una amplia gama de tiendas, caravanas, autocaravanas, artículos de camping, accesorios, muebles de jardín y deportes. Este artículo explicará los pasos necesarios para configurar una API de Obelink en la herramienta Channable.

Paso 1: Añadir una nueva conexión Obelink

La API Obelink utiliza la plataforma Mirakl, lo que significa que necesitarás una cuenta Mirakl para empezar a enviar tus listados de productos a Obelink.

Cuando tengas una cuenta Mirakl Obelink, ve a "[Tu compañía] menú de configuración (en la esquina superior derecha) > Conexiones > Añadir conexión". Haz clic en "+ Añadir una nueva conexión" y verás una pantalla, donde puedes seleccionar Obelink. Rellena la etiqueta de tu conexión, por ejemplo, Obelink. A continuación, haz clic en ''Conectar con Obelink''. Serás redirigido al entorno donde puedes iniciar sesión con tus credenciales Mirakl. Después de iniciar sesión, serás redirigido de nuevo a Channable, donde la conexión estará disponible.

Paso 2: Añadir una nueva API Obelink en Channable

Ahora ve a la vista general de las APIs, en tu proyecto. Y haz clic en Añadir nueva API, Selecciona la conexión Obelink que acabas de crear, y dale un nombre a tu nueva API.

Selecciona el campo que deseas utilizar para Único ID por item (recomendamos el campo 'id'), y el Idioma en el que se realizan la categorización y se configurarán los atributos. También puedes añadir un grupo de reglas generales si así lo deseas. Haz clic en "Continuar" para terminar de crear la nueva API Obelink.

Paso 3: Crea tus listados de productos en Channable

Una vez creada la API Obelink, puedes configurar los datos de tus productos siguiendo los pasos de la API.

1. Categorías
   Para que se creen los datos de sus productos, éstos necesitan una categoría. Agrega las categorías de tus productos usando la funcionalidad para auto generar categorías o puedes crearlas de manera manual.
   
   
2. Reglas
   Crea distintas reglas para optimizar el listado de tus productos. Para ver ejemplos, recomendamos que visites el siguiente artículo.
   
   
3. Crear
   En el paso Crear, debes configurar la información de la oferta para tus productos. Aquí puedes encontrar nuestra plantilla predefinida para los listados de productos. Todo lo que tienes que hacer es rellenarla haciendo clic en el campo y seleccionando lo que quieres que aparezca. Por ejemplo, el campo "Precio" debería mostrar el precio de tu producto y así sucesivamente. Cuando hayas terminado de configurar los listados de productos, haz clic en "Guardar" en la parte inferior de la pantalla.
   
   
   Tip! Observa el signo de interrogación detrás de cada campo, si pasas el cursor sobre el signo de interrogación verás la descripción del campo y sugerencias de posibles valores.
   En Valores estáticos para la clase de envío hay 3 valores. En la siguiente tabla, encontrarás estos valores y sus explicaciones:

   Código	Etiqueta	Explicación
   SP	Small parcel	Peso máximo 3 kg; longitud máxima 50 cm y una circunferencia máxima (2xw + 2xh + 1xl) de 111 cm.
   NP	Normal parcel	Peso máximo 31,5 kg; longitud máxima 175 cm y circunferencia máxima (2xw +2xh +1xl) de 300 cm.
   NSP	Non standard parcel	Paquete con longitud o diagonal superior a 130 cm; y/o peso >35 kg; y/o paquete inestable, forma irregular (esfera, cilindro, rollo)

   Por supuesto, si este valor es diferente para algunos de tus productos, puedes rellenar dinámicamente este campo.
   
   Nota I: Obelink también dispone de un campo de oferta adicional, denominado SKU del proveedor. Obelink especificó que algunos socios requieren este atributo para completar el pedido. Así que este campo se añade como un campo de oferta adicional en el paso crear. Si tienes este SKU del proveedor, puedes rellenarlo aquí, si no lo tienes puedes dejarlo vacío.
   Nota II: Obelink dispone de varios canales de venta: obelink.nl, obelink.be y obelink.de, pero no admiten precios específicos por canal, por lo que no mostramos la ventana emergente de selección de canal en la página de configuración de la API ni la pestaña adicional en el paso de creación. Los canales deben ser activados/desactivados en el backend de Mirakl aquí o en Configuración > Partners > Canales.
4. Atributos
   Lo siguiente es rellenar los campos del paso Atributos. Esto es muy importante si quieres vender productos nuevos que aún no existen en el marketplace, y evitará que el 'mirakl_unknown_error_code'. Selecciona primero la categoría que deseas optimizar. Un ejemplo de lo que debería estar delante de ti ahora se puede ver en la siguiente captura de pantalla. Una explicación más detallada de lo que hay que hacer en el paso Atributos se puede encontrar en nuestro artículo de ayuda sobre los atributos.
   

Paso 4: Envía tus productos a Obelink

Ya casi está, tus listados de productos 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 haz clic en "Activar tienda". Después, vuelve a la vista general de APIs y ve a "Tu nombre de API Obelink" > Configuración, donde activarás la API seleccionando "Activar API". Una vez completado este paso, vuelve a la vista general de APIs y selecciona el botón azul "Actualizar" para enviar tus listados de productos a Obelink.

Paso 5: Comprueba si hay errores en las listas de productos

Después de haber enviado tus listados de productos a Obelink, ve a la pestaña Resultados de tu API Obelink. Haz clic en el filtro "error". Ahora puedes ver qué listados de productos tienen errores y no se han publicado. Haz clic en un error específico para ver más información sobre la causa del error. Si has solucionado algunos errores cambiando la configuración o la información del producto, vuelve a ejecutar la API Obelink para ver los nuevos resultados. La creación de nuevos productos siempre da lugar a errores en la pestaña de resultados hasta que Obelink los apruebe.