Coati Payroll¶

Bienvenido a la documentación oficial de Coati Payroll, un sistema de administración de nóminas y planillas desarrollado por BMO Soluciones, S.A.

¿Qué es Coati Payroll?¶

Coati Payroll es una aplicación web diseñada para facilitar la gestión completa del proceso de nómina de una o múltiples empresas. El sistema permite:

Multi-empresa: Gestione nóminas para múltiples empresas o entidades desde una sola instalación.
Gestión de Empleados: Registro y administración completa de la información del personal.
Campos Personalizados: Extienda la información de empleados con campos personalizados definidos por el usuario.
Configuración de Conceptos de Nómina: Percepciones (ingresos), deducciones y prestaciones patronales.
Reglas de Cálculo: Motor de reglas con esquemas configurables para cálculos complejos como impuestos y seguridad social.
Planillas Flexibles: Configuración de diferentes tipos de planilla (mensual, quincenal, semanal).
Cálculo Automático: Motor de cálculo que procesa automáticamente salarios, deducciones e impuestos.
Procesamiento en Segundo Plano: Sistema de colas para nóminas grandes con feedback en tiempo real.
Préstamos y Adelantos: Control de préstamos a empleados con deducción automática de cuotas.
Multi-moneda: Soporte para múltiples monedas con tipos de cambio configurables.
Gestión de Vacaciones: Módulo robusto con políticas configurables, libro mayor auditable y acumulación automática.
Control de Acceso (RBAC): Sistema de permisos con tres roles: Admin, HHRR y Audit.
Sistema de Reportes: Reportes personalizados con permisos por rol y auditoría completa.
Internacionalización: Soporte multi-idioma para interfaz y contenidos.

Características Principales¶

📋 Gestión de Planillas¶

Las planillas son el elemento central del sistema. Una planilla conecta:

Empleados asignados
Percepciones (ingresos adicionales al salario)
Deducciones (descuentos del salario)
Prestaciones (aportes patronales)
Reglas de cálculo (impuestos, seguridad social)

💰 Cálculo de Nómina¶

El motor de nómina procesa automáticamente:

Percepciones: Se suman al salario base (bonos, comisiones, horas extras)
Deducciones: Se restan del salario bruto en orden de prioridad
Prestaciones: Costos patronales que no afectan el salario neto del empleado

🔄 Deducción Automática de Préstamos¶

El sistema deduce automáticamente:

Cuotas de préstamos aprobados
Adelantos salariales pendientes

La prioridad de estas deducciones es configurable por planilla.

Comenzando¶

¿Primera vez aquí?

Si es nuevo en Coati Payroll, comience con la Guía de Inicio Rápido para evaluar el sistema en 15-20 minutos. Esta guía le llevará desde la instalación hasta calcular su primera nómina con un ejemplo práctico.

Guía de Inicio Rápido

Instale el sistema y calcule su primera nómina en 15-20 minutos. Ideal para evaluar si Coati se ajusta a sus necesidades.

Inicio Rápido
Instalación

Aprende a instalar y configurar Coati Payroll en tu servidor.

Guía de Instalación
Primeros Pasos

Entiende los conceptos fundamentales y la estructura del sistema.

Primeros Pasos
Tutorial Completo

Sigue el tutorial paso a paso para configurar una nómina completa con todos los componentes.

Tutorial
Preguntas Frecuentes

Encuentra respuestas a las preguntas más comunes.

FAQ

Estructura del Sistema¶

El siguiente diagrama muestra cómo se relacionan los componentes principales del sistema:

graph TD
    EMP[Empresa] --> A[Empleados]
    EMP --> B[Planilla]
    A --> B
    C[Percepciones] --> B
    D[Deducciones] --> B
    E[Prestaciones] --> B
    F[Reglas de Cálculo] --> B
    B --> G[Nómina]
    H[Préstamos/Adelantos] --> G
    G --> I[Detalle por Empleado]
    J[Novedades] --> G

Flujo de Trabajo de Nómina¶

graph LR
    A[Ejecutar Nómina] --> B[Agregar Novedades]
    B --> C[Recalcular si es necesario]
    C --> D[Revisar y Aprobar]
    D --> E[Aplicar/Pagar]

Características Avanzadas¶

Sistema de Colas¶

Para nóminas grandes (más de 100 empleados por defecto), el sistema utiliza procesamiento en segundo plano:

Procesamiento paralelo: Los empleados se procesan de forma concurrente
Feedback en tiempo real: Progreso visible durante el cálculo
Doble backend: Dramatiq+Redis (producción) o Huey+Filesystem (desarrollo)
Selección automática: El sistema elige el mejor backend disponible

Más sobre el Sistema de Colas

Campos Personalizados¶

Extienda la información de empleados con campos adicionales:

Información médica (tipo de sangre, alergias)
Contactos de emergencia
Información bancaria adicional
Cualquier dato específico de su organización

Guía de Campos Personalizados

Reglas de Cálculo¶

Configure cálculos complejos usando esquemas estructurados:

Impuestos progresivos (IR)
Seguridad social con topes (INSS)
Bonos escalonados
Cualquier cálculo basado en tramos o tablas

Guía de Reglas de Cálculo

Gestión de Vacaciones¶

Módulo completo para gestionar vacaciones de empleados:

Políticas configurables: Adaptable a legislación de cualquier país
Libro mayor auditable: Trazabilidad completa de todos los movimientos
Acumulación automática: Se integra con el proceso de nómina
Múltiples métodos: Periódico, proporcional o por antigüedad
Carga de saldos iniciales: Importación individual o masiva desde Excel

Guía de Vacaciones | Documentación Técnica

Control de Acceso Basado en Roles (RBAC)¶

Sistema de permisos robusto con tres niveles de acceso:

Admin: Acceso completo al sistema incluyendo configuración y usuarios
HHRR: Gestión de personal y nóminas sin acceso a configuración del sistema
Audit: Acceso de solo lectura para auditorías y revisiones

Documentación RBAC

Sistema de Reportes¶

Reportes personalizados con control granular:

Reportes definidos por usuario: SQL personalizado o templates predefinidos
Permisos por rol: Control de acceso según tipo de usuario
Auditoría completa: Registro de todas las ejecuciones
Exportación múltiple: PDF, Excel, CSV

Internacionalización¶

Soporte multi-idioma integrado:

Interfaz traducible: Todos los textos de interfaz soportan traducciones
Babel integrado: Sistema de traducción con archivos .po/.mo
Fácil extensión: Agregue nuevos idiomas sin modificar código

Guía de Internacionalización | Guía de Traducciones

Licencia¶

Coati Payroll está licenciado bajo la Licencia Apache 2.0.

Soporte¶

Para reportar problemas o solicitar nuevas funcionalidades, por favor visite el repositorio en GitHub.