Qué es Portal Pilot
Portal Pilot es una plataforma empresarial modular, multi-empresa y multi-usuario para operar tu negocio en línea: punto de venta, inventario, facturación con CAI, CRM, cobros en ruta, flota, automatizaciones e inteligencia artificial — todo desde un mismo workspace con control de roles y consumo medido por plan.
Portal Pilot está disponible como aplicación Web (navegador, sin instalación) y como App móvil Workspace para operar en el día a día. La web es la fuente de verdad de tu empresa, usuarios y suscripción.
¿Para quién es?
Portal Pilot se adapta al tipo de negocio que eliges durante el onboarding. Los verticales soportados hoy son:
- Pulpería / Mercadito — comercio de barrio y colonia
- Tienda / Supermercado — retail y abarrotes
- Área Comercial — distribución y venta mayorista
- Club / Membresía — socios y cobros recurrentes
Y según tu operación: tienda física, venta online, distribución con rutas, autoservicio o modelos omnicanal (física + online).
¿Qué incluye?
- Facturación con CAI — correlativos, rangos autorizados, RTN, ISV 15%/18% y notas de crédito
- Inventario multi-bodega — productos, stock y kardex
- POS — ventas rápidas de mostrador con descuento de stock
- CRM — clientes y cobros (las ventas fiadas requieren plan Business o superior)
- Rutas y Cobros — visitas, cobranza en calle y cartera
- Flota — gestión de vehículos de reparto (plan Enterprise)
- Asistente IA — resúmenes, análisis de ventas y soporte (server-side, con límites por plan)
- Automatizaciones — reglas automáticas sobre tus operaciones (plan Enterprise)
- Portal Empresa — usuarios, roles, suscripción, consumo y seguridad (las API keys son del plan Enterprise)
Transparencia: el workspace web requiere conexión a internet. La app móvil/desktop funciona offline-first: guarda los datos localmente (SQLite) y sincroniza cuando haya conexión. La IA se ejecuta del lado del servidor y siempre requiere conexión; su cuota depende de tu plan.
Crear tu empresa
De la landing a tu workspace en pocos minutos. Este es el flujo real:
Regístrate en la web
Entra a Registro con tu nombre, correo y contraseña. Al confirmar se crea tu empresa con un código único (por ejemplo PP-XXXXXX) y tu usuario como Propietario (Owner).
Recibes 15 días de prueba
Tu empresa arranca en el plan Starter con un trial de 15 días con acceso completo. Puedes revisar el estado en Portal Empresa → Suscripción.
Inicia sesión
Entra en Iniciar Sesión. El sistema te dirige automáticamente al área que corresponde a tu rol.
Completa el perfil de empresa
En Portal Empresa → Configuración define nombre comercial, teléfono y dirección. Estos datos aparecen en tus documentos.
Carga tus productos y clientes
Dá de alta productos en Inventario y clientes en CRM. Con eso ya puedes facturar, vender en POS y cobrar.
¿Y si empezaste en la app?
La app móvil te guía por un onboarding (tipo de negocio, tipo de cliente y operación). Después te lleva al registro web para crear la cuenta: no necesitas repetir el onboarding y tu cuenta de web funciona directamente en la app con el mismo correo y contraseña.
Si ya tienes cuenta y abres la app, con una sesión válida entras directo al workspace: la app no te vuelve a pedir registro.
Cuenta y sesiones
Verificación de correo
Durante el registro el sistema puede enviarte un código de verificación a tu correo. Ingrésalo cuando se te pida; si no llega, revisa spam o reenvíalo desde la misma pantalla.
Recuperación de contraseña
En la pantalla de login usa Recuperar contraseña. Recibirás un código por correo que te permitirá definir una nueva. Por seguridad el código expira y los intentos están limitados.
Sesiones activas
Cada dispositivo que inicia sesión crea una sesión visible en Portal Empresa → Seguridad, con dispositivo, ubicación aproximada y fecha. Desde ahí puedes revocar cualquier sesión (o todas) y el acceso de ese dispositivo queda invalidado de inmediato.
Cierre de sesión
Usa Logout en la app o en la web. Tu token deja de usarse en ese dispositivo.
Las contraseñas se almacenan cifradas y nadie —ni soporte— puede verlas. Nunca compartas códigos de verificación.
Facturación (CAI / SAR)
Portal Pilot genera facturas, recibos y notas de crédito con los campos exigidos por la normativa hondureña: CAI, rango autorizado, fecha límite de emisión, correlativo, RTN del cliente e ISV 15%/18%.
Configurar tu CAI
Ingresa tu resolución
Al emitir tu primera factura la empresa solicita el CAI vigente, el rango autorizado (inicial y final) y la fecha límite de emisión, tal como aparecen en tu resolución del SAR.
El sistema administra el correlativo
Cada documento usa el siguiente número disponible dentro de tu rango. No puedes emitir fuera del rango ni después de la fecha límite.
Crear una factura
Ve a Facturación
En el Workspace abre Facturación → Nueva factura.
Selecciona el cliente
Elige un cliente existente o créalo con nombre y RTN.
Agrega los items
Productos con cantidad y precio. El ISV 15% (o 18%) se calcula automáticamente sobre el subtotal.
Guarda y comparte
El documento queda registrado con su correlativo y estado. Puedes consultarlo, imprimirlo o anularlo con motivo (generando su registro de anulación).
Recibos y notas de crédito
- Recibo — comprobante de pago simple, sin efectos fiscales de factura.
- Nota de crédito — ajuste o devolución asociada a tu operación; se registra como documento aparte, nunca mezclada con facturas.
Cada tipo de documento (factura, recibo, nota de crédito) lleva su propia serie y correlativo. No se pueden sustituir entre sí.
Inventario
Control de productos con stock en tiempo real, múltiples bodegas, kardex de movimientos y transferencias entre bodegas.
Crear producto
Abre Inventario
En el Workspace entra a Inventario → Nuevo producto.
Define los datos
Nombre, código, precio de compra y precio de venta, y el stock inicial. El stock vive por bodega.
Bodegas y transferencias
- Crea tantas bodegas como necesites (por ejemplo: principal, vehículo de reparto).
- Registra transferencias entre bodegas; el kardex refleja la salida y la entrada (el módulo de transferencias se incluye en el plan Enterprise).
- Cada venta POS o factura descuenta stock automáticamente del almacén correspondiente.
El kardex te da la trazabilidad completa: quién movió qué, cuándo y por qué documento.
Punto de Venta (POS)
El POS está pensado para la venta rápida de mostrador: pocos clics, ticket y stock descontado al instante.
Abre POS
Entra al módulo POS desde el Workspace.
Arma la venta
Agrega productos buscando por nombre. Ajusta cantidades y aplica descuentos si aplica.
Cobra
Confirma la venta: se registra con su folio, se descuenta el stock y queda en el resumen del día.
Resumen de ventas
POS → Resumen muestra el movimiento por periodo para cuadrar caja al cierre.
La IA puede analizar tus ventas de POS para detectar patrones y sugerir upsell según el ticket (si tu plan incluye IA y tienes cuota disponible).
CRM y cobros
Administra tu cartera de clientes y el crédito que le extiendes.
Clientes
- Alta de clientes con nombre, RTN, contacto y dirección.
- Historial de documentos por cliente (facturas, recibos, notas).
Ventas fiadas y abonos
`nLas ventas a crédito (fiado) y los abonos se incluyen en los planes Business y Enterprise.
Registra la venta fiada
Un cliente lleva mercadería a crédito: la venta queda en fiados con su saldo pendiente.
Recibe abonos
Los pagos parciales se registran como abonos y el saldo se actualiza solo. El resumen te muestra la cartera por cliente.
La IA puede ayudarte a perfilar un cliente para decisión de crédito (según cuota de tu plan).
Rutas, Flota y Sucursales
Si tu operación incluye reparto o varios puntos, estos módulos mantienen el control.
`nPor plan: Rutas y Cobros están en todos los planes; Flota y Sucursales forman parte del plan Enterprise.
Rutas y Cobros
- Define rutas con sus clientes y frecuencia.
- Registra visitas y cobros en calle; la cartera se descuenta al confirmar el abono.
Flota
- Administra los vehículos de tu operación de reparto.
- Asigna unidades a rutas y lleva su control operativo.
Sucursales
- Dá de alta cada sucursal de tu empresa.
- Los documentos y ventas pueden asociarse a la sucursal correspondiente.
Reportes y transacciones
Dashboard
El dashboard resume tu operación: ventas del periodo, documentos emitidos y estado general de la empresa, calculado con tus datos reales.
Transacciones (movimientos)
El módulo de transacciones registra los movimientos operativos de tu negocio (por ejemplo, ingresos y gastos del área comercial) con su tipo y monto. Alimenta los reportes y el consumo del plan se mide por uso.
Reportes del Portal Empresa
En Portal Empresa → Reportes / Actividad el propietario y administradores ven la actividad de la empresa, el consumo por recurso y los eventos registrados.
Portal Pilot no incluye un módulo de contabilidad formal: registra transacciones y kardex operativos. Para asientos, libro diario y estados financieros, tu contador sigue siendo quien prepara y presenta las declaraciones.
Asistente IA
El asistente de Portal Pilot funciona del lado del servidor: tu app nunca habla directo con los proveedores ni contiene claves. Tú conversas, el gateway elige el proveedor disponible.
¿Qué puede hacer?
- Chat / consultas — preguntas sobre tu operación con contexto de tu empresa
- Resumen de dashboard — interpretación de tus métricas del periodo
- Análisis de POS — patrones de venta y sugerencias de upsell
- Perfil de cliente CRM — apoyo para decisiones de crédito
- Soporte — asistencia guiada dentro de la plataforma
- Visión — análisis de imágenes (documentos, capturas de tickets)
¿Qué proveedores usa?
Portal Pilot usa proveedores de IA en la nube con un gateway propio: si el proveedor principal no está disponible o no está configurado, intenta con el de respaldo; si ninguno está disponible, verás un mensaje claro de que la función de IA no está disponible en este momento — nunca un error técnico crudo.
Tus datos de empresa se usan para responder tu consulta y el uso se registra bajo tu tenant. Las claves de los proveedores jamás salen del servidor.
Consumo y límites de IA
La IA es un recurso medido como los usuarios o los documentos: cada llamada consume tokens de la cuota mensual de tu plan.
Cómo se controla
- Antes de llamar al proveedor, el servidor verifica tu cuota disponible del mes.
- Si la cuota está agotada, la respuesta es un límite claro (
429 AI_TOKEN_LIMIT_REACHED) sin gastar ni llamar al proveedor. - Cada llamada registra proveedor, modelo, tokens y coste estimado bajo tu empresa.
Dónde ver mi consumo
En Portal Empresa → Consumo (y IA si tu plan lo incluye) verás tu uso del periodo. Si llegaste al límite, puedes mejorar de plan o esperar el siguiente ciclo.
Si tu periodo de prueba terminó y no has activado un plan, la empresa queda en modo solo lectura: puedes consultar y exportar, pero no registrar movimientos ni usar IA hasta pagar.
Reglas automáticas
El módulo de Automatizaciones te permite definir reglas sobre tus operaciones (por ejemplo, acciones al registrar una venta o al cambiar el stock) y ejecutarlas sin intervención manual. Es parte del plan Enterprise; en otros planes la sección indica cómo desbloquearlo.
Cómo funciona
- Reglas — defines la condición y la acción desde Portal Empresa → Automatización.
- Ejecución — las reglas se ejecutan sobre los eventos de tu empresa y quedan registradas.
- Control — puedes activar, desactivar o eliminar reglas cuando quieras.
Las automatizaciones son un recurso medido por plan: el uso incrementa tu consumo del periodo.
El editor visual de flujos con nodos y webhooks externos no forma parte de la plataforma hoy. Si lo ves mencionado en algún material antiguo, esta página manda.
Usuarios y roles
Solo el Propietario y administradores autorizados gestionan el equipo, desde Portal Empresa → Equipo.
Roles disponibles
| Rol | Puede | No puede |
|---|---|---|
| Owner (Propietario) | Todo dentro de su empresa: usuarios, configuración, suscripción, consumo, seguridad | Acceder a otras empresas o a la administración global de la plataforma |
| Admin | Operar y administrar lo que el Owner le permita (equipo operativo, módulos) | Cambiar el plan, eliminar la empresa o escalar privilegios |
| Member | Usar el Workspace: facturar, vender en POS, inventario, clientes | Acceder al Portal Empresa, crear usuarios o ver la facturación de la suscripción |
Crear un usuario
Equipo → Invitar
Como Owner, define nombre, correo, rol y contraseña inicial. El límite de usuarios depende de tu plan y se valida en el servidor.
El usuario inicia sesión
Con su correo y contraseña. Sus permisos se aplican en el servidor, no solo en la pantalla.
Los permisos se verifican en cada llamada al servidor. Ocultar un botón no es la medida de seguridad: el backend rechaza la acción si tu rol no la permite.
Suscripción y consumo
Estado de tu suscripción
En Portal Empresa → Suscripción ves tu plan actual, el estado (prueba, activo, vencido), las fechas del periodo y el consumo del mes por recurso (usuarios, documentos, API, IA).
Trial de 15 días
- Tu empresa arranca con 15 días de prueba del plan Starter.
- Al vencer sin pago, la empresa entra en modo solo lectura: puedes consultar y exportar, pero no registrar operaciones nuevas.
- Al pagar un plan (ver Planes y Pago), el acceso se reactiva de inmediato.
Cambiar de plan
Como Owner, desde Suscripción eliges el plan y completas el pago. El cambio aplica al momento y tu cuota se ajusta al nuevo plan. Los administradores no pueden modificar el plan: esa decisión es del propietario.
El consumo de cada recurso se registra automáticamente por operación exitosa; una operación fallida no genera consumo.
Seguridad y sesiones
Qué ves aquí
- Sesiones activas — dispositivo, ubicación aproximada y último uso de cada acceso a tu empresa.
- Revocación — cierra cualquier sesión al instante (por ejemplo, un equipo perdido o un ex-colaborador).
- Eventos de seguridad — registros de accesos y acciones sensibles de tu empresa.
Cómo protegemos tu empresa
- Contraseñas cifradas y verificación por código de correo.
- Separación estricta entre empresas (una empresa nunca ve datos de otra).
- Límites de intentos en login y recuperación para frenar abusos.
- Revocación de sesión efectiva: el token invalidado deja de funcionar aunque alguien lo conserve.
Si detectas un acceso que no reconoces, revoca esa sesión y cambia tu contraseña de inmediato.
API Keys
Las API keys permiten que sistemas propios (tu tienda en línea, un ERP contable) consulten tu empresa de forma controlada. Es un módulo según plan: si tu plan no lo incluye, la sección indica cómo desbloquearlo.
Crear una API key
Portal Empresa → API
Como Owner, crea una key y cópiala en ese momento: por seguridad solo se muestra una vez, después verás únicamente un prefijo identificador.
Úsala en tus integraciones
Envíala en el encabezado de tus peticiones a la API (ver la sección API de esta documentación).
Revoca cuando quieras
Una key revocada deja de funcionar de inmediato y no puede recuperarse; crea una nueva si la necesitas.
Trata las API keys como contraseñas: no las subas a repositorios ni las incrustes en páginas web.
Autenticación de la API
Toda la plataforma habla una única API, la misma que usan la web y la app. Base URL:
https://portal-pilot.vercel.app/apiCon sesión de usuario
Tras POST /api/login recibes un token. Envíalo en cada llamada:
Authorization: Bearer <token>El token identifica usuario, rol y empresa. Si la sesión se revoca, el token deja de funcionar.
Con API key (integraciones)
X-API-Key: <tu-key>La key opera dentro de su empresa con los permisos definidos y queda registrada en la auditoría.
Reglas de la casa
- Toda operación verifica identidad, rol, empresa y plan en el servidor.
- Las respuestas de error son consistentes (código + mensaje) para que puedas manejarlas.
- Los límites de tasa protegen login, recuperación, soporte y pagos contra abuso.
Endpoints principales
Referencia de los grupos de endpoints reales de la plataforma. Los endpoints marcados con 🔒 requieren sesión o API key.
Cuenta
Empresa (Portal Empresa)
Operación
IA (según plan y cuota)
Automatizaciones
Sistema
Los errores devuelven una estructura consistente con código y mensaje (por ejemplo TRIAL_EXPIRED, PLAN_LIMIT_REACHED, AI_TOKEN_LIMIT_REACHED) para que tu integración pueda reaccionar.
Comparar Planes
Portal Pilot ofrece planes por empresa. Los valores oficiales vigentes los publica siempre la plataforma (ver planes); esta tabla refleja la configuración actual:
| Característica | Starter (Prueba) | Business | Enterprise |
|---|---|---|---|
| Precio mensual (HNL — Lempiras) | L.0 — prueba 15 días | L.1,499 | L.4,999 |
| Usuarios | 5 | 50 | 200 |
| Empresas | 1 | 3 | 5 |
| Facturación con CAI | ✅ | ✅ | ✅ |
| Inventario multi-bodega | ✅ | ✅ | ✅ |
| POS | ✅ | ✅ | ✅ |
| CRM y clientes | ✅ | ✅ | ✅ |
| Ventas fiadas y abonos | — | ✅ | ✅ |
| Rutas y cobros | ✅ | ✅ | ✅ |
| Flota y sucursales | — | — | ✅ |
| Asistente IA — tokens al mes | 100,000 | 2,000,000 | 10,000,000 |
| Automatizaciones | — | — | ✅ (hasta 50) |
| API / Integraciones | — | — | ✅ |
| Almacenamiento | 5 GB | 100 GB | 500 GB |
| Seguridad avanzada, club de compras y puntos | — | — | ✅ |
| Al vencer la prueba | Modo solo lectura | — | — |
Cómo funcionan los límites
- Los límites (usuarios, documentos, IA, automatizaciones) se aplican en el servidor; la interfaz los refleja pero no los decide.
- Cada operación exitosa incrementa el consumo del periodo; las fallidas no consumen.
- Al alcanzar un límite, la plataforma responde con un mensaje claro y la opción de mejorar de plan.
La moneda operativa de Portal Pilot es el Lempira hondureño (HNL). La facturación es mensual: Starter gratis (15 días de prueba, luego modo solo lectura hasta pagar), Business L.1,499/mes y Enterprise L.4,999/mes. No existe facturación anual en el flujo actual; cualquier descuento ofrecido se muestra siempre al momento del pago.
Existe además un plan Custom para corporativos con necesidades a medida (más empresas, usuarios y cuotas). Contacta a soporte.
La activación por pago reactiva tu empresa de inmediato, sin esperas ni tickets.