Loading Optiviera...

Documentación

Documentación de Optiviera

Todo lo que necesitas para gestionar tu empresa en una sola plataforma

Optiviera es una plataforma en la nube todo en uno ERP + CRM + HelpDesk. Esta página cubre todos los módulos, roles de usuario, conceptos clave y recursos para desarrolladores.

Navegación rápida

Ve directamente a la sección que necesitas

Primeros pasosMódulosRolesConceptos claveStack tecnológicoReferencia APIFAQ

Primeros pasos

En funcionamiento en minutos

1

Crea tu cuenta

Regístrate en /register para crear tu organización. Tu primer usuario recibe automáticamente el rol Admin.

2

Configura tu tenant

Ve a Configuración → Tenant para establecer el nombre de tu empresa, moneda, zona horaria, información fiscal e idioma preferido.

3

Configura los departamentos

Crea tu jerarquía organizativa en Configuración → Departamentos. Asigna puestos y vincula permisos a cada puesto.

4

Invita a tu equipo

Añade empleados en el módulo RR.HH. Asígnalos a departamentos y puestos para controlar automáticamente su acceso a los módulos.

5

Empieza a trabajar

Crea tu primer ticket, cliente u orden de venta. Todos los datos están completamente aislados en tu tenant desde el primer día.

Módulos de la plataforma

12 módulos integrados que cubren cada aspecto de tu negocio

Helpdesk & Tickets

Helpdesk de TI de extremo a extremo con seguimiento de SLA, gestión de prioridades y hilos de comentarios.

  • Creación & asignación de tickets
  • Seguimiento SLA & flujo de estados
  • Niveles de prioridad
  • Comentarios & archivos adjuntos
  • Vinculación con órdenes de trabajo
  • Exportación PDF/Excel
Ver documentación

CRM

Gestión completa del pipeline de ventas, desde la captación de leads hasta el cierre de oportunidades.

  • Base de datos de clientes
  • Seguimiento de leads
  • Pipeline de oportunidades
  • Métricas de rendimiento CRM
  • Vinculación con ventas & facturación
Ver documentación

Recursos humanos

Gestiona tu personal, departamentos, puestos, vacaciones y evaluaciones de rendimiento.

  • Datos & perfiles de empleados
  • Jerarquía de departamentos
  • Solicitudes & aprobaciones de vacaciones
  • Evaluaciones de rendimiento
  • Integración con nóminas
Ver documentación

Nóminas

Cálculo automatizado de salarios con reglas de nómina específicas por país, configuración fiscal y bloqueo de período.

  • Cálculo automatizado de nóminas
  • Conjuntos de reglas configurables
  • Gestión de impuestos & festivos
  • Bloqueo de período
  • Exportación de nóminas

Finanzas & Contabilidad

Contabilidad de doble entrada completa: facturas, pagos, asientos contables, conciliación bancaria y cierre de período.

  • Facturación AR & AP
  • Asientos & libro mayor
  • Conciliación bancaria
  • Informes fiscales & IVA
  • Cierre de período
  • Factura electrónica (DE/TR)
Ver documentación

Ventas

Gestiona el ciclo de ventas completo: presupuestos → pedidos → entregas → facturas.

  • Generador de presupuestos
  • Pedidos de venta
  • Seguimiento de entregas
  • Albaranes (PDF)
  • Facturación automática
Ver documentación

Compras

Solicitudes de compra, pedidos, recepciones de mercancías y conciliación de pedidos con proveedores.

  • Solicitudes de compra
  • Pedidos de compra
  • Gestión de proveedores
  • Seguimiento de recepciones
  • Conciliación de pedidos
Ver documentación

Inventario

Catálogo de productos, historial de movimientos de stock y alertas de stock mínimo.

  • Catálogo de artículos & SKU
  • Registro de movimientos de stock
  • Alertas de stock mínimo
  • Informes de inventario
  • Vinculación con ventas & compras
Ver documentación

Órdenes de trabajo

Crea y sigue órdenes de trabajo de campo o internas, vinculadas directamente a tickets del helpdesk.

  • Creación de órdenes de trabajo
  • Gestión de líneas
  • Seguimiento de estado
  • Asignación de empleados
  • Flujo Ticket → Orden de trabajo
Ver documentación

Informes & Análisis

Informes financieros, operativos y métricas de negocio integrados con exportación PDF/Excel.

  • Informes financieros (P&L, balance)
  • Análisis tickets & RR.HH.
  • Informes ventas & compras
  • Panel de KPI
  • Exportación PDF/Excel
Ver documentación

Usuarios & Permisos

Control de acceso basado en roles con gestión de permisos a nivel de puesto.

  • Roles Admin & Empleado
  • Permisos basados en el puesto
  • Granularidad por módulo
  • Soporte multilingüe
  • Gestión de avatar & perfil
Ver documentación

Operaciones (SuperAdmin)

Gestión de tenants a nivel de plataforma, salud del sistema, registros de auditoría y monitoreo. Limitado a cuentas @optiviera.com.

  • CRUD de tenants
  • Registros de auditoría de plataforma
  • Panel de salud del sistema
  • Métricas Prometheus/Grafana
  • Tickets de soporte de plataforma

Roles de usuario & Permisos

Control de acceso granular en cada módulo

Admin

Nivel tenant

Acceso completo a todos los módulos del tenant. Puede gestionar usuarios, configuración, facturación, departamentos y puestos.

  • Acceso a todos los módulos (ver, crear, actualizar, eliminar, exportar)
  • Gestión de usuarios & permisos
  • Configuración del tenant & facturación
  • Jerarquía de departamentos & puestos
  • Acceso a registros de auditoría

Empleado

Nivel tenant

Rol predeterminado para todos los miembros del personal. El acceso está determinado por los permisos asociados a su puesto.

  • Acceso a módulos según el puesto asignado
  • Crear & ver sus propios tickets
  • Añadir & editar sus propios comentarios
  • Ver perfil & actualizar preferencias
  • Sin acceso a facturación o configuración por defecto

SuperAdmin

Nivel plataforma

Solo personal de Optiviera (@optiviera.com / @optiviera.de). Acceso cross-tenant para administración y monitoreo de la plataforma.

  • Todos los datos de tenant (cross-tenant)
  • Crear / suspender / eliminar tenants
  • Métricas de plataforma & salud del sistema
  • Eliminación forzada de registros protegidos
  • Gestión de tickets de soporte de plataforma

Cada módulo admite permisos detallados: ver, crear, actualizar, eliminar, gestionar, exportar. Finance admite además postJournalEntry, approveInvoice, closePeriod. Payroll admite calculate, approve, lock. Los permisos se asignan por puesto en Configuración → Puestos.

Conceptos clave

Principios arquitectónicos fundamentales de la plataforma

Multi-tenant

Cada registro tiene un TenantId. Los datos están completamente aislados entre organizaciones a nivel de base de datos — ningún tenant puede acceder a los datos de otro.

Autenticación JWT

El inicio de sesión devuelve un JWT firmado (HS256). El token contiene userId y tenantId. Todas las llamadas a la API quedan automáticamente limitadas a tu tenant.

Permisos basados en el puesto

Los permisos están asociados a puestos (p. ej. 'Contable', 'Agente de soporte'). Asignar un empleado a un puesto le otorga instantáneamente el acceso correcto.

Registro de auditoría

Cada creación, actualización y eliminación queda registrada con instantáneas JSON antes/después, identidad del usuario, marca de tiempo y tipo de entidad.

i18n en 8 idiomas

La interfaz completa está disponible en inglés, alemán, francés, italiano, español, polaco, neerlandés y turco. Los usuarios establecen su idioma preferido en su perfil.

Bloqueo de período

Los períodos contables y de nómina se pueden bloquear para evitar cambios retroactivos. Los períodos bloqueados requieren SuperAdmin o un permiso de desbloqueo explícito.

Stack tecnológico

Moderno, escalable y seguro desde el diseño

Backend

  • ASP.NET Core 8Framework Web API
  • Entity Framework CoreORM con proveedor Pomelo MySQL
  • MySQL 8Base de datos relacional principal
  • JWT BearerAutenticación (HS256)
  • HangfireProcesamiento de tareas en segundo plano
  • Swagger / OpenAPIDocumentación API auto-generada

Frontend

  • Nuxt 3 / Vue 3Framework de aplicación SSR
  • PrimeVue 4Biblioteca de componentes UI (tema Aura)
  • PiniaGestión de estado
  • TypeScriptTipado estricto
  • @nuxtjs/i18nInternacionalización en 8 idiomas
  • SCSSTematización personalizada & design tokens

Observabilidad

  • PrometheusRecopilación de métricas
  • GrafanaPanel de control & alertas
  • PostHogAnálisis de producto
  • Audit LogsSeguimiento de cambios integrado

Integraciones

  • StripeSuscripción & facturación
  • SEPATransferencias EU (SEPA)
  • e-InvoiceConformidad factura-e DE/TR
  • PDF / ExcelExportación en todos los módulos

Referencia API

API RESTful con documentación Swagger/OpenAPI completa

Autenticación

  • POST /auth/register
  • POST /auth/login
  • GET /auth/me

Tickets

  • GET /tickets
  • POST /tickets
  • PUT /tickets/{id}
  • DELETE /tickets/{id}
  • GET /tickets/{id}/comments
  • POST /tickets/{id}/comments

Finanzas

  • GET /invoices
  • POST /invoices
  • GET /journal-entries
  • POST /journal-entries
  • GET /bank-accounts
  • POST /bank-reconciliation

RR.HH. & Nóminas

  • GET /employees
  • POST /employees
  • GET /departments
  • POST /payroll/calculate
  • GET /leaves
  • POST /leaves

Ventas

  • GET /sales-orders
  • POST /sales-orders
  • GET /quotations
  • POST /quotations
  • GET /deliveries
  • GET /customers

Compras

  • GET /purchase-orders
  • POST /purchase-orders
  • GET /suppliers
  • POST /goods-receipts
  • GET /purchase-requests

Inventario

  • GET /items
  • POST /items
  • GET /stock-movements
  • GET /items/low-stock

Configuración

  • GET /tenant
  • PUT /tenant
  • GET /permissions
  • GET /positions
  • GET /priorities
  • GET /users
URL base: https://optiviera.com/api
Autenticación: token JWT Bearer — incluye Authorization: Bearer [token] en cada solicitud. Todos los endpoints están limitados al tenant; el token transporta automáticamente el contexto.

Preguntas frecuentes

Respuestas a preguntas comunes

¿Pueden varias organizaciones usar la misma plataforma?
¿Cómo se asignan los permisos a los empleados?
¿Qué idiomas admite la plataforma?
¿Cómo funciona el seguimiento de SLA de los tickets?
¿Puedo exportar datos a Excel o PDF?
¿Qué es una orden de trabajo y cómo se relaciona con un ticket?
¿Cómo funciona el bloqueo de período contable?
¿Está la API disponible para integraciones externas?

¿Necesitas más ayuda?

Nuestro equipo está listo para ayudarte con cualquier pregunta sobre la plataforma.