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.

Elegir el depósito​

Los dos endpoints aceptan un parámetro opcional depositoId para pedir el stock de un depósito en lugar del que resuelve la configuración de tu integración.

curl --request GET   --url 'https://api.test-ninox.com.ar/integraciones/Terceros/GetDataCurva?depositoId=7'   --header 'X-NX-TOKEN: {TU_TOKEN}'
  • Filtra, no desagrega: la respuesta tiene la misma forma de siempre; lo único que cambia es de dónde sale el número de stock.
  • Si lo omitís, el comportamiento es el de siempre.
  • Los depósitos válidos son los de tu integración: los lista GET /integraciones/terceros/config/depositos.

Devuelve 403 si el depósito no existe, si pertenece a una sucursal que no tenés habilitada, o si existe pero no está configurado en tu integración.

Sincronizar varios depósitos

Este endpoint devuelve un depósito por vez y no pagina, así que recorrer todo el catálogo depósito por depósito es caro. Para eso conviene:

  • webhooks en modo multidepósito informativo, que te mandan el stock de todos los depósitos en cada cambio (Webhooks);
  • exportar/stock para una reconciliación masiva por depósito (Exportaciones).

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.