🎯 Назначение API
Finance API предоставляет полный набор инструментов для финансового управления:
- Финансовая отчётность — детальные отчёты по продажам и реализации
- Анализ транзакций — подробная информация о начислениях и списаниях
- Взаиморасчёты — отчёты о взаиморасчётах с OZON
- Компенсации — управление компенсациями и декомпенсациями
- B2B продажи — специализированные отчёты для юридических лиц
⚠️ Важно: Finance API содержит критическую финансовую информацию.
Обеспечьте защищённое хранение API ключей и логирование доступа к финансовым данным.
📋 Основные методы (10 endpoints)
📊 Основные отчёты
| Метод | Endpoint | Назначение |
|---|---|---|
getTransactionList | /v3/finance/transaction/list | Список транзакций с детализацией |
getTransactionTotals | /v3/finance/transaction/totals | Итоговые суммы транзакций |
getRealizationReport | /v2/finance/realization | Отчёт о реализации товаров |
getRealizationReportPosting | /v1/finance/realization/posting | Позаказный отчёт о реализации |
🏢 B2B отчёты
| Метод | Endpoint | Назначение |
|---|---|---|
getDocumentB2BSalesReport | /v1/finance/document-b2b-sales | Реестр продаж юридическим лицам |
getDocumentB2BSalesJSON | /v1/finance/document-b2b-sales/json | B2B отчёт в JSON формате |
getMutualSettlementReport | /v1/finance/mutual-settlement | Отчёт о взаиморасчётах |
🔄 Компенсации
| Метод | Endpoint | Назначение |
|---|---|---|
getCompensationReport | /v1/finance/compensation | Отчёт о компенсациях |
getDecompensationReport | /v1/finance/decompensation | Отчёт о декомпенсациях |
getProductsBuyoutReport | /v1/finance/products/buyout | Отчёт о выкупленных товарах |
🚀 Быстрый пример
import { OzonSellerAPI } from 'daytona-ozon-seller-api';
// Инициализация
const client = new OzonSellerAPI({
clientId: 'your-client-id',
apiKey: 'your-api-key'
});
// Получить транзакции за месяц
const transactions = await client.finance.getTransactionList({
filter: {
date: {
from: '2024-01-01T00:00:00.000Z',
to: '2024-01-31T23:59:59.999Z'
},
operation_type: ['orders']
},
page: 1,
page_size: 1000
});
// Анализ доходов и расходов
let totalIncome = 0;
let totalExpenses = 0;
transactions.result?.operations?.forEach(operation => {
const amount = parseFloat(operation.amount || '0');
if (amount > 0) {
totalIncome += amount;
} else {
totalExpenses += Math.abs(amount);
}
});
console.log(`📈 Доходы: ${totalIncome}₽`);
console.log(`📉 Расходы: ${totalExpenses}₽`);
console.log(`💰 Прибыль: ${totalIncome - totalExpenses}₽`);