Guía de conector14 minutos de lectura38 herramientas MCP7 idiomas

The Range MCP: pedidos, ofertas y envíos

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidencias, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de The Range.

HCPor el equipo de HelpCodeActualizado 14 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

The Range Marketplace

The Range Marketplace

Run your shop on The Range marketplace from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, imports, messages, returns, invoices and transactions. The marketplace sells in the United Kingdom; sign in with the shop API key from your The Range seller back office.

herramientas

38

Región

GB

Categoría

E-commerce

Autenticación

API Key

Env vars requeridas

THE_RANGE_API_KEY
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidencias, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de The Range.

Configuración guiada

Conecta The Range Marketplace a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta The Range Marketplace con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Prueba a pedir

Prompts de ejemplo para The Range Marketplace

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

The Range Marketplace · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

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

The Range Marketplace

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidencias, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de The Range.

Configuración

Países: el Reino Unido. Los vendedores también pueden elegir entregar en la República de Irlanda, las Islas del Canal y la Isla de Man.

Quién puede vender: The Range acepta solicitudes en su página de registro de marketplace y verifica a cada vendedor: solicita un número de registro de empresa del Reino Unido que coincida con Companies House y los detalles del IVA del Reino Unido del negocio. El conector necesita una cuenta de vendedor que The Range ya haya abierto.

The Range trasladó su marketplace a una nueva oficina de vendedor en 2026 y migró las cuentas de vendedor existentes. El nombre de usuario y la contraseña de la anterior API de Partner Central no funcionan aquí; el conector necesita la clave API de la nueva oficina.

Configurar toma aproximadamente 5 minutos.

  1. Inicia sesión en la oficina de vendedor de The Range: https://therangeuk-prod.mirakl.net/login.
  2. En la oficina, abre tu nombre de usuario (arriba a la derecha) > Mis configuraciones de usuario > Clave API y haz clic en Generar una nueva clave (o copia la clave existente). Pégala en THE_RANGE_API_KEY. La clave se envía tal cual en el encabezado Authorization, sin Bearer. Generar una nueva clave invalida la anterior, por lo que cualquier otra herramienta que la use dejará de funcionar.
  3. Deja THE_RANGE_SHOP_ID vacío. Solo si tu usuario gestiona varias tiendas en The Range, establece THE_RANGE_SHOP_ID al id numérico de la tienda en la que debe funcionar este conector (mostrado en el panel de control de la oficina junto a Identificador o ID de tienda, y devuelto como shop_id por the_range_get_account). Sin ello, se usará tu tienda por defecto.
  4. Instala y ejecuta the_range_get_account: devuelve la tienda a la que pertenece la clave.

Por dónde empezar: the_range_get_account muestra la tienda detrás de la clave (id, nombre, estado, moneda y canales). Para el trabajo diario, usa the_range_list_orders con order_state_codes=WAITING_ACCEPTANCE, the_range_list_offers para precios y stock y the_range_list_threads para mensajes que esperan respuesta.

Productos y ofertas competidoras: the_range_get_products busca productos en el catálogo de The Range por EAN u otra referencia y devuelve el SKU del producto en el marketplace; the_range_list_product_offers lista las ofertas de cada tienda para productos dados, mejor precio primero, a aproximadamente 5 llamadas por minuto.

Flujo de trabajo de pedidos: un nuevo pedido espera en WAITING_ACCEPTANCE. the_range_accept_order acepta (o rechaza) cada línea; después de que se debite al cliente, el pedido pasa a SHIPPING. Luego, the_range_update_tracking almacena el transportista y el número de seguimiento (los códigos de transportista provienen de the_range_list_carriers) y the_range_ship_order confirma el envío (SHIPPED). Los estados posteriores son TO_COLLECT, RECEIVED, CLOSED, REFUSED y CANCELED. Usa the_range_list_orders con order_state_codes=WAITING_ACCEPTANCE para la lista de tareas diaria y has_incident=true para incidencias abiertas; the_range_resolve_incident cierra una incidencia en una línea de pedido una vez que se resuelve. Los documentos adjuntos a los pedidos (albaranes, etiquetas, facturas de clientes) se listan con the_range_list_order_documents.

Escrituras: confirma primero. the_range_accept_order, the_range_update_tracking, the_range_ship_order, the_range_resolve_incident, the_range_accept_return, the_range_receive_return, the_range_update_offers, the_range_reply_thread, the_range_create_order_thread y the_range_import_products actúan en el marketplace en vivo. Antes de cada llamada, muestra al usuario qué cambiará (id y líneas del pedido, número de seguimiento, SKU de la oferta con el precio o stock antiguo y nuevo, el texto del mensaje y los destinatarios) y espera un sí. Rechazar una línea de pedido la cancela de forma definitiva. Ninguna herramienta aquí reembolsa, cancela pedidos o mueve dinero; hazlo en la oficina. the_range_import_offers puede eliminar ofertas (el modo REPLACE elimina cada oferta que falta en el archivo), por lo que se instala apagado.

Actualización de ofertas (precios y stock): the_range_update_offers (OF24) reemplaza toda la oferta. Cada campo que dejes fuera se restablece: una quantity faltante se convierte en 0, un discount o description faltante se elimina. Siempre lee la oferta primero (the_range_get_offer o the_range_list_offers con sku) y envíala de vuelta completa con solo el cambio previsto: shop_sku, product_id y product_id_type (de product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (su código), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leído como available_start_date / available_end_date) y cualquier offer_additional_fields. Deja update_delete vacío o update. La llamada devuelve un import_id; el cambio se aplica de forma asíncrona, así que revísalo con the_range_get_offer_import antes de leer la oferta nuevamente. Los códigos de condición para state_code provienen de the_range_list_offer_conditions, los códigos de clase logística de the_range_list_logistic_classes.

Importaciones de archivos: the_range_import_products (P41) y the_range_import_offers (OF01) toman la URL de un archivo CSV, XLSX o XML en el formato de archivo que The Range solicita; el conector lo descarga y lo sube a The Range. Haz seguimiento con the_range_list_product_imports / the_range_get_product_import y the_range_list_offer_imports / the_range_get_offer_import.

Devoluciones: the_range_list_returns (RT11) lista las solicitudes de devolución. Donde The Range deja que la tienda decida, the_range_accept_return acepta o rechaza una en WAITING_ACCEPTANCE y the_range_receive_return confirma que los bienes han llegado. Los reembolsos permanecen en la oficina.

Mensajes: the_range_list_threads lista conversaciones (filtra con entity_type=MMP_ORDER y entity_id=<order id> para un pedido; entity_id sin entity_type es rechazado), the_range_get_thread lee uno con sus mensajes, the_range_reply_thread responde (destinatario CUSTOMER u OPERATOR, que es The Range) y the_range_create_order_thread abre una nueva conversación sobre un pedido. Los códigos de razón para temas provienen de the_range_list_reasons; deja su locale vacío a menos que sepas que el marketplace tiene ese idioma (un locale inactivo responde 400).

Dinero: the_range_list_invoices (IV01) lista los documentos contables que The Range emite a la tienda y the_range_list_transactions (TL02) las líneas de transacción (ventas, comisiones, reembolsos, pagos). Si The Range utiliza Facturación Mejorada para Vendedores, IV01 no devuelve nuevos documentos; usa the_range_list_document_requests (DR11) y las transacciones entonces.

Catálogo completo: para leer cada oferta (una verificación de stock o precio en todo el catálogo, contando ofertas), inicia una exportación con the_range_export_offers, consulta the_range_get_offer_export_status aproximadamente una vez por minuto hasta que esté COMPLETED, y lee los archivos uno por uno con the_range_get_offer_export_file; include_fields mantiene solo las columnas que necesitas. Se permite una exportación completa una vez al día; para lo que ha cambiado desde entonces, pasa last_request_date (una exportación diferencial, como máximo una vez por minuto). No pagines a través de cada oferta con the_range_list_offers: está destinado a unas pocas ofertas a la vez y responde 429 cuando se paginan a través de un gran catálogo.

Varias tiendas: cada herramienta toma un shop_id opcional. Un usuario que gestiona varias tiendas en este marketplace (una agencia, o una tienda por país) puede trabajar en todas ellas con una sola instalación: pasa el id de la tienda en cada llamada y verifica cuál es con the_range_get_account y el mismo shop_id. Sin shop_id, una llamada usa THE_RANGE_SHOP_ID, o la tienda por defecto del usuario cuando esta está vacía. Pregunta al usuario por los ids de sus tiendas; la oficina los muestra.

Listas de referencia: the_range_list_channels (sitios de países), the_range_list_carriers, the_range_list_shipping_zones, the_range_list_shipping_methods y the_range_list_logistic_classes cambian raramente; léelos una vez por conversación.

Paginación: pedidos, ofertas, facturas e importaciones de productos se paginan con max (como máximo 100) y offset. Hilos, devoluciones, transacciones, solicitudes de documentos e importaciones de ofertas devuelven un next_page_token; pásalo como page_token para obtener la siguiente página (todos los demás filtros se ignoran) hasta que falte.

Fechas son ISO 8601, por ejemplo 2026-10-01T00:00:00Z; las respuestas están en UTC.

Límites de tasa: Cada API tiene su propio límite y The Range puede ajustarlos. Listar ofertas y pedidos está destinado a uso interactivo, importaciones de productos y ofertas como máximo cada 15 minutos, the_range_get_account y las listas de referencia aproximadamente una vez al día. Un 429 lleva un encabezado Retry-After con los segundos a esperar; no intentes de nuevo en un bucle.

Errores: 401 significa que la clave es incorrecta o fue reemplazada por una más nueva, 403 que tu usuario no tiene el derecho para esta acción, 404 que el pedido, oferta o hilo no existe para esta tienda o que el marketplace no utiliza esa función, como devoluciones, 400 un parámetro incorrecto o un pedido en el estado incorrecto (el mensaje lo nombra, por ejemplo ORDER_INVALID_STATE).

Requisitos previos: THE_RANGE_API_KEY

Instala 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 The Range Marketplace y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

HerramientaQué hace
the_range_get_accountLee la tienda detrás de la clave API en este marketplace (A01): id y nombre de la tienda, estado, canales, moneda, grado y tasa de aprobación, contacto…
the_range_list_ordersLista pedidos (OR11) con sus líneas, cliente, dirección de envío, precios, estado e incidencias. Filtra por estado (por ejemplo, WAITING_ACCEPTANCE para…
the_range_list_offersLista las ofertas de la tienda (OF21): SKU, producto, precio y descuento, todos los precios de canal, cantidad en stock, condición, tiempo de entrega y si…
the_range_get_offerLee una oferta completa por su id de oferta (OF22): cada campo de precio, descuento, cantidad, condición, clase logística, tiempo de entrega y campos personalizados…
the_range_list_offer_conditionsLista las condiciones de oferta (OF61) que el marketplace acepta, por ejemplo, nuevo o usado, con el código para poner en state_code al actualizar ofertas
the_range_list_offer_importsLista importaciones y actualizaciones de ofertas (OF04), desde archivos y desde the_range_update_offers: estado (WAITING, RUNNING, COMPLETE, FAILED), líneas…
the_range_get_offer_importLee el estado de una importación de oferta o actualización de oferta (OF02) por su import_id, como lo devuelve the_range_update_offers o…
the_range_export_offersInicia una exportación de todas las ofertas de la tienda como archivos (OF52), la forma de leer todo el catálogo (cada SKU con precio y stock) en lugar de…
the_range_get_offer_export_statusEstado de una exportación de oferta iniciada con the_range_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code y error.detail), y…
the_range_get_offer_export_fileLee un archivo de una exportación de oferta completada (OF54): las ofertas con su SKU, producto, cantidad, precios y otros campos exportados, como…
the_range_list_product_importsLista importaciones de productos (P51) con su estado (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), los recuentos de transformación y los…
the_range_get_product_importLee el estado de una importación de producto (P42) por su import_id: estado de importación, razón, recuentos de transformación y los detalles de integración…
the_range_get_productsBusca productos en el catálogo del marketplace por sus identificadores (P31), por ejemplo, EAN, y obtén el SKU del producto en el marketplace, título y categoría.…
the_range_list_product_offersLista las ofertas de cada tienda para productos dados (P11), ordenadas por mejor precio, para comparar tu precio con la competencia. Da product_ids…
the_range_list_threadsLista hilos de mensajes (M11) con clientes y The Range: tema, pedido u oferta vinculada, participantes, fecha del último mensaje y desde cuándo un…
the_range_get_threadLee un hilo de mensaje (M10) con todos sus mensajes, remitentes, destinatarios, adjuntos y el pedido u oferta vinculada
the_range_list_returnsLista solicitudes de devolución (RT11) con su estado, líneas de devolución, razón, RMA, seguimiento y el pedido vinculado. Filtra por estado, pedido o fecha.…
the_range_list_reasonsLista los códigos de razón del marketplace (RE01): incidencia, cancelación, reembolso y razones de mensajes, con sus etiquetas y si la tienda puede…
the_range_list_carriersLista los transportistas que conoce el marketplace (SH21) con su código, etiqueta y URL de seguimiento. Usa el código como carrier_code en…
the_range_list_invoicesLista los documentos contables que The Range emite a la tienda (IV01): facturas y notas de crédito con periodo, totales con y sin impuestos…
the_range_list_transactionsLista las líneas de transacción de la tienda (TL02): montos de pedidos, envío, comisiones, reembolsos, créditos manuales y pagos, con monto, tipo…
the_range_list_document_requestsLista solicitudes de documentos contables (DR11), utilizadas cuando The Range ejecuta Facturación Mejorada para Vendedores: facturas y notas de crédito que The Range o…
the_range_list_order_documentsLista los documentos adjuntos a uno o más pedidos (OR72): albaranes, etiquetas de envío, facturas de clientes y otros archivos, con id, archivo…
the_range_list_channelsLista los canales de venta del marketplace (CH11), generalmente uno por sitio de país, con código y etiqueta. Usa los códigos como channel_codes en…
the_range_list_shipping_zonesLista las zonas de envío activas del marketplace (SH11) con código y etiqueta, por ejemplo, Francia continental o Córcega. Cambios raramente: llámalo…
the_range_list_shipping_methodsLista los métodos de envío activos del marketplace (SH12), por ejemplo, estándar, exprés o recogida, con código, etiqueta, si un número de seguimiento…
the_range_list_logistic_classesLista las clases logísticas del marketplace (SH31), los tamaños o bandas de peso que deciden los precios de envío, con código y etiqueta. Usa el código como…
the_range_accept_orderAcepta o rechaza las líneas de un pedido que espera aceptación (OR21). Cada línea del pedido debe estar listada. Rechazar una línea la cancela…
the_range_update_trackingEstablece el transportista y el número de seguimiento de un pedido (OR23). Da carrier_code de the_range_list_carriers, o carrier_name con carrier_url…
the_range_ship_orderConfirma que un pedido en SHIPPING ha sido enviado (OR24); pasa a SHIPPED y se notifica al cliente. Establece el seguimiento primero con…
the_range_update_offersCrea o actualiza ofertas, incluyendo precio y stock (OF24). Reemplaza cada oferta completamente: cada campo que se deje fuera se restablece (una falta…
the_range_reply_threadResponde en un hilo de mensaje (M12) al cliente o a The Range. El mensaje se entrega de inmediato y no puede ser retirado: muestra al usuario el…
the_range_create_order_threadInicia un nuevo hilo de mensaje sobre un pedido (OR43) con el cliente, The Range o ambos. El mensaje se entrega de inmediato: muestra al usuario el…
the_range_resolve_incidentMarca la incidencia abierta en una línea de pedido como resuelta (OR64), una vez que se soluciona el problema del cliente. reason_code debe ser un INCIDENT_CLOSE…
the_range_accept_returnAcepta o rechaza una solicitud de devolución en WAITING_ACCEPTANCE (RT21). Solo cuando The Range maneja devoluciones en la oficina del vendedor y deja…
the_range_receive_returnConfirma que los bienes de una devolución aceptada han llegado a tu almacén (RT25). La devolución pasa a RECEIVED. Actúa en el marketplace en vivo…
the_range_import_productsEnvía un archivo de producto al marketplace (P41) para crear o enriquecer productos en su catálogo. file_url es la dirección de un CSV, XLSX o XML…
the_range_import_offersImporta un archivo de oferta (OF01) para crear, actualizar o eliminar ofertas en bloque. El modo REPLACE elimina cada oferta que no está en el archivo, y…

Ejemplos de solicitudes

  • "¿Qué pedidos en The Range están esperando mi aceptación y cuánto valen en GBP?"
  • "Exporta mi catálogo completo en The Range y lista cada oferta con menos de 5 unidades en stock."
  • "Compara mi precio para el conjunto de sofá de jardín de ratán con EAN 5056150212345 con los otros vendedores en The Range."
  • "Añade el seguimiento de Evri H01HYA0012345678 al pedido 7712345-A y confirma el envío."
  • "Gestiono dos tiendas en The Range, 2001 y 2002: ¿cuántos pedidos está esperando cada una?"

Próximos pasos

¿Te ha sido útil esta guía?

Conecta The Range Marketplace a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta The Range Marketplace con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conecta The Range con ChatGPT mediante MCP

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de tu tienda desde el back office de vendedor de The Range.

Conectores

Conecta The Range con Claude mediante MCP

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de tu tienda desde el back office de vendedor de The Range.

Conectores

Conecta The Range con Microsoft Copilot mediante MCP

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de tu tienda desde el back office de vendedor de The Range.

Conectores

Conecta The Range con Cursor mediante MCP

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de tu tienda desde el back office de vendedor de The Range.

Conectores

Conecta The Range con Gemini CLI mediante MCP

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de tu tienda desde el back office de vendedor de The Range.

Conectores

Conecta The Range con Meta Muse mediante MCP

Gestiona tu tienda en el marketplace de The Range desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en el Reino Unido; inicia sesión con la clave API de tu tienda desde el back office de vendedor de The Range.