Acerca de este sitio
Este sitio es el Hub de Desarrollo de NinoxNet (docs.ninox.com.ar), mantenido por
Banhaia. Su propósito es documentar todas las opciones de integración técnica para
desarrolladores, agencias y vibe coders que quieren construir sobre NinoxNet.
¿Qué es NinoxNet?
NinoxNet es el ERP + e-commerce de Banhaia, orientado a comercios minoristas en Argentina. Cubre punto de venta, caja, stock, compras, facturación electrónica (AFIP), catálogo de artículos (con talles, colores y curvas), preventa y clientes.
El sitio de producto es ninoxnet.com.ar. La documentación de ayuda para usuarios finales
del ERP se conserva en este repositorio bajo docs/legacy/ pero está excluida del build
y no se publica.
Para quién es este hub
Está orientado a:
- Programadores que integran NinoxNet con un e-commerce, una app propia o un sistema externo.
- Agencias que implementan integraciones para clientes que ya usan NinoxNet.
- Vibe coders que usan agentes AI (Claude, Cursor, Copilot) para generar la integración.
No es un sitio de ayuda para usuarios finales del ERP. Ese caso de uso queda en legacy/.
Opciones de integración
1. Integración de terceros (API REST) — Estable
Es el camino recomendado para empezar hoy. Permite a una app externa:
- Leer artículos, precios, categorías, etiquetas, variantes (talle/color) y stock.
- Enviar pedidos y ventas hacia NinoxNet.
- Recibir cambios en tiempo cuasi-real por webhooks (push de stock, precios, variantes).
- Exportar en lote clientes, saldos, stock e ítems de venta (BETA).
La autenticación usa un header X-NX-TOKEN provisionado por Banhaia. Un token = un
depósito + un punto de venta. El token es de backend exclusivamente — nunca exponerlo
en cliente.
Hay dos ambientes:
- Pruebas:
https://api.test-ninox.com.ar— para desarrollo. - Producción:
https://api.ninox.com.ar— para go live.
La integración tiene costo adicional al plan NinoxNet. Detalle comercial en
ninoxnet.com/integraciones/terceros.
Documentación completa: /docs/terceros.
2. MCP Server — Próximamente
Un servidor Model Context Protocol que expondrá catálogo, stock y clientes como herramientas y recursos MCP, permitiendo que agentes AI (Claude Code, Claude Desktop, Cursor) operen NinoxNet de forma nativa. Aún no disponible; mientras tanto usar la integración de terceros.
Documentación: /docs/mcp.
3. API directa — Próximamente
Acceso programático directo a NinoxNet (no a través de la capa de terceros). Sin fecha
confirmada. Documentación placeholder en /docs/api.
Estructura de la documentación
| Sección | Ruta | Estado |
|---|---|---|
| Integración de terceros (intro) | /docs/terceros | Estable |
| Autenticación | /docs/terceros/autenticacion | Estable |
| Alcance y límites | /docs/terceros/alcance-y-limites | Estable |
Catálogo (GetData, GetDataCurva) | /docs/terceros/catalogo | Estable |
| Pedidos | /docs/terceros/pedidos | Estable |
| Ventas directas y facturación | /docs/terceros/ventas-beta | BETA |
| Movimientos de stock | /docs/terceros/stock | BETA |
| Exportaciones (clientes, saldos, venta) | /docs/terceros/exportaciones | BETA |
| Entidades y config | /docs/terceros/entidades | BETA |
| Webhooks | /docs/terceros/webhooks | Estable |
| Esquema de datos (TypeScript) | /docs/terceros/esquema | Estable |
| Errores comunes | /docs/terceros/errores | Estable |
| Onboarding | /docs/terceros/onboarding | Estable |
| Asistente de implementación | /docs/terceros/asistente | Estable |
| MCP Server | /docs/mcp | Próximamente |
| API directa | /docs/api | Próximamente |
| Ejemplos y repo starter | /docs/ejemplos | Estable |
| FAQ para desarrolladores | /docs/faq | Estable |
Casos de uso típicos
- E-commerce propio: leer catálogo con
GetData/GetDataCurva, sincronizar stock por webhooks, enviar pedidos conPOST /Pedido. - Chatbot con catálogo: leer artículos y stock, responder consultas de disponibilidad, registrar pedidos/reservas.
- Sincronización con sistema externo: exportar clientes, saldos e ítems de venta en lote.
- Automatizaciones comerciales: registrar ventas directas o preventas, facturar electrónicamente (AFIP) vía el endpoint BETA.
Repo starter
Hay un repositorio de ejemplos en github.com/banhaia/ninox-integration-starters con
templates en TypeScript listos para ser usados como base de una integración o generados por
un agente AI.
Contacto técnico
Para coordinar integraciones, solicitar tokens o sumar casos de uso, completá el formulario en ninoxnet.com/integraciones/terceros.