Get information about the Ozon seller account: shop name, company ID, account status. Use this to verify that Client-Id and Api-Key credentials are valid and working. Call this first to confirm the connection is established.

Get a list of all products in the Ozon seller account. You can filter by visibility status: ALL, VISIBLE (on sale), INVISIBLE (hidden), EMPTY_STOCK (out of stock), NOT_MODERATED (pending review), MODERATION_BLOCK (blocked), DISABLED (archived). Supports pagination via last_id. Returns product_id and offer_id for each product.

Get full information about a single product: name, description, attributes, category, price, old price, images, status, barcode, and all other fields. Provide either product_id (Ozon internal ID), offer_id (seller article), or sku.

Create one or more new products on Ozon (up to 100 per request). Each product requires: description_category_id (from Ozon category tree), name, offer_id (your article), price, vat, weight, depth, width, height, dimension_unit, weight_unit, images (array of URLs), and attributes. Returns a task_id — check import status with the product import task endpoint. Note: attributes list depends on the chosen category. Use Ozon documentation or /v1/description-category/attribute to get required attributes.

Update product attributes and characteristics. Note: this updates only attributes (characteristics) of a product card. Price and stock are updated via separate tools (update_prices, update_stocks). Existing attributes cannot be deleted — only added or changed. Returns a task_id — the update is processed asynchronously. Provide product_id or offer_id to identify the product.

Hide one or more products from the Ozon storefront (archive them). Archived products are not visible to buyers but are preserved and can be restored. Provide an array of product_ids. Use unarchive_product to restore.

Restore one or more archived products back to active sale on Ozon. Products will become visible to buyers again after unarchiving. Provide an array of product_ids.

Get current prices for products: selling price, old price (crossed out), marketing price, premium price, and price index (how your price compares to competitors). Optionally filter by offer_ids or product_ids. Supports pagination via last_id.

Update prices for one or more products (up to 1000 per request). For each product provide offer_id or product_id, and the new price. Optionally set old_price (crossed-out original price) and min_price (floor for promotions). Prices must be strings, e.g. "1990.00".

Get current stock levels for products across all warehouses. Returns present (available) and reserved quantities for each warehouse type. Optionally filter by offer_ids or product_ids. Supports pagination via cursor.

Update stock quantities for FBS warehouses (seller warehouses). For each item provide offer_id or product_id, stock quantity, and warehouse_id. Use list_warehouses to get warehouse IDs. Note: this updates FBS (seller warehouse) stocks, not FBO (Ozon warehouse) stocks.

Get a list of FBO orders (fulfilled by Ozon warehouse). Filter by date range (required) and optionally by status. FBO statuses: awaiting_packaging, awaiting_deliver, delivering, delivered, cancelled. Returns order details including products, quantities, and financial data.

Get full details of a single FBO order by posting number. Returns products, quantities, prices, analytics data, and financial breakdown including commissions and payouts.

Get a list of FBS orders (fulfilled from seller warehouse). Filter by date range (required) and optionally by status. FBS statuses: awaiting_registration, acceptance_in_progress, awaiting_approve, awaiting_packaging, awaiting_deliver, arbitration, client_arbitration, delivering, driver_pickup, delivered, cancelled. Returns order details including buyer info, delivery method, and products.

Get full details of a single FBS order by posting number. Returns products, buyer details, delivery address, shipment deadline, analytics data, and financial breakdown.

Get the list of FBS orders that are waiting to be processed and shipped. These are orders in "awaiting_packaging" or similar states that require seller action. Use this to see what needs to be packed and dispatched today. Optionally filter by cutoff time range or warehouse IDs. If cutoff dates are not provided, defaults to the current calendar month.

Get sales analytics for a date range. This is the most powerful analytics tool — use it to answer questions like "show revenue for last week", "top 10 products by orders", "how many cancellations this month".

Available metrics: revenue, ordered_units, delivered_units, returns, cancellations, hits_view_search (search impressions), hits_view_pdp (product page views), hits_tocart (add to cart), session_view_pdp, adv_sum (ad spend), adv_sum_all, position_category.

Available dimensions (group by): sku (by product), day, week, month, category1 (top category), category2, brand, delivery_type.

Dates must be in format "YYYY-MM-DD".

Note: the metrics array in the response corresponds 1:1 (by index) to the metrics array in the request.

Get detailed stock information for products on Ozon warehouses (FBO). Shows free-to-sell, reserved, and promised quantities per warehouse, along with turnover data. Note: this endpoint has stricter rate limits — use sparingly and cache results. warehouse_type: ALL (default), EXPRESS_DARK_STORE, or NOT_EXPRESS. skus is required — pass at least one SKU (use get_stocks or list_products to obtain SKUs).

Get a cash flow statement for a period: total orders amount, returns, commission, delivery costs, and net payout. Great for quick financial overview: "how much did I earn this month". Dates in format "YYYY-MM-DD".

Get a detailed list of financial transactions: sales accruals, commissions, delivery charges, returns, marketing fees, and payouts. Filter by date range (required). Optionally filter by operation type, posting number, or transaction type (orders, returns, services, transfers). Dates must be ISO 8601, e.g. "2024-01-01T00:00:00.000Z".

Get summary totals for transactions in a period: total orders amount, returns amount, commissions, delivery costs, and final balance. Faster than list_transactions when you only need the bottom line. Dates must be ISO 8601, e.g. "2024-01-01T00:00:00.000Z".

Get a list of product returns for FBO orders (from Ozon warehouse). Returns include product name, SKU, reason, status, and amounts. Useful for monitoring return rates and identifying problematic products. Filter by logistic return date range, posting number, offer_id, or product name. Note: use only one time filter field at a time.

Get a list of product returns for FBS orders (from seller warehouse). Returns include product name, SKU, return reason, status, and refund amounts. Filter by logistic return date range, posting number, offer_id, or product name. Note: use only one time filter field at a time.

Get the current seller quality index (rating) on Ozon. Returns overall rating score, status (fine/warning/critical), and breakdown by categories: shipment quality, cancellations, return rate, and others. Use this for monitoring — alert when rating drops below a threshold. No parameters required.

Get the history of seller rating (quality index) changes over time. Useful for tracking rating trends and diagnosing drops. By default returns history for all rating indicators. Optionally pass specific rating keys to narrow the result.

Available rating keys: rating_review_avg_score_total (product reviews), rating_shipment_delay_cb (shipment delays), rating_general_indicator_fbs_rfbs (overall FBS/rFBS score), rating_delivery_complaints_fbo/fbs/rfbs_sd (complaints by schema), rating_price_green/yellow/red/super (price index zones).

Get the list of seller warehouses (FBS warehouses). Returns warehouse IDs and names. Warehouse IDs are required when updating FBS stock levels with update_stocks. No parameters required.