Inicio Rápido
Aprende a autenticarte, crear tu primer producto y registrar una venta en minutos. Guía de inicio rápido →
NeoPOS API Docs
NeoPOS API Docs
NeoPOS es un sistema POS (Point of Sale) multitenant con arquitectura offline-first: PostgreSQL en la nube como primaria, SQLite como fallback local automático, y sincronización en segundo plano cuando se reconecta.
Autenticación
Login JWT, refresh tokens rotacionales, registro de tenants y gestión de sesiones. Ver endpoints de Auth →
Core POS
Ventas, productos, categorías, clientes, proveedores, carrito y mesas. Explorar módulos POS →
Finanzas
Caja, jornadas, egresos, saldo inicial, impuestos DIAN y más. Ver módulos financieros →
Créditos
Gestión de créditos con cuotas, movimientos, abonos y cálculo de mora. Ir a créditos →
Dashboard
Métricas de negocio: ventas diarias, top productos, resumen ejecutivo. Ver dashboard →
Infraestructura
Sincronización offline, multi-tenancy, permisos RBAC, reportes y backup. Explorar infraestructura →
Referencia
Códigos de error, tabla de permisos por rol, guía de autenticación detallada. Ver referencia →
Estado de la API
- Versión actual: 1.0.0
- Base URL:
http://localhost/api(desarrollo) —https://api.neopos.app/api(producción) - Total de endpoints: ~165
- Módulos documentados: 26
Tecnología
| Capa | Tecnología |
|---|---|
| Framework | FastAPI (Python 3.12+) |
| ORM | SQLAlchemy 2.0 asíncrono |
| Cloud DB | PostgreSQL 16 + asyncpg |
| Local DB | SQLite + aiosqlite |
| Auth | JWT (HS256) + bcrypt |
| Proxy | Nginx (rate limiting + TLS) |
| Contenedor | Docker + docker-compose |
Documentación mantenida por NeoApp Ingeniería SAS