📋 Supplier API

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

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

🚀 Quick Start

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

const supplierApi = new SupplierApi(httpClient);

// 1. Загрузка файла счёт-фактуры
const uploadResult = await supplierApi.uploadInvoiceFile({
  base64_content: 'JVBERi0xLjQKJcOkw7zDtsO...', // PDF в Base64
  posting_number: '0001-1234567-0000001'
});

console.log(`📄 Файл загружен: ${uploadResult.url}`);

// 2. Создание счёт-фактуры для турецкого продавца
const invoice = await supplierApi.createOrUpdateInvoice({
  date: '2024-01-15T10:00:00Z',
  posting_number: '0001-1234567-0000001',
  url: uploadResult.url!,
  number: 'TR-INV-2024-001',
  price: 2500.75,
  price_currency: 'TRY', // Турецкая лира
  hs_codes: [
    { code: '6203420000' }, // Мужские брюки из хлопка
    { code: '6109100000' }, // Футболки из хлопка
    { code: '6204620000' }  // Женские брюки из хлопка
  ]
});

console.log(`✅ Счёт-фактура создана: ${invoice.result ? 'успешно' : 'ошибка'}`);

// 3. Получение информации о счёт-фактуре
const invoiceInfo = await supplierApi.getInvoice({
  posting_number: '0001-1234567-0000001'
});

const data = invoiceInfo.result;
console.log('📋 Детали счёт-фактуры:');
console.log(`   📄 Номер: ${data?.number}`);
console.log(`   📅 Дата: ${data?.date}`);
console.log(`   💰 Сумма: ${data?.price} ${data?.price_currency}`);
console.log(`   📦 HS-коды: ${data?.hs_codes?.length} товарных позиций`);
console.log(`   🔗 URL: ${data?.file_url}`);

// Детальная информация по каждому HS-коду
data?.hs_codes?.forEach((hsCode, index) => {
  console.log(`   [${index + 1}] HS-код: ${hsCode.code}`);
});

// 4. Удаление ссылки на счёт-фактуру при необходимости
const deleteResult = await supplierApi.deleteInvoice({
  posting_number: '0001-1234567-0000001'
});

console.log(`🗑️ Удаление: ${deleteResult.result ? 'успешно' : 'ошибка'}`);

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

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