Servidor Billbee MCP: pedidos, stock y envíos

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Billbee Order Management, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Billbee

Deja que tu IA trabaje con Billbee: encuentra pedidos de todos tus marketplaces y tiendas, consulta artículos por SKU o EAN con precio y stock, revisa el historial de pedidos de un cliente y gestiona pedidos: cambia su estado, añade números de seguimiento, reserva etiquetas de envío con los transportistas conectados en Billbee, actualiza el stock, añade tags, cambia campos de pedidos y artículos y crea facturas. Con API key, email de acceso y contraseña de API.

Configuración

1. Inicia sesión en Billbee y abre Einstellungen (Settings) → Billbee API. En los ajustes generales de esa página, activa el acceso a la API y define una contraseña de API. Es una contraseña aparte, solo para la API, no la que usas para entrar.
2. Pide una API key a Billbee: usa su formulario de solicitud de API o escribe a [email protected] explicando brevemente qué quieres conectar (aquí: tu IA leyendo pedidos a través de AnythingMCP). Billbee te envía la clave.
3. Pon la clave en BILLBEE_API_KEY, el email con el que entras en Billbee en BILLBEE_LOGIN_EMAIL y la contraseña de API del paso 1 en BILLBEE_API_PASSWORD.
4. Instala el conector. No hay paso Authorize with Provider: cada llamada envía la API key en la cabecera X-Billbee-Api-Key, además de tu email y la contraseña de API como HTTP Basic auth.
5. Empieza con billbee_list_shipping_providers: no necesita parámetros y lista los transportistas configurados en tu cuenta. Si responde, los tres valores funcionan.

Tres valores, todos obligatorios: Billbee rechaza una llamada que lleve solo la API key, o solo el email y la contraseña de API. Los tres tienen que estar configurados en el conector.

Mantener la sesión iniciada: no hay tokens que renovar, el conector envía los tres valores en cada llamada. Si cambias la contraseña de API en Billbee o recibes una API key nueva, actualiza BILLBEE_API_PASSWORD o BILLBEE_API_KEY en la página del conector.

Lectura y escritura: 9 de las 17 herramientas solo leen pedidos, artículos, clientes, transportistas y almacenes. Las otras 8 cambian tu cuenta real de Billbee, y Billbee transmite la mayoría de los cambios a las tiendas y marketplaces conectados. Las 17 quedan activadas al instalar. Para un uso de solo lectura, desactiva las herramientas de escritura en la página del conector; también puedes desactivar herramientas de lectura sueltas, por ejemplo billbee_list_customers y billbee_get_customer_orders si la IA no debe ver datos de clientes.

Herramientas de escritura:

• billbee_set_order_state cambia el estado del pedido, por ejemplo 3 pagado, 4 enviado, 8 cancelado o 13 empaquetado. La tienda o el marketplace puede enviar un email al comprador.
• billbee_add_shipment_to_order guarda un número de seguimiento creado en otro sitio; no crea etiquetas ni cambia el estado. billbee_ship_order_with_label reserva una etiqueta real y de pago con un transportista conectado en Billbee (DHL, DPD, GLS, Deutsche Post y otros) con tu propio contrato; providerId y productId salen de billbee_list_shipping_providers, y la IA te pregunta antes de reservar.
• billbee_update_stock fija el stock absoluto de un artículo por SKU, no una diferencia; con varios almacenes necesita el stockId de billbee_list_stocks. Billbee envía el nuevo stock a tus tiendas y marketplaces.
• billbee_add_order_tags añade tags a un pedido. billbee_update_order y billbee_update_product cambian solo los campos que se pasan, con los nombres de campo que devuelven billbee_get_order y billbee_get_product, como SellerComment o Price.
• billbee_create_invoice crea la factura de un pedido con tu plantilla de factura, como máximo una vez por pedido cada 5 minutos, y puede devolver el PDF.

Las herramientas de escritura usan el id interno del pedido en Billbee, no el número de pedido de la tienda: billbee_get_order_by_extref encuentra el id a partir del número de pedido del marketplace.

Pedidos: billbee_list_orders filtra por fecha del pedido (minOrderDate, maxOrderDate) y por última modificación (modifiedAtMin, modifiedAtMax), con fechas en ISO 8601 como 2026-01-01. billbee_get_order devuelve el pedido completo con líneas, direcciones, datos de pago y de envío a partir del id de Billbee. billbee_get_order_by_extref encuentra un pedido por el número de pedido del marketplace o de la tienda, por ejemplo un número de pedido de Amazon o eBay. Los estados de los pedidos llegan como números.

Artículos y clientes: billbee_get_product busca un artículo por su id de Billbee, o por SKU o EAN cuando lookupBy es sku o ean, y devuelve precios y stock. billbee_list_products se puede limitar a los artículos creados después de una fecha (minCreatedAt). billbee_list_customers no tiene búsqueda, así que encontrar un cliente por nombre supone recorrer la lista página a página; con el id del cliente, billbee_get_customer_orders lista sus pedidos.

Páginas y límites de frecuencia: las herramientas de listado devuelven hasta 250 filas por página (pageSize), con Page, TotalPages y TotalRows en la respuesta, y la IA pide la siguiente page hasta llegar a la última. Billbee permite 2 peticiones por segundo por API key y usuario y por encima responde 429: espera un momento y vuelve a intentarlo. Billbee cobra el uso de la API por encima de un cupo gratuito, así que es mejor usar rangos de fechas acotados y modifiedAtMin que listarlo todo una y otra vez.

Errores frecuentes: si Billbee rechaza las credenciales, comprueba que las tres variables estén configuradas, que el acceso a la API esté activado en Einstellungen → Billbee API y que BILLBEE_API_PASSWORD contenga la contraseña de API y no la de acceso. 429 significa que se superó el límite de 2 peticiones por segundo.

El conector no crea ni borra pedidos, no crea ni cambia clientes y no crea ni borra artículos.

Requisitos previos: BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

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 Billbee Order Management e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pedidos han entrado en los últimos 7 días y cuáles de ellos todavía no se han enviado?"
• "Busca el pedido con el número de pedido del marketplace 302-1234567-1234567 y enséñame las líneas, la dirección de entrega y los datos de pago."
• "¿Cuántas unidades del SKU ABC-123 tenemos en stock y cuál es el precio de venta?"
• "Enumera todos los pedidos del cliente de Billbee 4567 con fecha e importe total, del más reciente al más antiguo."
• "Marca el pedido de Amazon 302-1234567-1234567 como enviado y añade el número de seguimiento de DHL 00340434161234567890."
• "Crea con Billbee una etiqueta de DHL para el pedido de eBay 14-12688-90311 y después su factura."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT