GET /v1/catalog — sincronizar catálogo para Portugal
Obtenha SKUs localizados com MOQ, prazos, escalões de preço. Paginação cursor, If-Modified-Since para delta sync, flags de disponibilidade hub Lisboa.
Paginação e deltas
GET /v1/catalog?country=Portugal&cursor=…&limit=200 (máx 500). Cada página: { data:[…], next_cursor }. Header If-Modified-Since para delta sync — servidor responde 304 se nada mudou. ETag suportado. Catálogo completo PT ~12k SKUs.
Forma do objeto
Cada item: { sku, name_i18n:{en, pt}, category_path, moq, lead_time_days, base_price_cents (EUR, sem IVA), iva_rate:23%, weight_grams, hub:'Lisboa', sustainability:{recycled_pct, gots_certified}, image_urls[], variants[] }. Preços pré-imposto; aplique IVA 23% ou use o campo explícito.
Filtragem e pesquisa
Filtros: ?category=apparel&min_moq=50&max_lead_days=15&hub=Lisboa&certified=gots. Pesquisa full-text via ?q=…. Todos os parâmetros combináveis. Limite 500 resultados por request mantém p95 abaixo de 250 ms.
FAQ
Com que frequência muda o catálogo?
Atualizações de preços diárias (00:30 UTC), novos SKUs semanalmente (seg 06:00 UTC). Use webhook catalog.updated para sync push.
Posso obter imagens dos produtos?
image_urls[] devolve URLs CDN à resolução original; junte ?w=800 para variantes redimensionadas.
Os preços incluem IVA?
Não — base_price_cents exclui IVA. Aplique iva_rate (tipicamente 23%) para preço ao cliente final em Portugal.
E o enforcement de MOQ?
Campo moq é o mínimo absoluto por linha. Abaixo disso devolve 400 min_qty_violation. Alguns SKUs têm moq_increment para quantidades em step.
Posso filtrar por certificação?
Sim — ?certified=gots,fairwear,iso14001 devolve só SKUs com todas as certificações. Combine com ?sustainability_min_recycled_pct=30.