Configurar una nueva API de Bol.com – Help Center - Channable

Traducción obsoleta: Este artículo ha sido actualizado en inglés, pero aún no hay una traducción disponible. Para obtener información más precisa, consulta la versión en inglés.

Este es un artículo del Centro de ayuda de Channable, la herramienta para la gestión de feeds de productos e integraciones de marketplace. Si aún no tienes una cuenta, regístrate gratis o aprende cómo integrar tu tienda online con Bol.com.

¿Deseas aprender de forma interactiva todos los aspectos básicos relacionados con la creación de una exportación API, o cómo realizar una configuración avanzada para una API en Channable? Aprende a crear una cuenta Channacademy en la Channable app a través de este artículo del Centro de Ayuda y empieza con el curso APIs Básicas o APIs Expertas.

Nota I: Este artículo asume que ya te has anunciado en Bol.com con tus productos. Si quieres anunciarte por primera vez en Bol.com, por favor lee también nuestro artículo de apoyo sobre cómo añadir códigos EAN desconocidos a Bol.com.

Nota II: Los códigos EAN son obligatorios para Bol.com. Asegúrate de tener códigos EAN válidos para todos tus productos, de lo contrario no se podrán crear listados de productos en la plataforma.

Nota III: Debes cerrar sesión en tu cuenta de Bol.com antes de crear una conexión. De lo contrario, el inicio de sesión se hará automáticamente y esto puede causar problemas más adelante en el proceso.

Importante: Es posible que tu conexión de Bol.com caduque después de usarla por un tiempo. Esto resultará en una "API fallida" con un mensaje de error. Para actualizar tu conexión, sigue los pasos de este artículo.

Tabla de contenido

Paso 1: Crear una conexión de Bol.com en Channable
Paso 2: Crear una nueva API de Bol.com
Paso 3: Crea tus listados de productos
Requisitos GPSR y DSA
Paso 4: Envía tu listado de productos a Bol.com
Paso 5: Comprueba si tus listings tienen algún error

Paso 1: Crear una conexión de Bol.com en Channable

Para crear una nueva conexión con Bol, ve a [nombre de tu compañía en la esquina superior derecha] > Conexiones. Haz clic en "+Agregar una nueva conexión" y verás esta pantalla, donde puedes seleccionar Bol.com:

Después de seleccionar Bol.com, asigna un nombre a la conexión y haz clic en "Conectar con Bol.com". A continuación, serás redirigido a tu cuenta de vendedor de Bol.com:

Cuando hayas iniciado sesión en tu cuenta de vendedor de Bol.com y hayas aceptado los términos y condiciones, serás redirigido a Channable. No olvides hacer clic en el botón azul "Añadir conexión" para guardar tu nueva conexión.

Paso 2: Crear una nueva API de Bol.com

Ahora puede utilizar esta conexión recién creada. Para ello, ve a "APIs > + Agregar nueva API" y selecciona tu conexión Bol.com. Introduce la siguiente información:

Un nombre para la API
El Único ID por Ítem. Recomendamos utilizar el campoid.
El Lenguaje de contenido. Ten en cuenta que no es posible cambiar estos ajustes una vez que ya han sido guardados.
También puedes elegir que sólo se envíen los datos de contenido a Bol.com. Para más información sobre esta función, lee este artículo.
Por último, también puedes añadir un grupo de reglas generales (opcional).

Haz clic en "Continuar" para empezar a crear los listados de productos en la API de Bol.com.

Paso 3: Crea tus listados de productos

Configura tus listados de productos siguiendo los 4 pasos que se indican a continuación.

Categorías

Añade categorías a tus productos utilizando la función de generar categorías o añade nuevas categorías desde cero. También puede hacer uso de nuestra categorización inteligente, que hace coincidir automáticamente tus artículos con la categoría de producto más adecuada de Bol.com.
Si Bol.com ya conoce los códigos EAN de tus productos, puedes crear los listados sin categorizar tus productos. Después de ejecutar la API por primera vez, en el caso de que tus productos no sean reconocidos por Bol.com, verás el siguiente error en "Resultado": UNMATCHED_OFFER. Para solucionar este error, consulta este artículo.
Reglas
Crea distintas reglas para optimizar los datos de tus productos. Para ver ejemplos puedes echar un vistazo a nuestro artículo de reglas más comunes. Asegúrate de incluir las tres reglas que se muestran a continuación para evitar errores.

Regla 1: Comprobar códigos EAN. Bol.com sólo acepta productos cuyo código EAN sea válido, por lo que si el código EAN es inválido, esta regla excluye el producto.

Regla 2: Eliminar duplicados en imágenes adicionales. Con la siguiente regla, Channable puede verificar si las imágenes adicionales de cada producto contienen duplicados de su imagen principal. Si la herramienta encuentra duplicados, la regla los elimina.

Regla 3: Límite de stock a 500. Bol.com no acepta productos cuyo stock sea superior a 500. Por lo tanto, puedes establecer un límite al stock si éste supera los 500. Sin embargo, enviar un stock estático durante varios días puede causar problemas en Bol, porque Channable sólo envía los cambios a Bol.com. Esto significa que si sigues enviando un stock estático de 500 en algún momento no estarás enviando ningún stock y Bol pensará que el producto está agotado. Por eso siempre debes configurar dos reglas alternando el stock entre días.
Crear
Puedes completar la información de la plantilla haciendo clic en el campo y seleccionando un campo importado o escribiendo manualmente un valor. Por ejemplo, puede asignar el título del campo importado al campo "Título" de la plantilla.

También debes introducir aquí los códigos de envío de tus productos. Para más información al respecto, puedes leer este artículo.

Tip: Observa el signo de interrogación que aparece junto a cada campo; si pasas el cursor por encima, verás la descripción del campo y sugerencias de posibles valores.

Nota: Para evitar errores, el campo "Comentario" debe permanecer vacío si la condición es Nieuw. Una vez enviado el campo "Comentario" a Bol, sólo podrás eliminarlo borrando los listados de Bol.com y enviándolos de nuevo sin comentario.

En el paso Crear, encontrarás otras 3 pestañas además de la plantilla predeterminada:
a. Descuento por volumen. La función de Descuento por volumen permite establecer descuentos para los consumidores que compren más de una cantidad de un producto. Para obtener más información sobre cómo configurar el descuento por volumen en Channable, haz clic aquí.
b. Descuento. Bol.com ofrece una comisión más baja para determinados productos si alcanzan un precio máximo específico. Puedes leer cómo activarla aquí.
c. Imágenes. Aquí enlazas las imágenes que quieres enviar a Bol.com. También tienes la opción de seleccionar la visualización de las imágenes, pero también de otros activos multimedia. En este artículo se explica cómo hacerlo.
Una vez que haya terminado de rellenar la información, simplemente haz clic en "Guardar" en la parte inferior de la pantalla.

4. Atributos:

En "Atributos", selecciona primero la categoría que deseas optimizar. Un ejemplo de lo que verás ahora se puede observar en la siguiente captura de pantalla. Una explicación más detallada se puede encontrar en nuestro artículo sobre Atributos.

Como ya hemos dicho, te recomendamos que intentes enviar tus listados de productos a Bol.com sin rellenar los atributos. Si Bol.com ya conoce los códigos EAN de tus productos, no necesitarás este paso. Ten en cuenta que los atributos dejan de estar disponibles automáticamente si te has saltado la categorización previa.

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 cumplir con GPSR en bol, sigue estos pasos.

Configura una o más entidades de operadores económicos en tu cuenta de vendedor de bol según en estas instrucciones.
Copia el nombre de cada operador económico individual y agrégalo al campo "Operador económico" en Atributos compartidos en la etapa de Crear de tu integración de bol en Channable.
Si utilizas varios operadores económicos, crea un nuevo campo de proyecto y usa reglas para dividir los nombres de tus operadores económicos entre tus productos.
Actualiza el exportador para añadir los operadores a las ofertas en bol.

Consejos:

Para eliminar un operador existente de un producto, deja el campo "Operador económico" vacío.
Para cambiar un operador existente por uno nuevo, agrega el nombre del nuevo operador en el campo "Operador económico".

Paso 4: Envía tu listado de productos a Bol.com

Tus productos están listos para ser enviados. Si tu proyecto aún no está activo, ve a "[Tu proyecto] > Configuración > Activar proyecto". A continuación, vuelve a "APIs > [Tu API de Bol.com] > Configuración > Activar API". Una vez hecho esto, puedes ejecutar la API haciendo clic en el botón azul "Actualizar". Esto enviará inmediatamente los listados de productos a tu cuenta de vendedor de Bol.com.

Paso 5: Comprueba si tus listings tienen algún error

Si ya has enviado tus productos a Bol.com ve a la pestaña de Resultado de tu API. Haz clic en "Errores". Ahora puedes ver qué listados de productos tienen errores y no han sido publicados. Si hay errores, intenta resolverlos añadiendo más reglas o ajustando la información en los pasos de Crear y Atributos (ver Paso 2). Vuelve a ejecutar la API de Bol para comprobar si el error se ha resuelto.

"Información de producto insuficiente" para EAN desconocidos

Si envías productos a Bol cuyo código EAN no se encuentra aún en su base de datos, es posible que los productos se muestren como "Exitosos" en Channable pero tengan el mensaje "Información de producto insuficiente" en tu cuenta de vendedor de Bol. Esto significa que aún no se ha enviado a Bol toda la información obligatoria para estos productos. Para solucionar este error lee nuestro artículo sobre cómo añadir nuevos códigos EAN a Bol.com.

Importante: Si tienes previsto vender productos clasificados como sustancias peligrosas, debes asegurarte de que cumplen el reglamento CLP (Clasificación, Etiquetado y Envasado) de la EU. Por lo tanto, es obligatorio rellenar las características del producto en "palabra de advertencia", las "indicaciones de peligro" y el "aviso de precaución". Puedes rellenar esta información en el generador de atributos de tu API buscando estas palabras en holandés: 'Signaalwoord', 'Gevarenaanduidingen', 'Voorzorgsaanduiding'. Puedes ver estos productos a través de tu cuenta de vendedor yendo a "Mis artículos" y luego seleccionando la opción "Low (en línea)" en el filtro "Información del producto". Aquí encontrarás los artículos para los que aún falta la información de sustancias peligrosas.

La información del producto en bol.com no coincide con la información que envías a través de la API.

Los socios de bol.com venden millones de artículos a través de Bol.com, y cada socio puede proporcionar información de producto por artículo. Esta cantidad de información no puede verificarse manualmente. Por lo tanto, el algoritmo de Bol.com examina la información de producto proporcionada por los socios, lo que da como resultado una puntuación por socio. Como resultado, la información de producto del socio con la puntuación más alta aparece automáticamente en línea en una página de producto. Al proporcionar una buena información sobre los productos, mejora tu puntuación. Para más información, consulta este artículo de Bol.com.

Artículos en esta sección