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 Claude, ChatGPT o 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 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 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
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
Configurar toma alrededor de 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 expira; 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-<nombre>.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 seguimiento, identificadores, notas o datos de aduanas suizas más tarde; refurbed_get_order_item lee un artículo.
Estados de los artículos de 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 digas 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 clientes.
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 del 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í.
Requisitos previos: REFURBED_API_TOKEN
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 refurbed y pega las variables de entorno listadas bajo Requisitos previos.
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 de 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 comerciante) 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 enlaces frescos), 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 (ABIERTO, PENDIENTE, RESUELTO, CERRADO), 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 verifique… |
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 del remitente de un… |
refurbed_get_currency | Lee una moneda y sus tasas de cambio. No necesita datos del vendedor; se utiliza para verificar que el token funciona |
Ejemplos de prompts
- "¿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 y 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?"
Próximos pasos
¿Te ha sido útil esta guía?