Resumen
API de vendedor de refurbed para vendedores de electrónica reacondicionada: pedidos y artículos de pedido (aceptar, enviar con seguimiento e IMEI), simulaciones de reembolso, etiquetas de envío, facturas, devoluciones, tickets de soporte, ofertas con stock y precios, precios de mercado, búsqueda de productos, perfiles de envío y transportistas. Token de API de refurbed.
Configuración guiada
Conecta refurbed a Cursor en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta refurbed con la configuración guiada y añade tu URL MCP a Cursor. 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 refurbed
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 → refurbed, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
refurbed + Cursor
API de vendedor de refurbed para vendedores de electrónica reacondicionada: pedidos y artículos de pedido (aceptar, enviar con seguimiento e IMEI), simulaciones de reembolso, etiquetas de envío, facturas, devoluciones, tickets de soporte, ofertas con stock y precios, precios de mercado, búsqueda de productos, perfiles de envío y transportistas. Token de API de refurbed.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
REFURBED_API_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda unos 5 minutos. Necesitas la respuesta de refurbed.
- Solicita un token de API con el formulario en supplier.refurbed.com/api-token-request (o pregunta a tu gerente de cuenta o a [email protected]). refurbed envía un token que parece un UUID.
- Pégalo en
REFURBED_API_TOKEN, instala y ejecutarefurbed_list_orders. El conector lo envía comoAuthorization: Plainseguido del token. - Un token que no se utiliza durante 2 meses caduca; luego solicita uno nuevo. Algunas llamadas también deben ser habilitadas por refurbed para tu cuenta (etiquetas de envío, ofertas de baterías nuevas).
La API funciona en https://api.refurbed.com. refurbed también proporciona a cada vendedor un sandbox a solicitud (supplier.refurbed.com/sandbox-request), en una dirección como https://grpc-<name>.qa.refurbed.io, con pedidos de prueba; una instalación autohospedada puede apuntar una copia de este conector allí.
Dónde empezar: refurbed_list_orders con estados NUEVO muestra pedidos a manejar; refurbed_get_order y refurbed_list_order_items muestran los artículos. Acepta con refurbed_accept_order_item, luego envía con refurbed_ship_order_item (enlace de seguimiento, o slug de transportista de refurbed_list_available_carriers más número de seguimiento, y el IMEI o número de serie en item_identifiers). refurbed_batch_update_order_item_states hace hasta 50 a la vez; refurbed_update_order_item cambia el seguimiento, identificadores, notas o datos de aduanas suizas más tarde; refurbed_get_order_item lee un artículo.
Estados de los artículos del pedido: NUEVO pasa a ACEPTADO, RECHAZADO o CANCELADO; ACEPTADO pasa a ENVIADO o CANCELADO; ENVIADO puede convertirse en DEVUELTO. Saltarse un paso falla con el código 9 (no se puede cambiar el estado de nuevo a enviado). RECHAZADO y CANCELADO son finales y no reembolsan: refurbed_reject_order_item está instalado apagado, y refurbed espera que le informes al cliente a través de un ticket primero. El estado del pedido se calcula a partir de sus artículos. No uses los campos obsoletos parcel_tracking_number, parcel_tracking_carrier y el único item_identifier.
Reembolsos: este conector nunca reembolsa. refurbed_calculate_item_refund y refurbed_calculate_order_refund son simulaciones que muestran los montos; el reembolso en sí se realiza en la interfaz del vendedor (necesita un ticket abierto).
Etiquetas, facturas, devoluciones, tickets: refurbed_list_shipping_labels proporciona enlaces de etiquetas frescas; refurbed_create_shipping_label (apagado) crea una etiqueta real en el acuerdo de envío de refurbed con cada llamada. refurbed_get_order_invoice enlaza la factura que subiste. refurbed_list_returns lista devoluciones con etiquetas de devolución de refurbed; establece el artículo como DEVUELTO cuando llegue el paquete. refurbed_list_tickets y refurbed_get_ticket leen tickets de soporte al cliente.
Ofertas: refurbed_list_offers, refurbed_get_offer, refurbed_create_offer (encuentra el producto con refurbed_get_instance, el perfil con refurbed_list_shipping_profiles), refurbed_update_offer y refurbed_batch_update_offers para stock y precios. Identifica ofertas por SKU: los ids de oferta cambian cuando se recrea una oferta. Pausa con stock 0; refurbed_delete_offer está apagado. Precios fijos por mercado: refurbed_list_market_offers, refurbed_create_market_offer, refurbed_update_market_offer, refurbed_delete_market_offer (apagado); solo los mercados del sitio de refurbed_list_markets los aceptan. Solo se acepta la garantía M12 para nuevas ofertas; la clasificación es AA, A, B o C.
Otras búsquedas: refurbed_list_merchant_addresses (ids de direcciones de remitente para etiquetas) y refurbed_get_currency (tasas de cambio; la verificación de configuración lo utiliza).
Cómo funciona la API: cada llamada es un POST de un cuerpo JSON a /refb.merchant.v1.<Service>/<Method>. Los nombres de los campos son snake_case; los ids son números enteros enviados y devueltos como cadenas ("3496079"); el dinero es una cadena decimal con un punto ("199.99", se rechaza una coma); los tiempos son RFC 3339 en UTC; los enums se envían por nombre. Proporciona una oferta por sku o por id, nunca ambos. Las listas se paginan con un cursor: pasa el último id como starting_after mientras has_more sea verdadero, hasta 100 filas. Los lotes toman de 1 a 50 artículos y responden un estado por artículo.
Límites y errores: 10 solicitudes por segundo por defecto (encabezados X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset); si superas esto, obtienes 429 RESOURCE_EXHAUSTED. Los errores responden con code y message con códigos gRPC: 3 argumento inválido, 5 no encontrado, 6 ya existe, 7 permiso denegado, 9 condición previa fallida, 16 no autenticado.
Términos: los términos de la API de refurbed permiten a los integradores actuar en nombre de los vendedores, pero cada acción debe ser rastreable al vendedor, y los datos de la API no pueden ser revendidos ni utilizados para benchmarking o inteligencia de mercado.
Escrituras: confirma primero. Aceptar, enviar, rastrear, cambios de stock y precio actúan en la cuenta en vivo. Antes de cada llamada, muestra al usuario qué cambios y espera un sí.
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 — Agregar el conector en Cursor
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.
Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
refurbed.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
refurbed_list_orders | Lista pedidos, los más nuevos primero por defecto: id, released_at, estado (NUEVO, ACEPTADO, ENVIADO, CUMPLIDO, CANCELADO y otros), etiquetas (p. ej.… |
refurbed_get_order | Lee un pedido con todos sus artículos: estado, etiquetas, correo electrónico del cliente, dirección de envío y factura (con números de IVA), totales y liquidación… |
refurbed_list_order_items | Lista los artículos de un pedido: id, nombre, estado, sku, totales, comisión, impuestos, datos de oferta (id de oferta, clasificación, garantía, envío… |
refurbed_get_order_item | Lee un artículo de pedido por su propio id (no el id del pedido): estado, sku, precios y comisión, datos de oferta, enlace de seguimiento y transportista… |
refurbed_accept_order_item | Acepta un artículo de pedido NUEVO (estado ACEPTADO): confirmas que lo enviarás. Responde el artículo actualizado |
refurbed_ship_order_item | Marca un artículo de pedido ACEPTADO como ENVIADO con su seguimiento: un parcel_tracking_url completo, o parcel_carrier_tracking_number (slug del transportista y… |
refurbed_update_order_item | Cambia un artículo de pedido sin cambiar su estado: reemplaza el enlace de seguimiento o el número de seguimiento del transportista, añade identificadores (IMEI, serie)… |
refurbed_batch_update_order_item_states | Cambia el estado de hasta 50 artículos de pedido en una llamada (aceptar o enviar varios). Cada actualización tiene los campos de las llamadas individuales; la respuesta… |
refurbed_reject_order_item | Rechaza (artículo NUEVO) o cancela (artículo NUEVO o ACEPTADO) un artículo de pedido. Final y no se puede deshacer; no reembolsa al cliente por sí mismo… |
refurbed_calculate_item_refund | Simulación: muestra lo que significaría reembolsar un artículo de pedido (total_pagado, total_reembolsado, reembolsado, las partes de refurbed y del vendedor) sin… |
refurbed_calculate_order_refund | Simulación: muestra lo que significaría reembolsar todos los artículos reembolsables de un pedido, sin reembolsar nada |
refurbed_list_shipping_labels | Lista las etiquetas de envío creadas para un pedido: id, enlaces PDF de impresora (expiran después de aproximadamente una hora, llama de nuevo para obtener frescas), seguimiento… |
refurbed_create_shipping_label | Crea una etiqueta de envío para un pedido en el acuerdo de envío de refurbed (DHL Express hoy). Cada llamada crea una nueva etiqueta real y su… |
refurbed_get_order_invoice | Obtén un enlace de descarga (válido 24 horas) para la factura que subiste para un pedido. NOT_FOUND cuando no hay ninguna |
refurbed_list_returns | Lista devoluciones que funcionan con etiquetas de devolución de refurbed: id, order_id, order_item_id, instance_name, identificadores, estado (INICIADO, EN_TRÁNSITO… |
refurbed_list_tickets | Lista tickets de soporte al cliente: id, estado (ABIERTA, PENDIENTE, RESUELTA, CERRADA), tema, urgencia, cliente, pedido y artículo de pedido… |
refurbed_get_ticket | Lee un ticket de soporte con sus mensajes, tema, estado, referencias de pedido y notas |
refurbed_list_offers | Lista tus ofertas: id, sku, instance_id y instance_name, estado (OK, NO_VERIFICADO, PENDIENTE_REVISIÓN, RECHAZADO con razón de rechazo), clasificación… |
refurbed_get_offer | Lee una oferta por SKU o por id: estado, clasificación, garantía, stock, perfiles de envío, impuestos, precios de referencia y los precios de mercado con… |
refurbed_create_offer | Crea una oferta para un producto: instance_id (refurbed_get_instance), o un gtin o mpn (la oferta está entonces NO_VERIFICADA hasta que refurbed verifica… |
refurbed_update_offer | Cambia una oferta por SKU o id: stock, precio de referencia y precio mínimo, clasificación, garantía, perfil de envío o impuestos; solo los campos dados… |
refurbed_batch_update_offers | Cambia hasta 50 ofertas en una llamada (actualizaciones de stock y precio). Cada entrada tiene identificador más los campos de refurbed_update_offer; la… |
refurbed_delete_offer | Elimina una oferta por SKU o id. No se puede deshacer; para pausar una oferta establece stock 0 con refurbed_update_offer en su lugar. Instalado apagado |
refurbed_list_market_offers | Lista los precios por mercado de una oferta: market_code, si es un mercado del sitio, precio fijo o calculado y precio mínimo, moneda… |
refurbed_create_market_offer | Establece un precio fijo para una oferta en un mercado del sitio en lugar del precio calculado a partir del precio de referencia. ALREADY_EXISTS cuando el mercado… |
refurbed_update_market_offer | Cambia el precio fijo de una oferta en un mercado. Proporciona la oferta por sku o offer_id y el market_code |
refurbed_delete_market_offer | Elimina el precio fijo de una oferta en un mercado; el precio vuelve al cálculo a partir del precio de referencia. Instalado apagado |
refurbed_get_instance | Busca un producto refurbed (instancia) por GTIN, MPN o id: id y nombre. Usa el id como instance_id al crear ofertas. No hay producto… |
refurbed_list_shipping_profiles | Lista tus perfiles de envío: id, nombre, país de origen, mercados de destino con costos y tiempos de entrega, y cuántas ofertas usa cada uno.… |
refurbed_list_available_carriers | Lista los transportistas que refurbed puede rastrear: nombre y slug. Usa el slug como transportista al enviar con un número de seguimiento en lugar de un enlace. Cache… |
refurbed_list_markets | Lista los mercados de refurbed: código (p. ej. de, at, fr), nombre, tipo, currency_code y is_site (un mercado con su propio sitio refurbed, donde los fijos… |
refurbed_list_merchant_addresses | Lista tus direcciones: id, tipo (ENTREGA o DEVOLUCIÓN), empresa, calle, ciudad, código postal y país. El id es la dirección de remitente de un… |
refurbed_get_currency | Lee una moneda y sus tasas de cambio. No necesita datos del vendedor; se usa para verificar que el token funcione |
Ejemplos de indicaciones
- "¿Qué artículos de pedido de refurbed están esperando aceptación?"
- "Envía el artículo de pedido 9123456 con seguimiento de DHL 00340434161234567890 e IMEI 356789012345678."
- "¿Cuáles son mis precios de oferta por mercado para el iPhone 14 de 128 GB?"
- "¿Qué devoluciones llegaron esta semana?"
- "¿Cuánto sería un reembolso del artículo de pedido 9123456?"
Preguntas frecuentes
¿De dónde proviene el token de API? Solicítalo con el formulario de token de API de refurbed, de tu gerente de cuenta o a [email protected]. Los tokens no utilizados caducan después de dos meses.
¿Qué cubre? Pedidos y artículos de pedido (aceptar, enviar con seguimiento e IMEI), simulaciones de reembolso, etiquetas de envío, facturas, devoluciones, tickets de soporte, ofertas con stock y precios, precios de mercado, búsqueda de productos, perfiles de envío y transportistas.
¿Qué herramientas se instalan apagadas? refurbed_reject_order_item, refurbed_create_shipping_label, refurbed_delete_offer y refurbed_delete_market_offer. Actívalas en la página del conector solo si la IA debe usarlas.
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Próximos pasos
¿Te ha sido útil esta guía?