Carga de huella

Actualiza la cobertura de forma masiva a partir de los ficheros CSV de los operadores: los subes, revisas la auditoría del impacto y apruebas la carga.

Abrir Carga de huella en Admin →

Cómo funciona una carga

Cada carga pasa por estas fases:

Los estados de una carga son En curso, Pendiente, Finalizada, Fallida y Cancelada.

Consultar las cargas

La tabla Cargas de huella muestra, para cada carga, su ID, sus ficheros, el tipo, la fase actual, quién la precargó, quién aprobó la auditoría y el estado. Puedes filtrar por Mis cargas, Fichero, Tipo carga, Fecha carga y Estado.

Pulsa la fase de una carga para ver todas sus fases, con la fecha en que terminó cada una.

El menú ⋮ de cada carga ofrece, según el caso:

• Ver ficheros: los ficheros incluidos, con un buscador.
• Auditar: solo si la carga está esperando la auditoría y tienes permiso de escritura.
• Ver log: solo si alguna fase ha fallado. Muestra los errores de validación (motivo, localización y mensaje) o, si el error fue inesperado, su texto.

Crear una carga

1. Pulsa Nueva carga y elige el tipo:

   Tipo	Para qué
   Huella total	Sustituir la huella completa de los operadores.
   Huella incremental	Aplicar solo altas, cambios y bajas sobre la huella actual.
   Bloqueo de huella	Crear o quitar bloqueos de forma masiva.
   Mapa	Corregir datos de direcciones: calles, municipios, códigos postales.
   Histórico de calles	Mantener los nombres antiguos de las calles para la búsqueda.

   Solo puede haber una carga de cada tipo a la vez: un tipo con una carga en curso aparece desactivado. El botón Cargas en curso indica cuáles están ocupados.

2. Arrastra o selecciona los ficheros CSV. Se suben uno a uno y puedes borrar los que sobren. La carga incluye todos los ficheros pendientes de ese tipo, también los que haya subido otra persona.

3. Pulsa Continuar, revisa la lista de ficheros y pulsa Precargar.

Revisar y aprobar la auditoría

Cuando termina la precarga, la carga queda en Auditoría (Pendiente). En ⋮ > Auditar se abre un panel con el resumen de la carga y el informe del impacto previsto. Lo que mide ese informe depende del tipo de carga: lo tienes en Tipos de carga.

Si nadie decide en 6 horas, la carga se cancela.

Ficheros de la carga

• Solo se aceptan ficheros CSV.
• Si no hay ningún fichero válido para el tipo elegido, la carga no sigue adelante.
• Qué ficheros espera cada tipo y cómo se validan está en Tipos de carga.

Estas guías no recogen las columnas, el separador ni el patrón exacto de nombre de cada fichero. Para eso, consulta al equipo de Feasibility.

Tipos de carga

Huella total

La huella total sustituye la cobertura FTTH de cada operador por la que traen sus ficheros. Úsala cuando un operador envía su huella completa.

Ficheros

• Un fichero CSV por operador. El sistema reconoce el operador por una parte del nombre del fichero; si no reconoce ninguno, la carga no sigue adelante.
• Es el único tipo que valida el formato de los ficheros: las columnas de cobertura y el formato de los gescal. Si algo no es válido, la carga queda Fallida y Ver log muestra cada error con su motivo, su localización y el mensaje.

Qué revisa la auditoría

• Altas y bajas de edificios (gescal 17) y de viviendas (gescal 37) por operador.
• El resultado de la validación de formato.
• Gescal duplicados y datos en conflicto entre operadores.
• Cambios en el mapa de direcciones y altas y bajas de direcciones.

Un volumen alto de cambios en viviendas «ZZ» suele ser normal: son las viviendas genéricas de los operadores que solo informan el edificio.

Qué cambia al aplicarla

Se actualizan la cobertura, el mapa de direcciones y el buscador de calles y edificios de Cobertura. Las bajas no se borran: la cobertura se desactiva y se conserva un tiempo. Después, la fase Sync replica los cambios al resto de sistemas.

Huella incremental

La huella incremental aplica solo los cambios sobre la cobertura actual, sin volver a enviar la huella completa del operador.

Ficheros

• Ficheros CSV.
• Un fichero cuyo nombre contiene DELETE se trata como bajas. El resto se trata como altas o cambios.
• No tiene la validación de formato de la huella total: revisa bien los ficheros antes de precargar.

Qué revisa la auditoría

Las altas y bajas de edificios (gescal 17) y de viviendas (gescal 37) por operador.

Qué cambia al aplicarla

Se aplican las altas, los cambios y las bajas sobre la cobertura y se actualiza el buscador de Cobertura. Después, la fase Sync replica los cambios al resto de sistemas.

Bloqueo de huella

Esta carga crea o quita muchos bloqueos de huella a la vez. Para uno o pocos bloqueos es más sencillo usar la pantalla de Bloqueo de huella.

Ficheros

• Ficheros CSV de bloqueos. Según la documentación técnica, su nombre empieza por blacklist_; si no hay ninguno, la carga queda Fallida.
• Las filas de operadores que no existen se descartan.
• Un bloqueo puede afectar a una vivienda (gescal 37), a un edificio (gescal 17), a una calle o a un municipio.

Qué revisa la auditoría

Cuántos bloqueos se van a crear y cuántos se van a quitar.

Qué cambia al aplicarla

Se quitan y se crean los bloqueos en cada ámbito: municipio, calle, edificio y vivienda. Después, la fase Sync replica los cambios, y los ficheros pasan a una copia de seguridad.

Aparte de estas cargas, cada día se retiran solos los bloqueos que han llegado a su fecha de fin.

Mapa

La carga de mapa corrige datos de las direcciones sin tocar la cobertura de los operadores. Puede no aparecer en Nueva carga si no está activada en tu entorno.

Ficheros

Ficheros CSV de actualizaciones de mapa, con nombres como map_updates_20261027.csv. Si no hay ninguno, la carga no sigue adelante.

Qué revisa la auditoría

Los cambios de mapa que se van a aplicar.

Qué cambia al aplicarla

• El aclarador de los edificios.
• Los códigos postales.
• La provincia de un municipio y el nombre de las provincias.
• El nombre de las calles y de los municipios.
• El tipo de vía.

Si algo falla al aplicar los cambios, la carga queda Fallida.

Histórico de calles

El histórico de calles guarda los nombres antiguos de las calles. Así, la búsqueda de direcciones de Cobertura también encuentra una calle por el nombre que tenía antes.

Ficheros

• Un fichero CSV de altas (nombres que se añaden) y otro de bajas (nombres que se quitan). Puedes enviar solo uno de los dos.
• Si no hay ningún fichero, la precarga termina con error.

Qué revisa la auditoría

Cuántos nombres se van a añadir y cuántos se van a quitar.

Qué cambia al aplicarla

Se añaden y se quitan los nombres históricos, y se actualiza el buscador de calles.

Qué no se puede hacer desde Admin

Desde Admin no se puede:

• editar ni reintentar una carga fallida;
• cancelar una carga fuera de la auditoría;
• descargar ficheros o logs;
• cambiar la ventana nocturna.

Para cualquiera de estos casos, o si una carga se queda bloqueada, escribe al equipo en #help-masstack-console.