Ozon Seller

Ozon Seller

This connector calls the Ozon Seller API (https://api-seller.ozon.ru) with the seller's own Client ID and API key: products, stock, prices, FBS and FBO postings (отправления), returns, finance accruals and balance, sales analytics, warehouses, promotions, reviews and questions. Almost every method is a POST with a JSON body, also for reads; the read tools are marked read-only.

Setup (about 3 minutes)

1. In the seller portal open Settings > Seller API (Настройки > Seller API, https://seller.ozon.ru/app/settings/api-keys) and click Generate key (Сгенерировать ключ).
2. Name the key, choose its access level (роль): Admin covers every tool; a narrower role works for the tools it covers. Choose "for an external service" and name AnythingMCP as the service if asked.
3. Copy the key, which is shown only once, into OZON_API_KEY, and the Client ID shown on the same page into OZON_CLIENT_ID.
4. Keys expire after 3 months: ozon_get_api_key_info shows the expiry date and the roles. Create a new key before it runs out.

Authentication: every request carries the Client-Id and Api-Key headers. 401 Invalid Api-Key means the key is wrong, expired or does not belong to this Client ID; 403 Api-Key is missing a required role for a method means the key works but its role does not cover that tool; 403 Api-Key is restricted to specific IP addresses means the key only allows certain networks.

Where to start: ozon_get_api_key_info and ozon_get_seller_info take no arguments. ozon_list_products lists products (20 by default) and ozon_get_products gives details for their ids. ozon_get_stocks, ozon_get_prices, ozon_list_returns and ozon_list_warehouses work without arguments as well. ozon_get_fbs_warehouse_stocks needs offer_ids or skus (at least one; Ozon refuses the call otherwise). Both posting lists need a period (since and to); for today's work on FBS orders call ozon_list_fbs_postings with statuses = ["awaiting_packaging"].

Answer size: the list tools return the fields sellers usually ask about (ids, names, status, dates, quantities, amounts). For the full record of one posting use ozon_get_fbs_posting, for one product ozon_get_products.

Ids: offer_id is the seller's own article (артикул), product_id the Ozon product id, sku the Ozon SKU shown on the site. A posting number (номер отправления) looks like 89491381-0072-1; an order number has one part fewer. warehouse_id comes from ozon_list_warehouses.

Pagination: product lists use last_id; stocks, prices, postings and warehouses use cursor together with has_next; returns use the id of the last return as last_id. Pass the value from the previous answer and keep the other arguments the same. Defaults are small (20 rows); raise limit only when the user needs more.

Dates: posting, review and question filters take ISO 8601 date-times in UTC (2026-10-01T00:00:00Z); finance and analytics take days (2026-10-01). The FBS posting period may not exceed one year, the balance report 30 days.

Finance: ozon_get_finance_balance gives the totals of a period (as Finance > Balance in the portal). ozon_list_accruals_by_day lists every accrual (начисление) of one day and ozon_get_posting_accruals explains up to 200 postings; ozon_list_accrual_types names the type_id values. Ozon switched off the old transaction list (/v3/finance/transaction/list) in September 2026; these methods replace it.

Subscriptions: reviews need the Review management (Управление отзывами) or Premium Pro subscription, questions need Premium Plus. Without Premium Plus, analytics returns only revenue and ordered_units, grouped by sku, spu, day, week or month, for the last 3 months and at most 50 calls a day; analytics allows 1 call a minute in any case.

Rate limits: at most 50 requests a second per Client ID across all methods, and per-method limits on top (prices: 10 changes per product an hour; stock: one change per product and warehouse every 30 seconds, 80 requests a minute). A 429 carries Retry-After; wait that long instead of retrying at once. Ozon may block keys that send many identical or failing requests.

Writes: ozon_update_prices and ozon_update_stocks change the live shop; both answer 200 with per-item updated and errors, so check them and read the values back. Replies to reviews and answers to questions are public on the product page. Show the user exactly what will change and wait for confirmation before every write. ozon_ship_fbs_posting and ozon_cancel_fbs_posting are installed switched off; an admin can enable them.

Out of scope: creating or editing product cards, FBO supply requests, labels and acts, chats with buyers, promotions management, the Performance (advertising) API and Ozon Delivery methods that need an OAuth token.