📖 Полное руководство | OZON Seller API SDK

📚 Обзор: Полная документация для SDK OZON Seller API с 278 endpoints в 33 категориях. Этот SDK предоставляет полный доступ к API OZON для продавцов.

278 API методов

33 Категорий API

100% TypeScript

95%+ Тест-покрытие

🎯 Основные возможности

📦 Управление товарами

Создание и редактирование товаров
Управление остатками и ценами
Импорт и экспорт каталогов
Работа с изображениями

🛒 Обработка заказов

FBO/FBS заказы
Доставка и отслеживание
Управление возвратами
Печать этикеток

🏭 Складская логистика

Управление складами
Поставки и приемка
Инвентаризация
Логистические схемы

💰 Финансовая отчетность

Транзакции и выплаты
Комиссии и сборы
Реализационные отчеты
Налоговые документы

📈 Маркетинг и аналитика

Акции и скидки
Продвижение товаров
Аналитика продаж
Отчеты по эффективности

👥 Взаимодействие с клиентами

Отзывы и рейтинги
Вопросы и ответы
Чат поддержка
Управление репутацией

🚀 Быстрый старт

Установка

npm install daytona-ozon-seller-api

Инициализация

                import { OzonSellerAPI } from 'daytona-ozon-seller-api';

const api = new OzonSellerAPI({
  clientId: 'your-client-id',
  apiKey: 'your-api-key'
});
            

Первый запрос

                // Получить список товаров
const products = await api.product.getList({ limit: 10 });
console.log(`Найдено товаров: ${products.result?.items?.length || 0}`);

// Получить информацию о заказах FBS
const orders = await api.fbs.getOrdersList({
  filter: { status: 'awaiting_packaging' },
  limit: 20
});

console.log(`Заказов к обработке: ${orders.result?.length || 0}`);
            

📖 Основные категории API

🔥 Популярные API

Product API - Управление товарами
FBS API - Заказы с доставкой
Finance API - Финансы и отчеты
Analytics API - Аналитика продаж

🛍️ Продажи и маркетинг

Pricing Strategy API - Стратегии цен
Promos API - Акции и скидки
Review API - Отзывы покупателей
Questions Answers API - Вопросы

📊 Аналитика и отчеты

Report API - Отчеты и статистика
Seller Rating API - Рейтинг продавца
Premium API - Премиум сервисы
Chat API - Коммуникации

🚚 Логистика и доставка

Delivery FBS/RFBS API - Доставка
Warehouse API - Склады
Returns API - Возвраты
Supplier API - Поставщики

📚 Документация и ресурсы

⚠️ Важно: Для доступа к некоторым API требуется подписка Premium Plus на OZON. Проверьте требования для конкретных методов в документации.

📖 Руководства

📑 Справочники

🔗 Полезные ссылки

🎯 Примеры использования

Пример: Полный цикл обработки заказа

                async function processOrder(orderNumber: string) {
  // 1. Получаем информацию о заказе
  const order = await api.fbs.getOrder({ posting_number: orderNumber });
  
  // 2. Проверяем наличие товаров на складе
  for (const product of order.products) {
    const stock = await api.product.getStocks({
      product_id: product.product_id
    });
    
    if (stock.present < product.quantity) {
      throw new Error(`Недостаточно товара ${product.name}`);
    }
  }
  
  // 3. Упаковываем заказ
  await api.fbs.packOrder({
    posting_number: orderNumber,
    packages: [{ products: order.products }]
  });
  
  // 4. Отгружаем заказ
  await api.fbs.shipOrder({
    posting_number: orderNumber,
    tracking_number: `TRACK${Date.now()}`
  });
  
  console.log(`✅ Заказ ${orderNumber} успешно обработан`);
}
            

💡 Совет: Начните с Быстрого старта, затем используйте Каталог категорий или Алфавитный индекс для поиска нужных методов. Полный перечень страниц категорий доступен здесь.