Resumen
API de vendedor de Back Market para reacondicionadores: pedidos con aceptación y envío con seguimiento, listados con precio y stock, precios de Backbox y competidores, categorías, carpetas y mensajes de atención al cliente, entregas de BackShip y pedidos de BuyBack. Token de API, por plataforma (Europa, Estados Unidos, Asia-Pacífico).
Configuración guiada
Conecta Back Market a Meta Muse en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Back Market con la configuración guiada y añade tu URL MCP a Meta Muse. 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 Back Market
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Back Market, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Back Market + Meta Muse
API de vendedor de Back Market para reacondicionadores: pedidos con aceptación y envío con seguimiento, listados con precio y stock, precios de Backbox y competidores, categorías, carpetas y mensajes de atención al cliente, entregas de BackShip y pedidos de BuyBack. Token de API, por plataforma (Europa, Estados Unidos, Asia-Pacífico).
Requisitos previos
Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 3 minutos.
- Inicia sesión en la oficina de Back Market de tu plataforma:
https://www.backmarket.fr/bo-seller(Europa),https://www.backmarket.com/bo-seller(Estados Unidos) ohttps://www.backmarket.co.jp/bo-seller(Japón y Australia). El acceso a la API viene con una cuenta de vendedor que Back Market ha validado. - Abre la página de Integraciones en Opciones y crea un token de API.
- Pega el token como se muestra en
BACK_MARKET_TOKEN, sin la palabra Basic al principio: el conector lo envía comoAuthorization: Basicseguido del token. - Elige tu plataforma en
BACK_MARKET_HOSTy tu mercado principal enBACK_MARKET_MARKET(por ejemplo, fr-fr en Europa, en-us en Estados Unidos, ja-jp en Asia-Pacífico). El mercado debe pertenecer a la plataforma.
Cada llamada lleva el mercado en Accept-Language y el User-Agent BM-AnythingMCP-Connector, que Back Market requiere. Las herramientas con un argumento market pueden mirar otro mercado de la misma plataforma para una llamada.
Dónde empezar: back_market_list_orders con estado 1 muestra pedidos pagados cuyas líneas debes aceptar, estado 3 los pedidos a enviar. back_market_list_listings muestra tus ofertas; back_market_list_backbox indica cuáles de ellas tienen el Backbox.
Flujo de trabajo de pedidos: un pedido llega en estado 1 una vez que se valida el pago (nunca envíes en estados 0, 8 o 10). Acepta cada línea con back_market_accept_order_line (estado de línea 1 a 2); el pedido luego pasa a estado 3. Envía con back_market_ship_order y un número de seguimiento (todas las líneas van en un solo paquete, estado del pedido 9). back_market_get_order muestra los estados de las líneas. back_market_set_order_line_identifiers almacena el IMEI o número de serie del dispositivo; no se puede corregir después. back_market_cancel_order_line y back_market_refund_order_line están instalados desactivados: ambos reembolsan al cliente y no pueden deshacerse, y las cancelaciones afectan al Backbox.
Listados: un listado cubre todos los mercados de la plataforma. La cantidad es compartida; el precio, comentario y garantía son por mercado. back_market_get_listing encuentra un listado por SKU; back_market_update_listing cambia el precio o stock en tiempo real (cantidad 0 lo saca de línea). back_market_import_listings (desactivado) envía un CSV para muchos listados a la vez y responde con un id de tarea para back_market_get_task. back_market_get_competitors muestra el precio necesario para ganar el Backbox por mercado. back_market_get_category_tree y back_market_get_category_branch dan las categorías y los atributos que necesita un nuevo producto.
Atención al cliente: back_market_list_care_folders y back_market_get_care_folder leen casos de postventa con sus mensajes; back_market_send_care_message responde al cliente. back_market_create_care_refund está instalado desactivado.
BackShip y BuyBack: back_market_list_deliveries y back_market_list_returns solo devuelven datos para vendedores que utilizan las etiquetas de envío BackShip de Back Market. back_market_list_buyback_orders y back_market_get_buyback_order leen pedidos de intercambio; validar o contrarrestar uno decide lo que se le paga al cliente y no está incluido.
Formatos: los precios son cadenas decimales con impuestos, en la moneda del mercado (160.99). Los ids de pedidos y los ids de líneas de pedido son enteros; los ids de listados son UUIDs (el id numérico de listado está en desuso). Las fechas son RFC 3339; los filtros de carpetas de atención utilizan YYYY-MM-DD-hh-mm. Las listas responden con count, next, previous y results; next es nulo en la última página.
Límites: más de 200 llamadas en 10 segundos se bloquean durante 10 segundos (llamadas de catálogo: 20 en 10 segundos), con un 429. Las actualizaciones de listados están limitadas a aproximadamente 2,000 líneas SKU por hora. Las llamadas de atención tienen límites diarios (lista de carpetas 4,000 al día, reembolsos 500 al día).
Respuestas 403: Back Market está detrás de Cloudflare. Un 403 con una página HTML o el código bot-need-challenge significa que el firewall bloqueó al llamador, no que el token sea incorrecto: envía el valor cf-ray de la respuesta a tu contacto de Back Market. Un token incorrecto o faltante también responde con 403 o 401, con un error JSON.
Paso 2 — Instalar el adaptador
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
Paso 3 — Añadir el conector en Muse
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.
- En Muse, abre Settings → Connectors y elige Add custom connector.
- Pega la URL del servidor MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
- En un chat, pídele a Muse algo que necesite las herramientas de
Back Market.
También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
back_market_list_orders | Lista pedidos, sin los no pagados (los estados de pedido 0 y 8 se omiten por defecto). La respuesta tiene count, next, previous y results[]… |
back_market_get_order | Lee un pedido: order_id, estado, date_creation, date_modification, date_payment, date_shipping, expected_dispatch_date, precio y… |
back_market_accept_order_line | Acepta una línea de pedido pagada (estado 1 a estado 2), lo que confirma que tienes el artículo y lo enviarás. Acepta cada línea del pedido, una… |
back_market_ship_order | Marca un pedido aceptado como enviado con su número de seguimiento (estado 3). Todas las líneas del pedido van en un solo paquete y se marcan como enviados… |
back_market_cancel_order_line | Cancela una línea de pedido pagada que no puedes entregar (estado 1 a estado 4). Back Market reembolsa al cliente por esa línea, la cancelación no puede… |
back_market_refund_order_line | Reembolsa una línea de pedido a través del flujo de trabajo del pedido: estado 5 para una línea aceptada que aún no se ha enviado, estado 6 para una línea enviada. El cliente… |
back_market_set_order_line_identifiers | Registra el IMEI y/o número de serie del dispositivo vendido en una línea de pedido. Proporciona al menos uno de los dos. Cuidado: una vez registrado, un… |
back_market_list_listings | Lista tus listados (ofertas): id (UUID), listing_id (id numérico antiguo), sku, título, product_id, grado (PREMIUM, EXCELENTE, MUY_BUENO, BUENO… |
back_market_get_listing | Lee un listado por tu SKU o por su id de Back Market: id, listing_id, sku, título, product_id, grado, cantidad, precio, min_price… |
back_market_update_listing | Cambia un listado en tiempo real: precio, cantidad de stock, comentario, garantía o el precio mínimo para el BackPricer. Solo los campos dados… |
back_market_import_listings | Crea o actualiza muchos listados (y propone nuevos productos) a partir de texto CSV, hasta 15,000 líneas. Cada fila necesita tu sku; un nuevo listado también… |
back_market_get_task | Lee el resultado de una tarea por lotes iniciada por back_market_import_listings: task_id, action_status (0 o 2 = esperando o ejecutándose, 8 = fallido, 9… |
back_market_list_backbox | Lista datos de Backbox por listado: sku, producto, precio, cantidad, buybox (verdadero cuando tu listado tiene el Backbox), price_for_buybox (el… |
back_market_get_competitors | Lee la competencia de Backbox de un listado, una fila por mercado: is_winning, precio, min_price, price_to_win y winner_price (cada uno con… |
back_market_get_category_tree | Lee todo el árbol de categorías: category_id, category_name, marketplace_category_id (el valor que debe coincidir con la categoría de un producto), is_leaf y… |
back_market_get_category_branch | Lee una categoría con los mismos campos que el árbol: category_id, category_name, marketplace_category_id, is_leaf y attributes[] con… |
back_market_list_care_folders | Lista carpetas de atención al cliente (casos de postventa, SAV), 10 por página: id, orderline, estado (0 abierto, 9 cerrado), date_creation… |
back_market_get_care_folder | Lee una carpeta de atención al cliente: estado, fechas, el cliente (nombre, apellido, correo electrónico), la línea de pedido con su pedido y direcciones, el… |
back_market_send_care_message | Publica un mensaje al cliente en una carpeta de atención (solo texto, sin adjunto). El cliente lo ve en la plataforma de postventa de Back Market… |
back_market_create_care_refund | Reembolsa una línea de pedido desde atención al cliente: reembolso completo de una línea pagada (tipo 4), reembolso completo de una línea aceptada (tipo 5), o un reembolso parcial o… |
back_market_list_deliveries | Lista entregas de BackShip (solo para vendedores suscritos al servicio de envío BackShip de Back Market): pedido, shipmentId, orderlines… |
back_market_list_returns | Lista devoluciones de productos de BackShip (solo para vendedores suscritos a BackShip): orderId, orderlineId, shipmentId, carrierName, trackingNumber… |
back_market_list_buyback_orders | Lista pedidos de BuyBack (intercambio), los dispositivos que los clientes te venden: orderPublicId, estado, mercado, creationDate, shippingDate, receivalDate… |
back_market_get_buyback_order | Lee un pedido de BuyBack (intercambio): estado, mercado, fechas (creación, envío, recepción, pago, contraoferta), el listado, el… |
Ejemplos de indicaciones
- "¿Qué pedidos de Back Market tienen líneas esperando mi aceptación?"
- "¿Cuáles de mis listados han perdido el Backbox, y qué precio lo ganaría de nuevo?"
- "Establece el stock de mi listado de iPhone 13 reacondicionado de 128 GB en 12."
- "Envía el pedido 41234567 con seguimiento de Colissimo 6A12345678901 y el IMEI de cada línea."
- "¿Qué carpetas de atención al cliente están abiertas, y qué preguntan los clientes?"
Preguntas frecuentes
¿Dónde obtengo el token de API? En la oficina de Back Market de tu plataforma, Opciones, Integraciones. Pega el token como se muestra, sin la palabra Basic, y elige tu plataforma (Europa, Estados Unidos o Asia-Pacífico) y mercado principal. El acceso a la API viene con una cuenta de vendedor que Back Market ha validado.
¿Qué mercados cubre? Cada mercado de la plataforma en la que está tu cuenta: los mercados europeos en backmarket.fr, Estados Unidos en backmarket.com, y Japón y Australia en backmarket.co.jp. Las herramientas con un argumento de mercado pueden mirar otro mercado de la misma plataforma.
¿Qué herramientas están instaladas desactivadas? back_market_cancel_order_line, back_market_refund_order_line, back_market_create_care_refund y back_market_import_listings, porque reembolsan a los clientes o reemplazan listados en bloque. Actívalas en la página del conector solo si la IA debe usarlas.
¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.
¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.
Próximos pasos
¿Te ha sido útil esta guía?