📚 Документация по разделам

Документация разделена на функциональные блоки для удобного изучения:

🚀 Quick Start

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

const warehouseApi = new WarehouseApi(httpClient);

// 1. Получение списка всех складов
const warehouses = await warehouseApi.getWarehousesList();

console.log(`📦 Найдено складов: ${warehouses.result?.length}`);

warehouses.result?.forEach(warehouse => {
  console.log(`\n🏪 ${warehouse.name} (ID: ${warehouse.warehouse_id})`);
  console.log(`   📊 Статус: ${warehouse.status}`);
  console.log(`   🚀 Тип: ${warehouse.is_rfbs ? 'rFBS (региональный)' : 'FBS (продавца)'}`);
  console.log(`   💰 Эконом товары: ${warehouse.is_economy ? 'Поддерживаются' : 'Не поддерживаются'}`);
  console.log(`   📏 КГТ товары: ${warehouse.is_kgt ? 'Принимаются' : 'Не принимаются'}`);
  console.log(`   🏥 Карантин: ${warehouse.is_karantin ? 'Активен' : 'Не активен'}`);
  
  // Информация о лимитах
  if (warehouse.has_postings_limit) {
    console.log(`   📦 Лимит отправлений: ${warehouse.postings_limit} (минимум: ${warehouse.min_postings_limit})`);
  } else {
    console.log(`   📦 Лимит отправлений: не установлен`);
  }
  
  // Рабочие дни
  if (warehouse.working_days?.length) {
    const dayNames = ['Пн', 'Вт', 'Ср', 'Чт', 'Пт', 'Сб', 'Вс'];
    const workingDayNames = warehouse.working_days.map(day => dayNames[parseInt(day) - 1]);
    console.log(`   📅 Рабочие дни: ${workingDayNames.join(', ')}`);
    console.log(`   📅 Минимум рабочих дней: ${warehouse.min_working_days}`);
  }
  
  // Настройки первой мили
  if (warehouse.first_mile_type) {
    console.log(`   🚚 Первая миля: ${warehouse.first_mile_type.first_mile_type}`);
    if (warehouse.first_mile_type.first_mile_is_changing) {
      console.log(`   ⚠️ Настройки первой мили обновляются`);
    }
    if (warehouse.first_mile_type.dropoff_point_id) {
      console.log(`   📍 DropOff точка: ${warehouse.first_mile_type.dropoff_point_id}`);
    }
  }
  
  // Дополнительные возможности
  console.log(`   📋 Доверительная приемка: ${warehouse.has_entrusted_acceptance ? 'Включена' : 'Отключена'}`);
  console.log(`   🖨️ Печать актов заранее: ${warehouse.can_print_act_in_advance ? 'Доступна' : 'Недоступна'}`);
  console.log(`   ⏰ Изменение расписания: ${warehouse.is_timetable_editable ? 'Разрешено' : 'Запрещено'}`);
});

// 2. Получение методов доставки для конкретного склада
const activeWarehouses = warehouses.result?.filter(w => w.status === 'created');

if (activeWarehouses && activeWarehouses.length > 0) {
  const warehouseId = activeWarehouses[0].warehouse_id;
  
  const deliveryMethods = await warehouseApi.getDeliveryMethods({
    limit: 20,
    offset: 0,
    filter: {
      warehouse_id: warehouseId,
      status: 'ACTIVE'
    }
  });
  
  console.log(`\n🚚 Активные методы доставки для склада ${warehouseId}:`);
  console.log(`   Найдено методов: ${deliveryMethods.result?.length}`);
  console.log(`   Есть еще данные: ${deliveryMethods.has_next ? 'Да' : 'Нет'}`);
  
  deliveryMethods.result?.forEach(method => {
    console.log(`\n   📦 ${method.name} (ID: ${method.id})`);
    console.log(`     📊 Статус: ${method.status}`);
    console.log(`     🏢 Поставщик: ${method.provider_id}`);
    console.log(`     ⏰ Cutoff: ${method.cutoff || 'Не установлен'}`);
    console.log(`     🕐 Время сборки: ${method.sla_cut_in} минут`);
    console.log(`     📅 Создан: ${method.created_at}`);
    console.log(`     🔄 Обновлен: ${method.updated_at}`);
  });
}

💡 Основные сценарии использования

💼 Интеграция с корпоративными системами