🛍️ Tienda online

EN CONSTRUCCIÓNgithub.com/banhaia/ninox-ecommerce-starter

Una tienda online chica que usa tu Ninox como fuente de verdad: los productos, precios y stock vienen del ERP y no se cargan dos veces. Vos sumás lo visual (fotos, descripciones, destacados) y los pedidos vuelven a Ninox como reservas, sin duplicados.

👉 Ver el repositorio · Armar el prompt para tu IA

Cómo funciona

Tu Ninox ──catálogo──▶ Tienda ──▶ Cliente arma el carrito y confirma
   ▲                                          │
   └──────── reserva (Terceros/Pedido) ◀──────┴──▶ cierra la venta por WhatsApp

• Catálogo desde Ninox (GetData): precio, stock, talles, colores y categorías.
• Vitrina editable: descripción, imágenes, destacados y orden se editan en la tienda y la sincronización nunca los pisa.
• Carrito y checkout: precios y stock se recalculan en el servidor, nunca se confía en el navegador.
• Cierre por WhatsApp con un mensaje configurable: el pago se acuerda ahí.
• Pedidos a Ninox sin duplicados: cada pedido se guarda primero en la tienda y se envía con un ordenId estable, con reintento, conciliación y cancelación desde el panel.

Estado

El starter se construye por fases. Cuando lo uses con una IA, el archivo docs/plan.md del repo le indica en qué fase está y cuál es el próximo paso, así que puede seguir construyéndolo con vos.

Fase	Qué incluye	Estado
0. Base	Proyecto, base de datos, cliente Ninox, panel de administración	✅ Lista
1. Catálogo	Sincronización con Ninox, vitrina, páginas de la tienda	🚧 En curso
2. Carrito y checkout	Carrito, checkout, pedido por WhatsApp	⏳ Pendiente
3. Pedidos a Ninox	Envío idempotente, reintentos, conciliación	⏳ Pendiente
4. Publicación	Guías probadas para Azure, Vercel y Netlify	⏳ Pendiente

Stack

• Un solo proceso Node con React Router (modo framework, Vite): las páginas y el backend viven juntos.
• Prisma detrás de interfaces propias: SQLite para desarrollar, Postgres o Supabase para publicar.
• Publicable en Azure App Service, Vercel o Netlify.

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-ecommerce-starter.git
cd ninox-ecommerce-starter
cp .env.example .env   # completá ADMIN_PASSWORD, SESSION_SECRET y NINOX_TOKEN
npm install && npm run dev

La tienda queda en http://localhost:5173 y el panel en /admin. Desde /admin/productos sincronizás el catálogo de tu Ninox.

¿Querés una tienda llave en mano?

NinoxNet también se integra de forma nativa con Tienda Nube y WordPress, sin programar. Este starter es para quien quiere una tienda propia y a medida.