GET /v1/catalog — synchronizacja katalogu dla Polski
Pobierz zlokalizowane SKU z MOQ, czasami realizacji, progami cenowymi. Paginacja cursor, If-Modified-Since dla delta sync, flagi dostępności huba Warszawa.
Paginacja i delty
GET /v1/catalog?country=Poland&cursor=…&limit=200 (max 500). Każda strona: { data:[…], next_cursor }. Nagłówek If-Modified-Since dla delta sync — serwer odpowiada 304 jeśli nic się nie zmieniło. ETag wspierany. Pełny katalog PL ~12k SKU.
Kształt obiektu
Każdy element: { sku, name_i18n:{en, pl}, category_path, moq, lead_time_days, base_price_cents (PLN/EUR, bez VAT), vat_rate:23%, weight_grams, hub:'Warszawa', sustainability:{recycled_pct, gots_certified}, image_urls[], variants[] }. Ceny pre-tax; zastosuj vat_rate (zazwyczaj 23%) lub użyj jawnego pola.
Filtrowanie i wyszukiwanie
Filtry: ?category=apparel&min_moq=50&max_lead_days=15&hub=Warszawa&certified=gots. Wyszukiwanie full-text via ?q=…. Wszystkie parametry łączne. Limit 500 wyników na request utrzymuje p95 poniżej 250 ms.
FAQ
Jak często zmienia się katalog?
Codzienne aktualizacje cen (00:30 UTC), nowe SKU co tydzień (pon 06:00 UTC). Użyj webhooka catalog.updated dla sync push.
Czy mogę pobrać obrazy produktów?
image_urls[] zwraca URL-e CDN w oryginalnej rozdzielczości; dodaj ?w=800 dla wariantów resize (przetwarzanie po stronie serwera).
Czy ceny zawierają VAT?
Nie — base_price_cents wyklucza VAT. Zastosuj vat_rate (zazwyczaj 23%) dla ceny dla klienta końcowego w Polsce.
Co z enforcementem MOQ?
Pole moq to absolutne minimum na linię. Poniżej zwraca 400 min_qty_violation. Niektóre SKU mają moq_increment dla ilości skokowych.
Czy mogę filtrować po certyfikacji?
Tak — ?certified=gots,fairwear,iso14001 zwraca tylko SKU ze wszystkimi certyfikatami. Połącz z ?sustainability_min_recycled_pct=30 dla ostrzejszych filtrów.