🏢 App para tu empresa

LISTA PARA USARgithub.com/banhaia/ninox-integration-starters

Una aplicación completa conectada a tu Ninox por la integración de terceros. Al levantarla ya tenés login, base de datos local y cinco módulos funcionando. Desde ahí la adaptás a tu caso: un tablero de ventas a medida, un chatbot que responde stock, una sincronización con tu CRM o alertas de reposición.

👉 Ver el repositorio · Armar el prompt para tu IA

Qué trae

Módulo	Qué hace	Endpoints de Ninox
Acceso	Login local. La primera vez se crea el usuario administrador.	—
Catálogo y stock	Sincroniza artículos, variantes (talle/color), precios, categorías y stock, con búsqueda y filtros.	GetData
Reservas y ventas	Crea reservas y ventas directas sin duplicados. Cancela, reintenta y consulta el comprobante.	Pedido, Pedido/cancelar, venta, comprobante/{id}, medios-pago
Ingesta de datos	Importa ventas y compras mes a mes con ítems, totales y medios de pago. Reimportar no duplica. Exporta a CSV.	exportar/ventaitems, ventatotales, compraitems, compratotales
Reportes	Ventas netas, ticket promedio, unidades, margen estimado, compras, top de artículos y medios de pago.	— (lee la base local)

Cómo está armada

Navegador (React)  ──/api──▶  Servidor (Express)  ──X-NX-TOKEN──▶  API de Ninox
                                     │
                                     ▼
                            Base local (SQLite)

• El token vive solo en el servidor y nunca llega al navegador.
• Los límites de frecuencia de Ninox se guardan en la base: reiniciar la app no provoca un 403.
• Los reportes nunca llaman a Ninox: trabajan sobre lo importado.
• Cada pedido tiene un ordenId propio que evita duplicados aunque se reintente.

Para qué la podés usar

• Tablero de gestión con tus indicadores, sin depender de exportar planillas.
• Chatbot con stock real: el repo incluye un ejemplo con Ollama que responde con el catálogo local.
• Sincronización con otro sistema (CRM, marketplace, planillas) a partir de la base local.
• Toma de pedidos desde un canal propio: vendedores, WhatsApp, eventos.

Primeros pasos

La forma más simple es armar el prompt y dejar que tu IA te guíe. Si preferís hacerlo a mano:

git clone https://github.com/banhaia/ninox-integration-starters.git
cd ninox-integration-starters
npm install && npm run dev

1. Abrí http://localhost:5173 y creá tu usuario.
2. En Configuración pegá el token, elegí testing y tocá Guardar y probar.
3. En Inicio sincronizá el catálogo.
4. En Ingesta importá algunos meses y mirá Reportes.

Para extenderla

El repo trae ONBOARDING.md (primeros pasos guiados), AGENTS.md y CLAUDE.md con la arquitectura y las reglas de la API, y un agente experto en la integración de terceros. Un pedido típico a tu IA:

"Usá el playbook del agente experto en Ninox para agregar la ingesta de saldos de clientes y un gráfico de deuda vencida en Reportes."