🎯 Назначение API
Supplier API предназначен исключительно для турецких продавцов и предоставляет инструменты для:
- Управление счёт-фактурами — создание и получение таможенных документов
- Соответствие законодательству — выполнение требований турецкого налогового права
- Автоматизация документооборота — интеграция с системами учёта
- Таможенное оформление — поддержка процедур импорта/экспорта
⚠️ Важно: Данный API доступен только для продавцов, зарегистрированных в Турции.
Для других стран используйте соответствующие категории API.
🇹🇷 Особенности турецкого рынка
Счёт-фактуры
Автоматическое создание документов в соответствии с турецким законодательством
Таможенные процедуры
Интеграция с таможенными органами для оформления товаров
Налоговое право
Соответствие требованиям турецкой налоговой системы
Автоматизация
Интеграция с системами учёта и документооборота
📋 Методы Supplier API (4 endpoints)
📄 Управление файлами и документами
| Метод | Endpoint | Назначение |
|---|---|---|
uploadInvoiceFile | /v1/invoice/file/upload | Загрузка файла счёт-фактуры (JPEG, PDF ≤10MB) |
createOrUpdateInvoice | /v2/invoice/create-or-update | Создание/обновление счёт-фактуры с HS-кодами |
getInvoice | /v2/invoice/get | Получение информации о счёт-фактуре |
deleteInvoice | /v1/invoice/delete | Удаление ссылки на счёт-фактуру |
💱 Поддерживаемые валюты
USD
Доллар США (по умолчанию)
EUR • TRY
Евро • Турецкая лира
CNY • RUB • GBP
Юань • Рубль • Фунт
💡 Рекомендация: Интегрируйте Supplier API с вашей системой учёта для автоматического
создания таможенных документов при обработке заказов.
🚀 Быстрый пример
import { OzonSellerAPI } from 'daytona-ozon-seller-api';
// Инициализация для турецкого продавца
const client = new OzonSellerAPI({
clientId: 'your-turkish-client-id',
apiKey: 'your-turkish-api-key'
});
try {
// 1. Загрузка файла счёт-фактуры
const file = await fs.readFile('invoice.pdf');
const base64Content = file.toString('base64');
const uploadResult = await client.supplier.uploadInvoiceFile({
base64_content: base64Content,
posting_number: '0001-1234567-0000001'
});
console.log(`📄 Файл загружен: ${uploadResult.url}`);
// 2. Создание записи о счёт-фактуре
const invoice = await client.supplier.createOrUpdateInvoice({
date: '2024-01-15T10:00:00Z',
posting_number: '0001-1234567-0000001',
url: uploadResult.url!,
number: 'INV-TR-2024-001',
price: 15000.50,
price_currency: 'TRY',
hs_codes: [
{ code: '6203420000' }, // Мужские брюки из хлопка
{ code: '6109100000' } // Футболки из хлопка
]
});
console.log(`✅ Счёт-фактура: ${invoice.result ? 'создана' : 'ошибка'}`);
// 3. Получение информации о счёт-фактуре
const invoiceInfo = await client.supplier.getInvoice({
posting_number: '0001-1234567-0000001'
});
console.log('📋 Информация о счёт-фактуре:');
console.log(` Номер: ${invoiceInfo.result?.number}`);
console.log(` Сумма: ${invoiceInfo.result?.price} ${invoiceInfo.result?.price_currency}`);
} catch (error) {
console.error('❌ Ошибка работы с счёт-фактурой:', error.message);
}