Saltar al contenido principal

Catálogo

La API pública ofrece dos formas de lectura del catálogo. Ambas tienen una frecuencia mínima de 10 minutos entre consultas (ver Alcance y límites).

Catálogo estándar​

GET/integraciones/Terceros/GetData

Devuelve Articulo[], con estructura agrupada por artículo y su curva (variantes anidadas).

Catálogo por variantes​

GET/integraciones/Terceros/GetDataCurva

Devuelve ArticuloConCurva[], con una estructura plana (un registro por variante) que suele ser más simple para sincronizaciones, indexación y procesamiento masivo.

El detalle de ambos tipos está en Esquema de datos.

Uso típico​

Con el catálogo podés:

  • publicar productos en un storefront
  • consultar stock desde un bot
  • indexar productos en un buscador
  • sincronizar precios y variantes
  • construir una base local para tu integración

Flujo recomendado de implementación​

Consumí GetData (o GetDataCurva) y validá la respuesta real de tu integración.

2. Normalizar datos​

Mapeá en tu sistema, como mínimo: artículo, código, descripción, precios, categorías y etiquetas, variantes y stock disponible.

3. Definir sincronización​

La estrategia más común es:

  • sincronización inicial completa
  • caché local o persistencia propia
  • refresco periódico respetando la ventana mínima de 10 minutos
  • actualización incremental mediante webhooks cuando aplique
Snapshot completo

GetData debe tratarse como una foto completa del depósito asociado a la app. Cada integración debe resolver su propia lógica para detectar qué artículos o variantes dejaron de llegar y marcarlos como eliminados, o bien reemplazar el conjunto local completo y tomar a NinoxNet como fuente de verdad.

4. Enviar pedidos​

Una vez resuelto el catálogo, integrá el flujo de pedidos.

5. Agregar controles operativos​

Antes de salir a producción, validá: reintentos por errores de red, idempotencia para evitar pedidos duplicados, manejo de artículos sin stock, diferencias de precio entre sistemas, y observabilidad/logs.