Кратко
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 и запусти через этот коннектор.
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 нет.
- Помести логин кабинета в
ROZETKA_USERNAME. - 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_required1 означает, что производитель обязателен) ->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 и отметь его как отправленный."
Следующие шаги
Это руководство помогло?