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

Rozetka MCP-сервер: заказы, товары и остатки

API продавца Rozetka Marketplace для крупнейшей торговой площадки Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов и новыми объявлениями, отзывы о магазине и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход через логин кабинета продавца.

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

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

Rozetka Marketplace

Rozetka Marketplace

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

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

29

Регион

INTL

Категория

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

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

Sign-in token

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

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

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

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

Кратко

API продавца Rozetka Marketplace для крупнейшей торговой площадки Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов и новыми объявлениями, отзывы о магазине и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход через логин кабинета продавца.

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

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

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

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

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

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

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

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

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

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

Rozetka Marketplace

API продавца Rozetka Marketplace для крупнейшей торговой площадки Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов и новыми объявлениями, отзывы о магазине и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход через логин кабинета продавца.

Настройка

API выполняет вход с логином и паролем кабинета продавца Rozetka (seller.rozetka.com.ua); отдельного ключа API нет.

  1. Помести логин кабинета в ROZETKA_USERNAME.
  2. Rozetka ожидает, что пароль будет закодирован в Base64, поэтому ROZETKA_PASSWORD_BASE64 принимает закодированную форму, а не обычный пароль. Закодируй его на своем компьютере, например, в терминале printf '%s' 'your-password' | base64, и вставь результат. Не используй онлайн-кодировщик для реального пароля. AnythingMCP выполняет вход с помощью POST /sites и отправляет токен сессии в качестве токена Bearer. Rozetka поддерживает токен активным, пока он используется, и позволяет ему истечь через 24 часа без использования; коннектор выполняет вход снова каждые четыре часа. Неправильный логин или пароль сообщается как incorrect_username_password.

С чего начать: rozetka_get_order_counts и rozetka_get_message_counts показывают, что ожидает (новые заказы, непрочитанные чаты, открытые запросы на возврат). Затем rozetka_list_orders с types=4 (новые) или types=2 (в обработке).

Заказы

  • rozetka_list_order_statuses сопоставляет числовой status заказа с его названием. rozetka_list_orders фильтрует по types (1 все, 2 в обработке, 3 завершенные, 4 новые, 5 в доставке, 6 неудачные), статусу или датам; rozetka_get_order читает один заказ. Добавь expand=purchases,delivery,user для товаров, доставки и покупателя, и status_available для статусов, к которым заказ может перейти дальше.
  • rozetka_update_order изменяет статус, добавляет накладную (ТТН) и комментарий продавца. Обычный поток: новый заказ (1) -> подтвердить с 2 (упаковывается) -> добавить ТТН со статусом 3 (передан перевозчику) или 61 (передача запланирована); ТТН, отправленный со статусом 2, переводит заказ в 61. После добавления ТТН Rozetka отслеживает посылку и изменяет статус самостоятельно. Статусы 7 и выше в основном являются отменами или состояниями доставки (например, 16/42 нет в наличии, 18 покупатель недоступен, 40 покупатель передумал, 45 отменено покупателем): устанавливай отмену только тогда, когда продавец просит, это нельзя отменить. Сначала проверь status_available.
  • rozetka_get_order_payment_status сообщает, оплачена ли онлайн-оплата, не оплачена, проверяется или отменена (кэшируется 5 минут).

Товары и цены

  • rozetka_list_goods и rozetka_get_goods читают товары продавца; rozetka_get_goods_counts подсчитывает их по вкладкам кабинета (ошибки, модерация, ожидание подтверждения).
  • rozetka_update_goods_price_stock изменяет цену и запас для одного или нескольких товаров по item_rz_id (идентификатор Rozetka, id/rz_item_id в списке товаров, а не внутренний item_id). Цены указаны в гривнах. Rozetka удерживает цену, увеличенную более чем в 1,5 раза или уменьшенную более чем вдвое, для подтверждения менеджером.
  • Идентификаторы статуса товаров: 0 заблокировано, 1 активно, 2 новое, 3 ожидает модерации, 4 в процессе модерации, 5 отклонено модерацией, 6 требует подтверждения модератора, 7 архивировано, 8 ожидает модерации. Статус продажи: 0 недоступен, 1 ожидается поставка, 2 звонок, 3 заканчивается, 4 доступен, 5 архив, 6 строго недоступен, 7 нет в наличии, 8 скрыт.
  • Новое объявление: rozetka_list_goods_categories (найди категорию; is_vendor_required 1 означает, что производитель обязателен) -> rozetka_list_category_attributes (его характеристики; увеличь pageSize, API возвращает 5 по умолчанию) -> rozetka_list_attribute_values (разрешенные значения для характеристик типа список) -> rozetka_list_producers -> rozetka_create_goods с русским и украинским названием, ценой, запасом и URL изображений. Новые товары проходят модерацию Rozetka перед тем, как они будут показаны.

Отзывы, вопросы и чаты

  • Отзывы о магазине: rozetka_list_store_reviews (например, reply_search=0 для отзывов без ответа, vote=dislike для негативных), затем rozetka_reply_store_review с id отзыва и его order_id.
  • Отзывы о товарах и вопросы: rozetka_list_goods_comments с isAnswered=0 перечисляет темы, ожидающие продавца; ответь с помощью rozetka_reply_goods_comment (parent_id = id комментария, item_id = item.id).
  • Чаты: rozetka_list_chats (msgType=orders для чатов по заказам, items для вопросов о товарах, has_response_to_user=0 для непрочитанных), rozetka_get_chat для чтения сообщений (это помечает их как прочитанные), rozetka_get_order_chat для поиска чата заказа и rozetka_send_message с chat_id и user_id покупателя как receiver_id.
  • Ответы, ответы и сообщения являются публичными или доходят до покупателя: подготовь текст, покажи его продавцу и отправь только после их согласия. Пиши на языке покупателя, обычно на украинском. Ответы и ответы на продукты модерация Rozetka перед тем, как они появятся.

Возвраты: rozetka_list_refund_requests (статус-коды из rozetka_list_refund_statuses), rozetka_get_refund_request для причины, решения, которое хочет покупатель, и чата, и rozetka_save_refund_ttn для хранения накладной возврата. rozetka_update_refund_status (принять или отклонить запрос) установлен выключенным, потому что принятие может вернуть деньги покупателю; администратор включает его намеренно. Идентификаторы запросов на возврат содержат буквы (например, AM1234567).

Не включено: балансы, счета, платежи, фискальные чеки (PRRO), создание оплаченной накладной с перевозчиками, учетные записи менеджеров и удаления. Коннектор никогда не перемещает деньги.

Форматы и особенности

  • Rozetka отвечает HTTP 200 даже при неудачном вызове, с success: false; коннектор преобразует это в ошибку с errors.message и errors.code, например, incorrect_access_token (1020) или access_denied (1010, у аккаунта нет прав).
  • Цены указаны в гривнах. Даты в фильтрах в формате YYYY-MM-DD; временные метки приходят как YYYY-MM-DD HH:MM:SS без часового пояса.
  • Тексты приходят на языке кабинета (украинском или русском); запросы на возврат отвечают на украинском.

Пагинация и лимиты: списки находятся под content с _meta (totalCount, pageCount, currentPage, perPage). Вызывай снова с page + 1, пока currentPage не станет равным pageCount. Заказы, отзывы и чаты приходят по 20 на страницу; товары, категории и директории принимают pageSize. Лимит частоты не опубликован; избегай плотных циклов и предпочитай одно массовое обновление вместо множества одиночных.

Доступность облака: api-seller.rozetka.com.ua является публичным через HTTPS, доступен из AnythingMCP Cloud и из локальных установок.

Предварительные требования: ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64

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

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

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

ИнструментЧто он делает
rozetka_list_ordersИщет заказы продавца Rozetka, 20 на странице, по группе статусов, статусу, дате создания или изменения, идентификатору заказа, телефону покупателя или накладной (ТТН).…
rozetka_get_orderПолучает один заказ Rozetka по идентификатору с суммами, статусом и комментариями. Используй expand для товаров (покупок), доставки, покупателя (пользователя), истории статуса…
rozetka_list_order_statusesПеречисляет статусы заказов Rozetka с идентификатором, украинским, русским и английским названием и группой статусов, чтобы прочитать числовой статус заказа
rozetka_list_goodsИщет товары продавца на Rozetka (все вкладки) по названию, тексту, артикулу, идентификатору прайс-листа или идентификатору Rozetka, доступности или категории. Возвращает идентификаторы…
rozetka_get_goodsПолучает детали одного из товаров продавца на Rozetka (цены, категория, описание, состояние запаса) по внутреннему item_id или по…
rozetka_update_orderИзменяет статус заказа Rozetka, добавляет номер накладной (ТТН) и/или комментарий продавца. Возвращает обновленный заказ. ТТН обязательна…
rozetka_get_order_countsПодсчитывает заказы продавца Rozetka по группам: inProgress (в обработке), новые, в доставке, inDone (завершенные), inNotDone (неудачные), непрочитанные…
rozetka_get_order_payment_statusПолучает текущий статус оплаты заказа, оплаченного онлайн: status_payment_id, название (оплачено, не оплачено, отменено, не утверждено, частично оплачено ...)…
rozetka_update_goods_price_stockОбновляет цену и запас одного или нескольких товаров продавца за один вызов (массовое обновление). Каждая запись требует item_rz_id (идентификатор Rozetka, id в…
rozetka_get_goods_countsПодсчитывает товары продавца по секциям кабинета: активные, неактивные, новые, на модерации, ожидающие подтверждения, ожидающие одобрения…
rozetka_create_goodsСоздает новое объявление товара в кабинете продавца Rozetka. Требуются русское и украинское название, категория из…
rozetka_list_goods_categoriesИщет категории Rozetka, в которых продавец может создавать товары, по названию или идентификаторам. Возвращает идентификатор, украинское, русское и английское название…
rozetka_list_category_attributesПеречисляет характеристики (атрибуты) категории Rozetka, необходимые для параметров в rozetka_create_goods. Возвращает идентификатор, названия, единицу, тип…
rozetka_list_attribute_valuesПеречисляет разрешенные значения одной или нескольких характеристик в категории (идентификатор, украинское, русское и английское название), для параметров типа список в…
rozetka_list_producersИщет справочник производителей Rozetka (брендов) по названию или идентификатору, для производителя rozetka_create_goods. Возвращает идентификатор, название и статус, 100…
rozetka_list_store_reviewsИщет отзывы покупателей о магазине (не о товаре): идентификатор, order_id, имя покупателя, комментарий, общий голос (нравится, средний, не нравится), голоса за…
rozetka_reply_store_reviewПубликует публичный ответ продавца на отзыв о магазине. Требуется идентификатор отзыва и его order_id из rozetka_list_store_reviews. Возвращает ответ…
rozetka_list_goods_commentsИщет отзывы и вопросы покупателей о товарах продавца: идентификатор, тип (комментарий или вопрос), текст, оценка (рейтинг 1-5), плюсы и минусы, автор…
rozetka_reply_goods_commentПубликует публичный ответ продавца на отзыв или вопрос о товаре. parent_id — это идентификатор комментария, а item_id — это item.id из…
rozetka_get_message_countsПодсчитывает непрочитанные и общие чаты и запросы покупателей: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread…
rozetka_list_chatsИщет чаты продавца с покупателями: чаты по заказам, вопросы о товарах или удаленные чаты. Возвращает идентификатор чата, тему, покупателя (user_id, имя)…
rozetka_get_chatОткрывает один чат с покупателем, с его сообщениями по умолчанию. Возвращает тему, user_id покупателя (receiver_id для rozetka_send_message)…
rozetka_get_order_chatПолучает чат, принадлежащий заказу, по идентификатору заказа: идентификатор чата, тема, user_id покупателя и, с expand, сообщения. Используй его, чтобы написать в…
rozetka_send_messageОтправляет сообщение покупателю в существующем чате. Требуются chat_id и receiver_id (user_id покупателя из rozetka_get_chat или…
rozetka_list_refund_requestsИщет запросы на возврат и возврат покупателей: идентификатор запроса (буквы и цифры, например, AM1234567), статус_title, reason_title, order_id, название товара…
rozetka_get_refund_requestПолучает один запрос на возврат или возврат: статус, причина и подпричина с комментарием покупателя, желаемое решение (decision_title), заказ и товар…
rozetka_list_refund_statusesПеречисляет коды статусов запросов на возврат и возврат (status_code с его украинским названием), для фильтрации rozetka_list_refund_requests и…
rozetka_save_refund_ttnСохраняет накладную (ТТН) возвратной посылки по запросу на возврат, например, когда продавец отправляет замену или возврат покупателя…
rozetka_update_refund_statusПереводит запрос на возврат или возврат в другой статус (принять, отклонить с причиной, товар получен ...). Принятие запроса может привести к…

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

  • "Сколько новых заказов Rozetka и непрочитанных сообщений от покупателей у меня?"
  • "Покажи заказ 123456789 с покупателем, доставкой и товарами."
  • "Установи цену товара 987654 на 1,499 грн и запас на 20."
  • "Какие отзывы о магазине за эту неделю еще не имеют ответа? Подготовь ответ для каждого."
  • "Добавь накладную Nova Poshta 20450000000000 к заказу 123456789 и отметь его как отправленный."

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

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

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

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

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

Коннекторы

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

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к ChatGPT

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Claude

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Cursor

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Gemini CLI

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.

Коннекторы

Подключить Rozetka MCP к Meta Muse

API продавца Rozetka Marketplace для крупнейшего маркетплейса Украины: заказы с обновлениями статуса и накладной (ТТН), статус оплаты, товары с массовыми обновлениями цен и запасов, новые объявления, отзывы о магазинах и вопросы к продуктам с ответами, чаты с покупателями и запросы на возврат. Вход с логином кабинета продавца.