Summary
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.
Guided setup
Connect Rozetka Marketplace to ChatGPT in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Rozetka Marketplace in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP's plugin in ChatGPT's directory answers questions from your company databases on AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, read-only): open the listing (opens in a new tab) and click Install plugin. Every other connector is added to ChatGPT as a custom MCP server with your AnythingMCP MCP URL.
Try asking
Example prompts for Rozetka Marketplace
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Rozetka Marketplace, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Rozetka Marketplace + ChatGPT
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.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
Step 1 — Get credentials
The API signs in with the login and password of the Rozetka seller cabinet (seller.rozetka.com.ua); there is no separate API key.
- Put the cabinet login in
ROZETKA_USERNAME. - Rozetka expects the password Base64-encoded, so
ROZETKA_PASSWORD_BASE64takes the encoded form, not the plain password. Encode it on your own computer, e.g. in a terminalprintf '%s' 'your-password' | base64, and paste the result. Do not use an online encoder for a real password. AnythingMCP logs in withPOST /sitesand sends the session token as a Bearer token. Rozetka keeps a token alive while it is used and lets it expire after 24 hours without use; the connector signs in again every four hours. A wrong login or password is reported asincorrect_username_password.
Where to start: rozetka_get_order_counts and rozetka_get_message_counts show what is waiting (new orders, unread chats, open return requests). Then rozetka_list_orders with types=4 (new) or types=2 (in processing).
Orders
rozetka_list_order_statusesmaps the numericstatusof an order to its name.rozetka_list_ordersfilters bytypes(1 all, 2 in processing, 3 completed, 4 new, 5 being delivered, 6 failed), status or dates;rozetka_get_orderreads one order. Addexpand=purchases,delivery,userfor items, delivery and buyer, andstatus_availablefor the statuses the order may move to next.rozetka_update_orderchanges the status, adds the waybill (TTN) and a seller comment. Usual flow: new order (1) -> confirm with 2 (being packed) -> add the TTN with status 3 (handed to the carrier) or 61 (handover planned); a TTN sent with status 2 moves the order to 61. After a TTN is added Rozetka tracks the parcel and moves the status itself. Statuses 7 and above are mostly cancellations or delivery states (e.g. 16/42 out of stock, 18 buyer unreachable, 40 buyer changed their mind, 45 cancelled by the buyer): set a cancellation only when the seller asks, it cannot be undone. Checkstatus_availablefirst.rozetka_get_order_payment_statustells whether an online payment is paid, unpaid, being checked or cancelled (cached 5 minutes).
Goods and prices
rozetka_list_goodsandrozetka_get_goodsread the seller's goods;rozetka_get_goods_countscounts them per cabinet tab (errors, moderation, waiting for confirmation).rozetka_update_goods_price_stockchanges price and stock for one or many goods byitem_rz_id(the Rozetka id,id/rz_item_idin the goods list, not the internalitem_id). Prices are in UAH. Rozetka holds a price raised more than 1.5 times or cut by more than half for a manager to confirm.- Goods status ids: 0 locked, 1 active, 2 new, 3 queued for moderation, 4 being moderated, 5 rejected by moderation, 6 needs moderator confirmation, 7 archived, 8 waiting for moderation. Sell status: 0 unavailable, 1 supply expected, 2 call, 3 running out, 4 available, 5 archive, 6 strictly unavailable, 7 out of stock, 8 hidden.
- New listing:
rozetka_list_goods_categories(find the category;is_vendor_required1 means a producer is mandatory) ->rozetka_list_category_attributes(its characteristics; raisepageSize, the API returns 5 by default) ->rozetka_list_attribute_values(allowed values for list-type characteristics) ->rozetka_list_producers->rozetka_create_goodswith Russian and Ukrainian name, price, stock and picture URLs. New goods go through Rozetka moderation before they are shown.
Reviews, questions and chats
- Shop reviews:
rozetka_list_store_reviews(e.g.reply_search=0for reviews without an answer,vote=dislikefor negative ones), thenrozetka_reply_store_reviewwith the reviewidand itsorder_id. - Product reviews and questions:
rozetka_list_goods_commentswithisAnswered=0lists threads waiting for the seller; answer withrozetka_reply_goods_comment(parent_id= comment id,item_id=item.id). - Chats:
rozetka_list_chats(msgType=ordersfor order chats,itemsfor product questions,has_response_to_user=0for unanswered ones),rozetka_get_chatto read the messages (this marks them read),rozetka_get_order_chatto find the chat of an order, androzetka_send_messagewithchat_idand the buyer'suser_idasreceiver_id. - Replies, answers and messages are public or reach the buyer: draft the text, show it to the seller and send only after they agree. Write in the buyer's language, usually Ukrainian. Replies and product answers are moderated by Rozetka before they appear.
Returns: rozetka_list_refund_requests (status codes from rozetka_list_refund_statuses), rozetka_get_refund_request for the reason, the decision the buyer wants and the chat, and rozetka_save_refund_ttn to store the return waybill. rozetka_update_refund_status (accept or reject a request) is installed switched off, because accepting can refund the buyer; an admin turns it on deliberately. Return request ids contain letters (e.g. AM1234567).
Not included: balances, invoices, payments, fiscal receipts (PRRO), paid waybill creation with carriers, manager accounts and deletions. The connector never moves money.
Formats and gotchas
- Rozetka answers HTTP 200 even when a call fails, with
success: false; the connector turns that into an error carryingerrors.messageanderrors.code, e.g.incorrect_access_token(1020) oraccess_denied(1010, the account's role lacks the right). - Prices are in UAH. Dates in filters are YYYY-MM-DD; timestamps come as
YYYY-MM-DD HH:MM:SSwithout a time zone. - Texts come in the cabinet's language (Ukrainian or Russian); return requests answer in Ukrainian.
Pagination and limits: lists sit under content with _meta (totalCount, pageCount, currentPage, perPage). Call again with page + 1 until currentPage equals pageCount. Orders, reviews and chats come 20 per page; goods, categories and directories accept pageSize. No rate limit is published; avoid tight loops and prefer one mass update over many single ones.
Cloud reachability: api-seller.rozetka.com.ua is public over HTTPS, reachable from AnythingMCP Cloud and from self-hosted installs.
Step 2 — Install the adapter
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
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
- Enter a name, e.g. Name:
Rozetka Marketplace. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
rozetka_list_orders | Search the seller's Rozetka orders, 20 per page, by status group, status, creation or change date, order id, buyer phone or waybill (TTN).… |
rozetka_get_order | Get one Rozetka order by id with amounts, status and comments. Use expand for items (purchases), delivery, buyer (user), status history… |
rozetka_list_order_statuses | List Rozetka order statuses with id, Ukrainian, Russian and English name and status group, to read the numeric status of an order |
rozetka_list_goods | Search the seller's goods on Rozetka (all tabs) by name, text, article, price-list id or Rozetka id, availability or category. Returns ids… |
rozetka_get_goods | Get the details of one of the seller's goods on Rozetka (prices, category, description, stock state) by the internal item_id or by… |
rozetka_update_order | Change the status of a Rozetka order, add the waybill number (TTN) and/or a seller comment. Returns the updated order. A TTN is required… |
rozetka_get_order_counts | Count the seller's Rozetka orders by group: inProgress (in processing), new, delivering, inDone (completed), inNotDone (failed), unwatched… |
rozetka_get_order_payment_status | Get the current payment status of an order paid online: status_payment_id, name (paid, unpaid, cancelled, unapproved, part-paid ...)… |
rozetka_update_goods_price_stock | Update price and stock of one or more of the seller's goods in one call (mass update). Each entry needs item_rz_id (the Rozetka id, id in… |
rozetka_get_goods_counts | Count the seller's goods per cabinet section: active, inactive, new, on moderation, waiting for confirmation, waiting for approval… |
rozetka_create_goods | Create a new product listing in the seller's Rozetka cabinet. Needs Russian and Ukrainian name, a category from… |
rozetka_list_goods_categories | Search the Rozetka categories in which the seller can create goods, by title or ids. Returns id, Ukrainian, Russian and English title… |
rozetka_list_category_attributes | List the characteristics (attributes) of a Rozetka category, needed for params in rozetka_create_goods. Returns id, titles, unit, type… |
rozetka_list_attribute_values | List the allowed values of one or more characteristics in a category (id, Ukrainian, Russian and English title), for list-type params in… |
rozetka_list_producers | Search the Rozetka producer (brand) directory by name or id, for the producer of rozetka_create_goods. Returns id, title and status, 100… |
rozetka_list_store_reviews | Search buyers' reviews of the shop (not of a product): id, order_id, buyer name, comment, overall vote (like, middle, dislike), votes for… |
rozetka_reply_store_review | Publish the seller's public reply to a shop review. Needs the review id and its order_id from rozetka_list_store_reviews. Returns the reply… |
rozetka_list_goods_comments | Search buyers' reviews and questions on the seller's goods: id, type (comment or question), text, mark (rating 1-5), pros and cons, author… |
rozetka_reply_goods_comment | Post the seller's public answer to a product review or question. parent_id is the comment id and item_id the item.id from… |
rozetka_get_message_counts | Count unread and total buyer chats and requests: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread… |
rozetka_list_chats | Search the seller's chats with buyers: order chats, product questions or deleted chats. Returns chat id, subject, buyer (user_id, name)… |
rozetka_get_chat | Open one chat with a buyer, with its messages by default. Returns subject, buyer user_id (the receiver_id for rozetka_send_message)… |
rozetka_get_order_chat | Get the chat that belongs to an order, by order id: chat id, subject, buyer user_id and, with expand, the messages. Use it to write to the… |
rozetka_send_message | Send a message to a buyer in an existing chat. Needs chat_id and receiver_id (the buyer's user_id from rozetka_get_chat or… |
rozetka_list_refund_requests | Search buyers' return and refund requests: request id (letters and digits, e.g. AM1234567), status_title, reason_title, order_id, item name… |
rozetka_get_refund_request | Get one return or refund request: status, reason and sub-reason with the buyer's comment, decision wanted (decision_title), order and item… |
rozetka_list_refund_statuses | List the status codes of return and refund requests (status_code with its Ukrainian title), for filtering rozetka_list_refund_requests and… |
rozetka_save_refund_ttn | Save the waybill (TTN) of the return parcel on a return request, e.g. when the seller sends a replacement or the buyer's return shipment… |
rozetka_update_refund_status | Move a return or refund request to another status (accept, reject with a reason, goods received ...). Accepting a request can lead to the… |
Example prompts
- "How many new Rozetka orders and unread buyer messages do I have?"
- "Show order 123456789 with the buyer, the delivery and the items."
- "Set the price of goods 987654 to 1,499 UAH and the stock to 20."
- "Which shop reviews from this week have no reply yet? Draft an answer for each."
- "Add the Nova Poshta waybill 20450000000000 to order 123456789 and mark it shipped."
FAQ
Which login does it use? Your Rozetka seller cabinet login (seller.rozetka.com.ua), with the password Base64-encoded. The connector signs in again every four hours.
Can it change orders and prices? Yes: order status and waybill (TTN), mass price and stock updates, new goods, replies to reviews, questions and buyer chats. Changing the status of a return request installs switched off, because accepting a return can refund the buyer.
Does it touch balances or payments? No. Balances, invoices, payments, fiscal receipts (PRRO) and paid waybill creation with carriers are not included.
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
- Connector landing page
- Connect to Claude
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
- Connect to Microsoft Copilot
Was this guide helpful?