Servidor bol.com MCP: pedidos, ofertas y envíos

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → bol.com, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

bol.com

API de minorista de bol.com para vendedores en el mercado holandés y belga: pedidos, envíos con seguimiento, devoluciones, inventario FBB, ofertas con precio y stock, comisión, contenido del catálogo, ofertas competidoras, valoraciones, facturas e indicadores de rendimiento. ID de cliente y secreto.

Configuración

Configurar lleva unos 3 minutos. Necesitas una cuenta de vendedor de bol.com (Verkopen via bol) y acceso a la configuración de la API en el panel de vendedor de bol. El conector necesita un ID de cliente y un secreto de cliente para la API de minorista.

1. En el panel de vendedor de bol abre tu cuenta, luego Instellingen → Diensten → API Instellingen (Configuraciones, Servicios, Configuración de API). Guarda un contacto técnico si bol lo solicita.
2. Bajo Client credentials voor de Retailer API haz clic en Aanmaken (Crear), dale un nombre a la clave y haz clic en Toon secret (Mostrar secreto).
3. Copia el ID de cliente en BOL_CLIENT_ID y el secreto en BOL_CLIENT_SECRET. Si se pierde el secreto, crea nuevas credenciales.
4. Instala el conector. Ejecuta bol_com_list_orders para verificar la conexión: devuelve tus pedidos abiertos que envías tú mismo (FBR).

La nube y el autoalojamiento funcionan de la misma manera: las credenciales son las mismas, y no hay URL de redirección ni dirección IP que registrar.

Autenticación: el conector intercambia el ID de cliente y el secreto en https://login.bol.com/token (credenciales de cliente) por un token de portador que dura unos 5 minutos, y lo reutiliza hasta que expire. Nunca solicita un nuevo token en cada llamada, porque bol bloquea direcciones que saturan su servicio de inicio de sesión.

Por dónde empezar: bol_com_list_orders lista los pedidos FBR abiertos, los más recientes primero; bol_com_get_order añade los detalles de envío y facturación del cliente y los artículos. bol_com_list_offers lista tus ofertas y bol_com_list_inventory muestra el stock que bol tiene para ti en sus almacenes (FBB).

Qué lee: pedidos, envíos con transporte y seguimiento, devoluciones con razones y comentarios de clientes, stock FBB, ofertas con precio, stock y disponibilidad por país, por qué una oferta no está a la venta, comisión por un producto a un precio, contenido del catálogo de bol por EAN, ofertas competidoras y quién tiene la buy box, valoraciones por estrellas, visitas y porcentaje de buy box por oferta, indicadores de rendimiento del vendedor por semana, y facturas (solo lectura).

Envíos: bol_com_create_shipment confirma el envío de artículos que envías tú mismo, con tu transportista y código de seguimiento. bol_com_add_track_and_trace añade un código faltante a un envío; no puede cambiar uno existente.

Ofertas: bol_com_create_offer y bol_com_update_offer crean ofertas y cambian precio, stock, cumplimiento, países o la bandera de en espera. Una actualización solo cambia los campos dados, pero un array (precios de paquete, países) reemplaza el antiguo por completo. Un 409 significa que alguien cambió la oferta al mismo tiempo. Los precios están en EUR incluyendo IVA, y el stock es de 0 a 999.

Desactivado en la instalación: bol_com_cancel_order_item (cancelar un artículo de pedido que no puedes entregar) y bol_com_delete_offer (eliminar una oferta). Una cancelación no se puede deshacer y cuenta contra tu puntuación de vendedor, y una oferta eliminada desaparece de bol de inmediato y no puede ser restaurada. Para pausar una oferta, configúrala en espera con bol_com_update_offer en su lugar. Actívalas en la página del conector solo si la IA debe usarlas; la IA te pedirá que confirmes cada cambio. Los envíos, el seguimiento y la creación y actualización de ofertas están activados.

Escrituras asíncronas: los envíos, transportes y cancelaciones responden con un estado de proceso en lugar de un resultado. bol_com_get_process_status (o bol_com_find_process_statuses por entidad y tipo de evento) muestra cuándo está en ÉXITO o FALLA. bol mantiene los estados de proceso durante un día. Las ofertas son sincrónicas.

Paginación: las listas de pedidos, envíos, devoluciones e inventario toman page desde 1 con 50 filas por página; una respuesta vacía significa que no hay más páginas. Las ofertas utilizan un cursor: pasa page.nextCursor hasta que falte.

Límites de tasa: bol los establece por endpoint. La lista de pedidos y la lista de envíos permiten 25 llamadas por minuto, devoluciones e inventario 20 por minuto, facturas 24 por minuto; detalles de pedidos 25 por segundo y ofertas de 25 a 50 por segundo. Un 429 lleva un Retry-After en segundos; los valores en vivo están en api.bol.com/retailer/public/ratelimits.

Ids y formatos: los ids de pedidos pueden contener letras (A4K8290LP0), los EAN son cadenas, las fechas son YYYY-MM-DD y las horas ISO 8601 con un desplazamiento. Los campos no utilizados se omiten, porque bol responde 400 a cadenas vacías.

Errores comunes: los errores vienen como application/problem+json con title, detail y violations que nombran el campo. 400 generalmente significa que falta o está vacío un campo. 429 es el límite de tasa: espera el tiempo de Retry-After.

No cubierto: manejo o registro de devoluciones (aceptar una devolución hace que bol reembolse al cliente), compra de etiquetas de envío y cualquier cosa que mueva dinero.

Requisitos previos: BOL_CLIENT_ID, BOL_CLIENT_SECRET

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige bol.com y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos abiertos aún necesitan enviarse hoy, y alguno de ellos tiene una solicitud de cancelación?"
• "Muestra el pedido A4K8290LP0 con la dirección del cliente y los artículos."
• "¿Cuáles de mis ofertas no están a la venta, y por qué?"
• "¿Quién tiene la buy box en EAN 8712345678901, y a qué precio?"
• "Establece el precio de mi oferta para EAN 8712345678901 en 24.95 y el stock en 40."

Próximos pasos

• Conectar a Claude
• Conectar a ChatGPT