GET /v1/catalog — sincronizar catálogo para España
Obtén SKUs localizados con MOQ, plazos, tramos de precio. Paginación cursor, If-Modified-Since para delta sync, flags de disponibilidad hub Madrid.
Paginación y deltas
GET /v1/catalog?country=Spain&cursor=…&limit=200 (máx 500). Cada página: { data:[…], next_cursor }. Header If-Modified-Since para delta sync — servidor responde 304 si nada cambió. ETag soportado. Catálogo completo ES ~12k SKUs.
Forma del objeto
Cada elemento: { sku, name_i18n:{en, es}, category_path, moq, lead_time_days, base_price_cents (EUR, sin IVA), iva_rate:21%, weight_grams, hub:'Madrid', sustainability:{recycled_pct, gots_certified}, image_urls[], variants[] }. Precios pre-tax; aplica iva_rate (típicamente 21%) o usa el campo explícito.
Filtrado y búsqueda
Filtros: ?category=apparel&min_moq=50&max_lead_days=15&hub=Madrid&certified=gots. Búsqueda full-text vía ?q=…. Todos los parámetros combinables. Límite 500 resultados por request mantiene p95 bajo 250 ms.
FAQ
¿Con qué frecuencia cambia el catálogo?
Actualizaciones de precios diarias (00:30 UTC), nuevos SKUs semanales (lun 06:00 UTC). Usa webhook catalog.updated para sync push.
¿Puedo obtener imágenes de producto?
image_urls[] devuelve URLs CDN en resolución original; añade ?w=800 para variantes redimensionadas.
¿Los precios incluyen IVA?
No — base_price_cents excluye IVA. Aplica iva_rate (típicamente 21%) para precio al cliente final en España.
¿Y el enforcement de MOQ?
El campo moq es el mínimo absoluto por línea. Enviar por debajo devuelve 400 min_qty_violation. Algunos SKUs tienen moq_increment para cantidades escalonadas.
¿Puedo filtrar por certificación?
Sí — ?certified=gots,fairwear,iso14001 devuelve solo SKUs con todas las certificaciones. Combina con ?sustainability_min_recycled_pct=30.