🎯 Назначение API
Warehouse API предоставляет базовые инструменты для работы со складской инфраструктурой OZON:
- Информация о складах — получение списка доступных складов FBS/rFBS
- Характеристики складов — адреса, контакты, режимы работы
- Планирование логистики — выбор оптимальных складов для размещения
- Интеграция с заказами — связь складских данных с системой FBS
🏭 Типы складов OZON
FBS склады
Fulfillment by Seller
Продавец самостоятельно отправляет товары покупателям
rFBS склады
Regional FBS
Региональные склады для ускорения доставки
Сортировочные центры
Центры консолидации и распределения товаров по регионам
📋 Методы Warehouse API (2 endpoints)
⚠️ Важно: Для получения списка складов FBO используйте отдельный метод
/v1/cluster/list
📍 Управление складами FBS/rFBS
| Метод | Endpoint | Назначение |
|---|---|---|
getWarehousesList | /v1/warehouse/list | Список всех доступных складов FBS/rFBS |
getDeliveryMethods | /v1/delivery-method/list | Методы доставки склада |
🔄 Сравнение FBS vs rFBS
| Характеристика | FBS | rFBS |
|---|---|---|
| Размещение товаров | На складе продавца | На складе OZON |
| Отправка заказов | Продавец | OZON |
| Скорость доставки | Зависит от продавца | 1-3 дня по России |
| Охват регионов | Ограниченный | Вся Россия |
| Сложность управления | Высокая | Низкая |
💡 Рекомендация: Используйте rFBS для максимального охвата регионов и быстрой доставки.
FBS подходит для специфических товаров и контроля логистики.
🚀 Быстрый пример
import { OzonSellerAPI } from 'daytona-ozon-seller-api';
// Инициализация
const client = new OzonSellerAPI({
clientId: 'your-client-id',
apiKey: 'your-api-key'
});
try {
// Получить список всех складов FBS/rFBS
const warehouses = await client.warehouse.getWarehousesList();
console.log(`🏪 Найдено складов: ${warehouses.result?.length || 0}`);
// Анализ складов по типам
const warehouseStats = {
fbs: 0,
rfbs: 0,
crossdock: 0
};
warehouses.result?.forEach(warehouse => {
console.log(`📍 ${warehouse.name} (ID: ${warehouse.warehouse_id})`);
console.log(` Статус: ${warehouse.status === 'ACTIVE' ? '✅ Активен' : '❌ Неактивен'}`);
console.log(` Тип: ${warehouse.is_rfbs ? 'rFBS' : 'FBS'}`);
console.log(` Эконом товары: ${warehouse.is_economy ? '✅' : '❌'}`);
console.log(` КГТ товары: ${warehouse.is_kgt ? '✅' : '❌'}`);
if (warehouse.has_postings_limit) {
console.log(` Лимит отправлений: ${warehouse.postings_limit}`);
}
// Подсчёт по типам
if (warehouse.is_rfbs) {
warehouseStats.rfbs++;
} else {
warehouseStats.fbs++;
}
});
console.log('📊 Статистика складов:');
console.log(` FBS: ${warehouseStats.fbs}`);
console.log(` rFBS: ${warehouseStats.rfbs}`);
console.log(` Cross-dock: ${warehouseStats.crossdock}`);
// Получить способы доставки
const deliveryMethods = await client.warehouse.getDeliveryMethods();
console.log(`🚚 Способов доставки: ${deliveryMethods.result?.length || 0}`);
} catch (error) {
console.error('❌ Ошибка получения информации о складах:', error.message);
}