GET /v1/catalog — синхронизация каталога для Польша
Получите локализованные SKU с MOQ, сроками, тарифами. Cursor-пагинация, If-Modified-Since для delta sync, флаги доступности хаба Варшава.
Пагинация и delta
GET /v1/catalog?country=Poland&cursor=…&limit=200 (max 500). Каждая страница: { data:[…], next_cursor }. Header If-Modified-Since для delta sync — сервер отвечает 304 если ничего не изменилось. ETag поддерживается. Полный каталог ~12k SKU.
Структура объекта
Каждый элемент: { sku, name_i18n:{en, pl}, category_path, moq, lead_time_days, base_price_cents (EUR, без VAT), vat_rate:23%, weight_grams, hub:'Варшава', sustainability:{recycled_pct, gots_certified}, image_urls[], variants[] }. Цены до налога; клиент применяет VAT 23% или использует явное поле.
Фильтрация и поиск
Фильтры: ?category=apparel&min_moq=50&max_lead_days=15&hub=Варшава&certified=gots. Full-text поиск через ?q=…. Все параметры комбинируются. Лимит 500 результатов на запрос держит p95 ниже 250 мс.
FAQ
Как часто меняется каталог?
Ежедневные обновления цен (00:30 UTC), еженедельные добавления SKU (пн 06:00 UTC). Используйте webhook catalog.updated для push-синхронизации.
Можно получить изображения товаров?
image_urls[] возвращает CDN URL в оригинальном разрешении; добавьте ?w=800 для resize-вариантов (image processing на сервере).
Цены с НДС?
Нет — base_price_cents без VAT. Применяйте vat_rate (обычно 23%) для цены конечному покупателю в Польше.
Что с enforcement MOQ?
Поле moq — абсолютный минимум на строку. Меньше — 400 min_qty_violation. У некоторых SKU есть moq_increment для шаговых количеств.
Можно фильтровать по сертификации?
Да — ?certified=gots,fairwear,iso14001 возвращает только SKU со всеми перечисленными сертификатами. Комбинируйте с ?sustainability_min_recycled_pct=30.