Fuentes de datos

Cada widget de una página de reportes lee de una fuente de datos. Esta página es la referencia de todas las fuentes y de cada uno de sus campos, para elegir bien qué medir, por qué agrupar y qué filtrar. Las usan administrador y gerente al diseñar; lo que cada quien ve al consultar depende de su rol.

Dónde está: en el editor de widgets, sección Datos → Fuente de datos (menú lateral → Reportes → Páginas de reportes → una página → Editar → Agregar widget, /reportes/paginas).

Cómo leer esta referencia

Columna	Significa
Clave	Nombre interno del campo (el que se guarda en la configuración del widget).
Etiqueta	Como aparece en los selectores del editor.
Tipo	texto, estado (lista cerrada), numero, dinero (pesos), minutos (se muestra en horas y minutos), fecha, fechahora o booleano (sí/no). El tipo decide los operadores de los filtros (ver Diseñador de widgets).
Agrupar	Sí = se puede usar en Agrupar por, en la serie y en las columnas de una tabla dinámica.
Sumar	Sí = se puede Sumar, sacar Promedio, Mínimo y Máximo. Los campos sí/no sirven para % de «sí». Cualquier campo sirve para Contar distintos. Todos sirven en Filtros y como columna de una tabla de registros.
Valores y notas	Valores exactos que entrega la fuente (úsalos tal cual en los filtros es / no es) y cómo se calcula el campo.
Roles	Si está vacío, lo ve cualquiera que pueda usar la fuente. Si dice un rol, los demás reciben «Tu rol no tiene acceso a estos datos».

Datos generales que valen para todas las fuentes:

• Fecha del periodo: el campo que se compara con el periodo de la página. Un registro entra si esa fecha cae dentro del periodo.
• Visibilidad: cada fuente entrega solo lo que el rol de quien mira ya ve en las pantallas. «Bandeja» = la visibilidad de tickets (áreas permitidas, tickets sin área, los asignados a ti y los tuyos). «Jerarquía» = los registros de los agentes que tienes a tu cargo; lo que no tiene agente solo lo ve quien ve a todos.
• Filtros globales: cuáles de los filtros Agente, Área y Organización de la barra de la página aplican a la fuente. Si un filtro no aplica, el widget avisa «Algún filtro de la página no aplica a esta fuente.».
• Valores de relleno: cuando falta un dato, las fuentes escriben «Sin asignar» (sin agente o técnico), «Sin dato», «Sin área», «Sin organización», «Sin equipo» o «Sin formulario». Puedes filtrar por ellos, por ejemplo Agente asignado no es «Sin asignar».
• Tope: cada fuente entrega hasta 50,000 registros por periodo. Si hay más, el widget avisa «La fuente superó el tope de filas: el resultado está recortado.».
• Roles de gestión = administrador, gerente y supervisor.

Resumen de fuentes

Fuente (en pantalla)	Clave	Fecha del periodo	Quién la usa	Visibilidad	Filtros globales	Campos personalizados
Tickets	tickets	Creado	Todos	Bandeja	Agente, Área, Organización	Organización y equipo
Actividades de tickets	actividades	Creada	Todos	Bandeja (la del ticket)	Agente, Área	No
Pausas de tickets	pausas	Inicio de la pausa	Todos	Bandeja (la del ticket)	Agente, Área, Organización	Organización
Tareas de campo	tareas	Programada (o creación)	Todos	Jerarquía del técnico	Agente, Área, Organización	Organización y equipo
Visitas en sitio	visitas	Llegada (check-in)	Todos	Jerarquía del técnico	Agente, Área, Organización	Organización y equipo
Evidencias	evidencias	Capturada	Todos	Jerarquía del técnico	Agente, Área, Organización	Organización
Refacciones	refacciones	Solicitada	Todos (importes: gestión)	Jerarquía del técnico de la tarea	Agente, Área, Organización	Organización y equipo
Movimientos de refacciones	refaccion_movimientos	Fecha del movimiento	Todos (importe: gestión)	Jerarquía del técnico de la tarea	Agente, Área, Organización	Organización y equipo
Equipos	equipos	Ninguna (ver notas)	Todos	Toda la empresa	Organización	Organización y equipo
Llamadas del conmutador	llamadas	Fecha y hora	Todos	Jerarquía del técnico	Agente, Área, Organización	Organización
Proyectos	proyectos	Creado (ver notas)	Todos	Toda la empresa	Agente (responsable), Organización	Organización
Finanzas de proyectos	partidas	Vence (o creación)	Gestión	Toda la empresa	Organización	Organización
Gastos y viáticos	gastos	Fecha	Gestión	Jerarquía del técnico	Agente, Área, Organización	Organización
Jornadas y costos de campo	jornadas	Día	Gestión (importes: admin y gerente)	Jerarquía	Agente, Área	No
Horas registradas	worklogs	Inicio	Gestión (costos: admin y gerente)	Jerarquía	Agente, Área	No

En el selector, las fuentes aparecen en orden alfabético por nombre y solo las que tu rol puede usar.

Tickets

• Clave: tickets
• Descripción: Solicitudes de la mesa de ayuda: volumen, tiempos de respuesta y resolución, SLA y satisfacción.
• Fecha del periodo: creado (fecha de creación del ticket).
• Roles: todos. Visibilidad: bandeja.
• Filtros globales: Agente (agente asignado), Área, Organización (la del cliente).
• No incluye tickets borrados ni tickets fusionados en otro.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
folio	Folio	texto	No	No	Folio del ticket.
titulo	Título	texto	No	No
estado	Estado	estado	Sí	No	Nuevo, Asignado, En proceso, Esperando cliente, Resuelto, Cerrado.
abierto	Abierto	booleano	Sí	No	Sí si el estado es Nuevo, Asignado, En proceso o Esperando cliente.
prioridad	Prioridad	estado	Sí	No	Crítica, Alta, Media, Baja.
canal	Canal	estado	Sí	No	Correo, Portal, Teléfono, WhatsApp, Manual.
tema	Tema	texto	Sí	No	Tema de ayuda; «Sin dato» si no tiene.
area	Área	texto	Sí	No	«Sin área» si no tiene.
agente	Agente asignado	texto	Sí	No	«Sin asignar» si no tiene.
cliente	Cliente	texto	Sí	No	El usuario que reportó; «Sin dato» si no hay.
organizacion	Organización	texto	Sí	No	La organización del cliente; «Sin organización» si no hay.
proyecto	Proyecto	texto	Sí	No	Vacío si el ticket no está ligado a un proyecto.
creado	Creado	fechahora	Sí	No
resuelto_en	Resuelto	fechahora	Sí	No	Primera resolución; vacío si no se ha resuelto.
primera_respuesta_min	Primera respuesta	minutos	No	Sí	De la creación a la primera respuesta.
resolucion_min	Tiempo de resolución	minutos	No	Sí	De la creación a la resolución (bruto). Vacío si no se ha resuelto.
sla_cumplido	SLA cumplido	booleano	Sí	No	Sí si se resolvió antes del vencimiento del SLA; No si se resolvió tarde o sigue abierto con el SLA vencido; vacío si no tiene SLA, si sigue abierto dentro del plazo o si se cerró sin pasar por Resuelto.
sla_vencido	SLA vencido (abierto)	booleano	Sí	No	Sí si está abierto y ya pasó el vencimiento del SLA.
csat	Satisfacción (1-5)	numero	Sí	Sí	Calificación de la encuesta; vacío si no contestó.
antiguedad_min	Tiempo abierto (bruto)	minutos	No	Sí	De la creación a la primera resolución; si sigue abierto, hasta ahora; si se cerró sin resolverse, hasta su última actualización.
antiguedad_neta_min	Tiempo abierto (neto de pausas)	minutos	No	Sí	El tiempo abierto menos las pausas que detienen el reloj.
resolucion_neta_min	Tiempo de resolución (neto de pausas)	minutos	No	Sí	Igual que el neto, solo para tickets resueltos; vacío si no se ha resuelto.
tiempo_en_pausa_min	Tiempo en pausa (todas)	minutos	No	Sí	Suma de todas sus pausas dentro de su tiempo abierto.
tiempo_pausa_detiene_min	Tiempo en pausa que detiene el reloj	minutos	No	Sí	Solo las pausas cuyo motivo detiene el reloj.
veces_en_pausa	Veces en pausa	numero	No	Sí	Número de pausas del ticket.
con_pausa	Tuvo pausas	booleano	Sí	No
en_pausa	En pausa ahora	booleano	Sí	No	Sí si está abierto y tiene un motivo de pausa puesto.
motivo_pausa	Motivo de la pausa actual	texto	Sí	No	Vacío si no está en pausa.
primer_contacto_min	Primer contacto (respuesta o llegada a sitio)	minutos	No	Sí	De la creación a lo que pase primero: la primera respuesta o la primera llegada a sitio (check-in) de una tarea del ticket. Vacío si aún no hay contacto.
espera_primer_contacto_min	Espera al primer contacto (o espera actual)	minutos	No	Sí	Como el anterior, pero si no hay contacto y sigue abierto, cuenta hasta ahora. Sirve para metas de primer contacto.
equipo	Equipo	texto	Sí	No	Nombre del equipo ligado; «Sin equipo» si no hay.
equipo_modelo	Modelo del equipo	texto	Sí	No	«Sin dato» si el equipo no tiene modelo.
equipo_serie	Serie del equipo	texto	Sí	No
equipo_tipo	Tipo de equipo	texto	Sí	No	«Sin dato» si el equipo no tiene tipo.

Actividades de tickets

• Clave: actividades
• Descripción: Pasos internos de cada ticket: carga por agente, vencidas y cumplimiento de plazos.
• Fecha del periodo: creada.
• Roles: todos. Visibilidad: la del ticket al que pertenecen (bandeja).
• Filtros globales: Agente (asignado a la actividad), Área (la del ticket). No filtra por Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
titulo	Actividad	texto	No	No
ticket	Ticket	texto	Sí	No	Folio del ticket.
estado	Estado	estado	Sí	No	Pendiente, En proceso, Completada, Cancelada.
agente	Agente	texto	Sí	No	«Sin asignar» si no tiene.
area	Área	texto	Sí	No	Área del ticket; «Sin área» si no tiene.
ubicacion	Ubicación	texto	Sí	No
creada	Creada	fechahora	Sí	No
vence_el	Vence	fechahora	Sí	No
completada_en	Completada	fechahora	Sí	No
duracion_min	Duración	minutos	No	Sí	De la creación a la completación.
vencida	Vencida	booleano	Sí	No	Sí si está Pendiente o En proceso y ya pasó su vencimiento.
a_tiempo	Completada a tiempo	booleano	Sí	No	Sí/No si tiene vencimiento y se completó; vacío si no.

Pausas de tickets

• Clave: pausas
• Descripción: Cada pausa (hold) de los tickets: motivo, duración, si detiene el reloj y quién la puso.
• Fecha del periodo: desde (inicio de la pausa).
• Roles: todos. Visibilidad: la de los tickets (bandeja).
• Filtros globales: Agente (asignado al ticket), Área (del ticket), Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
folio	Folio	texto	No	No	Folio del ticket.
ticket	Ticket	texto	No	No	Título del ticket.
motivo	Motivo	texto	Sí	No	Nombre del motivo de pausa.
detiene_reloj	Detiene el reloj	booleano	Sí	No
automatica	Automática	booleano	Sí	No	Sí si la puso el sistema.
desde	Inicio	fechahora	Sí	No
hasta	Fin	fechahora	Sí	No	Vacío si sigue en curso.
en_curso	En curso	booleano	Sí	No
duracion_min	Duración	minutos	No	Sí	Hasta el fin; si sigue en curso, hasta ahora.
agente	Agente asignado	texto	Sí	No	Agente del ticket.
puesta_por	Puesta por	texto	Sí	No	Quién la puso; «Sistema» si fue automática.
area	Área	texto	Sí	No
cliente	Cliente	texto	Sí	No
organizacion	Organización	texto	Sí	No

Tareas de campo

• Clave: tareas
• Descripción: Visitas y trabajos programados de los técnicos: carga, cumplimiento y vencidas.
• Fecha del periodo: programada (la fecha programada; si no tiene, la de creación).
• Roles: todos. Visibilidad: jerarquía del técnico asignado.
• Filtros globales: Agente (técnico), Área (la del técnico), Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
titulo	Tarea	texto	No	No
estado	Estado	estado	Sí	No	Pendiente, En proceso, Completada, Cancelada.
modo	Programación	estado	Sí	No	Cita fija, Ventana, Dia, Libre (se escriben así, «Dia» sin acento).
agente	Técnico	texto	Sí	No	«Sin asignar» si no tiene.
area	Área	texto	Sí	No	Área del técnico.
cliente	Cliente	texto	Sí	No
organizacion	Organización	texto	Sí	No
formulario	Formulario	texto	Sí	No	Formulario de la tarea; vacío si no tiene.
ubicacion	Ubicación	texto	Sí	No
programada	Programada	fechahora	Sí	No	Fecha programada o, si no tiene, de creación.
vence_el	Vence	fechahora	Sí	No
recurrente	Recurrente	booleano	Sí	No
duracion_estimada_min	Duración estimada	minutos	No	Sí	Si la tarea no la tiene, cuenta 45 minutos.
vencida	Vencida	booleano	Sí	No	Sí si está Pendiente o En proceso y pasó su plazo: fin de la ventana (Ventana), la hora de la cita (Cita fija), las 23:59 locales del día (Dia) o su vencimiento (Libre).

Visitas en sitio

• Clave: visitas
• Descripción: Cada llegada y salida de un técnico: puntualidad, geocerca y tiempo en sitio.
• Fecha del periodo: check_in (llegada).
• Roles: todos. Visibilidad: jerarquía del técnico que hizo la visita.
• Filtros globales: Agente (técnico), Área (del técnico), Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
tarea	Tarea	texto	Sí	No	Título de la tarea.
agente	Técnico	texto	Sí	No
area	Área	texto	Sí	No
cliente	Cliente	texto	Sí	No
organizacion	Organización	texto	Sí	No
check_in	Llegada	fechahora	Sí	No
check_out	Salida	fechahora	Sí	No	Vacío si no ha salido.
en_sitio_min	Tiempo en sitio	minutos	No	Sí
abierta	Sin salida	booleano	Sí	No	Sí si no tiene check-out.
a_tiempo	Llegó a tiempo	booleano	Sí	No
retraso_min	Retraso	minutos	No	Sí
dentro_geocerca	Dentro de la geocerca	booleano	Sí	No	Al hacer check-in.
resultado	Resultado	texto	Sí	No	Resultado registrado de la visita.
ticket	Ticket	texto	Sí	No	Folio del ticket de la tarea (el primero, si hay varios).
formulario	Tipo de servicio (formulario)	texto	Sí	No	Formulario de la tarea; «Sin formulario» si no tiene.
equipo	Equipo	texto	Sí	No	Equipo de la tarea; «Sin equipo» si no hay.
equipo_modelo	Modelo del equipo	texto	Sí	No
equipo_serie	Serie del equipo	texto	Sí	No
equipo_tipo	Tipo de equipo	texto	Sí	No
costo_tiempo	Costo del tiempo en sitio	dinero	No	Sí	Tiempo en sitio × tarifa por hora que tenía el técnico al hacer la visita. Vacío si no había tarifa.	Admin, gerente

Evidencias

• Clave: evidencias
• Descripción: Formularios capturados en campo: volumen, geocerca, tiempo hasta sincronizar y revisión.
• Fecha del periodo: capturada.
• Roles: todos. Visibilidad: jerarquía del técnico que la capturó.
• Filtros globales: Agente, Área, Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
formulario	Formulario	texto	Sí	No
tarea	Tarea	texto	Sí	No	Vacío si la evidencia no tiene tarea.
agente	Técnico	texto	Sí	No
area	Área	texto	Sí	No
cliente	Cliente	texto	Sí	No	El de la tarea.
organizacion	Organización	texto	Sí	No
capturada	Capturada	fechahora	Sí	No	Cuando se llenó en el teléfono.
recibida	Recibida	fechahora	Sí	No	Cuando llegó al servidor.
retraso_sync_min	Tiempo hasta sincronizar	minutos	No	Sí	De capturada a recibida.
dentro_geocerca	Dentro de la geocerca	booleano	Sí	No
distancia_m	Distancia al sitio (m)	numero	No	Sí
revision	Revisión	estado	Sí	No	Pendiente, Aprobada, Rechazada.

Refacciones

• Clave: refacciones
• Descripción: Refacciones pedidas por los técnicos: pendientes de surtir, tiempos de entrega, instaladas, devueltas y su costo.
• Fecha del periodo: solicitada (fecha en que se pidió la partida).
• Roles: todos; los importes solo gestión. Visibilidad: jerarquía del técnico de la tarea.
• Filtros globales: Agente (técnico de la tarea), Área (del técnico), Organización.
• Una fila por partida pedida (una refacción en una tarea).

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
numero_parte	Número de parte	texto	Sí	No	«Sin dato» si no tiene.
descripcion	Descripción	texto	Sí	No
refaccion	Refacción	texto	Sí	No	«<número de parte> — <descripción>», o solo la descripción.
del_catalogo	Del catálogo	booleano	Sí	No	Sí si está ligada al catálogo.
tecnico	Técnico	texto	Sí	No	Técnico asignado a la tarea.
area	Área	texto	Sí	No
cliente	Cliente	texto	Sí	No
organizacion	Organización	texto	Sí	No
activo	Equipo	texto	Sí	No	Equipo al que va la pieza; «Sin dato» si no hay.
ticket	Ticket	texto	Sí	No	Folio del ticket de la tarea.
tarea	Tarea	texto	Sí	No	Título de la tarea.
estado	Estado	estado	Sí	No	Solicitada, Aprobada, Rechazada, Entregada parcial, Entregada, Cerrada, Cancelada.
urgente	Urgente	booleano	Sí	No
por_surtir	Por surtir	booleano	Sí	No	Sí si el estado es Solicitada, Aprobada o Entregada parcial.
solicitada	Solicitada	fechahora	Sí	No
entregada_en	Entregada completa	fechahora	Sí	No
cantidad_solicitada	Cantidad solicitada	numero	No	Sí
cantidad_entregada	Cantidad entregada	numero	No	Sí
cantidad_instalada	Cantidad instalada	numero	No	Sí
cantidad_devuelta	Cantidad devuelta	numero	No	Sí
por_entregar	Por entregar	numero	No	Sí	Solicitada − entregada (nunca negativo). 0 si está Rechazada o Cancelada.
por_conciliar	Entregadas sin conciliar	numero	No	Sí	Entregada − instalada − devuelta (nunca negativo). 0 si está Rechazada o Cancelada.
tiempo_primera_entrega_min	Tiempo a la primera entrega	minutos	No	Sí	De la solicitud a la primera entrega.
tiempo_surtido_min	Tiempo de surtido completo	minutos	No	Sí	De la solicitud a la entrega completa.
costo_unitario	Costo unitario	dinero	No	Sí	Costo guardado en la partida.	Gestión
importe_instalado	Importe instalado	dinero	No	Sí	Costo unitario × cantidad instalada.	Gestión
importe_solicitado	Importe solicitado	dinero	No	Sí	Costo unitario × cantidad solicitada.	Gestión

Movimientos de refacciones

• Clave: refaccion_movimientos
• Descripción: Cada entrega, instalación y devolución de refacciones en su fecha: lo instalado en el periodo, devoluciones por motivo y quién surte.
• Fecha del periodo: fecha (fecha del movimiento). Sirve para «qué se instaló este mes» aunque se haya pedido antes.
• Roles: todos; el importe solo gestión. Visibilidad: jerarquía del técnico de la tarea.
• Filtros globales: Agente, Área, Organización.
• Una fila por movimiento. Trae también los campos numero_parte, descripcion, refaccion, del_catalogo, tecnico, area, cliente, organizacion, activo, ticket y tarea, iguales a los de Refacciones.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
fecha	Fecha	fechahora	Sí	No
tipo	Movimiento	estado	Sí	No	Solicitud, Aprobación, Rechazo, Entrega, Instalación, Devolución, Cancelación.
cantidad	Cantidad	numero	No	Sí	Piezas del movimiento.
motivo_devolucion	Motivo de devolución	estado	Sí	No	No usada, Dañada, Retirada del equipo. Vacío si no es devolución.
registrado_por	Registrado por	texto	Sí	No	Quién registró el movimiento.
importe	Importe	dinero	No	Sí	Costo unitario × cantidad del movimiento.	Gestión

Equipos

• Clave: equipos
• Descripción: Equipos de los clientes: garantía y cuántos tickets y visitas tuvo cada uno en el periodo.
• Fecha del periodo: ninguna. El periodo no filtra los equipos: siempre salen todos los equipos no borrados. El periodo solo acota los conteos tickets y visitas.
• Roles: todos. Visibilidad: todos los equipos de la empresa.
• Filtros globales: solo Organización.
• La tabla de registros no se puede ordenar por fecha (no hay fecha del periodo).

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
equipo	Equipo	texto	Sí	No	Nombre.
tipo	Tipo	texto	Sí	No	«Sin dato» si no tiene.
marca	Marca	texto	Sí	No	«Sin dato» si no tiene.
modelo	Modelo	texto	Sí	No	«Sin dato» si no tiene.
serie	Serie	texto	No	No
etiqueta	Etiqueta interna	texto	No	No
organizacion	Organización	texto	Sí	No
ubicacion	Ubicación	texto	Sí	No
estado	Estado	estado	Sí	No	Activo, En reparacion, Baja, Almacen (se escriben así, sin acentos).
alta	Alta	fechahora	Sí	No	Fecha de alta en el sistema.
garantia_hasta	Garantía hasta	fecha	Sí	No
en_garantia	En garantía	booleano	Sí	No	Sí si la garantía llega a hoy o después; vacío si no tiene fecha.
dias_garantia	Días de garantía restantes	numero	No	Sí	Negativo si ya venció.
tickets	Tickets en el periodo	numero	No	Sí	Tickets del equipo creados en el periodo.
visitas	Visitas en el periodo	numero	No	Sí	Visitas a tareas del equipo con llegada en el periodo.
tecnicos	Técnicos responsables	texto	Sí	No	Nombres separados por comas; «Sin asignar» si no hay.
garantia_meses	Meses de garantía	numero	No	Sí
fecha_compra	Fecha de compra / factura	fecha	Sí	No

Llamadas del conmutador

• Clave: llamadas
• Descripción: Atenciones telefónicas: duración, técnico, cliente, ticket y acuerdos registrados.
• Fecha del periodo: inicio.
• Roles: todos. Visibilidad: jerarquía del técnico; las llamadas sin técnico identificado solo las ve quien ve a todos.
• Filtros globales: Agente, Área (del técnico), Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
inicio	Fecha y hora	fechahora	Sí	No
direccion	Dirección	estado	Sí	No	Entrante, Saliente.
estado	Resultado	estado	Sí	No	Contestada, No contestada, Buzon, Ocupado, Fallida («Buzon» sin acento).
duracion_min	Duración	minutos	No	Sí
agente	Técnico	texto	Sí	No	El técnico identificado o el nombre que mandó el conmutador; «Sin asignar» si ninguno.
cliente	Cliente	texto	Sí	No	Nombre de la organización de la llamada o del contacto.
contacto	Contacto	texto	Sí	No	El usuario identificado.
numero	Número	texto	No	No	Número del cliente.
ticket	Ticket	texto	Sí	No	Folio ligado.
ligada_por	Cómo se ligó al ticket	texto	Sí	No	Por folio, Desde Flows, Por teléfono, Por la IA, A mano, Sin ticket.
con_ticket	Con ticket	booleano	Sí	No
relevante	Relevante	booleano	Sí	No
sentimiento	Sentimiento	texto	Sí	No	El que registró el análisis de la llamada.
resumen	Resumen	texto	No	No	Primera línea del resumen.
actividades	Actividades creadas	numero	No	Sí	Actividades registradas desde la llamada.
visitas	Visitas creadas	numero	No	Sí	Tareas registradas desde la llamada.
sugerencias	Por confirmar	numero	No	Sí	Acciones sugeridas aún sin confirmar.

Proyectos

• Clave: proyectos
• Descripción: Cartera de proyectos: estado, avance, retrasos y presupuesto por cliente o responsable.
• Fecha del periodo: creado, pero solo con el fin del periodo: entran todos los proyectos que ya existían al cierre (un proyecto abierto el año pasado sigue contando este mes).
• Roles: todos. Visibilidad: todos los proyectos de la empresa.
• Filtros globales: Agente (el responsable), Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
folio	Folio	texto	No	No
nombre	Proyecto	texto	No	No
estado	Estado	estado	Sí	No	Planeación, En proceso, Pausado, Cerrado.
responsable	Responsable	texto	Sí	No
cliente	Cliente	texto	Sí	No
organizacion	Organización	texto	Sí	No
creado	Creado	fechahora	Sí	No
inicio	Inicio	fechahora	Sí	No
fin_plan	Fin planeado	fechahora	Sí	No
presupuesto	Presupuesto	dinero	No	Sí
avance	Avance (%)	numero	No	Sí	0 si no tiene.
retrasado	Retrasado	booleano	Sí	No	Sí si no está Cerrado y ya pasó su fin planeado.

Finanzas de proyectos

• Clave: partidas
• Descripción: Cuentas por cobrar y por pagar de los proyectos: saldos, cobrado y vencido.
• Fecha del periodo: vence_el (vencimiento; si no vence, la fecha de creación).
• Roles: gestión (administrador, gerente, supervisor). Visibilidad: toda la empresa.
• Filtros globales: solo Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
tipo	Tipo	estado	Sí	No	Por cobrar, Por pagar.
concepto	Concepto	texto	No	No
proyecto	Proyecto	texto	Sí	No
organizacion	Organización	texto	Sí	No
estado	Estado	estado	Sí	No	Pendiente, Parcial, Pagado, Cancelado.
monto	Monto	dinero	No	Sí
pagado	Pagado / cobrado	dinero	No	Sí
saldo	Saldo	dinero	No	Sí	Monto − pagado (nunca negativo).
vence_el	Vence	fechahora	Sí	No
vencida	Vencida	booleano	Sí	No	Sí si tiene saldo, no está Cancelado y ya pasó su vencimiento.

Gastos y viáticos

• Clave: gastos
• Descripción: Cada gasto de campo: tipo, monto, tarea, técnico y cliente.
• Fecha del periodo: fecha (fecha del gasto).
• Roles: gestión. Visibilidad: jerarquía del técnico al que se carga.
• Filtros globales: Agente, Área, Organización.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
fecha	Fecha	fechahora	Sí	No
tipo	Tipo	texto	Sí	No	Combustible, Caseta, Comida, Hospedaje, Refacciones y material, Estacionamiento, Otro.
monto	Monto	dinero	No	Sí
nota	Nota	texto	No	No
con_comprobante	Con comprobante	booleano	Sí	No	Sí si tiene adjuntos.
tarea	Tarea	texto	Sí	No
agente	Técnico	texto	Sí	No
area	Área	texto	Sí	No
cliente	Cliente	texto	Sí	No
organizacion	Organización	texto	Sí	No

Jornadas y costos de campo

• Clave: jornadas
• Descripción: Cada técnico por día: en sitio, traslados, horas ordinarias y extra, kilómetros, gastos y costo total.
• Fecha del periodo: fecha (el día local de la jornada). Con Todo el historial toma los últimos 30 días, y nunca más de 93 días: si el periodo es más largo, se recorta a los 93 días más recientes.
• Roles: gestión; los importes que salen de la tarifa (costos de horas, de kilometraje y total) solo administrador y gerente. Visibilidad: jerarquía.
• Filtros globales: Agente, Área. No filtra por Organización.
• Se calcula igual que la pantalla Jornadas: una fila por técnico y día.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
fecha	Día	fecha	Sí	No
agente	Técnico	texto	Sí	No
area	Área	texto	Sí	No
visitas	Visitas	numero	No	Sí
primera_entrada	Primera entrada	fechahora	No	No
ultima_salida	Última salida	fechahora	No	No
en_sitio_min	Tiempo en sitio	minutos	No	Sí
traslado_min	Traslados	minutos	No	Sí
salidas	Salidas del sitio	numero	No	Sí
fuera_min	Fuera del sitio	minutos	No	Sí
fuera_descontado_min	Fuera del sitio (descontado)	minutos	No	Sí
ordinarias_min	Horas ordinarias	minutos	No	Sí
extra_min	Horas extra	minutos	No	Sí
tiempo_pagado_min	Tiempo pagado	minutos	No	Sí	Ordinarias + extra (incluye traslados solo si la empresa los paga).
extra_doble_min	Extra al doble	minutos	No	Sí
extra_triple_min	Extra al triple	minutos	No	Sí
km	Kilómetros	numero	No	Sí
km_fuente	Origen del kilometraje	texto	Sí	No	GPS, Estimado, Sin datos.
costo_ordinario	Costo horas ordinarias	dinero	No	Sí		Admin, gerente
costo_extra	Costo horas extra	dinero	No	Sí		Admin, gerente
costo_tiempo	Costo del tiempo	dinero	No	Sí		Admin, gerente
costo_km	Costo de kilometraje	dinero	No	Sí		Admin, gerente
gastos	Gastos y viáticos	dinero	No	Sí	Gastos del técnico ese día.
total	Costo total	dinero	No	Sí		Admin, gerente
sin_tarifa	Sin tarifa capturada	booleano	Sí	No
sin_salida	Visita sin salida	booleano	Sí	No	Sí si alguna visita del día no tiene salida.

Horas registradas

• Clave: worklogs
• Descripción: Tiempo cargado por cada agente a tickets, tareas y proyectos, con su costo.
• Fecha del periodo: inicio (inicio del registro).
• Roles: gestión; los costos solo administrador y gerente. Visibilidad: jerarquía.
• Filtros globales: Agente, Área. No filtra por Organización.
• El costo es el que se congeló al registrar; no se recalcula con la tarifa de hoy.

Clave	Etiqueta	Tipo	Agrupar	Sumar	Valores y notas	Roles
agente	Agente	texto	Sí	No
area	Área	texto	Sí	No
origen	Cargado a	estado	Sí	No	Ticket, Tarea, Proyecto (el primero que tenga el registro, en ese orden).
ticket	Ticket	texto	Sí	No	Folio.
tarea	Tarea	texto	Sí	No	Título.
proyecto	Proyecto	texto	Sí	No	Solo si el registro se cargó con proyecto; un registro cargado a un ticket puede no traerlo.
inicio	Inicio	fechahora	Sí	No
minutos	Tiempo	minutos	No	Sí
facturable	Facturable	booleano	Sí	No
costo_hora	Costo por hora	dinero	No	Sí		Admin, gerente
costo	Costo	dinero	No	Sí		Admin, gerente
descripcion	Descripción	texto	No	No

Campos personalizados de la empresa

Los campos personalizados activos que tu empresa definió para organizaciones y para equipos se agregan solos a las fuentes que traen esa organización o ese equipo:

Campos de…	Se agregan a	Clave	Etiqueta
Organizaciones	Tickets, Pausas de tickets, Tareas de campo, Visitas en sitio, Evidencias, Refacciones, Movimientos de refacciones, Equipos, Llamadas del conmutador, Proyectos, Finanzas de proyectos, Gastos y viáticos	org__<clave del campo>	« (organización)», por ejemplo «Zona (organización)».
Equipos	Tickets, Tareas de campo, Visitas en sitio, Refacciones, Movimientos de refacciones, Equipos	eq__<clave del campo>	« (equipo)», por ejemplo «Centro de costo (equipo)».

Cada campo toma el valor de la organización o el equipo del registro. Su tipo depende del tipo del campo personalizado:

Tipo del campo personalizado	Tipo en la fuente	Agrupar	Sumar
Número	numero	No	Sí
Fecha	fecha	Sí	No
Sí/no	booleano	Sí	No
Lista	texto, con sus opciones	Sí	No
Texto	texto	Sí	No
Cualquier otro tipo	texto	No	No

Si desactivas o borras un campo personalizado, los widgets que lo usaban muestran «El campo «…» no existe en «…»». Las plantillas no usan campos personalizados.

Preguntas frecuentes

¿Qué fuente uso para «refacciones instaladas este mes»?

Movimientos de refacciones, con Movimiento es «Instalación» y Sumar Cantidad. Refacciones filtra por la fecha de la solicitud, no por la de la instalación.

¿Por qué un supervisor ve el widget de Jornadas pero no el costo total?

La fuente es de gestión, pero Costo total y los demás importes de la tarifa son solo de administrador y gerente.

¿Hay una fuente de servicios (visitas) por cliente?

Sí: Visitas en sitio, agrupando por Organización o Cliente.