Integración de terceros
La integración de terceros de NinoxNet permite conectar una aplicación externa para leer catálogo y stock, enviar pedidos y ventas y mantenerse sincronizado por webhooks.
Está pensada como base para casos de uso como:
- ecommerce propio
- chatbot con catálogo y stock
- sincronización con un sistema externo
- automatizaciones comerciales
La integración de terceros es un proyecto activamente en desarrollo. La base actual es estable para comenzar una integración y se irán incorporando nuevos endpoints (algunos en BETA).
Qué resuelve hoy
Hoy la integración pública cubre estos flujos:
- Leer artículos, precios, categorías, etiquetas, variantes y stock.
- Enviar pedidos y ventas desde un sistema externo a NinoxNet.
- Recibir cambios por webhooks (push de stock, precios y variantes).
- Exportar en lote clientes, saldos, stock e ítems de venta (endpoints BETA).
Si tu objetivo es desarrollar una app, este es el flujo recomendado para comenzar:
- Obtener credenciales — ver Autenticación.
- Consumir el catálogo.
- Normalizar los datos en tu sistema.
- Definir una estrategia de sincronización.
- Integrar el envío de pedidos.
Contratación y costo
La integración de terceros tiene un costo adicional. Antes de avanzar con el desarrollo, verificá el esquema comercial vigente en ninoxnet.com/integraciones/terceros.
Tomá este punto en cuenta desde el inicio del proyecto, porque impacta tanto en el onboarding como en la decisión de alcance de la integración.
Mapa de la sección
| Página | Contenido |
|---|---|
| Autenticación | Base URLs, token X-NX-TOKEN, primer request |
| Alcance y límites | Reglas de alcance y límites de frecuencia |
| Catálogo | GetData / GetDataCurva y sincronización |
| Pedidos | Crear, actualizar, cambiar estado y cancelar pedidos |
| Ventas (BETA) | Venta directa, nota de crédito, facturar preventa, medios de pago |
| Stock (BETA) | Movimientos de stock y motivos |
| Exportaciones (BETA) | Clientes, saldos, stock, ventas, preventas, compras y gastos en lote |
| Entidades y configuración (BETA) | Listado paginado de clientes y config de la integración |
| Webhooks | Push de cambios de artículos |
| Esquema de datos | Tipos y contratos TypeScript |
| Enums y códigos | Valores numéricos de tipos, estados y medios de pago |
| Errores comunes | Tabla de códigos de error |
| Onboarding | Proceso de alta de la integración |
| Asistente de implementación | Guía paso a paso por escenario |
| Changelog | Historial de cambios de la API |
Siguiente paso
Si estás arrancando una integración nueva, empezá por la autenticación y el primer request al catálogo. Para una guía guiada por tu caso de uso, usá el asistente de implementación.