📋 FBS API

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

Инициализация клиента

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

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

Базовый workflow FBS

try {
  // 1. Получить новые отправления
  const newPostings = await client.fbs.getPostingListV3({
    filter: {
      since: '2024-01-01T00:00:00Z',
      to: '2024-01-31T23:59:59Z',
      status: 'awaiting_packaging' // Ожидают упаковки
    },
    limit: 50
  });

  console.log(`📦 Новых отправлений: ${newPostings.result?.postings?.length || 0}`);

  // 2. Обработать каждое отправление
  for (const posting of newPostings.result?.postings || []) {
    console.log(`\n🔄 Отправление: ${posting.posting_number}`);
    console.log(`   Статус: ${posting.status}`);
    console.log(`   Товаров: ${posting.products?.length}`);
    console.log(`   Дата отгрузки: ${posting.shipment_date}`);
    
    // 3. Создать этикетку для отправления
    const label = await client.fbs.packageLabel({
      posting_number: [posting.posting_number]
    });
    
    if (label.content) {
      console.log(`   ✅ Этикетка создана (${label.content.length} байт)`);
    }
  }

  // 4. Получить необработанные отправления
  const unfulfilledPostings = await client.fbs.getUnfulfilledListV3({
    limit: 100
  });
  
  console.log(`⏳ Необработанных отправлений: ${unfulfilledPostings.result?.postings?.length || 0}`);

} catch (error) {
  console.error('❌ Ошибка FBS workflow:', error);
}

📚 Подробные разделы документации

const createLabelWithRetry = async (postingNumbers: string[]) => {
  let attempts = 0;
  const maxAttempts = 5;
  
  while (attempts < maxAttempts) {
    try {
      const label = await client.fbs.packageLabel({
        posting_number: postingNumbers
      });
      
      return label;
    } catch (error) {
      if (error.message.includes("aren't ready")) {
        attempts++;
        console.log(`⏳ Этикетки не готовы, попытка ${attempts}/${maxAttempts}`);
        await new Promise(resolve => setTimeout(resolve, 60000)); // 1 минута
      } else {
        throw error;
      }
    }
  }
  
  throw new Error('Этикетки не готовы после максимального количества попыток');
};

const badExample = async () => {
  await client.fbs.packageLabel({ posting_number: ['123-456-1'] });
  // Нет проверки готовности этикеток
};

📊 Схемы FBS и rFBS

// Определение подходящей схемы на основе товара
const chooseFbsScheme = (product: Product): 'FBS' | 'rFBS' => {
  const criteria = {
    weight: product.weight,
    dimensions: product.dimensions,
    fragility: product.fragile,
    region: product.region
  };
  
  if (criteria.weight > 10000 || criteria.fragility) {
    return 'FBS'; // Больше контроля для тяжелых/хрупких товаров
  }
  
  if (criteria.region === 'moscow' || criteria.region === 'spb') {
    return 'rFBS'; // Быстрая доставка в крупных городах
  }
  
  return 'FBS';
};

// Пример автоматизированного обработчика FBS
class FbsOrderProcessor {
  async processNewOrders() {
    // 1. Получить новые заказы
    const newOrders = await this.getNewOrders();
    
    // 2. Создать этикетки
    const labels = await this.createLabelsWithRetry(newOrders);
    
    // 3. Уведомить склад об упаковке
    await this.notifyWarehouse(newOrders);
    
    // 4. Обновить статусы
    await this.updateOrderStatuses(newOrders, 'processing');
  }
  
  async handleCancellations() {
    const reasons = await client.fbs.getCancelReasonList();
    // Обработка отмен с правильными причинами
  }
}