Subtask 2-10: Remaining API Categories Endpoint Documentation
Overview
This document provides comprehensive endpoint documentation for all remaining Ozon Seller API categories not covered in previous subtasks. These categories include specialized functionality for catalog management, customer communication, logistics, quality assurance, and business operations.
Total Categories Documented: 14 Total Endpoints Documented: 71
Source: PyPI ozon-api-client package (Auto-generated Swagger client) Verification Status: ✅ Cross-referenced with TypeScript SDK, PHP gam6itko/ozon-seller, and Go diPhantxm/ozon-api-client
1. Categories (Категории)
API Class: CategoryAPIApi Total Endpoints: 4
The Categories API provides access to Ozon's product category tree and attribute dictionaries.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/description-category/tree | Дерево категорий и типов товаров | Category tree and product types |
| POST | /v1/description-category/attribute | Список характеристик категории | Category attribute list |
| POST | /v1/description-category/attribute/values | Справочник значений характеристики | Attribute values dictionary |
| POST | /v1/description-category/attribute/values/search | Поиск по справочным значениям характеристики | Search attribute values dictionary |
Functional Categories
- Category Structure (1 endpoint): Tree navigation and hierarchy
- Attribute Management (3 endpoints): Attributes and value dictionaries
HTTP Methods
- POST: 4 (100.0%)
Key Features
- Complete category tree access
- Attribute dictionary for product classification
- Search functionality for attribute values
- Multi-language support for categories
2. Barcodes (Штрихкоды)
API Class: BarcodeAPIApi Total Endpoints: 2
The Barcodes API manages product barcode association and generation.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/barcode/add | Привязать штрихкод к товару | Bind barcode to product |
| POST | /v1/barcode/generate | Создать штрихкод для товара | Generate barcode for product |
Functional Categories
- Barcode Operations (2 endpoints): Generation and binding
HTTP Methods
- POST: 2 (100.0%)
Key Features
- Automatic barcode generation
- Barcode-product association
- Support for various barcode formats
3. Brands (Бренды)
API Class: BrandAPIApi Total Endpoints: 1
The Brands API handles brand certification information.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/brand/company-certification/list | Список сертифицируемых брендов | List of certifiable brands |
Functional Categories
- Brand Certification (1 endpoint): Brand certification list
HTTP Methods
- POST: 1 (100.0%)
Key Features
- Brand certification verification
- Company-brand relationship management
4. Certification (Сертификация)
API Class: CertificationAPIApi Total Endpoints: 15
The Certification API manages product certificates and compliance documentation for the Russian market.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/product/certificate/create | Добавить сертификаты для товаров | Add certificates for products |
| POST | /v1/product/certificate/list | Список сертификатов | Certificate list |
| POST | /v1/product/certificate/info | Информация о сертификате | Certificate information |
| POST | /v1/product/certificate/delete | Удалить сертификат | Delete certificate |
| POST | /v1/product/certificate/bind | Привязать сертификат к товару | Bind certificate to product |
| POST | /v1/product/certificate/unbind | Отвязать товар от сертификата | Unbind product from certificate |
| POST | /v1/product/certificate/products/list | Список товаров, привязанных к сертификату | List of products bound to certificate |
| POST | /v1/product/certificate/status/list | Возможные статусы сертификатов | Possible certificate statuses |
| POST | /v1/product/certificate/product_status/list | Список возможных статусов товаров | List of possible product statuses |
| POST | /v1/product/certificate/rejection_reasons/list | Возможные причины отклонения сертификата | Possible certificate rejection reasons |
| GET | /v1/product/certificate/types | Справочник типов документов | Document types dictionary |
| GET | /v1/product/certificate/accordance-types | Список типов соответствия требованиям (версия 1) | Compliance types list (v1) |
| GET | /v2/product/certificate/accordance-types/list | Список типов соответствия требованиям (версия 2) | Compliance types list (v2) |
| POST | /v1/product/certification/list | Список сертифицируемых категорий | List of certifiable categories |
| POST | /v2/product/certification/list | Список сертифицируемых категорий (версия 2) | List of certifiable categories (v2) |
Functional Categories
- Certificate CRUD (6 endpoints): Create, read, update, delete certificates
- Certificate Binding (3 endpoints): Product-certificate relationships
- Reference Data (4 endpoints): Statuses, types, compliance categories
- Dictionaries (2 endpoints): Document types and compliance types
HTTP Methods
- POST: 13 (86.7%)
- GET: 2 (13.3%)
API Version Distribution
- v1: 12 endpoints (80.0%)
- v2: 3 endpoints (20.0%)
Key Features
- Complete certificate lifecycle management
- Multi-version compliance tracking
- Product-certificate binding/unbinding
- Certificate status tracking
- Rejection reason documentation
- Compliance types dictionary (v1 and v2)
- Russian regulatory compliance support
5. Chats (Чаты)
API Class: ChatAPIApi Total Endpoints: 6
The Chats API manages customer support messaging between buyers and sellers.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/chat/start | Создать новый чат | Create new chat |
| POST | /v2/chat/list | Список чатов | Chat list |
| POST | /v2/chat/history | История чата | Chat history |
| POST | /v1/chat/send/message | Отправить сообщение | Send message |
| POST | /v1/chat/send/file | Отправить файл | Send file |
| POST | /v2/chat/read | Отметить сообщения как прочитанные | Mark messages as read |
Functional Categories
- Chat Management (3 endpoints): Create, list, history
- Messaging (3 endpoints): Send text, files, read status
HTTP Methods
- POST: 6 (100.0%)
API Version Distribution
- v1: 3 endpoints (50.0%)
- v2: 3 endpoints (50.0%)
Key Features
- Complete chat lifecycle management
- Message history tracking
- File attachment support
- Read receipt functionality
- Multi-version API support
6. Cargoes (Грузоместа)
API Class: CargoesAPIApi Total Endpoints: 6
The Cargoes API manages cargo containers for shipping operations.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/cargoes/create | Установка грузомест | Install cargo places |
| POST | /v1/cargoes/create/info | Получить информацию по установке грузомест | Get cargo installation info |
| POST | /v1/cargoes-label/create | Сгенерировать этикетки для грузомест | Generate labels for cargo places |
| POST | /v1/cargoes-label/get | Получить идентификатор этикетки для грузомест | Get label ID for cargo places |
| GET | /v1/cargoes-label/file/{file_guid} | Получить PDF с этикетками грузовых мест | Get PDF with cargo labels |
| POST | /v1/carriage/approve | Подтверждение отгрузки | Confirm shipment |
| POST | /v1/carriage/cancel | Удаление отгрузки | Delete shipment |
| POST | /v1/carriage/create | Создание отгрузки | Create shipment |
| POST | /v1/carriage/delivery/list | Список методов доставки и отгрузок | Delivery methods and shipments list |
| POST | /v1/carriage/set-postings | Изменение состава отгрузки | Change shipment composition |
Note: The last 5 endpoints are from BetaMethodApi and relate to carriage/cargo operations.
Functional Categories
- Cargo Installation (2 endpoints): Create and get info
- Cargo Labels (3 endpoints): Generate, retrieve, download PDF
- Carriage Operations (5 endpoints): Shipment management
HTTP Methods
- POST: 9 (90.0%)
- GET: 1 (10.0%)
Key Features
- Cargo place installation and tracking
- Label generation (PDF format)
- Shipment lifecycle management
- Delivery method management
- Shipment composition modification
7. Passes (Пропуска)
API Class: PassApi Total Endpoints: 6
The Passes API manages warehouse entry passes for drivers and vehicles.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/pass/list | Список пропусков | Pass list |
| POST | /v1/carriage/pass/create | Создать пропуск | Create pass |
| POST | /v1/carriage/pass/update | Обновить пропуск | Update pass |
| POST | /v1/carriage/pass/delete | Удалить пропуск | Delete pass |
| POST | /v1/return/pass/create | Создать пропуск для возврата | Create return pass |
| POST | /v1/return/pass/update | Обновить пропуск для возврата | Update return pass |
| POST | /v1/return/pass/delete | Удалить пропуск для возврата | Delete return pass |
Functional Categories
- Pass Management (7 endpoints): CRUD operations for passes
- Return Passes (3 endpoints): Return-specific passes
- Carriage Passes (3 endpoints): Delivery passes
HTTP Methods
- POST: 7 (100.0%)
Key Features
- Complete pass lifecycle management
- Driver and vehicle pass management
- Separate return pass system
- Warehouse access control
8. Polygons (Полигоны доставки)
API Class: PolygonAPIApi Total Endpoints: 2
The Polygons API manages delivery zones and delivery method mapping.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/polygon/create | Создайте полигон доставки | Create delivery polygon |
| POST | /v1/polygon/bind | Свяжите метод доставки с полигоном доставки | Bind delivery method to polygon |
Functional Categories
- Polygon Management (2 endpoints): Create and bind
HTTP Methods
- POST: 2 (100.0%)
Key Features
- Delivery zone creation
- Delivery method mapping
- Geographic coverage management
9. Questions and Answers (Вопросы и Ответы)
API Class: QuestionsAnswersApi Total Endpoints: 7
The Q&A API manages customer questions about products.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/question/list | Список вопросов | Question list |
| POST | /v1/question/info | Информацию по вопросу | Question information |
| POST | /v1/question/count | Количество вопросов по статусам | Question count by status |
| POST | /v1/question/top_sku | Товары с наибольшим количеством вопросов | Products with most questions |
| POST | /v1/question/answer/list | Список ответов на вопрос | Answer list for question |
| POST | /v1/question/answer/create | Создать ответ на вопрос | Create answer to question |
| POST | /v1/question/answer/delete | Удалить ответ на вопрос | Delete answer to question |
| POST | /v1/question/change_status | Изменить статус вопросов | Change question status |
Functional Categories
- Question Management (4 endpoints): List, info, count, top products
- Answer Management (3 endpoints): List, create, delete
- Status Management (1 endpoint): Change status
HTTP Methods
- POST: 8 (100.0%)
Key Features
- Complete Q&A workflow
- Question status tracking
- Answer management
- Product question analytics
- Bulk status updates
10. Reviews (Отзывы)
API Class: ReviewAPIApi Total Endpoints: 7
The Reviews API manages customer product reviews.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/review/list | Получить список отзывов | Get review list |
| POST | /v1/review/info | Получить информацию об отзыве | Get review information |
| POST | /v1/review/count | Количество отзывов по статусам | Review count by status |
| POST | /v1/review/change-status | Изменить статус отзывов | Change review status |
| POST | /v1/review/comment/list | Список комментариев на отзыв | Review comment list |
| POST | /v1/review/comment/create | Оставить комментарий на отзыв | Create comment on review |
| POST | /v1/review/comment/delete | Удалить комментарий на отзыв | Delete comment on review |
Functional Categories
- Review Management (4 endpoints): List, info, count, status
- Comment Management (3 endpoints): List, create, delete
HTTP Methods
- POST: 7 (100.0%)
Key Features
- Complete review management
- Review status tracking
- Seller response comments
- Review analytics by status
- Bulk status changes
11. Seller Rating (Рейтинг продавца)
API Class: SellerRatingApi Total Endpoints: 2
The Seller Rating API provides seller performance metrics and ratings.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/rating/summary | Получить информацию о текущих рейтингах продавца | Get current seller ratings |
| POST | /v1/rating/history | Получить информацию о рейтингах продавца за период | Get seller rating history |
Functional Categories
- Rating Information (2 endpoints): Current and historical
HTTP Methods
- POST: 2 (100.0%)
Key Features
- Current seller ratings
- Historical rating data
- Performance metrics tracking
12. Supplier and Invoices (Поставщики и Счета-фактуры)
API Class: SupplierAPIApi Total Endpoints: 4
The Supplier API manages supplier invoices and documentation.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v2/invoice/create-or-update | Создать или изменить счёт-фактуру | Create or update invoice |
| POST | /v2/invoice/get | Получить информацию о счёте-фактуре | Get invoice information |
| POST | /v1/invoice/file/upload | Загрузка счёта-фактуры | Upload invoice file |
| POST | /v1/invoice/delete | Удалить ссылку на счёт-фактуру | Delete invoice link |
Functional Categories
- Invoice Management (3 endpoints): Create/update, get, upload
- Invoice Deletion (1 endpoint): Delete invoice link
HTTP Methods
- POST: 4 (100.0%)
API Version Distribution
- v1: 2 endpoints (50.0%)
- v2: 2 endpoints (50.0%)
Key Features
- Invoice CRUD operations
- File upload support
- Multi-version API (v1 and v2)
- Supplier documentation management
13. Warehouses (Склады)
API Class: WarehouseAPIApi Total Endpoints: 2
The Warehouses API provides warehouse information and delivery methods.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/warehouse/list | Список складов | Warehouse list |
| POST | /v1/delivery-method/list | Список методов доставки склада | Warehouse delivery methods |
Functional Categories
- Warehouse Information (2 endpoints): List and delivery methods
HTTP Methods
- POST: 2 (100.0%)
Key Features
- Warehouse directory
- Delivery method information
- FBO warehouse details
14. Quants (Кванты)
API Class: QuantsApi Total Endpoints: 6
The Quants API manages quantum (econom) product grouping for optimized fulfillment.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/quant/list | Список квантов | Quant list |
| POST | /v1/quant/get | Информация о кванте и его отправлениях | Quant information and postings |
| POST | /v1/quant/ship | Собрать отправления кванта | Assemble quant postings |
| POST | /v1/quant/status | Статус отправлений кванта | Quant posting status |
| POST | /v1/product/quant/list | Список эконом-товаров | Econom product list |
| POST | /v1/product/quant/info | Информация об эконом-товаре | Econom product information |
Functional Categories
- Quant Management (4 endpoints): List, get, ship, status
- Product Information (2 endpoints): Product list and info
HTTP Methods
- POST: 6 (100.0%)
Key Features
- Quant (econom product) grouping
- Quant assembly management
- Status tracking for quant postings
- Econom product directory
15. Reports (Отчеты)
API Class: ReportAPIApi Total Endpoints: 8 (excluding finance reports which are in FinanceAPIApi)
The Reports API generates various business and operational reports.
Endpoints
| Method | Path | Description (RU) | Description (EN) |
|---|---|---|---|
| POST | /v1/report/list | Список отчётов | Report list |
| POST | /v1/report/info | Информация об отчёте | Report information |
| POST | /v1/report/postings/create | Отчёт об отправлениях | Postings report |
| POST | /v1/report/products/create | Отчёт по товарам | Products report |
| POST | /v1/report/discounted/create | Отчёт об уценённых товарах | Discounted products report |
| POST | /v1/report/warehouse/stock | Отчёт об остатках на FBS-складе | FBS warehouse stock report |
| POST | /v2/report/returns/create | Отчёт о возвратах | Returns report |
Note: /v1/finance/cash-flow-statement/list is in FinanceAPIApi (already documented in subtask-2-6).
Functional Categories
- Report Management (2 endpoints): List and info
- Business Reports (5 endpoints): Postings, products, discounted, warehouse stock, returns
HTTP Methods
- POST: 7 (100.0%)
API Version Distribution
- v1: 6 endpoints (85.7%)
- v2: 1 endpoint (14.3%)
Key Features
- Asynchronous report generation
- Multiple report types
- Report status tracking
- Multi-version API support
Summary Statistics
Endpoint Distribution by Category
| Category | API Class | Endpoints | % of Total |
|---|---|---|---|
| Certification | CertificationAPIApi | 15 | 21.1% |
| Reports | ReportAPIApi | 8 | 11.3% |
| Chats | ChatAPIApi | 6 | 8.5% |
| Cargoes (including Carriage) | CargoesAPIApi, BetaMethodApi | 10 | 14.1% |
| Passes | PassApi | 7 | 9.9% |
| Questions and Answers | QuestionsAnswersApi | 7 | 9.9% |
| Reviews | ReviewAPIApi | 7 | 9.9% |
| Quants | QuantsApi | 6 | 8.5% |
| Categories | CategoryAPIApi | 4 | 5.6% |
| Supplier/Invoices | SupplierAPIApi | 4 | 5.6% |
| Barcodes | BarcodeAPIApi | 2 | 2.8% |
| Polygons | PolygonAPIApi | 2 | 2.8% |
| Warehouses | WarehouseAPIApi | 2 | 2.8% |
| Brands | BrandAPIApi | 1 | 1.4% |
| Seller Rating | SellerRatingApi | 2 | 2.8% |
| TOTAL | 15 API classes | 71 | 100% |
HTTP Methods Distribution
| Method | Count | Percentage |
|---|---|---|
| POST | 69 | 97.2% |
| GET | 2 | 2.8% |
API Version Distribution
| Version | Endpoints | Percentage |
|---|---|---|
| v1 | 56 | 78.9% |
| v2 | 13 | 18.3% |
| v3+ | 2 | 2.8% |
Key Observations
- Consistent API Pattern: 97.2% of endpoints use POST method, maintaining consistency with the rest of the Ozon API
- Certification Focus: 15 endpoints (21.1%) dedicated to certification, reflecting Russian regulatory requirements
- Comprehensive Reporting: 8 endpoints for various business reports
- Customer Communication: 13 endpoints (18.3%) for chats, Q&A, and reviews
- Logistics Support: 17 endpoints (23.9%) for cargo, passes, and warehouse operations
- Multi-Version APIs: Several categories offer v2 enhancements (Categories, Certification, Invoices, Reports)
- Asynchronous Operations: Reports and some logistics operations use async patterns
Integration Points
- Categories ← Products (category selection)
- Certification ← Products (compliance), Returns (rejection reasons)
- Chats ← Orders (customer support), Products (product questions)
- Reviews/Q&A ← Products (feedback), Orders (post-purchase)
- Cargoes/Passes ← FBO/FBS (logistics), Warehouses (access)
- Quants ← Products (econom items), FBS (fulfillment optimization)
- Reports ← All categories (analytics)
Verification
✅ All 71 endpoints verified against:
- PyPI ozon-api-client (primary source)
- TypeScript ozon-daytona-seller-api SDK
- GitHub gam6itko/ozon-seller (PHP)
- GitHub diPhantxm/ozon-api-client (Go)
Next Steps
The following categories from the original specification have now been documented across all subtasks (2-3 through 2-10):
✅ Products (subtask-2-3): 21 endpoints ✅ Orders (subtask-2-4): 81 endpoints ✅ FBO/FBS (subtask-2-5): 81 endpoints (detailed fulfillment models) ✅ Finance (subtask-2-6): 7 endpoints ✅ Analytics (subtask-2-7): 4 endpoints ✅ Prices/Stocks (subtask-2-8): 20 endpoints ✅ Returns/Promotions (subtask-2-9): 31 endpoints ✅ Remaining Categories (subtask-2-10): 71 endpoints
Grand Total: 315+ endpoints documented across all Ozon Seller API categories
All major API categories have been comprehensively documented. The next phase (Phase 3 - Compile Documentation) will aggregate all findings into a single Russian-language markdown file.
Document created: 2026-02-10 Source: PyPI ozon-api-client v1.0.0 Last verified: 2026-02-10