TimeTracker® v3.2

🚨 Advertencias Rápidas — Léelas Primero

Antes de empezar, guarda en tu memoria estos puntos críticos. Son los errores más frecuentes:

1 Introducción — ¿Qué es TimeTracker?

TimeTracker® v3.2 es una herramienta profesional de control de tiempo y facturación por proyectos. Está diseñada para autónomos, técnicos de campo y pequeñas empresas que necesitan:

• 🕐 Registrar el tiempo dedicado a cada cliente o empresa
• 📄 Generar partes de trabajo automáticamente
• 💶 Calcular la facturación en base a horas trabajadas, materiales y desplazamientos
• 📊 Obtener informes mensuales en Excel y PDF
• 📋 Exportar datos a sistemas de facturación externos

¿Cómo funciona?

El programa aparece como un panel flotante siempre visible en tu pantalla. Dentro, ves todas tus empresas o clientes. Con un clic en el botón de cada empresa, comienzas a cronometrar el tiempo dedicado. Al terminar, paras el contador. Todo queda registrado automáticamente.

Estructura de archivos del programa

Archivo / Carpeta	Para qué sirve	¿Crítico?
TimeTracker.exe	El programa principal	Sí
license.dat	Tu licencia activada y datos de hardware	🔴 CRÍTICO
data.json	Toda la configuración, historial y datos	🔴 CRÍTICO
data/	Logo de empresa y logs internos	Importante
iconos/	Iconos del programa	Menor
Facturación/	Facturas, albaranes y partes generados	Importante
backups/	Copias automáticas de data.json	Recomendado

2 Requisitos e Instalación

Requisitos del Sistema

Componente	Requisito
Sistema Operativo	Windows 10 / 11 (64 bits)
Espacio en Disco	~50 MB
RAM	512 MB (mínimo)
Permisos	Usuario estándar (Admin solo para inicio automático con Windows)

Proceso de Instalación

1. Copie la carpeta completa del programa a una ubicación permanente, por ejemplo C:\Herramientas\TimeTracker\.
2. Haga doble clic sobre TimeTracker.exe.
3. En el primer arranque, la aplicación creará automáticamente los directorios necesarios: backups/, REPORTES/, Partes/, Informes mensuales/.
4. Se generará automáticamente el archivo de datos data.json con la configuración predeterminada.

2 Primer Uso — Configuración Inicial

Paso 1 — Activar la Licencia

Sin licencia activa, el programa se ejecuta pero con funcionalidades limitadas. La activación es el primer paso obligatorio.

1. Abre el programa y haz clic en el botón ⚙️ (engranaje) en la barra superior
2. Ve a la pestaña "Licencia de Software"
3. Introduce tu código de activación en el campo de texto (el código se convierte automáticamente a mayúsculas)
4. Haz clic en el botón "ACTIVAR AHORA"
5. Si la activación es correcta, verás el mensaje de confirmación y el estado cambiará a ✅ LICENCIA ACTIVA

En la misma pestaña verás el Nº de Serie del Programa. Guárdalo. Es el identificador único de tu instalación que necesitarás si contactas con soporte técnico.

Paso 2 — Introducir datos de la empresa

Estos datos aparecerán en todos los documentos generados: albaranes, facturas y partes. Es fundamental que estén correctos.

1. En el diálogo de Configuración (⚙️), pestaña "Licencia de Software"
2. Haz clic en "✏️ Editar datos de usuario"
3. Rellena todos los campos: nombre de empresa, NIF/CIF, dirección, CP, ciudad, provincia, teléfono, email
4. Si generas facturas, introduce también el IBAN bancario
5. Guarda los cambios

Paso 3 — Configurar el logotipo

1. En la pestaña "Licencia de Software", haz clic en "🖼️ Cambiar logo"
2. Selecciona un archivo de imagen (PNG, JPG, BMP)
3. El programa redimensiona automáticamente la imagen al tamaño adecuado para documentos
4. El logo aparecerá en albaranes, facturas y partes generados

Paso 4 — Configurar parámetros de facturación

Este paso es crítico. Sin él, todas tus horas se facturarán a 0€.

1. En Configuración (⚙️), ve a la pestaña "Facturación"
2. Configura el Precio por hora por defecto (tarifa estándar que se aplicará a todos los servicios)
3. Configura el IVA aplicable
4. Si tienes tarifas distintas por empresa, podrás ajustarlas individualmente al crear cada servicio

3 Configuración Completa

Accede a toda la configuración haciendo clic en ⚙️ en la barra superior del programa. Encontrarás las siguientes pestañas:

Pestaña: General

Ajustes de apariencia y comportamiento del programa:

• Color de fondo: personaliza el color del panel principal
• Escala / Tamaño: ajusta el tamaño del panel
• Tiempo de inactividad: el programa puede detectar que no estás trabajando y pausar automáticamente
• Exportar / Importar datos: puedes exportar tus datos a JSON para hacer copias de seguridad manuales o para importar desde otro dispositivo

Pestaña: Empresas (CSV)

Gestiona las empresas o clientes a los que facturas tiempo:

• Añadir empresa: crea una nueva empresa con nombre, iniciales y color identificativo
• Editar empresa: modifica datos de una empresa existente
• Eliminar empresa: desactiva una empresa (sus registros históricos se conservan)
• Cambiar color/iniciales: personaliza la apariencia del botón de esa empresa
• Editar clientes/usuarios: cada empresa puede tener múltiples usuarios o departamentos asociados

Pestaña: Dpto/Usuario (CSV)

Define los usuarios o departamentos que pueden generar actividad dentro de cada empresa. Útil para diferenciar entre distintos contactos o áreas de un mismo cliente.

Pestaña: Partes

Gestiona y genera partes de trabajo y reportes mensuales. Ver sección «Uso Diario» para el detalle completo.

Pestaña: Facturación

Configuración de todos los parámetros económicos:

Parámetro	Descripción
Precio €/hora por defecto	Tarifa base aplicada a todos los servicios
IVA (%)	Porcentaje de IVA aplicado en albaranes y facturas
IBAN	Aparece en las facturas como forma de pago
Coste desplazamiento	Importe fijo o por km que se añade al servicio
Recargo urgencia	Porcentaje adicional para servicios urgentes

Pestaña: Licencia de Software

Gestiona tu licencia, datos de empresa y logotipo. Ver sección «Primer Uso» para el proceso completo. Además, en esta pestaña encontrarás el botón:

5 Uso Diario del Programa

Pantalla Principal — Vista General

Al abrir el programa aparece la ventana principal con fondo translúcido oscuro. La interfaz está dividida en las siguientes zonas:

Zona	Descripción
Barra Superior	Icono de la app + título «⏱️ TimeTracker® v3.2» + botón ❓ Manual + ⚙️ Configuración + — Minimizar + ✕ Cerrar
LED de Estado	🟢 Trabajando / 🟡 Pausa / 🔴 Detenido
Barra de Aviso	Muestra el estado actual con colores pulsantes: «▶️ TRABAJANDO», «⏸️ EN PAUSA» o «⚠️ TIEMPO DETENIDO»
Barra de Totales	Resumen en vivo: Total trabajo | Total pausas | Facturable. Botones rápidos: Excel diario (🟢), Excel mensual (🔵), Pausa (⏸), Reanudar (▶)
Área Central (Flow)	Tarjetas translúcidas de cada empresa con: reloj, botón de iniciales, filtro de búsqueda, desplegable de clientes
Registro de Actividad	Panel inferior con el historial cronológico del día actual. Botón ➕ para añadir registros manuales.
Pie / Firma	Copyright del autor + grip de redimensión

Cómo Iniciar y Detener el Tiempo

Iniciar un Cronómetro

1. Localiza la tarjeta de la empresa en el panel principal.
2. Selecciona el departamento/usuario en el desplegable de la tarjeta. Puedes usar el campo «🔍 Filtrar…» para buscar rápidamente.
3. Haz clic en el botón circular (con las iniciales de la empresa).
4. Aparecerá el diálogo «Iniciar Seguimiento» donde debes:
   • Escribir el motivo del trabajo (campo obligatorio). El sistema ofrece autocompletado predictivo basado en motivos anteriores.
   • Indicar si el trabajo es facturable (SÍ/NO).
5. Pulsa ▶ Iniciar.

Detener el Cronómetro

Para detener, simplemente haz clic de nuevo en el mismo botón circular de la empresa activa. El sistema:

• Guardará la sesión automáticamente en data.json.
• Actualizará los reportes Excel (diario + mensual).
• Mostrará la sesión en el Registro de Actividad inferior.

Cambio de Cliente en Caliente

Si tienes el tiempo corriendo y cambias el desplegable de cliente en la misma empresa, el sistema realiza un switch automático: cierra la sesión actual con el cliente anterior y abre una nueva con el cliente seleccionado, sin perder tiempo.

Sistema de Pausas

Cuando tienes el cronómetro activo, pulsa el botón ⏸ naranja en la barra de controles. Se abrirá el diálogo de pausa con las siguientes opciones predefinidas:

Icono	Tipo de Pausa
☕	Descanso
🍔	Comida
👥	Reunión
📞	Llamada
✉️	Emails
🔧	Técnico
⏳	Esperando Info
🎓	Formación
🚗	Desplazamiento
❓	No especificado

También puedes escribir un motivo libre en el campo de texto inferior. Al pausar, el tiempo de trabajo se detiene y comienza a contar el tiempo de pausa por separado.

Para reanudar, pulsa el botón ▶ verde. El sistema cerrará la pausa y reabrirá el cronómetro con la misma empresa y motivo.

Registro de Actividad (Historial Vivo)

En la parte inferior de la pantalla principal se encuentra el panel «📋 REGISTRO DE ACTIVIDAD» que muestra en tiempo real todas las sesiones del día actual. Cada entrada presenta:

• Hora inicio – Hora fin del fragmento.
• Icono de estado: ▶ (trabajo) o ⏸ (pausa).
• Nombre de la empresa y cliente/departamento (en texto legible, no IDs internos).
• Motivo del trabajo o tipo de pausa.

Los registros se agrupan automáticamente si empresa y motivo coinciden en sesiones consecutivas. El código de colores es:

Color	Significado
Verde	Sesión activa (en curso)
Naranja	Pausa
Rojo	Registro manual (entrada añadida a mano)
Blanco/Negro	Registro automático finalizado

Añadir Registros Manuales

Si olvidaste iniciar el cronómetro o necesitas registrar tiempo pasado, pulsa el botón ➕ ubicado a la izquierda de la cabecera del Registro de Actividad. Se abrirá el formulario «Añadir Registro Manual» con los siguientes campos:

1. Fecha (formato dd/mm/aaaa): Por defecto, la fecha actual.
2. Hora de Inicio y Hora de Fin (formato HH:MM).
3. Empresa: Desplegable con todas las empresas registradas.
4. Cliente/Proyecto: Desplegable que se actualiza según la empresa seleccionada.
5. Motivo de trabajo: Con autocompletado predictivo.
6. Tipo de pausa (opcional): Si deseas registrar una pausa pasada.
7. ¿Es facturable?: SÍ / NO.

Al pulsar «💾 Guardar Registro», la entrada se añade inmediatamente al historial y se regeneran los Excel.

Exportar a Excel

• Excel Diario (botón verde 📊): exporta los registros del día actual
• Excel Mensual (botón azul 📊): exporta todos los registros del mes actual, incluyendo el Dashboard de análisis y la pestaña Gerencia

Generar Partes de Trabajo

1. Abre Configuración (⚙️) → pestaña "Partes"
2. Selecciona el mes y el filtro de empresa / cliente
3. La tabla mostrará todos los registros del periodo
4. Selecciona el registro que quieres documentar
5. Haz clic en "Generar Parte Word" para crear el documento en formato .docx
6. O usa "Generar Parte Manual" para una entrada libre
7. Los partes se guardan automáticamente en la carpeta Facturación/

Generar Informe PDF Mensual

1. En la pestaña "Partes", selecciona el mes deseado
2. Haz clic en "Generar Informe PDF"
3. El PDF incluirá: KPIs de producción, gráficos de facturación, análisis por cliente y desglose de estados
4. Se guardará en la carpeta Facturación/ del mes correspondiente

🗑️ Borrar un Servicio desde la Pestaña Partes

Es posible eliminar un servicio directamente desde la tabla de Partes usando el menú contextual (clic derecho). Esta opción borra el servicio de forma completa y consistente en todos los sistemas.

Estados y permisos de borrado

Estado	¿Se puede borrar?	Acción recomendada
PENDIENTE	✅ Sí	Borrado directo disponible
NO FACTURABLE	✅ Sí	Borrado directo disponible
ALB. BORRADOR	❌ No	Revertir a PENDIENTE desde Facturación
ALBARANADO	❌ No	El albarán ya fue emitido
FACTURADO	❌ No	La factura ya fue generada
BLOQUEADO	❌ No	Ciclo cerrado e inamovible

Cómo borrar un servicio paso a paso

1. Abre Configuración (⚙️) → pestaña «Partes»
2. Selecciona el mes en el desplegable
3. Haz clic derecho sobre la fila del servicio que quieres eliminar
4. En el menú contextual selecciona 🗑️ Borrar servicio
5. El sistema muestra un diálogo de confirmación con los detalles del servicio
6. Si el servicio tiene un parte generado, se te avisará específicamente — el archivo DOCX también será eliminado
7. Confirma con «Sí» para proceder al borrado

Qué se elimina exactamente

• 🗑️ Todos los registros del servicio del historial JSON (incluyendo sesiones agrupadas)
• 🗑️ Las pausas intercaladas vinculadas al servicio
• 🗑️ El archivo DOCX/PDF del parte del disco (si fue generado)
• 🔄 Re-exportación automática del Excel de partes y facturación

Módulo de Facturación

Accede desde Configuración (⚙️) → pestaña "Facturación". Usa el botón ? (esquina superior derecha) para ver la ayuda contextual completa en cualquier momento.

Estado	Significado
PENDIENTE	Tiempo registrado, aún sin albaranar
ALB. BORRADOR	Albarán en proceso de revisión; precios congelados
ALBARANADO	Albarán emitido con número oficial
FACTURADO	Factura externa generada (Holded / FACe)
NO FACTURABLE	Trabajo registrado pero sin coste económico
BLOQUEADO	Ciclo cerrado; registro inmutable

Flujo para generar un albarán

1. Selecciona un servicio en estado PENDIENTE
2. Haz clic en ✅ Revisar (Borrador) — los precios quedan congelados
3. El diálogo 🛠️ Editar Servicio se abre automáticamente para revisar importes
4. Cierra el diálogo y haz clic en 🧾 Generar Albarán
5. El sistema asigna un número único y crea el DOCX en Facturación/

📱 Importar desde App Móvil (JSON)

Los registros creados con la app Android de TimeTracker se exportan como JSON y pueden importarse directamente en el programa de escritorio:

1. En la app móvil, exporta los registros como archivo .json
2. Transfiere el archivo al PC (correo, USB, nube…)
3. En TimeTracker de escritorio: Configuración (⚙️) → General → "Importar JSON de App Móvil"
4. Selecciona el archivo descargado
5. El sistema importa todos los registros y los vincula automáticamente con las empresas y clientes existentes

Campo del JSON	Comportamiento en la importación
empresa_id / cliente_id	Se usan para vincular la empresa y cliente. Si no existen, se crean automáticamente.
materiales_detalle	Se importa como líneas independientes en el grid de Materiales/Componentes (una fila por artículo, con cantidad).
materiales	Solo se usa si no existe materiales_detalle. Se carga como texto libre en una sola fila.
km	Se pre-rellena en el campo KM de «Editar Servicio», pero el usuario debe activar «Desplazamiento por KM» manualmente.
observaciones	Siempre como texto plano. Nunca se mezcla con datos estructurados.

6 Edición de Datos — Historial vs Servicio

Resumen de cuándo usar cada uno

Situación	Qué usar
Me equivoqué en la hora de inicio o fin	✅ Editar Historial
Asigné mal la empresa o el cliente	✅ Editar Historial
Quiero cambiar la descripción del trabajo	✅ Editar Historial
Quiero añadir/editar materiales con cantidad y precio	✅ Editar Historial (grid de Materiales)
Quiero cambiar el precio/hora del servicio	✅ Editar Servicio
Quiero facturar el desplazamiento por kilómetros	✅ Editar Servicio → Desplazamiento por KM
Quiero marcar como Albaranado o Facturado	✅ Editar Servicio
Quiero aplicar un descuento en este servicio concreto	✅ Editar Servicio

🛣️ Desplazamiento por KM — Nueva Funcionalidad

Permite facturar el desplazamiento en función de los kilómetros realizados, en lugar de usar un precio fijo global o manual. Es la opción de mayor prioridad: cuando está activa, ignora completamente el precio de desplazamiento manual y el global de configuración.

Cómo usarlo paso a paso

1. Abre Editar Servicio en la pestaña Facturación
2. Asegúrate de que el campo Desplazamiento del registro está marcado como «SI (facturable)» (se configura en Editar Historial)
3. En la sección «Precios Personalizados», marca la casilla 🛣️ Desplazamiento por KM
4. Introduce el número de KM realizados
5. Introduce el Precio por km (ej: 0,25 €/km)
6. El sistema muestra el cálculo en tiempo real: = 120 km × 0,250 €/km → 30,00 €
7. Guarda — el albarán generado mostrará: «Desplazamiento 120 km x 0,25 €/km»

Método	Prioridad	Cuándo aplica
🛣️ Desplazamiento por KM (activo)	🥇 Máxima	Checkbox marcado + KM y €/km > 0
Precio manual de desplazamiento	🥈 Media	Valor > 0 en «Desplazamiento» (€)
Precio global de configuración	🥉 Mínima	Sin ningún ajuste manual

🔧 Materiales por Línea — Grid de Materiales/Componentes

Los materiales utilizados en un servicio pueden registrarse con total detalle: artículo, cantidad y precio unitario. Cada uno aparece como una línea independiente en el albarán generado.

Desde el programa de escritorio

1. Abre Editar Historial (doble clic en el registro del historial)
2. En la sección «Materiales / Componentes», usa el grid editable
3. Cada fila permite: nombre del artículo, cantidad y precio unitario
4. Los botones ➕ y ➖ añaden y eliminan filas
5. Al guardar, los materiales quedan vinculados al registro

Desde la app móvil (importación)

Cuando la app móvil exporta registros con el campo materiales_detalle (formato estructurado), cada artículo se importa automáticamente en una línea independiente del grid, con su cantidad correcta. El campo materiales (texto libre) solo se usa como alternativa si materiales_detalle no está presente.

7 Apariencia: Color, Opacidad y Escala

Dentro de Configuración → General, la sección «Apariencia» permite personalizar completamente el aspecto visual de la aplicación:

• 🎨 Color de Fondo: Abre un selector de color para cambiar el fondo de la ventana principal. El texto se ajusta automáticamente (blanco sobre fondos oscuros, negro sobre claros).
• 🔡 Cambiar Color/Iniciales: Seleccione una empresa en la tabla y modifique el color de su botón y las iniciales (máximo 3 letras).
• Slider Opacidad (30–100%): Controla la transparencia de la ventana principal. Los cambios se aplican en tiempo real.
• Slider Escala (50–120%): Ajusta el tamaño de las tarjetas de empresa, botones, fuentes y elementos de la interfaz. Los cambios se aplican en tiempo real sin reinicio.
• ↩️ Restablecer Estética Segura: Vuelve a los valores por defecto (fondo azul oscuro #00007f, opacidad 100%, escala 100%).

8 Reportes Excel Automáticos

TimeTracker genera automáticamente archivos Excel con 4 hojas:

Hoja	Contenido
Registros (Día/Mes)	Fecha, Día, Semana, Empresa, Dpto/Usuario, Motivo, Tipo Entrada, Facturable, Desplazamiento, Materiales, Observaciones, Hora Inicio, Hora Fin, Duración Total, Duración Decimal. Incluye fórmula SUBTOTAL automática en la columna Duración Decimal.
Pausas	Fecha, Empresa, Hora Inicio/Fin, Motivo, Duración, Duración Decimal.
Dashboard	Tablas resumen y gráficas circulares de distribución por empresa y por cliente.
Facturación	Empresa, Dpto/Usuario, Horas Decimales Facturables, con fórmula SUM total.

Los anchos de columna se ajustan automáticamente al texto de las cabeceras. Las entradas manuales se resaltan en rojo, las importadas en verde claro, y las filas alternas tienen fondo azul claro.

Archivos Generados

• Diario: REPORTES/YYYY/MM_mes/[Usuario]_Reporte_tiempos_YYYY-MM-DD.xlsx
• Mensual: REPORTES/YYYY/MM_mes/[Usuario]_Reporte_tiempos_mes_de_[Mes].xlsx

Se regeneran automáticamente cada 5 minutos, al iniciar/detener tiempo, y al cerrar la aplicación.

9 Sistema de Inactividad Inteligente (Smart Idle)

TimeTracker monitoriza la actividad del teclado y ratón del sistema operativo para ofrecer dos niveles de protección contra olvidos:

Pausa Automática por Inactividad (>10 minutos)

Si tienes el cronómetro activo y no tocas el PC durante más de 10 minutos, el sistema pausará automáticamente la sesión con motivo «Inactividad (Sistema >10m)» y te preguntará si deseas reanudar al volver.

Recordatorio Smart Idle (Estado Pausa/Detenido)

Si el programa está en estado PAUSA o DETENIDO y detecta actividad del usuario en el PC (inactividad < 5 seg), lanza un recordatorio visual:

«Se ha detectado actividad, pero el tiempo está parado
¿Revisa el programa si deseas reanudar el registro?»

El recordatorio ofrece opciones de delay: 1 min, 3 min, 5 min, o «No volver a mostrar hasta reiniciar».

Alertas de Salud

• ⚠️ 2 horas continuas: Muestra un Toast naranja recordando levantarse, estirar y beber agua.
• ⚠️ Pausa >15 min: Notifica que el proyecto lleva pausado demasiado tiempo.

10 Bandeja del Sistema (Tray Icon)

Al minimizar o ejecutar, la aplicación muestra un icono en la bandeja del sistema de Windows con las siguientes características:

• Icono dinámico: Muestra visualmente el estado: tiempo transcurrido sobre el icono (trabajando), «⏸ PAUSA» pulsante (pausa), o «⚠ DETENIDO» pulsante (detenido).
• Tooltip: Al pasar el ratón: Empresa / Estado / Tiempo.
• Menú contextual: Clic derecho → «Mostrar» o «Salir».
• Doble clic: Restaura la ventana principal.

11 Copias de Seguridad y Licencia

El archivo license.dat — Tu licencia

Este archivo contiene:

• Tu código de licencia activado
• Los datos de hardware de tu equipo (CPU, disco, red)
• La fecha de activación
• El tipo de licencia (permanente o temporal)

Reglas obligatorias sobre license.dat

El archivo data.json — Todos tus datos

Este archivo contiene todo tu historial de trabajo, configuración, empresas, clientes y preferencias. Si se pierde, perderás todos tus registros históricos.

Cómo hacer una copia de seguridad manual

1. Cierra el programa antes de copiar para asegurarte de que los datos están guardados
2. Ve a la carpeta donde está TimeTracker.exe
3. Copia los archivos: license.dat, data.json
4. Copia también la carpeta Facturación/ si quieres conservar los documentos generados
5. Pégalos en una ubicación segura (USB, carpeta en la nube, etc.)

También puedes exportar tus datos desde dentro del programa: Configuración (⚙️) → General → "Exportar JSON".

12 Cómo Actualizar el Programa

Actualizar TimeTracker es muy sencillo y completamente seguro para tu licencia y datos, siempre que sigas estas instrucciones:

¿Qué pasa si instalo en una carpeta diferente?

Si por cualquier razón instalas el nuevo .exe en una carpeta diferente, debes copiar manualmente los archivos críticos:

• license.dat
• data.json
• Carpeta data/ (contiene el logo)
• Carpeta Facturación/ (si quieres conservar documentos anteriores)

13 Resolución de Problemas y Errores Comunes

🔴 El programa dice que la licencia no es válida o ha cambiado

Solución:

• Si has cambiado componentes físicos del equipo, necesitarás una nueva activación. Contacta con soporte técnico con el Nº de Serie del Programa
• Si no has cambiado hardware, verifica que license.dat existe en la misma carpeta que el ejecutable y no ha sido modificado
• Si hiciste una copia de seguridad, restaura el license.dat original

🔴 He borrado license.dat accidentalmente

Solución:

• Primero revisa la Papelera de Reciclaje de Windows — si está ahí, restáuralo
• Si tienes una copia de seguridad, cópiala de vuelta a la carpeta del programa
• Si no tienes copia → necesitarás un nuevo código de activación. Contacta con soporte

🔴 Los albaranes o facturas muestran 0€ o datos en blanco

Solución:

• Ve a Configuración (⚙️) → Licencia de Software → "Editar datos de usuario" y comprueba que todos los campos están rellenos
• Ve a Configuración (⚙️) → Facturación y verifica que el Precio €/hora no es 0
• Los documentos ya generados no se actualizan automáticamente — tendrás que regenerarlos

🔴 El logo no aparece en los documentos

Solución:

• Ve a Configuración (⚙️) → Licencia de Software → "🖼️ Cambiar logo"
• Selecciona de nuevo el archivo de imagen
• Verifica que el archivo existe en la carpeta data/logo.png
• Si tras actualizar el programa el logo desapareció, copia manualmente la carpeta data/ desde la instalación anterior

🔴 Modifiqué las horas de un servicio y el albarán tiene un importe diferente

Causa: Has usado "Editar Historial" (modifica horas reales) pero el albarán que ya se generó tiene los importes antiguos.

Solución:

• Si el albarán aún no se ha enviado al cliente, regenera el documento desde Facturación
• Si ya se envió, lo correcto es emitir un documento rectificativo
• Para evitar esto: no modifiques horas de servicios ya albaranados

🔴 Tras actualizar el programa, los datos han desaparecido

Solución:

• Localiza la carpeta donde estaba la instalación anterior y copia data.json a la nueva ubicación
• Si tienes copias en backups/, usa la más reciente
• Si usaste la función "Exportar JSON", importa ese archivo desde Configuración → General → "Importar JSON"

🔴 El programa no abre o se cierra inmediatamente

Pasos a seguir:

1. Verifica que license.dat existe y no ha sido modificado
2. Comprueba que no tienes una versión anterior del programa abierta (busca en la bandeja del sistema)
3. Si el problema persiste tras una actualización, restaura el .exe anterior temporalmente
4. Contacta con soporte indicando el mensaje de error exacto que aparece

🔴 El tiempo no se registra correctamente / hay desfase en las horas

Causas posibles:

• El equipo entró en suspensión mientras el cronómetro estaba activo → el tiempo suspendido no se cuenta
• Se modificó manualmente el reloj del sistema

Solución: Usa "Añadir registro manual" (botón ➕) para corregir o completar el tiempo que falta. Posteriormente, "Editar Historial" para ajustar los horarios exactos.

🔴 El archivo Excel está bloqueado y no se puede guardar

Causa: El archivo .xlsx está abierto en Microsoft Excel u otro programa.

Solución:

• Cierra el archivo en Excel.
• TimeTracker habrá guardado automáticamente una copia con sufijo _COPIA_XXXX.xlsx en la misma carpeta.
• El siguiente ciclo de exportación (cada 5 minutos o al parar el cronómetro) regenerará el archivo principal.

🔴 Aparece el error «TRIAL_LIMIT» — versión de prueba limitada

Causa: La versión de prueba permite un máximo de 20 registros y se ha alcanzado ese límite.

Solución: Activa tu licencia desde Configuración (⚙️) → pestaña «Licencia de Software» → introducir el código de activación y pulsar «ACTIVAR AHORA».

🔴 No se genera el parte de trabajo en Word

Causa: Falta la plantilla parte_trabajo.docx.

Solución:

• Verifica que el archivo parte_trabajo.docx existe en la carpeta Partes/ o en la raíz del programa.
• Si lo has borrado accidentalmente, cópialo desde una instalación anterior o solicítalo al soporte técnico.

🔴 No aparecen empresas en la pantalla principal

Causa: No hay empresas registradas en data.json.

Solución: Ve a Configuración (⚙️) → «Empresas (CSV)» → Añadir empresa, o importa desde Excel usando el botón «📥 IMPORTAR DESDE EXCEL».

📋 Tabla Rápida de Diagnóstico

Síntoma	Causa más probable	Acción
«Licencia inválida» al iniciar	Hardware cambiado o license.dat corrupto	Restaurar copia o contactar soporte
Albarán con 0€	Precio/hora = 0	Configurar precio en Facturación
Nombre en blanco en documentos	Datos de empresa no configurados	Editar datos de usuario en Licencia
Sin logo en documentos	Archivo logo.png no existe	Recargar logo en Configuración
Datos perdidos tras actualización	Nueva carpeta sin data.json	Copiar data.json desde carpeta anterior
Importe incorrecto en albarán	Horas editadas después de albaranar	Regenerar documento desde Facturación
El programa no arranca	license.dat dañado o ausente	Restaurar license.dat desde copia
Excel bloqueado al exportar	Archivo .xlsx abierto en Excel	Cerrar Excel; se habrá guardado copia _COPIA_XXXX.xlsx
Error «TRIAL_LIMIT»	Versión de prueba con 20+ registros	Activar licencia en Configuración → Licencia de Software
No se genera el parte Word	Falta plantilla parte_trabajo.docx	Verificar que existe en Partes/ o raíz del programa
Sin empresas en pantalla principal	data.json sin empresas registradas	Ir a Configuración → Empresas → Añadir o importar Excel
CSV Holded con 1 sola línea y sin materiales	Versión anterior del exportador	Actualizar el programa a v3.2 — ahora genera 1 fila por artículo
Descuadre de 1 céntimo en FACe	TaxAmount calculado sobre base global	Actualizar a v3.2 — el IVA de cabecera ya se suma por línea
Error de PersonTypeCode «J» en autónomo	Tipo de persona no detectado automáticamente	Actualizar a v3.2 — se detecta auto por formato DNI/NIE/CIF

14 📤 Exportaciones Holded y FACe — Novedades v3.2

La versión 3.2 corrige y mejora los tres pilares del módulo de exportación a sistemas externos: el importador Holded (CSV/XLSX) y el generador de XML Facturae 3.2.2 para FACe.

🧾 Holded CSV/XLSX — Exportación por artículo (una fila por línea)

En versiones anteriores, el CSV de Holded generaba una única fila por servicio que sumaba mano de obra + materiales en un solo importe. Esto impedía que Holded reconociera el desglose de artículos.

Líneas que genera el exportador por cada servicio

Línea	Concepto en Holded	Base
1	Mano de obra (motivo del servicio)	Horas × €/hora
2…N	Cada material del grid (nombre del artículo)	Cantidad × precio unitario
N+1	Coste de Materiales adicionales (no detallados)	Importe numérico global
N+2	Desplazamiento (con km y €/km si aplica)	Importe calculado
N+3	Recargo por urgencia	Importe de urgencia
N+4	Descuento aplicado	Importe negativo

Estructura del CSV generado

Columna	Descripción
Number	Número de factura/albarán — idéntico en todas las filas del mismo documento
Date	Fecha de emisión (formato dd/mm/yyyy exigido por Holded)
Due Date	Fecha de vencimiento (dd/mm/yyyy)
Contact	Nombre del cliente/empresa
Concept	Descripción del artículo o concepto
Base	Importe sin IVA de esa línea
Tax	Porcentaje de IVA (sin símbolo, ej. 21)
Total	Base + IVA de esa línea

🏛️ FACe XML — Corrección del redondeo de 1 céntimo en TaxAmount

El estándar Facturae 3.2.2 exige que el <fe:TaxAmount> del bloque <fe:TaxesOutputs> de cabecera sea exactamente igual a la suma de los <fe:TaxAmount> de cada <fe:InvoiceLine>. En versiones anteriores, estos valores podían diferir en ±0,01 € al calcularse de forma independiente sobre la base global.

🆔 FACe XML — Detección automática de Persona Física / Jurídica

Anteriormente, todos los terceros (clientes y emisores) se clasificaban siempre como Persona Jurídica (J) en el XML Facturae, lo que provocaba errores de validación en FACe cuando el cliente era un autónomo con DNI o NIE.

Reglas de detección automática

Formato del identificador	Ejemplo	Tipo asignado	Bloque XSD
DNI: 8 dígitos + 1 letra	12345678Z	F — Persona Física	<Individual> con Name / FirstSurname / SecondSurname
NIE: X/Y/Z + 7 dígitos + 1 letra	X1234567L	F — Persona Física	<Individual> con Name / FirstSurname / SecondSurname
CIF: letra (excl. X/Y/Z) + 7 dígitos + control	B12345678	J — Persona Jurídica	<LegalEntity> con CorporateName
Formato desconocido (fallback)	—	J (por defecto)	<LegalEntity>

15 📱 App Móvil TimeTracker — Manual Completo

La App Móvil de TimeTracker es una Progressive Web App (PWA) diseñada para que el técnico en campo pueda registrar sus trabajos de forma rápida desde el móvil. Los datos se sincronizan con el programa de escritorio mediante exportación/importación JSON.

📋 Requisitos e Instalación

Elemento	Requisito
Dispositivo	Android 8+ o iOS 13+ (cualquier smartphone moderno)
Navegador	Chrome (recomendado), Firefox, Safari
Conexión	Solo para la primera carga — después funciona 100% offline
Cámara	Requerida solo para escanear QR de licencia

Cómo instalar la app en el móvil

1. Abre Chrome en el móvil y navega a la URL donde está alojada la app (proporcionada por el administrador)
2. Pulsa el botón de menú (⋮) en Chrome → «Añadir a pantalla de inicio»
3. Confirma el nombre y pulsa «Añadir»
4. El icono de TimeTracker aparecerá en tu pantalla de inicio como si fuera una app nativa
5. Ábrela: la primera vez cargará todos los recursos y quedará disponible sin conexión

⚙️ Primera Configuración — Paso a Paso

🔑 Activación de Licencia

La licencia de la app se vincula al código de licencia del programa de escritorio. Hay dos métodos para activarla:

⚙️ Panel de Configuración de la App

Accede pulsando el icono ⚙️ en la esquina superior derecha. Encontrarás las siguientes secciones:

Sección	Contenido
Datos de Empresa	Nombre, CIF/DNI/NIE, dirección, CP y ciudad, teléfono, email
Técnico	Nombre del técnico que aparecerá en el parte de servicio
Logo de Empresa	Imagen JPG/PNG/WebP (máx. 5 MB, se redimensiona automáticamente). Aparece en los partes PDF generados
Licencia de Uso	Badge de estado + campo de código manual + botón «Escanear QR»
Empresas y Clientes	Acceso al gestor de empresas y clientes (botón «Gestionar»)

🏢 Gestión de Empresas y Clientes

Desde Configuración → «Gestionar Empresas y Clientes» puedes:

• Crear una nueva empresa con nombre, CIF y dirección
• Añadir clientes dentro de cada empresa (nombre, CIF, dirección, email, teléfono)
• Editar o eliminar cualquier empresa o cliente existente

🧭 Navegación de la App

La app tiene una barra de navegación inferior con 4 pestañas:

Pestaña	Icono	Función
Lista	☰	Ver todos los trabajos guardados en el dispositivo
Nuevo	➕	Crear un nuevo registro de trabajo (pantalla principal)
Exportar	📤	Descargar los registros en JSON para importar al PC
Importar	📥	Importar un JSON externo (p.ej. lista de clientes del PC)

✏️ Crear un Nuevo Trabajo

La pantalla principal (pestaña «Nuevo») está dividida en 5 bloques:

Bloque 1 — Detalles del Trabajo

• Empresa: desplegable con todas las empresas configuradas
• Cliente: se actualiza automáticamente al cambiar la empresa
• Trabajo: descripción del trabajo realizado (campo obligatorio)
• Observaciones: notas adicionales (campo libre, opcional)

Bloque 2 — Registro de Tiempo

Hay dos formas de registrar el tiempo:

Bloque 3 — Facturación y Extras

• Trabajo Facturable: toggle ON/OFF (por defecto activado). Indica si este trabajo genera coste para el cliente.
• Añadir Desplazamiento: toggle para registrar kilómetros. Al activarlo aparecen:
  • Campo Kilómetros (km) realizados
  • Toggle Desplazamiento Facturable

Bloque 4 — Material Instalado

Toggle para indicar si se instaló material. Al activarlo aparece el grid de materiales:

• Cada fila tiene: nombre del material + unidades (cantidad)
• Botón ➕ Añadir línea para agregar más artículos
• Botón ✕ en cada fila para eliminarla

Bloque 5 — Firma y Documento PDF

• Canvas de firma: área táctil donde el cliente puede firmar con el dedo
• Botón «🗑️ Borrar Firma»: limpia el canvas si se necesita repetir
• Toggle «Generar PDF al guardar» (activado por defecto): al guardar el trabajo, se genera automáticamente un parte de servicio en PDF con todos los datos

Guardar el Trabajo

1. Rellena todos los campos obligatorios (empresa, cliente, trabajo, hora inicio/fin)
2. Añade materiales, desplazamiento y firma si procede
3. Pulsa el botón azul «💾 Guardar Trabajo»
4. Si tienes el toggle PDF activado, el navegador abrirá el PDF para que puedas compartirlo o descargarlo
5. El registro queda guardado en el dispositivo y aparecerá en la pestaña Lista

📋 Lista de Trabajos Guardados

La pestaña «Lista» muestra todos los registros guardados en el dispositivo, ordenados del más reciente al más antiguo. Cada tarjeta muestra:

• Empresa y cliente
• Descripción del trabajo
• Fecha, hora inicio y hora fin
• Duración total calculada
• Indicadores de: facturable, desplazamiento, materiales, PDF generado

Borrar todos los registros

El botón «🗑️ Eliminar todo» borra todos los registros del dispositivo. Antes de confirmar, el sistema muestra un diálogo de advertencia con dos opciones:

• «Exportar y borrar»: descarga el JSON primero y luego limpia la lista
• «Borrar todo»: elimina directamente sin exportar

📤 Exportar e Importar Datos

Exportar registros de trabajo al PC

1. Ve a la pestaña «📤 Exportar»
2. Comprueba el contador de registros disponibles
3. Pulsa «⬇️ Descargar JSON Trabajos»
4. El archivo timetracker_registros_YYYY-MM-DD.json se descarga en el móvil
5. Transfiere el archivo al PC (correo, WhatsApp, cable USB, nube…)
6. En el PC: Configuración → General → «Importar JSON de App Móvil»

Exportar/Importar lista de clientes

En la misma pestaña Exportar, en la sección «Gestión de Clientes»:

Botón	Función
Exportar Clientes (JSON)	Descarga la lista de empresas y clientes de la app en formato JSON
Importar Clientes (JSON)	Carga una lista de clientes desde un archivo JSON (p.ej. generado por el PC)

Importar JSON externo (pestaña «📥 Importar»)

El botón «📥 Importar» en la barra de navegación inferior abre el selector de archivos del móvil. Puedes cargar cualquier archivo .json compatible (exportado de otra instancia de la app, por ejemplo).

🔄 Flujo Completo de Trabajo: Móvil → PC

1. Campo: técnico abre la app, crea el registro, introduce materiales y firma el cliente
2. PDF: la app genera automáticamente el parte en PDF — se puede compartir al cliente en el momento
3. Exportar: al final del día o la semana, técnico exporta los registros como JSON
4. Transferir: el JSON llega al PC (correo, nube, USB…)
5. Importar en PC: Configuración → General → «Importar JSON de App Móvil» — los registros se integran en el historial
6. Facturar: los registros importados aparecen en la pestaña Facturación con estado PENDIENTE, listos para generar albarán

🔧 Resolución de Problemas — App Móvil

Síntoma	Causa probable	Solución
No aparece «Guardar Trabajo»	Licencia no activada	Activar licencia con QR o código manual
El QR no se escanea	Poca iluminación o cámara sin permisos	Dar permisos de cámara en Android/iOS al navegador
No hay empresas en los desplegables	No se han importado clientes	Importar JSON de clientes desde el PC
El PDF no se genera	Bloqueador de pop-ups activo	Permitir pop-ups para esta URL en el navegador
La app no funciona sin conexión	No se completó la carga inicial	Abrir con conexión al menos una vez para cachear los recursos
Al importar al PC aparece error de formato	Archivo JSON dañado o edición manual	No editar el JSON a mano — usar siempre el botón de exportar de la app
Los km no aparecen en «Editar Servicio»	El campo km se transfiere pero el checkbox de KM no se activa automáticamente	Activar manualmente «🛣️ Desplazamiento por KM» en Editar Servicio