Guía de conector11 minutos de lectura33 herramientas MCP7 idiomas

Conectar refurbed MCP con ChatGPT: pedidos y ofertas

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.

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

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

refurbed

refurbed

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

herramientas

33

Región

INTL

Categoría

E-commerce

Autenticación

API Key

Env vars requeridas

REFURBED_API_TOKEN
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

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 ChatGPT en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta refurbed con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.

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

El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.

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.

refurbed · live vía MCP
Compartir
Opus 4.7

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 + ChatGPT

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.

  1. 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.
  2. Pégalo en REFURBED_API_TOKEN, instala y ejecuta refurbed_list_orders. El conector lo envía como Authorization: Plain seguido del token.
  3. 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 ChatGPT

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 muestra YOUR_SERVER_ID.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

  1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
  2. Escribe un nombre, por ejemplo Name: refurbed.
  3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
  4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
  5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

HerramientaQué hace
refurbed_list_ordersLista pedidos, los más nuevos primero por defecto: id, released_at, estado (NUEVO, ACEPTADO, ENVIADO, CUMPLIDO, CANCELADO y otros), etiquetas (p. ej.…
refurbed_get_orderLee 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_itemsLista 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_itemLee 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_itemAcepta un artículo de pedido NUEVO (estado ACEPTADO): confirmas que lo enviarás. Responde el artículo actualizado
refurbed_ship_order_itemMarca 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_itemCambia 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_statesCambia 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_itemRechaza (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_refundSimulació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_refundSimulación: muestra lo que significaría reembolsar todos los artículos reembolsables de un pedido, sin reembolsar nada
refurbed_list_shipping_labelsLista 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_labelCrea 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_invoiceObté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_returnsLista 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_ticketsLista tickets de soporte al cliente: id, estado (ABIERTA, PENDIENTE, RESUELTA, CERRADA), tema, urgencia, cliente, pedido y artículo de pedido…
refurbed_get_ticketLee un ticket de soporte con sus mensajes, tema, estado, referencias de pedido y notas
refurbed_list_offersLista 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_offerLee 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_offerCrea 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_offerCambia 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_offersCambia 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_offerElimina 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_offersLista 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_offerEstablece 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_offerCambia el precio fijo de una oferta en un mercado. Proporciona la oferta por sku o offer_id y el market_code
refurbed_delete_market_offerElimina 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_instanceBusca 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_profilesLista 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_carriersLista 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_marketsLista 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_addressesLista 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_currencyLee 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.

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Próximos pasos

¿Te ha sido útil esta guía?

Conecta refurbed a ChatGPT en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta refurbed con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar refurbed MCP con Claude: pedidos y ofertas

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.

Conectores

Conectar refurbed MCP con 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.

Conectores

Conectar refurbed MCP con Cursor: pedidos y ofertas

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.

Conectores

Conectar refurbed MCP con Gemini CLI

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.

Conectores

Conectar refurbed MCP con Meta Muse

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.

Conectores

refurbed MCP Server: pedidos y ofertas

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.