RRHH y Operaciones AY-032

Empleados Permiso 630

Catálogo del personal de planilla (módulo RH-001). Cada empleado guarda sus datos personales, laborales (puesto, departamento, fechas de ingreso/salida), salario base y por hora, método de pago (transferencia/SINPE, efectivo o cheque) con banco y cuenta, y los datos de CCSS y renta (si cotiza, créditos por hijos y cónyuge).

Detalles

• El código se genera automáticamente o lo podés escribir.
• Es un catálogo independiente del usuario de login: un empleado de planilla no necesita ser usuario del sistema.
• Si un empleado ya tiene movimientos de planilla, al "eliminarlo" se marca como egresado en vez de borrarse, para conservar el historial.

Conceptos de pago Permiso 638

Catálogo configurable (módulo RH-002) de los ingresos y deducciones que se usan en la planilla: horas extra, feriados, bonos, comisiones, viáticos, adelantos, préstamos, embargos, asociación solidarista, etc. Vienen varios cargados de fábrica y podés agregar los tuyos.

Banderas de cada concepto

• Si es ingreso o deducción.
• Si se calcula por monto fijo o por porcentaje del salario.
• Para los ingresos: si afecta la base de CCSS, la base de renta y/o el aguinaldo. Así, por ejemplo, las horas extra cotizan pero los viáticos no.

Tablas CCSS / Renta Permiso 633

Acá viven los porcentajes de cargas sociales y los tramos del impuesto sobre la renta al salario (módulo RH-003), configurables por vigencia. Ya vienen cargados los valores de Costa Rica 2026:

• CCSS obrera (trabajador): 10.83% (SEM 5.50% + IVM 4.33% + Banco Popular 1.00%).
• CCSS patronal (empresa): 26.83% (SEM, IVM, FODESAF, INA, IMAS, Banco Popular, FCL y pensión complementaria).
• Renta: exento hasta ₡918.000; luego 10%, 15%, 20% y 25% sobre el excedente de cada tramo. Créditos por hijo ₡1.710 y cónyuge ₡2.590.

Vigencias

Cuando la ley cambia las tarifas, el botón "Nueva vigencia" copia la actual con la fecha en que rige para que la edites. La planilla siempre usa la vigencia que corresponde a su fecha, así nunca queda desactualizada.

Cálculo de planilla Permiso 635

Procesa la nómina del período (módulo RH-004). Al crear una planilla indicás el tipo de período (mensual, quincenal o semanal) y las fechas; el sistema calcula automáticamente a todos los empleados activos: salario bruto, deducción de CCSS obrera, impuesto de renta, aportes patronales y el neto a pagar.

Conceptos por empleado

Abriendo cada empleado (con la flecha) podés agregarle conceptos del catálogo —horas extra, bonos, adelantos…— y el neto se recalcula al instante. El botón Recalcular vuelve a leer salarios y tarifas, conservando los conceptos que agregaste a mano.

Aplicar / Anular

Al Aplicar la planilla se genera el asiento contable automáticamente y queda definitiva (ya no se edita). Si hubo un error, se Anula y se crea de nuevo.

Colilla de pago Permiso 640

Comprobante de pago por empleado (módulo RH-008), listo para imprimir o guardar en PDF. Muestra el desglose de ingresos y deducciones, el neto a pagar, el método de pago y un espacio para la firma "recibí conforme".

Se puede generar para toda la planilla o para un empleado puntual, y se accede también desde el botón "Colillas" en el detalle de la planilla.

Estado de cuenta Permiso 641

Control de adelantos, préstamos, vales y abonos por empleado (módulo RH-006), con saldo al día. El saldo es lo que el empleado debe a la empresa (positivo) o lo que tiene a favor (negativo).

Cómo funciona

• La pantalla principal lista los empleados con su saldo. Al entrar a uno se ve el detalle de movimientos con saldo acumulado.
• Débito sube la deuda del empleado (adelanto, préstamo, vale).
• Crédito la baja (un abono, o una rebaja aplicada en la planilla).

Marcas de Reloj

Registro de asistencia de empleados: entradas, salidas y descansos. Es el reporte base para calcular horas laboradas y planilla.

Columnas

• Empleado (código + nombre)
• Fecha y hora de la marca
• Tipo: Entrada, Salida, Inicio descanso, Fin descanso
• Método: Manual, Huella, Rostro, Tarjeta
• Observaciones

Filtros

Por empleado, rango de fechas, tipo de marca, método.

Marcar Huella

Pantalla para que los empleados registren su asistencia usando huella digital.

Flujo

1. El empleado se acerca al lector de huella
2. Coloca el dedo registrado
3. El sistema valida contra la plantilla biométrica
4. Si coincide, registra la marca automáticamente (entrada o salida según corresponde)

Marcar Rostro

Alternativa biométrica usando reconocimiento facial. Ideal en entornos donde el lector de huella no funciona (manos sucias, húmedas, con guantes).

Cómo funciona

La cámara captura la cara, extrae características y compara contra las plantillas almacenadas. Si hay match, registra la marca.

Saldos de Vacaciones Permiso 626

Gestión de solicitudes de vacaciones, aprobaciones y cálculo de saldos disponibles. Esta pantalla muestra el saldo y el historial de cada empleado en una sola vista.

Flujo

1. Empleado solicita vacaciones (fechas + motivo)
2. El sistema verifica saldo disponible (días acumulados − días ya tomados)
3. Jefe directo aprueba o rechaza
4. Si se aprueba, se registran las fechas como ausencias justificadas
5. El saldo se actualiza automáticamente

Resumen: días disponibles por empleado

En la parte superior aparece un resumen con una tarjeta por empleado que muestra de un vistazo cuántos días le quedan disponibles en el año seleccionado. El color indica la situación: verde (tiene saldo), ámbar (le quedan 1 o 2 días) y rojo (sin días). Al hacer clic en una tarjeta se filtra el detalle de ese empleado.

• Solo aparece para usuarios que pueden ver a todos los empleados (permiso 627).
• No se muestran los empleados que tienen 0 días configurados en ese año (no se les ha asignado saldo de vacaciones).
• El resumen se actualiza al cambiar el año.

Cálculo de días

Según ley costarricense: 1 día por cada mes trabajado (14 días al año aproximadamente después de 50 semanas). La configuración puede ajustarse por política interna.

Registrar Huella (Enrolar)

Proceso de capturar y almacenar la huella de un empleado para poder usarla en las marcas.

Flujo

1. Seleccionar al empleado
2. Elegir el dedo (índice, medio, pulgar)
3. El empleado coloca el dedo en el lector 5 veces
4. El sistema construye una plantilla robusta combinando las 5 capturas
5. Se almacena la plantilla asociada al empleado

Configurar Kiosko de Huella BIO-001

El Kiosko de Huella Digital es una app independiente para Windows (descarga única en Menú → Herramientas → Huella Digital → Huella Digital Windows) que reemplaza al servicio C# anterior y al "Lite Client" de DigitalPersona. Una vez instalado y configurado, arranca solo al prender Windows y los empleados marcan poniendo el dedo en el lector.

Token de acceso (qué es)

El kiosko necesita un token para saber a qué empresa pertenece. El token tiene la forma <empresa>~<aleatorio> (ej.: invefacon~a1b2c3...). Se genera desde esta página (FactuPOS → Biometría → "Configurar Kiosko") con la sesión de la empresa abierta, y se pega en el kiosko (botón ⚙ Config dentro del kiosko, o archivo token.conf al lado del .exe).

Cómo generar un token

1. Entrar logueado a la empresa que va a usar el kiosko.
2. Ir a Menú → Biometría → "Configurar Kiosko".
3. Completar:
   • Identificador del puesto (ej. KIOSKO-RECEPCION) — útil para distinguir varios kioskos.
   • Descripción (opcional): a qué planta/oficina pertenece.
4. Botón Generar token. Aparece el token recién creado con dos opciones:
   • Copiar al portapapeles.
   • Descargar token.conf (baja un archivo de texto con el token; se pone al lado del .exe del kiosko).

Listado de tokens

Abajo se ve la tabla con todos los tokens generados para esta empresa: dispositivo, descripción, fecha de creación, último uso e IP. Cada fila tiene:

• Copiar el token de nuevo.
• Descargar token.conf.
• Desactivar / Activar — sin borrar la fila; el kiosko que usaba ese token deja de funcionar.
• Eliminar — borra la fila definitivamente.

Instalación del kiosko en el PC

1. Aplicar las migraciones 20260511104641 (tabla HuellaUsuario) y 20260511104642 (tabla KioskoToken) a la BD de la empresa, desde la pantalla de Migraciones del admin.
2. Descargar el .zip en Menú → Herramientas → Huella Digital → Huella Digital Windows.
3. Descomprimir en una carpeta local, ej. C:\Factupos\Biometria (no en una unidad de red mapeada con UAC).
4. Clic derecho en INICIAR.bat → "Ejecutar como administrador" la primera vez. Eso libera el lector (cierra el servicio C# viejo, agentes DigitalPersona, detiene "Servicio biométrico de Windows") y arranca el servicio + el kiosko.
5. La primera vez, en Chrome abrir https://127.0.0.1:52181/status y aceptar el certificado autofirmado (Avanzado → Continuar).
6. En la ventana del kiosko → botón ⚙ Config:
   • Pegar el token que generaste arriba.
   • Ajustar URLs del servidor (ej.: https://miempresa.factupos.com, https://factupos.com).
   • Marcar "Iniciar automáticamente al arrancar Windows" para que arranque solo en cada reinicio.
   • Guardar.
7. Registrar las huellas: botón ✋ "Registrar huella" → elegir empleado → poner el dedo 4 veces.

Cómo se marca después

El empleado pone el dedo en el lector → suena un beep ascendente → la ventana del kiosko se trae al frente un instante mostrando su nombre + ENTRADA / SALIDA. La marca queda en MarcaReloj y JornadaLaboral igual que cualquier otra marca del sistema. Si la huella no está registrada, el kiosko abre solo el diálogo para que el empleado elija su nombre y se registre en el momento (4 toques) y haga la marca automáticamente.

Requisitos del PC

• Runtime del DigitalPersona One Touch SDK instalado (es el mismo que ya usaba el servicio C# anterior — registra DPFPApi.dll, dpHFtrEx.dll, dpHMatch.dll y el servicio DpHostW).
• Lector DigitalPersona U.are.U 4500 conectado por USB.

Problemas comunes

• "No detecta el dedo" — algo (Windows Hello / servicio C# viejo) tomó el lector. Cerrá todo y abrí INICIAR.bat como administrador; eso ejecuta la limpieza automática.
• "WinError 10061: connection refused" al marcar/registrar — el servicio no está corriendo. Abrir INICIAR.bat (no el FactuposKiosko.exe directo; el .bat arranca los dos en orden).
• "404" al cargar empleados — la lista api_base tiene URLs que no existen o que no son FactuPOS. Ajustá las URLs desde ⚙ Config.
• Para ver el log: logs\error.log (servicio) y logs\kiosk-AAAA-MM-DD.log (kiosko).

Registrar Rostro

Enrolamiento facial. Se capturan varias fotos en diferentes ángulos para robustez.

Flujo

1. Seleccionar al empleado
2. Posicionarlo frente a la cámara con buena iluminación
3. Capturar fotos: frontal, ligera izquierda, ligera derecha
4. El sistema valida la calidad (nitidez, ángulo, oclusión)
5. Se generan embeddings que se almacenan

Activos Fijos

Catálogo de bienes depreciables de la empresa: computadoras, vehículos, maquinaria, mobiliario, edificios.

Ficha de activo

• Código y nombre del activo
• Categoría (computadoras, vehículos, mobiliario, etc.)
• Fecha de adquisición
• Costo de adquisición
• Vida útil en años
• Método de depreciación (línea recta, acelerada)
• Cuenta contable de activo
• Cuenta contable de depreciación acumulada
• Ubicación, responsable, estado

Depreciación mensual

El sistema calcula automáticamente la depreciación del período y genera el asiento contable cargando gasto de depreciación y acreditando depreciación acumulada.

Estados del activo

• Activo — En uso, sigue depreciándose
• Vendido / Baja — Se retira del balance
• Totalmente depreciado — Alcanzó su vida útil, valor neto = valor residual

Proyectos / Seguimiento

Herramienta de seguimiento de proyectos con tareas, avance e ingresos/gastos asociados. Útil para empresas de servicios que facturan por proyecto.

Estructura

• Proyecto — Nombre, cliente, fecha inicio/fin, presupuesto
• Tareas / Fases — Subdivisiones del proyecto
• Responsable — Usuario asignado a cada tarea
• Estado — Planificado, En progreso, Pausado, Completado

Control financiero

A cada proyecto se asocian:

• Facturas de venta (ingresos del proyecto)
• Facturas de compra y gastos (costos del proyecto)
• Horas hombre (si se usa time-tracking)

Al final se calcula la rentabilidad del proyecto: margen = (ingresos − costos) / costos.

Multi-Empresa / Corporativo

Gestión de varias empresas desde un mismo sistema. Cada empresa tiene su base de datos, su cédula jurídica, sus usuarios, pero comparten la misma instancia de FactuPOS.

Funcionalidades

• Cambiar entre empresas sin salir del sistema
• Reportes consolidados inter-empresa (ventas, compras, inventario)
• Traslados de inventario entre empresas (ver Inventarios → Traslados)
• Sincronización de catálogos (artículos, clientes, cuentas contables)

Sincronización entre empresas

Se configura desde Configuración → Sincronización Empresas. Permite definir qué datos se copian automáticamente de una empresa "maestra" a las demás (útil para grupos empresariales).

Consignaciones

Las consignaciones son mercadería entregada a un cliente sin facturar, que se factura conforme el cliente la vende o consume. Usado típicamente en distribución a detallistas.

Flujo

1. Se entrega mercadería a un cliente con un documento de consignación
2. La mercadería sale del inventario pero no genera factura
3. Periódicamente se visita al cliente y se cuenta lo vendido
4. Se factura lo consumido
5. El saldo restante queda en consignación

Proyectos de consignación

Cada cliente-consignación es un "proyecto" con su propio saldo. El reporte muestra cuánto hay en cada cliente, última visita, facturación del período.

Reservaciones

Agenda para reservar servicios: citas, turnos, mesas de restaurante, alquileres de salones, etc.

Campos de una reservación

• Fecha y hora (inicio y fin)
• Cliente
• Servicio reservado
• Recursos asignados (empleado, mesa, salón, equipo)
• Estado: Pendiente, Confirmada, Realizada, Cancelada
• Notas

Vista de calendario

El módulo presenta una vista de calendario (día, semana, mes) donde se visualizan las reservaciones. Permite detectar conflictos o huecos libres.

Reparaciones / Servicio Técnico

Gestión de órdenes de servicio técnico. Usado en talleres, servicios técnicos, mantenimiento.

Flujo

1. Recepción del equipo: cliente, modelo, serie, diagnóstico inicial
2. Presupuesto: repuestos + mano de obra
3. Aprobación del cliente
4. Ejecución: el técnico repara y registra avance
5. Finalización y prueba
6. Facturación y entrega

Estados de la orden

• Recibida
• En diagnóstico
• Pendiente aprobación
• En reparación
• Lista
• Entregada

Órdenes de Trabajo (OT)

Gestión de trabajos en campo: instalaciones, mantenimientos, visitas técnicas. Similar a Reparaciones pero para servicios fuera del taller.

Estructura

• Cliente y ubicación del servicio
• Fecha y hora programada
• Técnicos asignados
• Tareas a realizar (checklist)
• Materiales/repuestos
• Horas estimadas vs horas reales

Vista Kanban

Las OT se presentan como tarjetas en un tablero Kanban con columnas por estado: Por programar, Programada, En progreso, Finalizada, Facturada.