Instalación de Portal Pilot

Descarga e instala Portal Pilot en tu dispositivo (web, móvil o escritorio). Disponible para Android, iOS, Windows, macOS y Linux.

Tu primera factura

Veamos cómo crear tu primera factura electrónica en menos de 2 minutos.

Facturación Electrónica SAR

Portal Pilot genera facturas electrónicas conformes a la normativa del SAR (Servicio de Administración de Rentas) de Honduras, incluyendo códigos QR, CAI válido y formato DEI.

Configurar CAI

Generar Factura

• Selecciona o crea un cliente (requiere nombre y RTN)
• Agrega productos/servicios con cantidades y precios
• Aplica impuestos (ISV 15% se calcula automáticamente)
• Haz clic en "Enviar al SAR" — se genera factura electrónica con QR
• Descarga PDF o comparte enlace directo al cliente

Gestión de Inventario

Control total de productos, almacenes y stock en tiempo real con alertas automáticas de stock mínimo.

Crear Producto

• Nombre: Nombre descriptivo del producto
• Código SKU: Código único de identificación
• Precio de compra: Costo de adquisición
• Precio de venta: Precio al público
• Stock mínimo: Nivel mínimo de alerta
• Almacén: Ubicación física del producto

Multi-Almacén

Administra múltiples ubicaciones físicas. Cada almacén tiene stock independiente y se pueden transferir productos entre ellos. Las transferencias quedan registradas en el historial con auditoría completa.

Contabilidad

Módulo contable completo con estados financieros, balances y reportes fiscales automáticos.

Funciones Principales

• Estado de Resultados por período
• Balance General
• Libro de Compras y Ventas
• Reporte de Retenciones
• Cálculo automático de ISV
• Conciliación Bancaria

Reportes

Genera reportes en PDF o Excel para declaraciones fiscales. El sistema integra directamente los datos de facturación SAR, eliminando el doble registro.

Nómina Hondureña

Cálculo automático de nómina con deducciones de ley hondureñas: IHSS, RAP, decimoctavo, decimocuarto.

Deducciones Automáticas

• IHSS: Instituto Hondureño de Seguridad Social — 2.5% salario, 1.5% patrono
• RAP: Retiro Alimentario para Pensionados — 1.5% empleado, 2% patrono
• Decimoctavo: Bono de 1 mes / 12 × días trabajados
• Decimocuarto: Bono de 1 mes / 12 × días trabajados
• ISR: Impuesto Sobre la Renta según tabla vigente

Asistente de Inteligencia Artificial

Portal Pilot integra modelos de IA local (sin enviar datos a la nube) para asistencia contable, generación de reportes y automatización inteligente.

Modelos Disponibles

Modelo	Uso Principal	Requisitos
Gemma 3N	Contabilidad, facturación, análisis financiero	4GB RAM, CPU moderna
Llama 3	Procesamiento de texto, generación de reportes	8GB RAM, CPU moderna
Mistral	Chat conversacional, asistencia general	4GB RAM, CPU moderna

Configurar

Ve a Configuración → IA y selecciona tu modelo. La primera ejecución descarga el modelo (~2-4GB). Después funciona 100% offline.

Modo Offline

Portal Pilot Workspace funciona completamente sin conexión a internet para operaciones esenciales.

Disponible Offline

• ✅ Crear y enviar facturas (se sincronizan al reconectar)
• ✅ Gestionar inventario
• ✅ Consultas contables
• ✅ Generar reportes
• ✅ Usar IA local (Gemma 3N)

Requiere Conexión

• ❌ Envío de facturas al SAR (se encola y envía al reconectar)
• ❌ Bots RPA y automatizaciones
• ❌ Sincronización multi-usuario
• ❌ Actualizaciones del sistema

Bots RPA Enterprise

Automatiza tareas repetitivas con bots de Robotic Process Automation. Crea agentes que ejecutan flujos de trabajo cuando ocurren eventos (emails, CRON, webhooks, manuales).

Crear tu primer Bot

Editor de Flujos (Flow Editor)

Editor visual drag & drop para construir pipelines de automatización con nodos conectados.

Tipos de Nodos

Nodo	Descripción	Ejemplo
Trigger	Punto de inicio del flujo	Email recibido, CRON, Webhook
Condición	Evalúa una expresión	Si monto > 1000 → ruta A
Delay	Espera un tiempo determinado	Esperar 5 minutos
Webhook	Envía HTTP request	Notificar a Slack, Telegram
DB	Operación en base de datos	Crear registro, actualizar stock
IA	Procesamiento con modelo	Clasificar email, extraer datos

Ejemplo: Auto-facturar desde email

Trigger (Email) → IA (Extraer datos) → Condición (¿Cliente existe?) 
  ├─ Sí → DB (Crear factura) → Webhook (Notificar)
  └─ No → DB (Crear cliente) → DB (Crear factura) → Webhook (Notificar)

Configuración de IA en Bots

Cada bot puede usar un modelo de IA diferente. Configura el modelo, temperatura y prompt del sistema.

Opciones de Configuración

• Modelo: Gemma 3N (recomendado), Llama 3, Mistral
• Temperatura: 0.0 (determinista) a 1.0 (creativo). Para contabilidad usa 0.0-0.2
• Prompt del sistema: Instrucciones específicas para el bot. Ej: "Eres un asistente contable. Extrae montos y conceptos de emails."
• Max tokens: Límite de respuesta del modelo (512-2048)

Triggers y Webhooks

Los triggers determinan cuándo se activa un bot. Webhooks permiten activar bots externamente.

Tipos de Trigger

Trigger	Descripción	Uso típico
Email	Se activa al recibir un email	Auto-facturar desde solicitudes
CRON	Ejecuta en horario programado	Reportes diarios, recordatorios
Webhook	HTTP POST a una URL	Integraciones externas
Manual	Activación manual desde UI	Tareas bajo demanda

Endpoint de Webhook

Cada bot genera una URL única tipo:

POST https://api.portalpilot.hn/webhook/bot/{bot_id}

Envía un POST con JSON y el bot procesará los datos según su flujo configurado.

Crear Serverless Function

Portal Pilot Serverless permite crear funciones backend personalizadas ejecutadas en la nube.

Desplegar Function

Haz clic en "Deploy" para publicar tu function. Se ejecuta en entorno aislado con escalado automático.

Monitoreo

• Logs en tiempo real desde la consola
• Métricas de invocaciones, latencia y errores
• Alertas por email si hay fallos

Autenticación API

Portal Pilot usa JWT (JSON Web Token) para autenticar peticiones API. El token se obtiene al iniciar sesión y se envía en cada petición.

Headers Requeridos

Authorization: Bearer <tu_token_jwt>
Content-Type: application/json

Login — Obtener Token

// Request
{
  "email": "usuario@empresa.com",
  "password": "tu_password"
}

// Response 200
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "abc123",
    "email": "usuario@empresa.com",
    "nombre": "Juan Pérez",
    "role": "admin"
  }
}

// Response 401
{ "error": "Credenciales inválidas" }

Refresh Token

Renueva el token JWT antes de que expire. Requiere autenticación.

// Response 200
{ "token": "eyJhbGciOiJIUzI1NiIs...(nuevo)" }

Registro

// Request
{
  "email": "nuevo@empresa.com",
  "password": "password123",
  "nombre": "María López",
  "empresa": "Mi Empresa S.A."
}

// Response 201
{ "message": "Cuenta creada. Verifica tu correo.", "userId": "abc123" }

Verificación de Email

Envía un código de verificación al correo registrado.

Recuperación de Contraseña

Envía un enlace de recuperación al correo. Rate limit: 3 req / 15 min.

Verifica el código de recuperación y restablece la contraseña.

Verificar Email Existente

// Response 200
{ "exists": true }

Health Check

Verifica el estado del servidor. No requiere autenticación.

// Response 200
{ "status": "ok", "uptime": 12345 }

Referencia de Endpoints

Todos los endpoints marcados con 🔒 requieren autenticación JWT en el header Authorization.

Tenants (Empresas)

Lista todas las empresas. Soporta paginación y búsqueda.

// Query params: ?page=1&limit=20&search=nombre
// Response 200
{
  "tenants": [{ "id": "abc123", "nombre": "TechCorp", "plan": "business", ... }],
  "total": 45,
  "page": 1,
  "pages": 3
}

Crea una nueva empresa.

// Request
{
  "nombre": "Nueva Empresa",
  "rtn": "0801-1234-567890",
  "direccion": "Tegucigalpa",
  "giro": "Comercio",
  "plan": "starter"
}

// Response 201
{ "id": "xyz789", "nombre": "Nueva Empresa", ... }

Obtiene los detalles de una empresa específica.

Actualiza los datos de una empresa. Puede enviar solo los campos a modificar.

// Request (parcial)
{ "plan": "business", "nombre": "TechCorp Actualizado" }

Elimina una empresa y todos sus datos. Operación irreversible.

Información de debug de una empresa (solo para diagnosticar problemas).

Usuarios

Lista todos los usuarios. Soporta paginación y búsqueda por nombre o email.

// Query params: ?page=1&limit=50&search=juan
// Response 200
{
  "users": [{ "id": "u123", "email": "juan@...", "nombre": "Juan", "role": "user", ... }],
  "total": 12,
  "page": 1
}

Obtiene los detalles de un usuario específico.

Crea un nuevo usuario. Requiere rol admin.

// Request
{
  "email": "nuevo@empresa.com",
  "password": "temporal123",
  "nombre": "Carlos López",
  "role": "user"
}

Actualiza un usuario (nombre, email, rol, avatar, banner). El usuario solo puede actualizar su propio perfil.

// Request
{ "nombre": "Carlos Actualizado", "role": "admin" }

Elimina un usuario. No se puede eliminar a uno mismo.

Archivos (Upload)

Sube archivos (avatars, banners) a Supabase Storage.

// Request: multipart/form-data
// Campo: file (imagen JPG/PNG, máx 5MB)
// Campo: type (opcional: "avatar" | "banner")

// Response 200
{ "url": "https://storage.supabase.co/..." }

Seguridad

Reporta un intento de acceso no autorizado. Rate limit: 10 req / 15 min.

// Request
{
  "email": "usuario@empresa.com",
  "ip": "190.100.50.xx",
  "reason": "Contraseña incorrecta"
}

Notificaciones (Bots)

Envía notificación de bienvenida al completar onboarding.

Envía notificación de activación de cuenta.

Diagnóstico

Estado detallado del sistema: Supabase, NocoDB, email, uptime. No requiere auth.

// Response 200
{
  "supabase": { "connected": true },
  "nocodb": { "configured": true },
  "email": { "configured": true },
  "uptime": 86400
}

Test Email

Envía un correo de prueba para verificar la configuración SMTP.

Configuración Pública

Información pública del servidor (versión, funcionalidades habilitadas). No requiere auth.

Comparar Planes

Elige el plan que mejor se adapte a tu negocio. Todos incluyen soporte por email y WhatsApp.

Característica	Starter (L.499/mes)	Business (L.1,499/mes)	Enterprise (L.4,999/mes)
Usuarios	3	10	Ilimitados
Facturas/mes	100	500	Ilimitadas
Inventario	1 almacén	5 almacenes	Ilimitados
Contabilidad	Básica	Completa	Completa + API
Nómina	—	✅	✅
IA Local	—	Gemma 3N	Gemma 3N + Llama 3
Bots RPA	—	—	Ilimitados
Serverless	—	3 functions	Ilimitadas
Soporte	Email	Email + WhatsApp	Prioritario 24/7
Modo Offline	✅	✅	✅