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 Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta refurbed con la configuración guiada y añade tu URL MCP a Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
refurbed. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?