Subtask 2-6 Findings: Finance (Финансы) Category Endpoints
Task: Extract complete endpoint list for Finance (Финансы) category Date: 2026-02-10 Status: ✅ COMPLETED
Executive Summary
Successfully extracted 7 endpoints from the Finance (Финансы) category, covering comprehensive financial operations including transaction management, financial reports, realization reports, B2B sales registries, and mutual settlement reports.
Source: PyPI ozon-api-client package (Auto-generated Swagger client from official OpenAPI spec) API Classes: FinanceAPIApi, ReportAPIApi Total Endpoints: 7
Complete Finance (Финансы) Endpoint List
| # | HTTP Method | Path | Method Name | Description (RU) | Description (EN) |
|---|---|---|---|---|---|
| 1 | POST | /v3/finance/transaction/list | finance_api_finance_transaction_list_v3 | Список транзакций | Transaction list |
| 2 | POST | /v3/finance/transaction/totals | finance_api_finance_transaction_total_v3 | Суммы транзакций | Transaction totals |
| 3 | POST | /v1/finance/realization | finance_api_get_realization_report | Отчёт о реализации товаров | Goods realization report |
| 4 | POST | /v2/finance/realization | finance_api_get_realization_report_v2 | Отчёт о реализации товаров (версия 2) | Goods realization report (version 2) |
| 5 | POST | /v1/finance/cash-flow-statement/list | finance_api_finance_cash_flow_statement_list | Финансовый отчёт | Financial report |
| 6 | POST | /v1/finance/document-b2b-sales | report_api_create_document_b2_b_sales_report | Реестр продаж юридическим лицам | B2B sales registry |
| 7 | POST | /v1/finance/mutual-settlement | report_api_create_mutual_settlement_report | Отчёт о взаиморасчётах | Mutual settlement report |
Endpoint Analysis by Function Type
Transaction Management (2 endpoints)
POST /v3/finance/transaction/list- Get list of financial transactions with filtering and paginationPOST /v3/finance/transaction/totals- Get transaction totals and aggregated financial data
Realization Reports (2 endpoints)
POST /v1/finance/realization- Get goods realization report (legacy version)POST /v2/finance/realization- Get goods realization report (enhanced version 2)
Financial Reports (1 endpoint)
POST /v1/finance/cash-flow-statement/list- Get comprehensive cash flow statements
B2B Operations (1 endpoint)
POST /v1/finance/document-b2b-sales- Generate B2B sales registry for legal entities
Settlement Reports (1 endpoint)
POST /v1/finance/mutual-settlement- Generate mutual settlement reports
API Version Distribution
| API Version | Endpoint Count | Percentage |
|---|---|---|
| v1 | 4 | 57.1% |
| v2 | 2 | 28.6% |
| v3 | 1 | 14.3% |
Note: Multiple API versions indicate ongoing evolution with v3 for transactions (latest), v2 for enhanced realization reports, and v1 for other financial operations.
Key Observations
1. Comprehensive Financial Operations
The Finance category provides complete financial management:
- Transaction tracking: Detailed transaction lists and totals
- Financial reporting: Cash flow statements and realization reports
- B2B support: Specialized registry for legal entity sales
- Settlement tracking: Mutual settlement reports for accounting
2. Version Evolution
- Latest versions: v3 for transactions (most advanced)
- Enhanced reporting: v2 for realization reports (improved data structure)
- Stable operations: v1 endpoints maintained for backward compatibility
- Clear upgrade path: v1 → v2 → v3 for enhanced features
3. Specialized Features
- Transaction aggregation: Dedicated totals endpoint for summary data
- Multi-format reporting: Various financial report types (realization, cash flow, B2B, settlements)
- B2B sales tracking: Separate registry for legal entity transactions
- Russian accounting standards: Reports tailored to Russian financial regulations
4. Integration Points
- Related to Orders category (transaction data from order fulfillment)
- Related to Products category (realization reports by product)
- Related to Returns category (financial impact of returns)
- Related to Analytics category (financial performance metrics)
HTTP Methods Distribution
| HTTP Method | Count | Percentage |
|---|---|---|
| POST | 7 | 100% |
Note: All Finance endpoints use POST method, consistent with Ozon API design pattern for complex financial queries and report generation.
Endpoint Frequency by Use Case
High Frequency (Daily Operations)
- Transaction List (
/v3/finance/transaction/list) - Daily transaction monitoring - Transaction Totals (
/v3/finance/transaction/totals) - Financial summaries
Medium Frequency (Regular Reporting)
- Financial Report (
/v1/finance/cash-flow-statement/list) - Periodic financial statements - Realization Report v2 (
/v2/finance/realization) - Sales analysis
Low Frequency (Periodic/Ad-hoc)
- Mutual Settlement Report (
/v1/finance/mutual-settlement) - Accounting reconciliation - B2B Sales Registry (
/v1/finance/document-b2b-sales) - B2B sales reporting - Realization Report v1 (
/v1/finance/realization) - Legacy reporting (use v2)
Detailed Endpoint Analysis
Transaction Management Endpoints
1. POST /v3/finance/transaction/list
Description: Get comprehensive list of financial transactions Use Cases:
- Daily transaction monitoring
- Financial reconciliation
- Audit trail generation
- Transaction filtering by date, type, order
2. POST /v3/finance/transaction/totals
Description: Get aggregated transaction totals and summaries Use Cases:
- Financial dashboard metrics
- Quick summary reports
- Period-over-period comparison
- Revenue tracking
Realization Report Endpoints
3. POST /v1/finance/realization
Description: Generate goods realization report (legacy version) Use Cases:
- Basic sales reporting
- Inventory realization tracking
- Legacy system integration
4. POST /v2/finance/realization (RECOMMENDED)
Description: Generate enhanced goods realization report Use Cases:
- Detailed sales analysis
- Product performance metrics
- Enhanced filtering and grouping
- Improved data structure
Financial Reporting Endpoints
5. POST /v1/finance/cash-flow-statement/list
Description: Generate comprehensive cash flow statements Use Cases:
- Cash flow analysis
- Financial planning
- Accounting reconciliation
- Liquidity management
B2B Operations Endpoints
6. POST /v1/finance/document-b2b-sales
Description: Generate B2B sales registry for legal entities Use Cases:
- Legal entity sales tracking
- B2B transaction reporting
- Invoice generation support
- Corporate customer management
Settlement Reporting Endpoints
7. POST /v1/finance/mutual-settlement
Description: Generate mutual settlement reports Use Cases:
- Accounting reconciliation
- Settlement tracking
- Payment verification
- Financial audit support
Comparison with Other Sources
TypeScript SDK (ozon-daytona-seller-api)
- Total methods: 278 across 33 categories
- Finance category: Matches extracted endpoints
- Verification: ✅ All 7 endpoints present in TypeScript SDK
GitHub Client Libraries
- gam6itko/ozon-seller (PHP): Implements all major finance endpoints
- diPhantxm/ozon-api-client (Go): Complete finance API coverage
- Verification: ✅ Endpoints confirmed across major client libraries
Recommendations for Documentation
Phase 3 (Compile Documentation):
- Include all 7 endpoints in the Finance section
- Group by functionality (Transactions, Reports, B2B, Settlements)
- Provide usage examples for common operations:
- Transaction retrieval workflow
- Financial report generation
- B2B sales registry creation
- Note version differences (v1 vs v2 vs v3)
- Recommend v2 for realization reports
- Recommend v3 for transactions
- Cross-reference related categories (Orders, Products, Returns, Analytics)
Implementation Examples to Include:
- Transaction list retrieval (transaction list v3)
- Transaction totals (transaction totals v3)
- Realization report generation (realization v2)
- Cash flow statement (cash flow statement)
- B2B registry creation (document-b2b-sales)
Data Quality Verification
✅ Completeness
- All 7 FinanceAPIApi and ReportAPIApi finance-related endpoints extracted
- No endpoints missing from catalog
- All HTTP methods and paths verified
✅ Accuracy
- Source: Auto-generated from official OpenAPI spec
- Cross-referenced with TypeScript SDK
- Verified against GitHub client libraries
✅ Consistency
- All endpoints use POST method (consistent with Ozon API pattern)
- Path naming conventions followed
- Russian descriptions provided for all endpoints
- Clear version progression (v1 → v2 → v3)
Finance Category Statistics
Endpoint Count by API Class
| API Class | Endpoint Count | Percentage |
|---|---|---|
| FinanceAPIApi | 6 | 85.7% |
| ReportAPIApi | 1 | 14.3% |
Functional Distribution
| Function Type | Endpoint Count | Percentage |
|---|---|---|
| Transaction Management | 2 | 28.6% |
| Realization Reports | 2 | 28.6% |
| Financial Reports | 1 | 14.3% |
| B2B Operations | 1 | 14.3% |
| Settlement Reports | 1 | 14.3% |
Conclusion
Successfully extracted and documented 7 complete endpoints for the Finance (Финансы) category from the Ozon Seller API. The extraction is comprehensive, verified against multiple sources, and ready for inclusion in the final documentation.
Key Highlights:
- Complete financial transaction management (list + totals)
- Multi-version realization reports (v1 + v2)
- Comprehensive financial reporting (cash flow, B2B, settlements)
- Clear API version progression (v1 → v2 → v3)
- Russian accounting standard compliance
Next Steps:
- ✅ Finance endpoints documented
- ⏭️ Proceed to subtask-2-7: Analytics (Аналитика) endpoints
- ⏭️ Continue with remaining categories (Prices, Stocks, Returns, Promotions, Others)
Sources
Primary Source
- PyPI ozon-api-client: https://pypi.org/project/ozon-api-client/
- FinanceAPIApi class (6 endpoints)
- ReportAPIApi class (1 finance-related endpoint)
- 7 total endpoints with complete paths and descriptions
Verification Sources
- TypeScript SDK: https://salacoste.github.io/ozon-daytona-seller-api/
- GitHub gam6itko/ozon-seller: PHP implementation
- GitHub diPhantxm/ozon-api-client: Go implementation
Additional References
- Ozon API Documentation: https://docs.ozon.ru/api/seller/
- Finance Operations Guide: https://docs.ozon.ru/global/en/accounting/receiving-payments/settlements/
End of Subtask 2-6 Findings