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

RETIF MCP-сервер: заказы, цены и доставка

Управляй своим магазином на маркетплейсе RETIF через AI агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и запасами, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API ключом магазина из своего личного кабинета продавца RETIF.

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

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

RETIF Marketplace

RETIF Marketplace

Run your shop on the RETIF marketplace from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, imports, messages, returns, invoices and transactions. The marketplace sells in France, Belgium, Germany, Spain, Italy, Luxembourg and the Netherlands; sign in with the shop API key from your RETIF seller back office.

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

38

Регион

FR

Категория

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

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

API Key

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

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

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

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

Кратко

Управляй своим магазином на маркетплейсе RETIF через AI агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и запасами, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API ключом магазина из своего личного кабинета продавца RETIF.

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

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

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

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

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

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

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

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

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

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

RETIF Marketplace

Управляй своим магазином на маркетплейсе RETIF через AI агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и запасами, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API ключом магазина из своего личного кабинета продавца RETIF.

Настройка

Страны: Франция, Бельгия, Германия, Испания, Италия, Люксембург и Нидерланды. Один аккаунт продавца продает в каждой стране RETIF. RETIF продает только бизнес-клиентам.

Кто может продавать: RETIF принимает продавцов, ориентирующихся на бизнес-клиентов: свяжись с RETIF, чтобы зарегистрировать свой интерес. Продавцы выставляют счета и отправляют товары напрямую клиенту. Нет первоначального взноса или ежемесячной платы; RETIF взимает комиссию с каждой продажи, которая зависит от категории продукта. Коннектор требует аккаунт продавца, который уже открыт RETIF.

RETIF поддерживает только цветовые варианты; другие типы вариантов перечислены как отдельные продукты.

Настройка занимает около 5 минут.

  1. Войди в личный кабинет продавца RETIF: https://marketplace.retif.eu/login.
  2. В личном кабинете открой свое имя пользователя (в правом верхнем углу) > Мои настройки пользователя > API ключ и нажми Создать новый ключ (или скопируй существующий ключ). Вставь его в RETIF_API_KEY. Ключ отправляется как есть в заголовке Authorization, без Bearer. Создание нового ключа делает старый недействительным, поэтому любой другой инструмент, использующий его, перестает работать.
  3. Оставь RETIF_SHOP_ID пустым. Только если твой пользователь управляет несколькими магазинами на RETIF, установи RETIF_SHOP_ID на числовой идентификатор магазина, с которым должен работать этот коннектор (показан на панели управления личного кабинета рядом с Идентификатором или ID магазина, и возвращается как shop_id с помощью retif_get_account). Без него будет использоваться твой магазин по умолчанию.
  4. Установи и запусти retif_get_account: он возвращает магазин, к которому принадлежит ключ.

С чего начать: retif_get_account показывает магазин, связанный с ключом (идентификатор, имя, состояние, валюта и каналы). Для повседневной работы используй retif_list_orders с order_state_codes=WAITING_ACCEPTANCE, retif_list_offers для цен и запасов и retif_list_threads для сообщений, ожидающих ответа.

Продукты и конкурирующие предложения: retif_get_products ищет продукты в каталоге RETIF по EAN или другой ссылке и возвращает SKU продукта на маркетплейсе; retif_list_product_offers перечисляет предложения каждого магазина для заданных продуктов, начиная с лучшей цены, примерно 5 вызовов в минуту.

Рабочий процесс заказов: новый заказ ожидает в WAITING_ACCEPTANCE. retif_accept_order принимает (или отказывает) каждую строку; после списания с клиента заказ переходит в SHIPPING. Затем retif_update_tracking сохраняет перевозчика и номер отслеживания (коды перевозчиков берутся из retif_list_carriers), а retif_ship_order подтверждает отправку (SHIPPED). Поздние состояния: TO_COLLECT, RECEIVED, CLOSED, REFUSED и CANCELED. Используй retif_list_orders с order_state_codes=WAITING_ACCEPTANCE для повседневного списка задач и has_incident=true для открытых инцидентов; retif_resolve_incident закрывает инцидент по одной строке заказа, как только он решен. Документы, прикрепленные к заказам (накладные, ярлыки, счета клиентов), перечисляются с помощью retif_list_order_documents.

Записи: сначала подтверждай. retif_accept_order, retif_update_tracking, retif_ship_order, retif_resolve_incident, retif_accept_return, retif_receive_return, retif_update_offers, retif_reply_thread, retif_create_order_thread и retif_import_products действуют на живом маркетплейсе. Перед каждым вызовом покажи пользователю, что изменится (идентификатор заказа и строки, номер отслеживания, SKU предложения с прежней и новой ценой или запасом, текст сообщения и получатели) и жди подтверждения. Отказ от строки заказа отменяет ее навсегда. Никакой инструмент здесь не возвращает деньги, не отменяет заказы и не перемещает деньги; делай это в личном кабинете. retif_import_offers может удалять предложения (режим REPLACE удаляет каждое предложение, отсутствующее в файле), поэтому он установлен выключенным.

Обновление предложений (цен и запасов): retif_update_offers (OF24) заменяет все предложение. Каждое поле, которое ты оставляешь пустым, сбрасывается: отсутствующее quantity становится 0, отсутствующая discount или description удаляется. Всегда сначала читай предложение (retif_get_offer или retif_list_offers с sku) и отправляй его обратно полностью с только предполагаемым изменением: shop_sku, product_id и product_id_type (из product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (его код), min_quantity_alert, description, discount, all_prices, available_started / available_ended (читай как available_start_date / available_end_date) и любые offer_additional_fields. Оставь update_delete пустым или update. Вызов возвращает import_id; изменение применяется асинхронно, поэтому проверь его с помощью retif_get_offer_import перед повторным чтением предложения. Код состояния для state_code берется из retif_list_offer_conditions, коды логистического класса из retif_list_logistic_classes.

Импорт файлов: retif_import_products (P41) и retif_import_offers (OF01) принимают URL CSV, XLSX или XML файла в формате, который требует RETIF; коннектор загружает его и загружает в RETIF. Отслеживай их с помощью retif_list_product_imports / retif_get_product_import и retif_list_offer_imports / retif_get_offer_import.

Возвраты: retif_list_returns (RT11) перечисляет запросы на возврат. Где RETIF позволяет магазину решать, retif_accept_return принимает или отказывает в WAITING_ACCEPTANCE, а retif_receive_return подтверждает, что товары прибыли. Возвраты остаются в личном кабинете.

Сообщения: retif_list_threads перечисляет разговоры (фильтруй с entity_type=MMP_ORDER и entity_id=<order id> для одного заказа; entity_id без entity_type отклоняется), retif_get_thread читает один с его сообщениями, retif_reply_thread отвечает (получатель CUSTOMER или OPERATOR, который является RETIF) и retif_create_order_thread открывает новый разговор по заказу. Код причин для тем берется из retif_list_reasons; оставь его locale пустым, если не знаешь, что на маркетплейсе есть этот язык (неактивная локаль отвечает 400).

Деньги: retif_list_invoices (IV01) перечисляет бухгалтерские документы, которые RETIF выдает магазину, а retif_list_transactions (TL02) — строки транзакций (продажи, комиссии, возвраты, выплаты). Если RETIF использует Упрощенное Выставление Счетов Продавцам, IV01 не возвращает новые документы; используй retif_list_document_requests (DR11) и транзакции тогда.

Весь каталог: чтобы прочитать каждое предложение (проверка запасов или цен по всему каталогу, подсчет предложений), начни экспорт с retif_export_offers, опрашивай retif_get_offer_export_status примерно раз в минуту, пока он не станет COMPLETED, и читай файлы один за другим с помощью retif_get_offer_export_file; include_fields оставляет только нужные столбцы. Полный экспорт разрешен раз в день; для того, что изменилось с тех пор, передай last_request_date (дифференциальный экспорт, не чаще одного раза в минуту). Не прокручивай каждое предложение с помощью retif_list_offers: он предназначен для нескольких предложений за раз и отвечает 429, когда прокручивается большой каталог.

Несколько магазинов: каждый инструмент принимает необязательный shop_id. Пользователь, который управляет несколькими магазинами на этом маркетплейсе (агентство или один магазин на страну), может работать со всеми ними с одной установкой: передавай идентификатор магазина в каждом вызове и проверяй, какой это магазин, с помощью retif_get_account и того же shop_id. Без shop_id вызов использует RETIF_SHOP_ID или магазин по умолчанию пользователя, когда тот пуст. Спроси пользователя о идентификаторах их магазинов; личный кабинет показывает их.

Справочные списки: retif_list_channels (страницы стран), retif_list_carriers, retif_list_shipping_zones, retif_list_shipping_methods и retif_list_logistic_classes меняются редко; читай их один раз за разговор.

Пагинация: заказы, предложения, счета и импорты продуктов используют max (максимум 100) и offset. Темы, возвраты, транзакции, запросы документов и импорты предложений возвращают next_page_token; передай его как page_token, чтобы получить следующую страницу (все другие фильтры тогда игнорируются), пока он не исчезнет.

Даты — это ISO 8601, например, 2026-10-01T00:00:00Z; ответы в UTC.

Лимиты скорости: У каждого API есть свой лимит, и RETIF может их ужесточить. Перечисление предложений и заказов предназначено для интерактивного использования, импорты продуктов и предложений — не чаще чем раз в 15 минут, retif_get_account и справочные списки примерно раз в день. Код 429 содержит заголовок Retry-After с количеством секунд, которые нужно подождать; не пытайся повторять в цикле.

Ошибки: 401 означает, что ключ неверен или был заменен более новым, 403 — что у твоего пользователя нет прав на это действие, 404 — что заказ, предложение или тема не существуют для этого магазина или что маркетплейс не использует эту функцию, такую как возвраты, 400 — неверный параметр или заказ в неверном состоянии (сообщение указывает на это, например, ORDER_INVALID_STATE).

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

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

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, выбери RETIF Marketplace и вставь переменные окружения, указанные в предварительных условиях.

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

ИнструментЧто он делает
retif_get_accountЧитает магазин, связанный с API ключом на этом маркетплейсе (A01): идентификатор магазина и имя, состояние, каналы, валюта, рейтинг и процент одобрения, контакт…
retif_list_ordersПеречисляет заказы (OR11) с их строками, клиентом, адресом доставки, ценами, состоянием и инцидентами. Фильтруй по состоянию (например, WAITING_ACCEPTANCE для…
retif_list_offersПеречисляет предложения магазина (OF21): SKU, продукт, цена и скидка, все цены по каналам, количество на складе, состояние, время доставки и…
retif_get_offerЧитает одно предложение полностью по его идентификатору предложения (OF22): каждое ценовое поле, скидка, количество, состояние, логистический класс, время доставки и пользовательские…
retif_list_offer_conditionsПеречисляет условия предложения (OF61), которые принимает маркетплейс, например, новые или использованные, с кодом, который нужно указать в state_code при обновлении предложений
retif_list_offer_importsПеречисляет импорты и обновления предложений (OF04), из файлов и из retif_update_offers: статус (WAITING, RUNNING, COMPLETE, FAILED), строки прочитаны, в…
retif_get_offer_importЧитает статус одного импорта предложения или обновления предложения (OF02) по его import_id, как возвращается retif_update_offers или retif_import_offers…
retif_export_offersНачинает экспорт всех предложений магазина как файлов (OF52), способ прочитать весь каталог (каждый SKU с ценой и запасом) вместо…
retif_get_offer_export_statusСтатус экспорта предложения, начатого с retif_export_offers (OF53): PENDING, COMPLETED или FAILED (с error.code и error.detail), и…
retif_get_offer_export_fileЧитает один файл завершенного экспорта предложений (OF54): предложения с их SKU, продуктом, количеством, ценами и другими экспортированными полями, как…
retif_list_product_importsПеречисляет импорты продуктов (P51) с их статусом (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), количество трансформаций и…
retif_get_product_importЧитает статус одного импорта продукта (P42) по его import_id: статус импорта, причина, количество трансформаций и детали интеграции…
retif_get_productsИщет продукты в каталоге маркетплейса по их идентификаторам (P31), например, EAN, и получает SKU продукта на маркетплейсе, название и категорию.…
retif_list_product_offersПеречисляет предложения каждого магазина для заданных продуктов (P11), отсортированные по лучшей цене, чтобы сравнить свою цену с конкурентами. Укажи product_ids…
retif_list_threadsПеречисляет темы сообщений (M11) с клиентами и RETIF: тема, связанный заказ или предложение, участники, дата последнего сообщения и с какого времени магазин…
retif_get_threadЧитает одну тему сообщения (M10) со всеми ее сообщениями, отправителями, получателями, вложениями и связанным заказом или предложением
retif_list_returnsПеречисляет запросы на возврат (RT11) с их состоянием, строками возврата, причиной, RMA, отслеживанием и связанным заказом. Фильтруй по состоянию, заказу или дате.…
retif_list_reasonsПеречисляет коды причин маркетплейса (RE01): инциденты, отмены, возвраты и причины сообщений, с их метками и тем, может ли магазин…
retif_list_carriersПеречисляет перевозчиков, известных маркетплейсу (SH21), с их кодом, меткой и URL отслеживания. Используй код как carrier_code в…
retif_list_invoicesПеречисляет бухгалтерские документы, которые RETIF выдает магазину (IV01): счета и кредитные ноты с периодом, итогами с налогом и без…
retif_list_transactionsПеречисляет строки транзакций магазина (TL02): суммы заказов, доставка, комиссии, возвраты, ручные кредиты и выплаты, с суммой, типом…
retif_list_document_requestsПеречисляет запросы бухгалтерских документов (DR11), используемые, когда RETIF проводит Упрощенное Выставление Счетов Продавцам: счета и кредитные ноты, которые RETIF или магазин…
retif_list_order_documentsПеречисляет документы, прикрепленные к одному или нескольким заказам (OR72): накладные, ярлыки доставки, счета клиентов и другие файлы, с id, файлом…
retif_list_channelsПеречисляет каналы продаж маркетплейса (CH11), обычно по одному на страну, с кодом и меткой. Используй коды как channel_codes в…
retif_list_shipping_zonesПеречисляет активные зоны доставки маркетплейса (SH11) с кодом и меткой, например, материковая Франция или Корсика. Меняется редко: вызывай это…
retif_list_shipping_methodsПеречисляет активные методы доставки маркетплейса (SH12), например, стандартный, экспресс или самовывоз, с кодом, меткой, есть ли номер отслеживания…
retif_list_logistic_classesПеречисляет логистические классы маркетплейса (SH31), размеры или весовые категории, которые определяют цены на доставку, с кодом и меткой. Используй код как…
retif_accept_orderПринимает или отказывает в строках заказа, ожидающего принятия (OR21). Каждая строка заказа должна быть перечислена. Отказ от строки отменяет ее…
retif_update_trackingУстанавливает перевозчика и номер отслеживания заказа (OR23). Укажи carrier_code из retif_list_carriers или carrier_name с carrier_url для…
retif_ship_orderПодтверждает, что заказ в состоянии SHIPPING был отправлен (OR24); он переходит в SHIPPED, и клиент уведомляется. Сначала установи отслеживание с…
retif_update_offersСоздает или обновляет предложения, включая цену и запас (OF24). Полностью заменяет каждое предложение: каждое поле, оставленное пустым, сбрасывается (отсутствующее…
retif_reply_threadОтвечает в теме сообщения (M12) клиенту или RETIF. Сообщение доставляется сразу и не может быть отозвано: покажи пользователю текст…
retif_create_order_threadНачинает новую тему сообщения по заказу (OR43) с клиентом, RETIF или обоими. Сообщение доставляется сразу: покажи пользователю текст…
retif_resolve_incidentПомечает открытый инцидент по одной строке заказа как решенный (OR64), как только проблема клиента решена. reason_code должен быть INCIDENT_CLOSE…
retif_accept_returnПринимает или отказывает в запросе на возврат в WAITING_ACCEPTANCE (RT21). Только когда RETIF обрабатывает возвраты в личном кабинете продавца и оставляет…
retif_receive_returnПодтверждает, что товары принятого возврата прибыли на твой склад (RT25). Возврат переходит в RECEIVED. Действует на живом маркетплейсе…
retif_import_productsОтправляет файл продукта на маркетплейс (P41), чтобы создать или обогатить продукты в его каталоге. file_url — это адрес CSV, XLSX или XML…
retif_import_offersИмпортирует файл предложений (OF01), чтобы создать, обновить или удалить предложения оптом. Режим REPLACE удаляет каждое предложение, которого нет в файле, и…

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

  • "Какие заказы RETIF от бизнес-клиентов ждут моего принятия и из каких стран?"
  • "Установи запас моего черного пакета вешалок SKU RT-HNG-100 на 500 и сохрани цену."
  • "Добавь отслеживание DPD 15501234567892 к заказу 7701234-A и подтверди отправку."
  • "Экспортируй мой каталог RETIF и перечисли каждое предложение с менее чем 20 единицами на складе."
  • "Покажи транзакции за прошлый месяц: продажи и комиссии."

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

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

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

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

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

Коннекторы

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

Запускай свой магазин на маркетплейсе RETIF с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API-ключом магазина из своего личного кабинета продавца RETIF.

Коннекторы

Подключить RETIF MCP к Claude: заказы и остатки

Запускай свой магазин на маркетплейсе RETIF с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API-ключом магазина из своего личного кабинета продавца RETIF.

Коннекторы

Подключить RETIF MCP к Microsoft Copilot

Запускай свой магазин на маркетплейсе RETIF с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API-ключом магазина из своего личного кабинета продавца RETIF.

Коннекторы

Подключить RETIF MCP к Cursor: заказы и остатки

Запускай свой магазин на маркетплейсе RETIF с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API-ключом магазина из своего личного кабинета продавца RETIF.

Коннекторы

Подключить RETIF MCP к Gemini CLI: заказы

Запускай свой магазин на маркетплейсе RETIF с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API-ключом магазина из своего личного кабинета продавца RETIF.

Коннекторы

Подключить RETIF MCP к Meta Muse: заказы

Запускай свой магазин на маркетплейсе RETIF с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции, Бельгии, Германии, Испании, Италии, Люксембурге и Нидерландах; войди с API-ключом магазина из своего личного кабинета продавца RETIF.