ozon-seller

A library that implements a client for Ozon Seller API.

Features

• common features:
  • use dataclasses for all the request and responses
  • support for automatic JSON serialization and parsing for all the request and responses, respectively
  • implement iterators for the endpoints with pagination
  • powerful error handling — for each error is available:
    • HTTP status
    • Ozon Seller API error code and message
• implemented endpoints:
  • Uploading and updating products:
    • Upload and update product images:
      • endpoint: POST /v1/product/pictures/import
      • module: ozon_seller.product_pictures_import
    • Get a description of the product characteristics:
      • endpoint: POST /v4/product/info/attributes
      • module: ozon_seller.product_info_attributes
    • Get product description:
      • endpoint: POST /v1/product/info/description
      • module: ozon_seller.product_description
  • Prices and Stocks:
    • Update the quantity of products in stock:
      • endpoint: POST /v2/products/stocks
      • modules:
        • ozon_seller.product_import_stocks
        • ozon_seller.products_stocks
    • Information about product quantity:
      • endpoint: POST /v4/product/info/stocks
      • module: ozon_seller.stocks
    • Update prices:
      • endpoint: POST /v1/product/import/prices
      • module: ozon_seller.product_import_prices
  • Promotions:
    • Available promotions:
      • endpoint: GET /v1/actions
      • module: ozon_seller.actions
    • Products that can participate in a promotion:
      • endpoint: POST /v1/actions/candidates
      • module: ozon_seller.actions_candidates
    • Products in a promotion:
      • endpoint: POST /v1/actions/products
      • module: ozon_seller.actions_products
  • FBS and rFBS orders processing:
    • Shipments list (version 3):
      • endpoint: POST /v3/posting/fbs/list
      • module: ozon_seller.posting_fbs_list
    • Get shipment details by identifier (version 3):
      • endpoint: POST /v3/posting/fbs/get
      • module: ozon_seller.posting_fbs_get
    • List of manufacturing countries:
      • endpoint: POST /v2/posting/fbs/product/country/list
      • module: ozon_seller.posting_fbs_product_country_list
    • Set the manufacturing country:
      • endpoint: POST /v2/posting/fbs/product/country/set
      • module: ozon_seller.posting_fbs_product_country_set
    • Print the labeling:
      • endpoint: POST /v2/posting/fbs/package-label
      • module: ozon_seller.posting_fbs_package_label
  • FBO:
    • Shipments list:
      • endpoint: POST /v2/posting/fbo/list
      • module: ozon_seller.posting_fbo_list
  • FBS delivery:
    • Create an acceptance and transfer certificate and a waybill:
      • endpoint: POST /v2/posting/fbs/act/create
      • module: ozon_seller.posting_fbs_act_create
    • List of shipments in the certificate:
      • endpoint: POST /v2/posting/fbs/act/get-postings
      • module: ozon_seller.fbs_act_get_postings
    • Barcode for product shipment:
      • endpoint: POST /v2/posting/fbs/act/get-barcode
      • module: ozon_seller.posting_fbs_act_get_barcode
    • Status of acceptance and transfer certificate and waybill:
      • endpoint: POST /v2/posting/fbs/act/check-status
      • module: ozon_seller.posting_fbs_act_check_status
  • Chats with customers:
    • Send message:
      • endpoint: POST /v1/chat/send/message
      • module: ozon_seller.chat_send_message
    • Create a new chat:
      • endpoint: POST /v1/chat/start
      • module: ozon_seller.chat_start
  • outdated endpoints:
    • ???:
      • endpoint: POST /v2/product/info
      • module: ozon_seller.product_info
    • ???:
      • endpoint: POST /v2/returns/company/fbo
      • module: ozon_seller.returns_fbo
    • ???:
      • endpoint: POST /v2/returns/company/fbs
      • module: ozon_seller.returns_fbs
    • ???:
      • endpoint: POST /v3/posting/fbs/ship
      • module: ozon_seller.posting_fbs_ship_gtd

Installation

From PyPI

Install the library from PyPI:

$ python3 -m pip install ozon-seller

From source

Clone this repository:

$ git clone https://github.com/irenicaa/ozon-seller
$ cd ozon-seller

Then install the library:

$ make install

Examples

Information about product quantity:

import sys
import os
import os.path
import logging

# requires: python3 -m pip install "python-dotenv >= 0.7.1, < 1.0.0"
import dotenv

from ozon_seller.common import credentials, http_error
from ozon_seller import stocks


def _run_request(credentials: credentials.Credentials, logger: logging.Logger) -> None:
    data = stocks.PaginatedProductFilter(
        filter=stocks.ProductFilter(
            visibility="VISIBLE",
        ),
        cursor="",
        limit=1000,
    )
    logger.info("request payload: %s", data.to_json())

    for item in stocks.get_product_info_stocks_iterative(credentials, data):
        logger.info("stock item: %r", item)


if __name__ == "__main__":
    logging.basicConfig(format="%(asctime)s [%(levelname)s] %(message)s", level=logging.INFO)
    dotenv.load_dotenv()

    logger = logging.getLogger(__name__)
    try:
        request_credentials = credentials.Credentials(
            os.getenv("OZON_CLIENT_ID", ""),
            os.getenv("OZON_API_KEY", ""),
        )

        _run_request(request_credentials, logger)
    except http_error.HTTPError as error:
        logger.error("HTTP error occurred: status = %d; message = %r", error.status, error.message)
        logger.error("HTTP error occurred: response data = %r", error.response_data)

License

The MIT License (MIT)

Copyright © 2025 irenica