People Cloud Referencia
Columnas de los CSV del registro de jornada
Qué trae cada columna del CSV de jornadas y del CSV de asientos, y cómo se abren en una hoja de cálculo.
Esta función está en pruebas: puede cambiar y quizá todavía no esté disponible en tu cuenta.
En esta página
En resumen
- En la aplicación, los dos CSV se descargan desde el registro de jornada, siempre de un mes entero (Descargar el registro de jornada (PDF y CSV)).
- El CSV de jornadas tiene una fila por jornada, 18 columnas, con las duraciones en minutos. El CSV de asientos tiene una fila por anotación, 26 columnas, con sus huellas.
- Van en UTF-8, separados por punto y coma: una hoja de cálculo los abre con sus acentos. Un texto que empieza por
=,+,-,@o un apóstrofo lleva un apóstrofo delante. - Ninguno dice el tipo de una ausencia.
Para qué sirve
Para saber qué es cada columna al abrir los CSV en una hoja de cálculo, y para comprobar las anotaciones del registro fuera de la aplicación.
Quién puede usarlo
Descargas lo que puedes ver, con las mismas llaves que el registro: lo tuyo, siempre que tengas ficha laboral; lo de los demás, si eres de Recursos Humanos o tu panel de permisos te lo deja ver con Registro de jornada de los demás o Corregir el registro de jornada. En la consulta del registro, la Inspección descarga los dos CSV y la representación, sólo el de jornadas (Consultar y descargar el registro de jornada).
El formato
- UTF-8 con BOM, punto y coma entre campos y fin de línea de Windows.
- Los números van tal cual (
480,-172); el texto, entre comillas dobles. Un número vacío no lleva nada (;;) y un texto vacío es"". - Fórmulas: un texto que empieza por
=,+,-,@o un apóstrofo lleva un apóstrofo delante, para que la hoja de cálculo no lo tome por una fórmula. Para recuperar el texto exacto, si empieza por un apóstrofo, quita uno. - El nombre del fichero, en la aplicación:
Registro-, el mes y el nombre de la persona, oequipo; el de asientos, con-asientosdetrás. Por ejemplo,Registro-2026-09-equipo-asientos.csv.
CSV de jornadas
Una fila por jornada, y una fila por cada día sin ninguna. Las horas son las de la empresa.
| # | Columna | Qué trae |
|---|---|---|
| 1 | Persona | El nombre de la persona. |
| 2 | Fecha | El día, como aaaa-mm-dd. |
| 3 | Día | El día de la semana, en minúscula («lunes»). |
| 4 | Jornada | El número de la jornada en ese día (1, 2…); vacío en un día sin jornadas. |
| 5 | Entrada | La hora de entrada (hh:mm). |
| 6 | Salida | La hora de salida; vacía si no tiene salida o sigue abierta. |
| 7 | Salida al día siguiente | «Sí» o «No»: si la salida es del día siguiente; vacía si no tiene salida. |
| 8 | Pausas | Cada pausa como hh:mm-hh:mm, separadas por una barra vertical; una pausa sin vuelta, hh:mm-. |
| 9 | Minutos de pausa | Los minutos de las pausas cerradas. |
| 10 | Minutos trabajados | De la entrada a la salida, menos las pausas; vacío si no tiene salida. Una jornada en curso cuenta hasta el momento de descargar. |
| 11 | Modalidad | «Presencial» o «A distancia». |
| 12 | Previsto (minutos) | Lo previsto por su horario; 0 en un día libre, festivo, de ausencia de día entero o con el registro apagado, y en los días antes de su registro, fuera de él o fuera de su ficha que salen por tener algo registrado. |
| 13 | Diferencia del día (minutos) | Trabajado menos previsto, con signo; vacía en un día sin cerrar, hoy, con el registro apagado, y antes o fuera de su registro o de su ficha. |
| 14 | Ausencia | «Sí» (día entero), «Parte del día» o vacío. Nunca el tipo. |
| 15 | Festivo | El nombre del festivo del centro. |
| 16 | Avisos | Los avisos del día, separados por comas: «Sin fichar», «Sin salida», «Jornada larga», «Descanso corto», «Sin pausa», «En ausencia», «Marca suelta», «Corrección pendiente», «Sin conformidad», «Discrepancia». |
| 17 | Correcciones del día | El estado de cada corrección de ese día, en corto: «propuesta pendiente», «propuesta aprobada», «propuesta rechazada», «propuesta retirada», «empresa, sin respuesta de la persona», «empresa, la persona está conforme», «empresa, la persona discrepa» o «empresa, retirada». |
| 18 | Trabajado según la persona | Los minutos que tendría el día según la persona, cuando lo ha dicho: su propuesta pendiente o rechazada, o una corrección de la empresa con la que no está conforme. |
- De la columna 12 a la 18 sólo se rellenan en la primera fila de cada día; en las demás jornadas de ese día van vacías.
- No salen los días que no han llegado (el de hoy, sí), ni los anteriores a su registro, fuera de su ficha laboral o fuera del registro, salvo que tengan algo registrado.
- Los motivos de las correcciones no van aquí: van en el CSV de asientos.
CSV de asientos
Una fila por anotación del registro que toca los días del mes (fichajes, correcciones, anulaciones y decisiones), ordenadas por persona y por número. Los valores de las columnas 6, 8, 9, 12, 16 y 17 van como se guardan, porque son los que entran en la huella; «Qué es» lo dice en castellano.
| # | Columna | Qué trae |
|---|---|---|
| 1 | Persona | El nombre. |
| 2 | Id persona | El número interno de la persona. |
| 3 | Cuenta | El número interno de la cuenta. |
| 4 | N.º | El número de la anotación en la cadena de esa persona. Si salta, la que falta es de otro día. |
| 5 | Id asiento | El número interno de la anotación. |
| 6 | Clase | marca, anula, solicitud o decision. |
| 7 | Qué es | «Marca», «Anulación», «Corrección» o «Decisión». |
| 8 | Tipo | En una marca: entrada, pausa, reanuda o salida. |
| 9 | Modalidad | En una entrada: presencial o distancia. |
| 10 | Hora (local) | La hora de la marca en la zona de la empresa (aaaa-mm-dd hh:mm:ss). |
| 11 | Hora UTC | La misma, en UTC, con milésimas. |
| 12 | Origen | directo (fichada en el momento) o correccion. |
| 13 | Id corrección | La corrección a la que pertenece. |
| 14 | Id anulado | La marca que anula, en una anulación. |
| 15 | Día corregido | El día que corrige, en la propia corrección. |
| 16 | Iniciativa | Quién propone la corrección: trabajador o empresa. |
| 17 | Decisión | aprobada, rechazada, retirada, conforme o discrepa. |
| 18 | Texto | El motivo de una corrección o de una decisión, tal como se escribió. |
| 19 | Id autor | Quién la anotó. |
| 20 | Autor | Su nombre; «Sistema» si no tiene autor, «Usuario eliminado» si ese usuario ya no existe. |
| 21 | Registrado (local) | Cuándo se anotó, en la zona de la empresa. |
| 22 | Registrado UTC | Lo mismo en UTC, con milésimas. |
| 23 | Día al que se refiere | El día del registro al que pertenece. |
| 24 | Huella anterior | La huella de la anotación anterior de esa persona (64 ceros en la primera). |
| 25 | Huella | La huella de esta anotación (64 caracteres hexadecimales). |
| 26 | Huella comprobada | «Sí» o «NO»: si la huella cuadra con su contenido, calculado al descargar. |
«Huella comprobada» mira cada anotación por separado. Que encadenan unas con otras se comprueba viendo que la «Huella anterior» de cada una es la «Huella» de la anterior de esa persona.
Qué cambia según quién descarga
Nada: en la aplicación, los dos CSV salen iguales para Recursos Humanos y para quien puede ver ese registro, con los textos en «Texto». Lo que cambia es el PDF (Descargar el registro de jornada (PDF y CSV)). Las salidas del registro no van en ningún CSV.
Comprobar la huella de una anotación
La «Huella» es el SHA-256 de estos campos del CSV de asientos, unidos con | y en este orden:
v1 · Cuenta · Id persona · N.º · Clase · Tipo · Modalidad · Hora UTC · Origen · Id corrección · Id anulado · Día
corregido · Iniciativa · Decisión · Id autor · Registrado UTC · Huella anterior · Texto
- Un campo vacío es una cadena vacía.
- Las horas UTC van con sus milésimas, tal como vienen.
- Al «Texto», si empieza por un apóstrofo, se le quita uno antes.