Руководство по коннектору8 мин чтенияMCP-инструментов: 337 языков

refurbed MCP-сервер: заказы и предложения

API продавца refurbed для продавцов восстановленной электроники: заказы и позиции заказов (прием, доставка с отслеживанием и IMEI), пробные возвраты, транспортные ярлыки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. Токен API от refurbed.

HCАвтор: команда HelpCodeОбновлено 8 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

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.

инструментов

33

Регион

INTL

Категория

Электронная коммерция

Аутентификация

API Key

Требуемые env-vars

REFURBED_API_TOKEN
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

API продавца refurbed для продавцов восстановленной электроники: заказы и позиции заказов (прием, доставка с отслеживанием и IMEI), пробные возвраты, транспортные ярлыки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. Токен API от refurbed.

Пошаговая настройка

Подключи refurbed к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи refurbed в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для refurbed

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

refurbed · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → refurbed, вставь свои учетные данные, создай ключ API MCP и готово. Никакого Docker, никакого git clone, никакого локального сервера.

refurbed

API продавца refurbed для продавцов восстановленной электроники: заказы и позиции заказов (прием, доставка с отслеживанием и IMEI), пробные возвраты, транспортные ярлыки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. Токен API от refurbed.

Настройка

Настройка занимает около 5 минут. Тебе нужен ответ от refurbed.

  1. Запроси токен API с помощью формы на supplier.refurbed.com/api-token-request (или спроси у своего менеджера по аккаунту или на [email protected]). refurbed отправляет токен, который выглядит как UUID.
  2. Вставь его в REFURBED_API_TOKEN, установи и запусти refurbed_list_orders. Коннектор отправляет его как Authorization: Plain, за которым следует токен.
  3. Токен, который не используется в течение 2 месяцев, истекает; затем запроси новый. Некоторые вызовы также должны быть активированы refurbed для твоего аккаунта (транспортные ярлыки, предложения на новые батареи).

API работает на https://api.refurbed.com. refurbed также предоставляет каждому продавцу песочницу по запросу (supplier.refurbed.com/sandbox-request), по адресу вроде https://grpc-<name>.qa.refurbed.io, с тестовыми заказами; самостоятелная установка может указывать копию этого коннектора туда.

С чего начать: refurbed_list_orders с состоянием NEW показывает заказы для обработки; refurbed_get_order и refurbed_list_order_items показывают позиции. Принимай с помощью refurbed_accept_order_item, затем отправляй с помощью refurbed_ship_order_item (ссылка для отслеживания или slug перевозчика из refurbed_list_available_carriers плюс номер отслеживания, а также IMEI или серийный номер в item_identifiers). refurbed_batch_update_order_item_states обрабатывает до 50 за раз; refurbed_update_order_item изменяет отслеживание, идентификаторы, заметки или данные швейцарской таможни позже; refurbed_get_order_item читает одну позицию.

Состояния позиций заказа: NEW переходит в ACCEPTED, REJECTED или CANCELLED; ACCEPTED переходит в SHIPPED или CANCELLED; SHIPPED может стать RETURNED. Пропуск шага приводит к ошибке с кодом 9 (нельзя изменить состояние с нового на отправленный). REJECTED и CANCELLED являются окончательными и не подлежат возврату: refurbed_reject_order_item установлен выключенным, и refurbed ожидает, что ты сначала сообщишь об этом клиенту через тикет. Состояние заказа рассчитывается по его позициям. Не используй устаревшие поля parcel_tracking_number, parcel_tracking_carrier и единственный item_identifier.

Возвраты: этот коннектор никогда не производит возвраты. refurbed_calculate_item_refund и refurbed_calculate_order_refund — это пробные запуски, которые показывают суммы; сам возврат осуществляется в интерфейсе продавца (нужен открытый тикет).

Ярлыки, счета, возвраты, тикеты: refurbed_list_shipping_labels предоставляет свежие ссылки на ярлыки; refurbed_create_shipping_label (выключен) создает реальный ярлык по соглашению о доставке refurbed с каждым вызовом. refurbed_get_order_invoice связывает счет, который ты загрузил. refurbed_list_returns перечисляет возвраты с ярлыками возврата refurbed; установи позицию в RETURNED, когда посылка прибудет. refurbed_list_tickets и refurbed_get_ticket читают тикеты клиентов.

Предложения: refurbed_list_offers, refurbed_get_offer, refurbed_create_offer (найди продукт с помощью refurbed_get_instance, профиль с помощью refurbed_list_shipping_profiles), refurbed_update_offer и refurbed_batch_update_offers для наличия и цен. Идентифицируй предложения по SKU: идентификаторы предложений меняются, когда предложение воссоздается. Приостанови с наличием 0; refurbed_delete_offer выключен. Фиксированные цены по рынку: refurbed_list_market_offers, refurbed_create_market_offer, refurbed_update_market_offer, refurbed_delete_market_offer (выключен); только рыночные сайты из refurbed_list_markets принимают их. Только гарантия M12 принимается для новых предложений; градация — AA, A, B или C.

Другие запросы: refurbed_list_merchant_addresses (идентификаторы адресов отправителей для ярлыков) и refurbed_get_currency (курсы обмена; проверка настройки использует его).

Как работает API: каждый вызов — это POST с телом JSON на /refb.merchant.v1.<Service>/<Method>. Имена полей в snake_case; идентификаторы — целые числа, отправляемые и возвращаемые как строки ("3496079"); деньги — десятичная строка с точкой ("199.99", запятая не принимается); время — RFC 3339 в UTC; перечисления отправляются по имени. Указывай предложение по sku или по id, никогда не оба. Списки страниц с курсором: передавай последний идентификатор как starting_after, пока has_more истинно, до 100 строк. Пакеты принимают от 1 до 50 элементов и отвечают одним статусом на элемент.

Ограничения и ошибки: 10 запросов в секунду по умолчанию (заголовки X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset); при превышении получаешь 429 RESOURCE_EXHAUSTED. Ошибки отвечают code и message с кодами gRPC: 3 недопустимый аргумент, 5 не найдено, 6 уже существует, 7 доступ запрещен, 9 не выполнено предварительное условие, 16 неаутентифицирован.

Условия: условия API refurbed позволяют интеграторам действовать от имени продавцов, но каждое действие должно быть прослеживаемым к продавцу, а данные API не могут быть перепроданы или использованы для бенчмаркинга или рыночной аналитики.

Записи: сначала подтвердите. Принятие, доставка, отслеживание, изменения наличия и цен действуют на живом аккаунте. Перед каждым вызовом покажи пользователю, какие изменения, и дождись подтверждения.

Предварительные условия: REFURBED_API_TOKEN

Установи коннектор локально

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

Открой http://localhost:3000/connectors/store, выбери refurbed и вставь переменные окружения, указанные в предварительных условиях.

Доступные инструменты

ИнструментЧто он делает
refurbed_list_ordersПеречисляет заказы, по умолчанию от новых к старым: id, released_at, state (NEW, ACCEPTED, SHIPPED, FULFILLED, CANCELLED и другие), ярлыки (например,…
refurbed_get_orderЧитает один заказ со всеми его позициями: состояние, ярлыки, электронная почта клиента, адрес доставки и счета (с номерами НДС), итоги и расчет…
refurbed_list_order_itemsПеречисляет позиции одного заказа: id, имя, состояние, sku, итоги, комиссия, налогообложение, данные предложения (идентификатор предложения, градация, гарантия, доставка…
refurbed_get_order_itemЧитает одну позицию заказа по ее собственному id (не id заказа): состояние, sku, цены и комиссия, данные предложения, ссылка для отслеживания и перевозчик…
refurbed_accept_order_itemПринимает новую позицию заказа (состояние ACCEPTED): ты подтверждаешь, что отправишь ее. Ответ — обновленная позиция
refurbed_ship_order_itemОтмечает принятую позицию заказа как отправленную с ее отслеживанием: полный parcel_tracking_url или parcel_carrier_tracking_number (slug перевозчика и…
refurbed_update_order_itemИзменяет позицию заказа без изменения ее состояния: заменяет ссылку для отслеживания или номер отслеживания перевозчика, добавляет идентификаторы (IMEI, серийный номер)…
refurbed_batch_update_order_item_statesИзменяет состояние до 50 позиций заказа за один вызов (принимает или отправляет несколько). Каждое обновление имеет поля одиночных вызовов; ответ…
refurbed_reject_order_itemОтклоняет (новую позицию) или отменяет (новую или принятую позицию) позицию заказа. Окончательно и не может быть отменено; это не возвращает деньги клиенту само по себе…
refurbed_calculate_item_refundПробный запуск: показывает, что значит возврат позиции заказа (total_paid, total_refunded, refunded, доли refurbed и торговца) без…
refurbed_calculate_order_refundПробный запуск: показывает, сколько составит возврат всех подлежащих возврату позиций заказа, без возврата чего-либо
refurbed_list_shipping_labelsПеречисляет транспортные ярлыки, созданные для заказа: id, ссылки на PDF для принтера (они истекают примерно через час, вызови снова для свежих), отслеживание…
refurbed_create_shipping_labelСоздает транспортный ярлык для заказа по соглашению о доставке refurbed (DHL Express сегодня). Каждый вызов создает новый реальный ярлык и его…
refurbed_get_order_invoiceПолучает ссылку для скачивания (действительна 24 часа) для счета, который ты загрузил для заказа. NOT_FOUND, когда его нет
refurbed_list_returnsПеречисляет возвраты, которые осуществляются по ярлыкам возврата refurbed: id, order_id, order_item_id, instance_name, идентификаторы, состояние (INITIATED, IN_TRANSIT…
refurbed_list_ticketsПеречисляет тикеты поддержки клиентов: id, статус (OPEN, PENDING, SOLVED, CLOSED), тема, срочность, клиент, заказ и позиция заказа…
refurbed_get_ticketЧитает один тикет поддержки с его сообщениями, темой, статусом, ссылками на заказы и заметками
refurbed_list_offersПеречисляет твои предложения: id, sku, instance_id и instance_name, состояние (OK, UNVERIFIED, PENDING_REVIEW, REJECTED с rejection_reason), градация…
refurbed_get_offerЧитает одно предложение по SKU или по id: состояние, градация, гарантия, наличие, профили доставки, налогообложение, справочные цены и рыночные цены с…
refurbed_create_offerСоздает предложение для продукта: instance_id (refurbed_get_instance), или gtin или mpn (предложение тогда UNVERIFIED, пока refurbed не проверит…
refurbed_update_offerИзменяет предложение по SKU или id: наличие, справочная цена и минимальная цена, градация, гарантия, профиль доставки или налогообложение; только указанные поля…
refurbed_batch_update_offersИзменяет до 50 предложений за один вызов (обновления наличия и цен). Каждая запись имеет идентификатор плюс поля refurbed_update_offer; ответ…
refurbed_delete_offerУдаляет предложение по SKU или id. Не может быть отменено; чтобы приостановить предложение, установи наличие 0 с помощью refurbed_update_offer вместо этого. Установлен выключенным
refurbed_list_market_offersПеречисляет цены на одно предложение по рынкам: market_code, является ли это рыночным сайтом, установленная или рассчитанная цена и минимальная цена, валюта…
refurbed_create_market_offerУстанавливает фиксированную цену для предложения в одном рыночном сайте вместо цены, рассчитанной по справочной цене. ALREADY_EXISTS, когда рынок…
refurbed_update_market_offerИзменяет фиксированную цену предложения в одном рынке. Укажи предложение по sku или offer_id и market_code
refurbed_delete_market_offerУдаляет фиксированную цену предложения в одном рынке; цена возвращается к расчету по справочной цене. Установлен выключенным
refurbed_get_instanceИщет продукт refurbed (экземпляр) по GTIN, MPN или id: id и имя. Используй id как instance_id при создании предложений. Продукта нет…
refurbed_list_shipping_profilesПеречисляет твои профили доставки: id, имя, страна отправления, рынки назначения с затратами и сроками доставки, и сколько предложений использует каждый.…
refurbed_list_available_carriersПеречисляет перевозчиков, которых refurbed может отслеживать: имя и slug. Используй slug как перевозчика при отправке с номером отслеживания вместо ссылки. Кэш…
refurbed_list_marketsПеречисляет рынки refurbed: код (например, de, at, fr), имя, тип, currency_code и is_site (рынок с собственным сайтом refurbed, где фиксированные…
refurbed_list_merchant_addressesПеречисляет твои адреса: id, тип (DELIVERY или RETURN), компания, улица, город, почтовый индекс и страна. Id — это адрес отправителя для…
refurbed_get_currencyЧитает валюту и ее курсы обмена. Не требует данных продавца; используется для проверки работоспособности токена

Примеры запросов

  • "Какие позиции заказов refurbed ждут принятия?"
  • "Отправить позицию заказа 9123456 с отслеживанием DHL 00340434161234567890 и IMEI 356789012345678."
  • "Каковы мои цены предложений по рынкам для iPhone 14 128 ГБ?"
  • "Какие возвраты пришли на этой неделе?"
  • "Сколько составит возврат позиции заказа 9123456?"

Следующие шаги

Это руководство помогло?

Подключи refurbed к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи refurbed в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключи refurbed MCP к ChatGPT: заказы и цены

API для продавцов refurbed: заказы и позиции заказов (прием, отправка с отслеживанием и IMEI), тестовые возвраты, этикетки для отправки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. API токен от refurbed.

Коннекторы

Подключи refurbed MCP к Claude: заказы и цены

API для продавцов refurbed: заказы и позиции заказов (прием, отправка с отслеживанием и IMEI), тестовые возвраты, этикетки для отправки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. API токен от refurbed.

Коннекторы

Подключи refurbed MCP к Microsoft Copilot

API для продавцов refurbed: заказы и позиции заказов (прием, отправка с отслеживанием и IMEI), тестовые возвраты, этикетки для отправки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. API токен от refurbed.

Коннекторы

Подключи refurbed MCP к Cursor: заказы и цены

API для продавцов refurbed: заказы и позиции заказов (прием, отправка с отслеживанием и IMEI), тестовые возвраты, этикетки для отправки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. API токен от refurbed.

Коннекторы

Подключи refurbed MCP к Gemini CLI

API для продавцов refurbed: заказы и позиции заказов (прием, отправка с отслеживанием и IMEI), тестовые возвраты, этикетки для отправки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. API токен от refurbed.

Коннекторы

Подключи refurbed MCP к Meta Muse

API для продавцов refurbed: заказы и позиции заказов (прием, отправка с отслеживанием и IMEI), тестовые возвраты, этикетки для отправки, счета, возвраты, тикеты поддержки, предложения с наличием и ценами, рыночные цены, поиск продуктов, профили доставки и перевозчики. API токен от refurbed.