# UGPS Atlas API

> Documentación de la API REST de UGPS Atlas para integradores

## Docs

- [Listar eventos de actividad del cliente](https://docs.ugps.io/api-reference/activity-log/listar-eventos-de-actividad-del-cliente.md): Obtiene el registro de eventos de actividad del cliente autenticado.
- [Obtener detalle de un evento de actividad](https://docs.ugps.io/api-reference/activity-log/obtener-detalle-de-un-evento-de-actividad.md): Obtiene el detalle completo de un evento de actividad específico.
- [Actualizar el icono de un activo](https://docs.ugps.io/api-reference/activos--assets/actualizar-el-icono-de-un-activo.md): Actualiza el icono de un activo específico.
- [Actualizar masivamente el icono de varios activos](https://docs.ugps.io/api-reference/activos--assets/actualizar-masivamente-el-icono-de-varios-activos.md): Actualiza el icono de un conjunto de activos en una sola operación.
- [Actualizar un activo por ID](https://docs.ugps.io/api-reference/activos--assets/actualizar-un-activo-por-id.md): Actualiza un activo existente. Solo se actualizan los campos proporcionados.
- [Crear un nuevo activo](https://docs.ugps.io/api-reference/activos--assets/crear-un-nuevo-activo.md): Crea un nuevo activo en el sistema.
- [Eliminar un activo por ID](https://docs.ugps.io/api-reference/activos--assets/eliminar-un-activo-por-id.md): Elimina un activo del sistema.
- [Obtener activos disponibles para una alerta](https://docs.ugps.io/api-reference/activos--assets/obtener-activos-disponibles-para-una-alerta.md): Obtiene los activos que pueden asignarse a una alerta según el trigger, respetando los límites por tipo (velocidad, geocerca, etc.).
- [Obtener todos los activos](https://docs.ugps.io/api-reference/activos--assets/obtener-todos-los-activos.md): Obtiene todos los activos del cliente autenticado.
- [Obtener trackers agrupados por plataforma](https://docs.ugps.io/api-reference/activos--assets/obtener-trackers-agrupados-por-plataforma.md): Obtiene los trackers agrupados por plataforma (navixy, atlas, etc.) para los activos del cliente autenticado.
- [Obtener un activo por ID](https://docs.ugps.io/api-reference/activos--assets/obtener-un-activo-por-id.md): Obtiene los detalles de un activo específico por su ID.
- [Actualizar un grupo de activos por ID](https://docs.ugps.io/api-reference/activos--grupos/actualizar-un-grupo-de-activos-por-id.md): Actualiza un grupo de activos existente. Solo se actualizan los campos proporcionados.
- [Crear un nuevo grupo de activos](https://docs.ugps.io/api-reference/activos--grupos/crear-un-nuevo-grupo-de-activos.md): Crea un nuevo grupo de activos en el sistema.
- [Eliminar un grupo de activos por ID](https://docs.ugps.io/api-reference/activos--grupos/eliminar-un-grupo-de-activos-por-id.md): Elimina un grupo de activos del sistema.
- [Obtener todos los grupos de activos](https://docs.ugps.io/api-reference/activos--grupos/obtener-todos-los-grupos-de-activos.md): Obtiene todos los grupos de activos del cliente autenticado.
- [Obtener todos los IDs de activos](https://docs.ugps.io/api-reference/activos--grupos/obtener-todos-los-ids-de-activos.md): Obtiene todos los IDs de activos del cliente autenticado.
- [Obtener un grupo de activos por ID](https://docs.ugps.io/api-reference/activos--grupos/obtener-un-grupo-de-activos-por-id.md): Obtiene los detalles de un grupo de activos específico por su ID.
- [Actualizar un tipo de activo por ID](https://docs.ugps.io/api-reference/activos--tipos/actualizar-un-tipo-de-activo-por-id.md): Actualiza un tipo de activo existente. Solo se actualizan los campos proporcionados.
- [Crear un nuevo tipo de activo](https://docs.ugps.io/api-reference/activos--tipos/crear-un-nuevo-tipo-de-activo.md): Crea un nuevo tipo de activo en el sistema.
- [Eliminar un tipo de activo por ID](https://docs.ugps.io/api-reference/activos--tipos/eliminar-un-tipo-de-activo-por-id.md): Elimina un tipo de activo del sistema.
- [Obtener todos los tipos de activos](https://docs.ugps.io/api-reference/activos--tipos/obtener-todos-los-tipos-de-activos.md): Obtiene todos los tipos de activos disponibles en el sistema.
- [Obtener un tipo de activo por ID](https://docs.ugps.io/api-reference/activos--tipos/obtener-un-tipo-de-activo-por-id.md): Obtiene los detalles de un tipo de activo específico por su ID.
- [Obtener todos los tipos de vehículos](https://docs.ugps.io/api-reference/activos--vehículos/obtener-todos-los-tipos-de-vehículos.md): Obtiene todos los tipos de vehículos disponibles en el sistema.
- [Actualizar el estado de una alerta](https://docs.ugps.io/api-reference/alertas--alertas/actualizar-el-estado-de-una-alerta.md): Actualiza el estado de una alerta. Si el estado se cambia a false y la alerta tiene un calculatorId asociado,  el sistema automáticamente removerá los dispositivos del calculator en Flespi para desactivar la alerta.
- [Actualizar una alerta por ID](https://docs.ugps.io/api-reference/alertas--alertas/actualizar-una-alerta-por-id.md): Actualiza una alerta existente. El payload se valida según el tipo de trigger (alertTriggerId en el body o el de la alerta actual). Mismas reglas que creación: speed_limit requiere speedLimit; geofence requiere geofences y geofenceActivationType; ignition y lost_connection solo base. Si se modifican…
- [Crear una nueva alerta](https://docs.ugps.io/api-reference/alertas--alertas/crear-una-nueva-alerta.md): Crea una nueva alerta. El payload se valida según el tipo de trigger (alertTriggerId): - **speed_limit:** Requiere speedLimit (km/h); minDuration opcional. Crea calculator en Flespi. - **geofence:** Requiere geofences (array de ObjectIds, al menos una) y geofenceActivationType (entrance, exit o both…
- [Eliminar una alerta por ID](https://docs.ugps.io/api-reference/alertas--alertas/eliminar-una-alerta-por-id.md): Elimina una alerta. Si la alerta tiene un calculatorId asociado, el sistema automáticamente  removerá los dispositivos del calculator en Flespi antes de eliminar la alerta.
- [Obtener las alertas de un cliente](https://docs.ugps.io/api-reference/alertas--alertas/obtener-las-alertas-de-un-cliente.md): Devuelve las alertas asociadas a un cliente específico (campos base; sin campos específicos por tipo). Requiere el permiso `access_alerts`.
- [Obtener todas las alertas](https://docs.ugps.io/api-reference/alertas--alertas/obtener-todas-las-alertas.md)
- [Obtener una alerta por ID](https://docs.ugps.io/api-reference/alertas--alertas/obtener-una-alerta-por-id.md)
- [Actualizar un disparador de alerta por ID](https://docs.ugps.io/api-reference/alertas--disparadores/actualizar-un-disparador-de-alerta-por-id.md)
- [Crear un nuevo disparador de alerta](https://docs.ugps.io/api-reference/alertas--disparadores/crear-un-nuevo-disparador-de-alerta.md)
- [Eliminar un disparador de alerta por ID](https://docs.ugps.io/api-reference/alertas--disparadores/eliminar-un-disparador-de-alerta-por-id.md)
- [Obtener todos los disparadores de alerta](https://docs.ugps.io/api-reference/alertas--disparadores/obtener-todos-los-disparadores-de-alerta.md)
- [Obtener un disparador de alerta por ID](https://docs.ugps.io/api-reference/alertas--disparadores/obtener-un-disparador-de-alerta-por-id.md)
- [Actualizar el estado de una notificación](https://docs.ugps.io/api-reference/alertas--notificaciones/actualizar-el-estado-de-una-notificación.md)
- [Actualizar estado de múltiples notificaciones](https://docs.ugps.io/api-reference/alertas--notificaciones/actualizar-estado-de-múltiples-notificaciones.md): Actualiza el estado de múltiples notificaciones en una sola operación. Solo se actualizan las notificaciones que pertenecen al cliente autenticado. Si algunos IDs no existen o no pertenecen al cliente, simplemente no se actualizan (reflejado en modifiedCount).
- [Eliminar una notificación por ID](https://docs.ugps.io/api-reference/alertas--notificaciones/eliminar-una-notificación-por-id.md)
- [Obtener detalle de una notificación por ID](https://docs.ugps.io/api-reference/alertas--notificaciones/obtener-detalle-de-una-notificación-por-id.md): Retorna la notificación completa según su tipo (NotificationDetail). El payload incluye campos específicos por tipo: speed_limit, geofence, ignition, lost_connection.
- [Obtener listado paginado de notificaciones](https://docs.ugps.io/api-reference/alertas--notificaciones/obtener-listado-paginado-de-notificaciones.md): Retorna notificaciones del cliente en formato simplificado (NotificationBase) con paginación offset-based. Soporta filtros multi-valor por tipo de alerta, estado y activo, además de rango de fechas. Si no se especifica rango de fechas, retorna los últimos 30 días. Incluye conteo global de notificaci…
- [Obtener notificaciones vecinas (anterior/siguiente)](https://docs.ugps.io/api-reference/alertas--notificaciones/obtener-notificaciones-vecinas-anteriorsiguiente.md): Retorna los ids de la notificación anterior y siguiente dentro del listado ordenado (mismo orden y filtros que la grilla: `createdAt` descendente). Acepta los mismos filtros que el listado (types, status, assetIds, startDate, endDate) para que los vecinos coincidan con lo que ve el usuario. Cada ext…
- [Crear un API token propio](https://docs.ugps.io/api-reference/auth--autenticación/crear-un-api-token-propio.md): Crea un nuevo API token (prefijo `atk_`) para el usuario autenticado.
- [Listar los API tokens propios](https://docs.ugps.io/api-reference/auth--autenticación/listar-los-api-tokens-propios.md): Lista los API tokens del usuario autenticado (sin exponer el hash ni el token raw).
- [Obtener el usuario de la sesión actual](https://docs.ugps.io/api-reference/auth--autenticación/obtener-el-usuario-de-la-sesión-actual.md): Retorna los datos del usuario autenticado actualmente (sesión web).
- [Revocar un API token propio](https://docs.ugps.io/api-reference/auth--autenticación/revocar-un-api-token-propio.md): Revoca un API token del usuario autenticado por su ID (marca `isRevoked: true`).
- [Verificar la validez de un token](https://docs.ugps.io/api-reference/auth--autenticación/verificar-la-validez-de-un-token.md): Verifica si el token de acceso actual es válido y no ha expirado.
- [Actualizar disponibilidad de un activo](https://docs.ugps.io/api-reference/cargo--activos/actualizar-disponibilidad-de-un-activo.md): Actualiza el estado de disponibilidad de un activo de carga (vehículo).
- [Monitoreo en vivo de carga](https://docs.ugps.io/api-reference/cargo--monitoreo/monitoreo-en-vivo-de-carga.md): Obtiene el estado en tiempo real de pedidos, activos y transportistas.
- [Actualizar pedido](https://docs.ugps.io/api-reference/cargo--pedidos/actualizar-pedido.md): Actualiza campos informativos de un pedido. Solo permitido en estado `programado`.
- [Calcular ETA de un pedido](https://docs.ugps.io/api-reference/cargo--pedidos/calcular-eta-de-un-pedido.md): Calcula la ETA vía Azure Maps usando las coordenadas de origen y destino del pedido, y actualiza `etaLlegada` y `distanciaKm`.
- [Cambiar estado de un pedido](https://docs.ugps.io/api-reference/cargo--pedidos/cambiar-estado-de-un-pedido.md): Transición manual de estado. Solo acepta `completado` (desde estados operativamente cerrables) o `cancelado`. Las transiciones automáticas provienen del worker de eventos de geozona.
- [Crear pedido](https://docs.ugps.io/api-reference/cargo--pedidos/crear-pedido.md)
- [Eliminar pedido](https://docs.ugps.io/api-reference/cargo--pedidos/eliminar-pedido.md): Elimina un pedido. Solo permitido en pedidos `completado` o `cancelado` (los activos deben cancelarse primero).
- [Listar pedidos](https://docs.ugps.io/api-reference/cargo--pedidos/listar-pedidos.md): Obtiene la lista de pedidos de carga.
- [Listar pedidos activos](https://docs.ugps.io/api-reference/cargo--pedidos/listar-pedidos-activos.md): Obtiene los pedidos en estados activos (`programado`, `en_transito`, `en_destino`, `descargando`) con su indicador de salud derivado.
- [Obtener pedido por ID](https://docs.ugps.io/api-reference/cargo--pedidos/obtener-pedido-por-id.md)
- [Sanear un pedido (botón mágico)](https://docs.ugps.io/api-reference/cargo--pedidos/sanear-un-pedido-botón-mágico.md): Re-deriva el pedido contra el historial de Flespi y lo deja en su estado fidedigno. Devuelve el diff `before`/`after` de lo aplicado.
- [Rendimiento de transportistas](https://docs.ugps.io/api-reference/cargo--rendimiento/rendimiento-de-transportistas.md): Devuelve el rendimiento agregado por trayecto (`origen→destino`) sobre los pedidos terminales del cliente: métricas pooled y ranking de transportistas por trayecto.
- [Actualizar transportista](https://docs.ugps.io/api-reference/cargo--transportistas/actualizar-transportista.md)
- [Crear transportista](https://docs.ugps.io/api-reference/cargo--transportistas/crear-transportista.md): Crea un nuevo transportista.
- [Eliminar transportista](https://docs.ugps.io/api-reference/cargo--transportistas/eliminar-transportista.md)
- [Listar transportistas](https://docs.ugps.io/api-reference/cargo--transportistas/listar-transportistas.md): Obtiene la lista de transportistas del cliente.
- [Obtener transportista por ID](https://docs.ugps.io/api-reference/cargo--transportistas/obtener-transportista-por-id.md)
- [Actualizar ubicación de cargo](https://docs.ugps.io/api-reference/cargo--ubicaciones/actualizar-ubicación-de-cargo.md)
- [Crear ubicación de cargo](https://docs.ugps.io/api-reference/cargo--ubicaciones/crear-ubicación-de-cargo.md): Crea una ubicación de cargo (origen/destino) vinculada a geozonas de Atlas. Si no se envían coordenadas, se desnormalizan desde la geozona de llegada.
- [Eliminar ubicación de cargo](https://docs.ugps.io/api-reference/cargo--ubicaciones/eliminar-ubicación-de-cargo.md)
- [Listar ubicaciones de cargo](https://docs.ugps.io/api-reference/cargo--ubicaciones/listar-ubicaciones-de-cargo.md): Obtiene la lista de ubicaciones de cargo del cliente con sus geozonas asociadas.
- [Obtener ubicación de cargo por ID](https://docs.ugps.io/api-reference/cargo--ubicaciones/obtener-ubicación-de-cargo-por-id.md)
- [Obtener todas las restricciones](https://docs.ugps.io/api-reference/clientes--restricciones/obtener-todas-las-restricciones.md)
- [Obtener una restricción por ID](https://docs.ugps.io/api-reference/clientes--restricciones/obtener-una-restricción-por-id.md)
- [Obtener detalle de salud de un dispositivo del cliente](https://docs.ugps.io/api-reference/device-health/obtener-detalle-de-salud-de-un-dispositivo-del-cliente.md): Obtiene el historial detallado de todos los intervalos de salud de un dispositivo específico.
- [Obtener modelos de hardware del cliente](https://docs.ugps.io/api-reference/device-health/obtener-modelos-de-hardware-del-cliente.md): Obtiene la lista de modelos de hardware únicos de los dispositivos del cliente autenticado.
- [Obtener reporte de salud de dispositivos del cliente](https://docs.ugps.io/api-reference/device-health/obtener-reporte-de-salud-de-dispositivos-del-cliente.md): Obtiene un reporte unificado del estado de salud de los dispositivos del cliente autenticado.
- [Enviar formulario interno](https://docs.ugps.io/api-reference/formularios/enviar-formulario-interno.md): Guarda una respuesta de formulario usando el cliente y usuario de la sesión.
- [Obtener definición de formulario interno](https://docs.ugps.io/api-reference/formularios/obtener-definición-de-formulario-interno.md): Retorna una definición activa para renderizar formularios internos autenticados.
- [Actualizar output1 de un dispositivo en Flespi](https://docs.ugps.io/api-reference/integraciones--flespi/actualizar-output1-de-un-dispositivo-en-flespi.md): Actualiza el output1 de un dispositivo específico en Flespi. El sistema detecta el modelo de hardware del tracker y usa el metodo de control correspondiente:
- [Obtener configuración de outputs de un dispositivo en Flespi](https://docs.ugps.io/api-reference/integraciones--flespi/obtener-configuración-de-outputs-de-un-dispositivo-en-flespi.md): Obtiene la configuración actual de outputs de un dispositivo específico en Flespi desde el endpoint de settings. Extrae específicamente el objeto outputs3.current que contiene los estados actuales de los outputs del dispositivo.
- [Obtener los tipos de dispositivos desde Flespi](https://docs.ugps.io/api-reference/integraciones--flespi/obtener-los-tipos-de-dispositivos-desde-flespi.md)
- [Obtener mensajes de un dispositivo en Flespi](https://docs.ugps.io/api-reference/integraciones--flespi/obtener-mensajes-de-un-dispositivo-en-flespi.md): Obtiene todas las posiciones de un dispositivo para un día específico. La fecha se debe proporcionar en formato DD/MM/YYYY y el sistema automáticamente genera el rango desde las 00:00:00 hasta las 23:59:59 de ese día, convirtiendo internamente a timestamps unix para consultar la API de Flespi.
- [Vuelve a enviar los datos del dispositivo en Flespi](https://docs.ugps.io/api-reference/integraciones--flespi/vuelve-a-enviar-los-datos-del-dispositivo-en-flespi.md): Envia mensaje al gps para que vuelva a enviar los datos del dispositivo.
- [Obtener hashes de integración Navixy](https://docs.ugps.io/api-reference/integraciones--navixy/obtener-hashes-de-integración-navixy.md): Obtiene los hashes de autenticación para la integración con la plataforma Navixy.
- [Obtener información de vehículo por patente](https://docs.ugps.io/api-reference/integraciones--vehículo/obtener-información-de-vehículo-por-patente.md): Endpoint genérico para obtener información básica de un vehículo por patente. La ruta es estable y no depende del proveedor; la implementación actual usa un proveedor externo.
- [Crear entrada de costo](https://docs.ugps.io/api-reference/mantenimiento--costos/crear-entrada-de-costo.md)
- [Listar entradas de costos](https://docs.ugps.io/api-reference/mantenimiento--costos/listar-entradas-de-costos.md)
- [Obtener resumen de costos](https://docs.ugps.io/api-reference/mantenimiento--costos/obtener-resumen-de-costos.md)
- [Resumen del dashboard de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--dashboard/resumen-del-dashboard-de-mantenimiento.md): Obtiene métricas generales del estado de mantenimiento de la flota.
- [Actualizar defecto](https://docs.ugps.io/api-reference/mantenimiento--defectos/actualizar-defecto.md)
- [Crear defecto](https://docs.ugps.io/api-reference/mantenimiento--defectos/crear-defecto.md)
- [Listar defectos](https://docs.ugps.io/api-reference/mantenimiento--defectos/listar-defectos.md)
- [Obtener defecto por ID](https://docs.ugps.io/api-reference/mantenimiento--defectos/obtener-defecto-por-id.md)
- [Actualizar reporte DVIR](https://docs.ugps.io/api-reference/mantenimiento--dvir/actualizar-reporte-dvir.md)
- [Crear reporte DVIR](https://docs.ugps.io/api-reference/mantenimiento--dvir/crear-reporte-dvir.md)
- [Listar reportes DVIR](https://docs.ugps.io/api-reference/mantenimiento--dvir/listar-reportes-dvir.md): Driver Vehicle Inspection Report - Reportes de inspección pre-viaje.
- [Obtener reporte DVIR por ID](https://docs.ugps.io/api-reference/mantenimiento--dvir/obtener-reporte-dvir-por-id.md)
- [Resumen de estado de mantenimiento de activos](https://docs.ugps.io/api-reference/mantenimiento--estado/resumen-de-estado-de-mantenimiento-de-activos.md): Obtiene el estado de mantenimiento de todos los activos con datos enriquecidos.
- [Actualizar falla](https://docs.ugps.io/api-reference/mantenimiento--fallas/actualizar-falla.md)
- [Crear falla activa](https://docs.ugps.io/api-reference/mantenimiento--fallas/crear-falla-activa.md)
- [Listar fallas activas](https://docs.ugps.io/api-reference/mantenimiento--fallas/listar-fallas-activas.md)
- [Obtener falla por ID](https://docs.ugps.io/api-reference/mantenimiento--fallas/obtener-falla-por-id.md)
- [Resolver falla activa](https://docs.ugps.io/api-reference/mantenimiento--fallas/resolver-falla-activa.md)
- [Aplicar datos de factura a orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--importación-de-facturas/aplicar-datos-de-factura-a-orden-de-trabajo.md)
- [Iniciar importación de factura con IA](https://docs.ugps.io/api-reference/mantenimiento--importación-de-facturas/iniciar-importación-de-factura-con-ia.md): Sube una factura PDF y extrae datos usando IA (Azure Document Intelligence).
- [Obtener estado de importación de factura](https://docs.ugps.io/api-reference/mantenimiento--importación-de-facturas/obtener-estado-de-importación-de-factura.md)
- [Actualizar parte del catálogo](https://docs.ugps.io/api-reference/mantenimiento--inventario/actualizar-parte-del-catálogo.md)
- [Actualizar stock de inventario](https://docs.ugps.io/api-reference/mantenimiento--inventario/actualizar-stock-de-inventario.md)
- [Actualizar ubicación de inventario](https://docs.ugps.io/api-reference/mantenimiento--inventario/actualizar-ubicación-de-inventario.md)
- [Crear parte en catálogo](https://docs.ugps.io/api-reference/mantenimiento--inventario/crear-parte-en-catálogo.md)
- [Crear ubicación de inventario](https://docs.ugps.io/api-reference/mantenimiento--inventario/crear-ubicación-de-inventario.md)
- [Eliminar parte del catálogo](https://docs.ugps.io/api-reference/mantenimiento--inventario/eliminar-parte-del-catálogo.md)
- [Listar catálogo de partes](https://docs.ugps.io/api-reference/mantenimiento--inventario/listar-catálogo-de-partes.md)
- [Listar stock de inventario](https://docs.ugps.io/api-reference/mantenimiento--inventario/listar-stock-de-inventario.md)
- [Listar ubicaciones de inventario](https://docs.ugps.io/api-reference/mantenimiento--inventario/listar-ubicaciones-de-inventario.md)
- [Actualizar perfil](https://docs.ugps.io/api-reference/mantenimiento--perfiles/actualizar-perfil.md)
- [Cambiar estado operacional del perfil](https://docs.ugps.io/api-reference/mantenimiento--perfiles/cambiar-estado-operacional-del-perfil.md)
- [Crear perfil de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--perfiles/crear-perfil-de-mantenimiento.md)
- [Listar perfiles de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--perfiles/listar-perfiles-de-mantenimiento.md)
- [Obtener perfil de mantenimiento por activo](https://docs.ugps.io/api-reference/mantenimiento--perfiles/obtener-perfil-de-mantenimiento-por-activo.md)
- [Obtener perfil por ID](https://docs.ugps.io/api-reference/mantenimiento--perfiles/obtener-perfil-por-id.md)
- [Actualizar problema](https://docs.ugps.io/api-reference/mantenimiento--problemas/actualizar-problema.md)
- [Crear problema de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--problemas/crear-problema-de-mantenimiento.md)
- [Listar problemas de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--problemas/listar-problemas-de-mantenimiento.md)
- [Obtener problema por ID](https://docs.ugps.io/api-reference/mantenimiento--problemas/obtener-problema-por-id.md)
- [Actualizar programación](https://docs.ugps.io/api-reference/mantenimiento--programaciones/actualizar-programación.md)
- [Asignar activo a programación](https://docs.ugps.io/api-reference/mantenimiento--programaciones/asignar-activo-a-programación.md)
- [Crear programación de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--programaciones/crear-programación-de-mantenimiento.md)
- [Desasignar activo de programación](https://docs.ugps.io/api-reference/mantenimiento--programaciones/desasignar-activo-de-programación.md)
- [Eliminar programación](https://docs.ugps.io/api-reference/mantenimiento--programaciones/eliminar-programación.md)
- [Listar programaciones de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--programaciones/listar-programaciones-de-mantenimiento.md)
- [Obtener programación por ID](https://docs.ugps.io/api-reference/mantenimiento--programaciones/obtener-programación-por-id.md)
- [Reemplazar activos de programación](https://docs.ugps.io/api-reference/mantenimiento--programaciones/reemplazar-activos-de-programación.md)
- [Actualizar proveedor](https://docs.ugps.io/api-reference/mantenimiento--proveedores/actualizar-proveedor.md)
- [Crear proveedor de servicio](https://docs.ugps.io/api-reference/mantenimiento--proveedores/crear-proveedor-de-servicio.md)
- [Eliminar proveedor](https://docs.ugps.io/api-reference/mantenimiento--proveedores/eliminar-proveedor.md)
- [Listar proveedores de servicio](https://docs.ugps.io/api-reference/mantenimiento--proveedores/listar-proveedores-de-servicio.md)
- [Obtener proveedor por ID](https://docs.ugps.io/api-reference/mantenimiento--proveedores/obtener-proveedor-por-id.md)
- [Ignorar ítem de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--próximos/ignorar-ítem-de-mantenimiento.md)
- [Listar ítems de mantenimiento próximos](https://docs.ugps.io/api-reference/mantenimiento--próximos/listar-ítems-de-mantenimiento-próximos.md)
- [Obtener ítem próximo por ID](https://docs.ugps.io/api-reference/mantenimiento--próximos/obtener-ítem-próximo-por-id.md)
- [Posponer ítem de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--próximos/posponer-ítem-de-mantenimiento.md)
- [Resolver ítem de mantenimiento](https://docs.ugps.io/api-reference/mantenimiento--próximos/resolver-ítem-de-mantenimiento.md)
- [Actualizar registro de servicio](https://docs.ugps.io/api-reference/mantenimiento--registros-de-servicio/actualizar-registro-de-servicio.md)
- [Agregar adjunto a registro de servicio](https://docs.ugps.io/api-reference/mantenimiento--registros-de-servicio/agregar-adjunto-a-registro-de-servicio.md)
- [Crear registro de servicio](https://docs.ugps.io/api-reference/mantenimiento--registros-de-servicio/crear-registro-de-servicio.md)
- [Listar adjuntos de registro de servicio](https://docs.ugps.io/api-reference/mantenimiento--registros-de-servicio/listar-adjuntos-de-registro-de-servicio.md)
- [Listar registros de servicio](https://docs.ugps.io/api-reference/mantenimiento--registros-de-servicio/listar-registros-de-servicio.md)
- [Obtener registro de servicio por ID](https://docs.ugps.io/api-reference/mantenimiento--registros-de-servicio/obtener-registro-de-servicio-por-id.md)
- [Actualizar tarea de servicio](https://docs.ugps.io/api-reference/mantenimiento--tareas-de-servicio/actualizar-tarea-de-servicio.md)
- [Crear tarea de servicio](https://docs.ugps.io/api-reference/mantenimiento--tareas-de-servicio/crear-tarea-de-servicio.md)
- [Eliminar tarea de servicio](https://docs.ugps.io/api-reference/mantenimiento--tareas-de-servicio/eliminar-tarea-de-servicio.md)
- [Listar tareas de servicio de orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--tareas-de-servicio/listar-tareas-de-servicio-de-orden-de-trabajo.md)
- [Obtener tarea de servicio por ID](https://docs.ugps.io/api-reference/mantenimiento--tareas-de-servicio/obtener-tarea-de-servicio-por-id.md)
- [Actualizar orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/actualizar-orden-de-trabajo.md)
- [Agregar comentario a orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/agregar-comentario-a-orden-de-trabajo.md)
- [Agregar formulario a orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/agregar-formulario-a-orden-de-trabajo.md)
- [Agregar ítem a orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/agregar-ítem-a-orden-de-trabajo.md)
- [Cancelar orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/cancelar-orden-de-trabajo.md)
- [Cerrar orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/cerrar-orden-de-trabajo.md)
- [Completar orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/completar-orden-de-trabajo.md)
- [Crear orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/crear-orden-de-trabajo.md)
- [Eliminar formulario de orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/eliminar-formulario-de-orden-de-trabajo.md)
- [Eliminar orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/eliminar-orden-de-trabajo.md)
- [Eliminar ítem de orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/eliminar-ítem-de-orden-de-trabajo.md)
- [Listar categorías de órdenes de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/listar-categorías-de-órdenes-de-trabajo.md)
- [Listar comentarios de orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/listar-comentarios-de-orden-de-trabajo.md)
- [Listar formularios de orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/listar-formularios-de-orden-de-trabajo.md)
- [Listar ítems de orden de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/listar-ítems-de-orden-de-trabajo.md)
- [Listar órdenes de trabajo](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/listar-órdenes-de-trabajo.md)
- [Obtener orden de trabajo por ID](https://docs.ugps.io/api-reference/mantenimiento--órdenes-de-trabajo/obtener-orden-de-trabajo-por-id.md)
- [Actualizar una capa](https://docs.ugps.io/api-reference/otros--capas/actualizar-una-capa.md)
- [Crear una nueva capa](https://docs.ugps.io/api-reference/otros--capas/crear-una-nueva-capa.md)
- [Eliminar una capa](https://docs.ugps.io/api-reference/otros--capas/eliminar-una-capa.md)
- [Obtener todas las capas](https://docs.ugps.io/api-reference/otros--capas/obtener-todas-las-capas.md)
- [Obtener una capa por ID](https://docs.ugps.io/api-reference/otros--capas/obtener-una-capa-por-id.md)
- [Actualizar un conductor por ID](https://docs.ugps.io/api-reference/otros--conductores/actualizar-un-conductor-por-id.md): Actualiza un conductor existente. Solo se actualizan los campos proporcionados.
- [Crear un nuevo conductor](https://docs.ugps.io/api-reference/otros--conductores/crear-un-nuevo-conductor.md): Crea un nuevo conductor en el sistema.
- [Eliminar un conductor por ID](https://docs.ugps.io/api-reference/otros--conductores/eliminar-un-conductor-por-id.md)
- [Obtener todos los conductores](https://docs.ugps.io/api-reference/otros--conductores/obtener-todos-los-conductores.md)
- [Obtener un conductor por ID](https://docs.ugps.io/api-reference/otros--conductores/obtener-un-conductor-por-id.md)
- [Actualizar un POI por ID](https://docs.ugps.io/api-reference/otros--lugares/actualizar-un-poi-por-id.md): Actualiza un POI del cliente autenticado. Se debe enviar al menos un campo. No se permiten campos desconocidos (validación estricta).
- [Crear un POI (lugar)](https://docs.ugps.io/api-reference/otros--lugares/crear-un-poi-lugar.md): Crea un punto de interés (POI) para el cliente autenticado.
- [Eliminar POIs en lote](https://docs.ugps.io/api-reference/otros--lugares/eliminar-pois-en-lote.md): Elimina múltiples POIs del cliente autenticado. El body es un arreglo de ObjectId (al menos uno). Solo se eliminan los POIs pertenecientes al cliente.
- [Eliminar un POI por ID](https://docs.ugps.io/api-reference/otros--lugares/eliminar-un-poi-por-id.md): Elimina un POI del cliente autenticado por su ID.
- [Listar POIs del cliente](https://docs.ugps.io/api-reference/otros--lugares/listar-pois-del-cliente.md): Devuelve todos los POIs del cliente autenticado, ordenados por `label`. La paginación, búsqueda y orden se resuelven en el frontend.
- [Obtener un POI por ID](https://docs.ugps.io/api-reference/otros--lugares/obtener-un-poi-por-id.md): Devuelve un POI del cliente autenticado por su ID.
- [Obtener el reloj de negocio del servidor](https://docs.ugps.io/api-reference/público--business-time/obtener-el-reloj-de-negocio-del-servidor.md): Devuelve la hora actual del servidor, la zona horaria de negocio (America/Santiago) y el fin del día de negocio (23:59:59.999 del día actual en esa zona).
- [Obtener reporte de check-ins de tareas](https://docs.ugps.io/api-reference/reportes--check-ins/obtener-reporte-de-check-ins-de-tareas.md): Recibe un rango de fechas y filtros opcionales por empleados y formularios. Retorna los check-ins registrados en tareas dentro del periodo, con soporte para búsqueda de texto y para incluir/excluir los formularios asociados.
- [Obtener detalle de excesos de velocidad de un tracker](https://docs.ugps.io/api-reference/reportes--excesos-de-velocidad/obtener-detalle-de-excesos-de-velocidad-de-un-tracker.md): Devuelve cada infracción de velocidad individualmente con coordenadas y dirección geocodificada. Ideal para mostrar los eventos en un mapa o tabla detallada.
- [Obtener estadísticas de excesos de velocidad](https://docs.ugps.io/api-reference/reportes--excesos-de-velocidad/obtener-estadísticas-de-excesos-de-velocidad.md): Recibe N trackers, un límite de velocidad, duración mínima y rango de fechas. Retorna estadísticas de excesos de velocidad por tracker, analizando las posiciones GPS de los viajes para detectar segmentos donde la velocidad supera el límite.
- [Exportar detalle de visitas de un tracker específico](https://docs.ugps.io/api-reference/reportes--exportación/exportar-detalle-de-visitas-de-un-tracker-específico.md): Genera un archivo Excel o PDF con el detalle de visitas de un tracker específico. Incluye cada visita a geocercas con nombre de geocerca, dirección, fecha/hora de entrada, salida y duración.
- [Exportar detalle de visitas de una geocerca específica](https://docs.ugps.io/api-reference/reportes--exportación/exportar-detalle-de-visitas-de-una-geocerca-específica.md): Genera un archivo Excel o PDF con el detalle de visitas de una geocerca específica. Incluye cada entrada de un tracker a la geocerca con fecha/hora de entrada, salida y duración.
- [Exportar reporte de check-ins](https://docs.ugps.io/api-reference/reportes--exportación/exportar-reporte-de-check-ins.md): Genera un archivo Excel o PDF con el reporte de check-ins de tareas.
- [Exportar reporte de progreso de geozonas](https://docs.ugps.io/api-reference/reportes--exportación/exportar-reporte-de-progreso-de-geozonas.md): Genera un archivo Excel o PDF con el progreso de cobertura de las geozonas agrícolas.
- [Exportar reporte de temperatura](https://docs.ugps.io/api-reference/reportes--exportación/exportar-reporte-de-temperatura.md): Genera un archivo Excel o PDF con el resumen de temperatura de los assets seleccionados.
- [Exportar reporte de utilización de assets](https://docs.ugps.io/api-reference/reportes--exportación/exportar-reporte-de-utilización-de-assets.md): Genera un archivo Excel o PDF con el resumen de utilización de los assets seleccionados. Incluye horas de uso (basado en ignición), distancia recorrida, y consumo de batería.
- [Exportar reporte de última actividad](https://docs.ugps.io/api-reference/reportes--exportación/exportar-reporte-de-última-actividad.md): Genera un archivo Excel o PDF con el reporte de última actividad de los activos seleccionados, mostrando solo los activos inactivos (sin comunicación o fuera de rango).
- [Exportar resumen de excesos de velocidad](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-excesos-de-velocidad.md): Genera un archivo Excel o PDF con el resumen de excesos de velocidad (estadísticas por asset) para los trackers indicados.
- [Exportar resumen de paradas](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-paradas.md): Genera un archivo Excel o PDF con el resumen de paradas (estadísticas por asset) para los trackers indicados en el rango de fechas.
- [Exportar resumen de posiciones](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-posiciones.md): Genera un archivo Excel o PDF con el resumen de posiciones (estadísticas por asset) para los trackers indicados en el rango de fechas.
- [Exportar resumen de ralentí](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-ralentí.md): Genera un archivo Excel o PDF con el resumen de ralentí (estadísticas por asset) para los trackers indicados.
- [Exportar resumen de viajes](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-viajes.md): Genera un archivo Excel o PDF con el resumen de viajes para los trackers indicados.
- [Exportar resumen de visitas por geocercas](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-visitas-por-geocercas.md): Genera un archivo Excel o PDF con el resumen de visitas por geocercas. Incluye estadísticas por geocerca: cantidad de visitas, tiempo total dentro, tiempo promedio de parada y trackers únicos que visitaron la geocerca.
- [Exportar resumen de visitas por trackers](https://docs.ugps.io/api-reference/reportes--exportación/exportar-resumen-de-visitas-por-trackers.md): Genera un archivo Excel o PDF con el resumen de visitas por trackers. Incluye estadísticas por tracker: geocercas visitadas, tiempo total dentro, tiempo total fuera y cantidad total de visitas.
- [Obtener detalle de posiciones de un activo](https://docs.ugps.io/api-reference/reportes--historial-de-posiciones/obtener-detalle-de-posiciones-de-un-activo.md): Retorna las posiciones GPS individuales de un activo en un rango de fechas. Cada posición incluye coordenadas, velocidad, dirección, estado de ignición y satélites.
- [Obtener estadísticas de posiciones de múltiples activos](https://docs.ugps.io/api-reference/reportes--historial-de-posiciones/obtener-estadísticas-de-posiciones-de-múltiples-activos.md): Recibe un array de IDs de activos y un rango de fechas. Retorna estadísticas de posiciones GPS por cada activo (velocidad máxima, velocidad promedio, distancia total recorrida, total de posiciones) y estadísticas globales agregadas.
- [Exportar resumen de horas de trabajo](https://docs.ugps.io/api-reference/reportes--horas-de-trabajo/exportar-resumen-de-horas-de-trabajo.md): Genera un archivo Excel o PDF con el resumen de horas de trabajo (estadísticas por asset) para los trackers indicados.
- [Obtener desglose diario de horas de trabajo de un tracker](https://docs.ugps.io/api-reference/reportes--horas-de-trabajo/obtener-desglose-diario-de-horas-de-trabajo-de-un-tracker.md): Devuelve el desglose diario de horas de trabajo de un tracker: por cada día indica cantidad de viajes, paradas, tiempo de conducción, tiempo de paradas y tiempo total de trabajo dentro del horario laboral configurado.
- [Obtener estadísticas de horas de trabajo](https://docs.ugps.io/api-reference/reportes--horas-de-trabajo/obtener-estadísticas-de-horas-de-trabajo.md): Recibe N trackers y un rango de fechas. Retorna estadísticas de horas de trabajo por tracker: viajes, paradas dentro de viajes, tiempo de conducción, tiempo de paradas y tiempo total de trabajo, filtrado por días de la semana y horario laboral configurable.
- [Obtener detalle de progreso de una geozona específica](https://docs.ugps.io/api-reference/reportes--progreso-de-geozonas/obtener-detalle-de-progreso-de-una-geozona-específica.md): Devuelve el detalle de cobertura de una geozona agrícola específica para los assets indicados en el rango de fechas.
- [Obtener estadísticas de progreso de geozonas](https://docs.ugps.io/api-reference/reportes--progreso-de-geozonas/obtener-estadísticas-de-progreso-de-geozonas.md): Recibe N assets y un rango de fechas. Retorna el progreso de cobertura de las geozonas agrícolas (superficie cubierta) por los assets indicados.
- [Obtener detalle de ralentí de un tracker](https://docs.ugps.io/api-reference/reportes--ralentí/obtener-detalle-de-ralentí-de-un-tracker.md): Devuelve cada evento de ralentí individualmente con coordenadas y dirección geocodificada. Ideal para mostrar los eventos en un mapa o tabla detallada.
- [Obtener estadísticas de ralentí](https://docs.ugps.io/api-reference/reportes--ralentí/obtener-estadísticas-de-ralentí.md): Recibe N trackers y un rango de fechas. Retorna estadísticas de ralentí por tracker, detectando periodos donde el vehículo tiene el motor encendido pero no se mueve (ignition ON + speed < 3 km/h, duración mínima 3 minutos).
- [Actualizar estado de reporte programado](https://docs.ugps.io/api-reference/reportes--reportes-programados/actualizar-estado-de-reporte-programado.md): Activa o desactiva un reporte programado (toggle isActive)
- [Actualizar reporte programado](https://docs.ugps.io/api-reference/reportes--reportes-programados/actualizar-reporte-programado.md): Actualiza un reporte programado existente. No se permite modificar el campo reportType. La validación se aplica según el tipo de reporte existente en la base de datos.
- [Crear reporte programado](https://docs.ugps.io/api-reference/reportes--reportes-programados/crear-reporte-programado.md): Crea un nuevo reporte programado. El tipo de reporte determina la validación aplicada: - trips_history: permite reportConfig con fuelNormRate y fuelPrice opcionales - stops_history: sin configuración adicional - speed_excess: requiere reportConfig.speedLimit obligatorio, minDuration opcional
- [Eliminar reporte programado](https://docs.ugps.io/api-reference/reportes--reportes-programados/eliminar-reporte-programado.md): Elimina un reporte programado del cliente autenticado
- [Obtener detalle de una ejecución](https://docs.ugps.io/api-reference/reportes--reportes-programados/obtener-detalle-de-una-ejecución.md): Obtiene el detalle de una ejecución específica de un reporte programado del cliente autenticado
- [Obtener historial de ejecuciones de un reporte programado](https://docs.ugps.io/api-reference/reportes--reportes-programados/obtener-historial-de-ejecuciones-de-un-reporte-programado.md): Obtiene el historial paginado de ejecuciones de un reporte programado, ordenado de más reciente a más antiguo
- [Obtener la última ejecución completada](https://docs.ugps.io/api-reference/reportes--reportes-programados/obtener-la-última-ejecución-completada.md): Devuelve la última ejecución completada de un reporte programado, con todos sus archivos descargables (uno por formato marcado). Las URLs de descarga se re-firman en cada consulta. Retorna 404 si aún no hay ninguna ejecución exitosa.
- [Obtener reporte programado por ID](https://docs.ugps.io/api-reference/reportes--reportes-programados/obtener-reporte-programado-por-id.md): Obtiene un reporte programado específico del cliente autenticado
- [Obtener reportes programados](https://docs.ugps.io/api-reference/reportes--reportes-programados/obtener-reportes-programados.md): Obtiene todos los reportes programados del cliente autenticado
- [Obtener detalle de temperatura de un asset](https://docs.ugps.io/api-reference/reportes--temperatura/obtener-detalle-de-temperatura-de-un-asset.md): Devuelve las lecturas de temperatura individuales de un asset en el rango de fechas.
- [Obtener estadísticas de temperatura](https://docs.ugps.io/api-reference/reportes--temperatura/obtener-estadísticas-de-temperatura.md): Recibe N assets y un rango de fechas. Retorna estadísticas de temperatura por asset (mínima, máxima y promedio) a partir de los sensores reportados.
- [Obtener desglose diario de utilización de un asset](https://docs.ugps.io/api-reference/reportes--utilización/obtener-desglose-diario-de-utilización-de-un-asset.md): Devuelve el desglose diario de utilización de un asset: viajes, horas de uso, distancia recorrida y consumo de batería por día.
- [Obtener estadísticas de utilización de assets](https://docs.ugps.io/api-reference/reportes--utilización/obtener-estadísticas-de-utilización-de-assets.md): Recibe N assets y un rango de fechas. Retorna el resumen de utilización por asset: horas de uso (basado en ignición), distancia recorrida y consumo de batería.
- [Obtener detalle de visitas de una geocerca específica](https://docs.ugps.io/api-reference/reportes--visitas-por-geocercas/obtener-detalle-de-visitas-de-una-geocerca-específica.md): Devuelve cada entrada de un tracker a la geocerca indicada con fecha/hora de entrada, salida y duración, más un resumen agregado (cantidad, tiempo total y promedio).
- [Obtener resumen de visitas agrupado por geocercas](https://docs.ugps.io/api-reference/reportes--visitas-por-geocercas/obtener-resumen-de-visitas-agrupado-por-geocercas.md): Recibe N assets, N geocercas y un rango de fechas. Retorna estadísticas por geocerca: cantidad de visitas, tiempo total dentro, tiempo promedio de parada y trackers únicos.
- [Obtener detalle de visitas de un asset específico](https://docs.ugps.io/api-reference/reportes--visitas-por-trackers/obtener-detalle-de-visitas-de-un-asset-específico.md): Resuelve el asset a su tracker principal (`mainTrackerId`) y devuelve el detalle de sus visitas a geocercas: nombre de geocerca, dirección, entrada, salida y duración.
- [Obtener resumen de visitas agrupado por trackers](https://docs.ugps.io/api-reference/reportes--visitas-por-trackers/obtener-resumen-de-visitas-agrupado-por-trackers.md): Recibe N assets, N geocercas y un rango de fechas. Retorna estadísticas por tracker: geocercas visitadas, tiempo total dentro, tiempo total fuera y cantidad total de visitas.
- [Obtener reporte de última actividad de activos](https://docs.ugps.io/api-reference/reportes--última-actividad/obtener-reporte-de-última-actividad-de-activos.md): Recibe un listado de IDs de activos (MongoDB ObjectIds) y un rango de fechas. Retorna el estado de comunicación de cada activo: última comunicación, última posición reportada, dirección geocodificada y voltaje de batería.
- [Liveness probe](https://docs.ugps.io/api-reference/sistema/liveness-probe.md): Siempre responde 200 mientras el proceso viva. Es el health probe de Azure App Service. El estado real de las dependencias (Mongo, Redis) va en el payload, pero no afecta el código de respuesta. Público, sin autenticación.
- [Readiness probe](https://docs.ugps.io/api-reference/sistema/readiness-probe.md): Responde 200 solo si todas las dependencias duras están listas (Mongo `connected` y Redis `ready`); 503 en caso contrario. Se usa como gate post-deploy en CI. Público, sin autenticación.
- [Actualizar un departamento](https://docs.ugps.io/api-reference/trabajo--empleados/actualizar-un-departamento.md): **Permisos requeridos:** `access_employees`
- [Actualizar un empleado](https://docs.ugps.io/api-reference/trabajo--empleados/actualizar-un-empleado.md): Actualiza el empleado completo: Navixy valida el objeto entero y rechaza los payloads parciales, así que el body debe traer todos los campos.
- [Crear un departamento](https://docs.ugps.io/api-reference/trabajo--empleados/crear-un-departamento.md): **Permisos requeridos:** `access_employees`
- [Crear un empleado](https://docs.ugps.io/api-reference/trabajo--empleados/crear-un-empleado.md): Crea el empleado en la plataforma Navixy del cliente.
- [Eliminar un departamento](https://docs.ugps.io/api-reference/trabajo--empleados/eliminar-un-departamento.md): **Permisos requeridos:** `access_employees`
- [Eliminar un empleado](https://docs.ugps.io/api-reference/trabajo--empleados/eliminar-un-empleado.md): Elimina el empleado de la plataforma Navixy del cliente.
- [Listar los departamentos del cliente](https://docs.ugps.io/api-reference/trabajo--empleados/listar-los-departamentos-del-cliente.md): Departamentos de Navixy a los que se adscriben los empleados.
- [Listar los empleados del cliente](https://docs.ugps.io/api-reference/trabajo--empleados/listar-los-empleados-del-cliente.md): Empleados de la plataforma Navixy del cliente, adaptados al DTO camelCase de Atlas.
- [Listar los tags de empleados](https://docs.ugps.io/api-reference/trabajo--empleados/listar-los-tags-de-empleados.md): Catálogo de tags de Navixy con que se clasifican los empleados.
- [Listar los trackers asignables a un empleado](https://docs.ugps.io/api-reference/trabajo--empleados/listar-los-trackers-asignables-a-un-empleado.md): Trackers de Navixy candidatos a vincularse con un empleado.
- [Actualizar una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/actualizar-una-tarea.md): Actualiza una tarea existente. El id proviene del path.
- [Actualizar una tarea recurrente](https://docs.ugps.io/api-reference/trabajo--tareas/actualizar-una-tarea-recurrente.md): Actualiza una tarea recurrente existente. El id proviene del path.
- [Adjuntar un formulario a una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/adjuntar-un-formulario-a-una-tarea.md): Adjunta un formulario (plantilla) a una tarea.
- [Asignar o desasignar una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/asignar-o-desasignar-una-tarea.md): Asigna una tarea a un tracker/empleado, o la desasigna enviando `trackerId: null`.
- [Consultar el estado de una operación masiva](https://docs.ugps.io/api-reference/trabajo--tareas/consultar-el-estado-de-una-operación-masiva.md): Devuelve el estado y progreso de una operación masiva de tareas previamente encolada.
- [Crear una ruta con checkpoints](https://docs.ugps.io/api-reference/trabajo--tareas/crear-una-ruta-con-checkpoints.md): Crea una ruta (secuencia de tareas encadenadas) con sus checkpoints en Navixy.
- [Crear una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/crear-una-tarea.md): Crea una tarea. Opcionalmente puede crear también su formulario asociado (`createForm: true` + `form_template_id`).
- [Crear una tarea recurrente](https://docs.ugps.io/api-reference/trabajo--tareas/crear-una-tarea-recurrente.md): Crea una tarea recurrente (schedule) que genera tareas según una frecuencia (días de la semana o días del mes).
- [Eliminar el formulario de una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/eliminar-el-formulario-de-una-tarea.md): Elimina el formulario asociado a una tarea.
- [Eliminar una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/eliminar-una-tarea.md): Elimina una tarea del cliente.
- [Eliminar una tarea recurrente](https://docs.ugps.io/api-reference/trabajo--tareas/eliminar-una-tarea-recurrente.md): Elimina una tarea recurrente (schedule) del cliente.
- [Geocodificar una dirección de tarea](https://docs.ugps.io/api-reference/trabajo--tareas/geocodificar-una-dirección-de-tarea.md): Forward geocoding de una dirección para los formularios de tarea.
- [Iniciar una operación masiva de tareas](https://docs.ugps.io/api-reference/trabajo--tareas/iniciar-una-operación-masiva-de-tareas.md): Encola una operación masiva (update, delete o assign) sobre hasta 500 tareas y responde de inmediato con el id de la operación. El procesamiento es asíncrono (BullMQ); consultar el progreso vía `GET /api/work/tasks/bulk/{bulkOperationId}`.
- [Leer el formulario de una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/leer-el-formulario-de-una-tarea.md): Lee el formulario asociado a una tarea (passthrough tipado del formulario Navixy).
- [Leer una tarea](https://docs.ugps.io/api-reference/trabajo--tareas/leer-una-tarea.md): Lee una tarea individual, adaptada al DTO de UI y enriquecida con su empleado.
- [Listar tareas](https://docs.ugps.io/api-reference/trabajo--tareas/listar-tareas.md): Lista las tareas del cliente, ya adaptadas al DTO de UI y enriquecidas con el empleado embebido (antes lo resolvía el web con `useEmployeeNavixyList`).
- [Listar tareas recurrentes](https://docs.ugps.io/api-reference/trabajo--tareas/listar-tareas-recurrentes.md): Lista las tareas recurrentes (schedules) del cliente, enriquecidas con su empleado y su plantilla de formulario.
- [Optimizar el orden de una ruta](https://docs.ugps.io/api-reference/trabajo--tareas/optimizar-el-orden-de-una-ruta.md): Optimiza el orden de los puntos de una ruta (resolución del orden de visita óptimo vía Navixy).
- [Actualizar una geofence por ID en Flespi](https://docs.ugps.io/api-reference/tracking--geocercas/actualizar-una-geofence-por-id-en-flespi.md): Actualiza una geofence existente en Flespi y MongoDB. Permite editar todos los campos, incluyendo la geometría.
- [Confirmar importación de geocercas desde un preview](https://docs.ugps.io/api-reference/tracking--geocercas/confirmar-importación-de-geocercas-desde-un-preview.md): Confirma una sesión de preview y encola el trabajo de importación en background que crea las geocercas importables en Flespi y MongoDB.
- [Crear una nueva geofence en Flespi](https://docs.ugps.io/api-reference/tracking--geocercas/crear-una-nueva-geofence-en-flespi.md): Crea una nueva geofence (geocerca) directamente en Flespi y la asigna automáticamente al calculator de geofences. Soporta tres tipos de geometrías: - **circle**: Requiere center (lat, lng) y radius (en metros) - **polygon**: Requiere un array de points (mínimo 3 puntos) - **corridor**: Requiere un a…
- [Descargar CSV de geocercas rechazadas de una importación](https://docs.ugps.io/api-reference/tracking--geocercas/descargar-csv-de-geocercas-rechazadas-de-una-importación.md): Genera y descarga un archivo CSV con los ítems no importados de una importación (rechazados, duplicados y fallidos), incluyendo el motivo y el detalle sanitizado.
- [Eliminar múltiples geocercas por _id](https://docs.ugps.io/api-reference/tracking--geocercas/eliminar-múltiples-geocercas-por-_id.md): Elimina varias geocercas por sus _id de MongoDB, tanto en Flespi como en la base de datos.
- [Exportar geocercas seleccionadas a archivo KML](https://docs.ugps.io/api-reference/tracking--geocercas/exportar-geocercas-seleccionadas-a-archivo-kml.md): Genera un archivo KML con las geocercas indicadas por sus _id de MongoDB.
- [Generar preview de importación de geocercas (KML/KMZ)](https://docs.ugps.io/api-reference/tracking--geocercas/generar-preview-de-importación-de-geocercas-kmlkmz.md): Sube un archivo KML o KMZ y genera una sesión de preview con el resultado del análisis, sin crear todavía ninguna geocerca. Cada placemark se extrae, se prepara su geometría (simplificación con control de calidad) y se clasifica como importable, duplicada o rechazada.
- [Listar ítems de una importación de geocercas](https://docs.ugps.io/api-reference/tracking--geocercas/listar-ítems-de-una-importación-de-geocercas.md): Lista de forma paginada los ítems de una importación de geocercas, con opción de filtrar por estado.
- [Obtener estado de una importación de geocercas](https://docs.ugps.io/api-reference/tracking--geocercas/obtener-estado-de-una-importación-de-geocercas.md): Obtiene el historial y el estado agregado de una importación de geocercas, incluyendo el conteo de ítems por estado.
- [Obtener geofences del cliente autenticado](https://docs.ugps.io/api-reference/tracking--geocercas/obtener-geofences-del-cliente-autenticado.md): Obtiene todas las geofences (geocercas) del cliente autenticado desde Flespi. El sistema automáticamente filtra las geofences por el `clientId` del usuario autenticado, que se encuentra almacenado en el campo `metadata.clientId` de cada geofence en Flespi.
- [Obtener una geofence por ID](https://docs.ugps.io/api-reference/tracking--geocercas/obtener-una-geofence-por-id.md): Obtiene una geofence específica por su MongoDB ObjectId. Retorna todos los campos almacenados en MongoDB: `geometry`, `color`, `address`, `clientId`, `flespiId` y `type`.
- [Subir y procesar archivo KML/KMZ](https://docs.ugps.io/api-reference/tracking--geocercas/subir-y-procesar-archivo-kmlkmz.md): Sube un archivo KML o KMZ y procesa automáticamente todas las ubicaciones (placemarks) encontradas. Para cada placemark válido: - Se extrae el nombre, color y geometría - Se calcula el centro de la geometría para geocoding inverso - Se obtiene la dirección usando Azure Maps - Se crea una geofence en…
- [Actualizar un tracker por ID](https://docs.ugps.io/api-reference/tracking--trackers/actualizar-un-tracker-por-id.md): Actualiza un tracker existente. Solo se actualizan los campos proporcionados.
- [Configurar horometro de un tracker](https://docs.ugps.io/api-reference/tracking--trackers/configurar-horometro-de-un-tracker.md): Configura el horometro para un tracker identificado por su `flespiId`.
- [Configurar odometro de un tracker](https://docs.ugps.io/api-reference/tracking--trackers/configurar-odometro-de-un-tracker.md): Configura el odometro para un tracker identificado por su `flespiId`.
- [Configurar sensores de un tracker por Flespi ID](https://docs.ugps.io/api-reference/tracking--trackers/configurar-sensores-de-un-tracker-por-flespi-id.md): Actualiza la configuración de sensores de un tracker (PATCH parcial). Solo persiste los sensores presentes en el body; el mapping sensor→DIN es metadata Atlas y no se replica al dispositivo en Flespi.
- [Crear un nuevo tracker](https://docs.ugps.io/api-reference/tracking--trackers/crear-un-nuevo-tracker.md): Crea un nuevo tracker en el sistema.
- [Eliminar un tracker por ID](https://docs.ugps.io/api-reference/tracking--trackers/eliminar-un-tracker-por-id.md)
- [Obtener datos de horometro de un tracker](https://docs.ugps.io/api-reference/tracking--trackers/obtener-datos-de-horometro-de-un-tracker.md): Obtiene la configuracion actual del horometro para un tracker identificado por su `flespiId`.
- [Obtener datos de odometro de un tracker](https://docs.ugps.io/api-reference/tracking--trackers/obtener-datos-de-odometro-de-un-tracker.md): Obtiene la configuracion actual del odometro para un tracker identificado por su `flespiId`.
- [Obtener inputs disponibles para configurar sensores](https://docs.ugps.io/api-reference/tracking--trackers/obtener-inputs-disponibles-para-configurar-sensores.md): Devuelve los DIN (entradas digitales) disponibles para asociar a sensores de un tracker Atlas (Flespi), junto con los sensores ya configurados y las fuentes de temperatura reportadas por el dispositivo.
- [Obtener posiciones de un tracker en un rango de fechas](https://docs.ugps.io/api-reference/tracking--trackers/obtener-posiciones-de-un-tracker-en-un-rango-de-fechas.md): Obtiene las posiciones de un tracker según un rango de fechas especificado.
- [Obtener todos los trackers de un cliente específico](https://docs.ugps.io/api-reference/tracking--trackers/obtener-todos-los-trackers-de-un-cliente-específico.md): Obtiene todos los trackers de un cliente específico. Requiere el permiso `access_tracking` o `access_fleet_assets`. Solo se puede consultar el cliente de la propia sesión; consultar otro cliente requiere además `access_admin_panel`.
- [Obtener trackers](https://docs.ugps.io/api-reference/tracking--trackers/obtener-trackers.md)
- [Obtener un tracker por ID](https://docs.ugps.io/api-reference/tracking--trackers/obtener-un-tracker-por-id.md)
- [Renombrar un tracker por Flespi ID](https://docs.ugps.io/api-reference/tracking--trackers/renombrar-un-tracker-por-flespi-id.md): Actualiza únicamente el nombre de un tracker identificado por su `flespiId`.
- [Obtener estadísticas de paradas entre viajes para todos los mainTrackers de los assets](https://docs.ugps.io/api-reference/tracking--viajes/obtener-estadísticas-de-paradas-entre-viajes-para-todos-los-maintrackers-de-los-assets.md): Obtiene estadísticas de paradas entre viajes para todos los mainTrackers de los assets del cliente autenticado en un rango de fechas. Retorna estadísticas individuales por cada tracker. Incluye todos los trackers aunque no tengan paradas (stats: null).
- [Obtener estadísticas de viajes para todos los mainTrackers de los assets](https://docs.ugps.io/api-reference/tracking--viajes/obtener-estadísticas-de-viajes-para-todos-los-maintrackers-de-los-assets.md): Obtiene estadísticas de viajes para todos los mainTrackers de los assets del cliente autenticado en un rango de fechas. Retorna estadísticas individuales por cada tracker. Incluye todos los trackers aunque no tengan viajes (stats: null).
- [Obtener estadísticas de viajes por Flespi ID](https://docs.ugps.io/api-reference/tracking--viajes/obtener-estadísticas-de-viajes-por-flespi-id.md): Obtiene estadísticas agregadas de los viajes de un dispositivo específico en un rango de fechas.
- [Obtener línea de tiempo combinada de trips, stops y stops entre trips](https://docs.ugps.io/api-reference/tracking--viajes/obtener-línea-de-tiempo-combinada-de-trips-stops-y-stops-entre-trips.md): Obtiene una línea de tiempo cronológica que combina trips, stops dentro de trips y stops entre trips de un dispositivo específico.  Todos los eventos están ordenados cronológicamente por su timestamp de inicio (begin).
- [Obtener línea de tiempo de trips con stops dentro de viajes](https://docs.ugps.io/api-reference/tracking--viajes/obtener-línea-de-tiempo-de-trips-con-stops-dentro-de-viajes.md): Obtiene una línea de tiempo cronológica que combina trips y stops dentro de trips de un dispositivo específico. **No incluye stops entre trips.** Todos los eventos están ordenados cronológicamente por su timestamp de inicio (begin).
- [Obtener mapa de calor de actividad de la flota](https://docs.ugps.io/api-reference/tracking--viajes/obtener-mapa-de-calor-de-actividad-de-la-flota.md): Devuelve el mapa de calor de actividad de la flota: cantidad de viajes iniciados por día de la semana y hora del día en un rango de fechas. Usa el mismo scope de assets y filtros (smart + monitoreo) que `GET /api/trips/stats`.
- [Obtener paradas dentro de un viaje específico](https://docs.ugps.io/api-reference/tracking--viajes/obtener-paradas-dentro-de-un-viaje-específico.md): Obtiene todas las paradas que ocurrieron dentro de un viaje específico de un dispositivo. Utiliza el calculador de paradas de Flespi para obtener los intervalos de parada filtrados por el ID del viaje.
- [Obtener paradas entre viajes de un dispositivo](https://docs.ugps.io/api-reference/tracking--viajes/obtener-paradas-entre-viajes-de-un-dispositivo.md): Obtiene todas las paradas entre viajes de un dispositivo específico. Las paradas entre viajes son intervalos de tiempo en los que el vehículo está detenido entre dos viajes consecutivos. Si se proporcionan parámetros de fecha, filtra las paradas por el rango especificado.
- [Obtener todas las paradas dentro de viajes de un dispositivo](https://docs.ugps.io/api-reference/tracking--viajes/obtener-todas-las-paradas-dentro-de-viajes-de-un-dispositivo.md): Obtiene todas las paradas que ocurrieron dentro de viajes de un dispositivo específico. Si se proporcionan parámetros de fecha, filtra las paradas por el rango especificado.
- [Obtener un viaje específico por ID](https://docs.ugps.io/api-reference/tracking--viajes/obtener-un-viaje-específico-por-id.md): Obtiene un viaje específico de un dispositivo por su ID único. El sistema transforma automáticamente el viaje agregando información de cliente y activo, además de obtener las direcciones de inicio y fin mediante geocoding.
- [Obtener una parada entre viajes específica por ID](https://docs.ugps.io/api-reference/tracking--viajes/obtener-una-parada-entre-viajes-específica-por-id.md): Obtiene una parada entre viajes específica de un dispositivo por su ID único. El sistema obtiene automáticamente la dirección de la parada mediante geocoding.
- [Obtener viajes por Flespi ID](https://docs.ugps.io/api-reference/tracking--viajes/obtener-viajes-por-flespi-id.md): Obtiene los viajes de un dispositivo específico. Si se proporcionan parámetros de fecha, filtra los viajes por el rango especificado.
- [Asignar trackers a un usuario](https://docs.ugps.io/api-reference/user-tracker-access/asignar-trackers-a-un-usuario.md): Reemplaza los trackers asignados al usuario con los nuevos trackers especificados.
- [Eliminar trackers asignados a un usuario](https://docs.ugps.io/api-reference/user-tracker-access/eliminar-trackers-asignados-a-un-usuario.md): Vacía el array de trackers, otorgando acceso completo al usuario.
- [Obtener todos los assets del cliente](https://docs.ugps.io/api-reference/user-tracker-access/obtener-todos-los-assets-del-cliente.md): Retorna todos los assets del cliente sin filtro de asignaciones. Usado por el panel de administración.
- [Obtener trackers asignados a un usuario](https://docs.ugps.io/api-reference/user-tracker-access/obtener-trackers-asignados-a-un-usuario.md): Retorna los trackers asignados a un usuario específico con audit trail.
- [Toggle restricciones de acceso](https://docs.ugps.io/api-reference/user-tracker-access/toggle-restricciones-de-acceso.md): Activa o desactiva las restricciones de acceso del usuario.
- [Obtener permisos de acceso filtrados por restricciones del cliente](https://docs.ugps.io/api-reference/usuarios--permisos/obtener-permisos-de-acceso-filtrados-por-restricciones-del-cliente.md): Obtiene los permisos de acceso disponibles para el cliente, excluyendo aquellos bloqueados por las restricciones del cliente
- [Obtener permisos de acción filtrados por restricciones del cliente](https://docs.ugps.io/api-reference/usuarios--permisos/obtener-permisos-de-acción-filtrados-por-restricciones-del-cliente.md): Obtiene los permisos de acción disponibles para el cliente, excluyendo aquellos bloqueados por las restricciones del cliente
- [Actualizar un rol por ID](https://docs.ugps.io/api-reference/usuarios--roles/actualizar-un-rol-por-id.md)
- [Crear un nuevo rol](https://docs.ugps.io/api-reference/usuarios--roles/crear-un-nuevo-rol.md)
- [Eliminar un rol por ID](https://docs.ugps.io/api-reference/usuarios--roles/eliminar-un-rol-por-id.md)
- [Obtener roles del cliente del token](https://docs.ugps.io/api-reference/usuarios--roles/obtener-roles-del-cliente-del-token.md)
- [Obtener un rol por ID](https://docs.ugps.io/api-reference/usuarios--roles/obtener-un-rol-por-id.md)
- [Actualizar estado de un usuario](https://docs.ugps.io/api-reference/usuarios--usuarios/actualizar-estado-de-un-usuario.md): Actualiza el estado activo/inactivo de un usuario. Solo actualiza el campo `isActive`.
- [Actualizar un usuario por ID](https://docs.ugps.io/api-reference/usuarios--usuarios/actualizar-un-usuario-por-id.md): Actualiza un usuario existente. Solo se actualizan los campos proporcionados.
- [Cambiar la contraseña de un usuario](https://docs.ugps.io/api-reference/usuarios--usuarios/cambiar-la-contraseña-de-un-usuario.md): Cambia la contraseña de un usuario específico.
- [Crear un nuevo usuario](https://docs.ugps.io/api-reference/usuarios--usuarios/crear-un-nuevo-usuario.md): Crea un nuevo usuario en el sistema.
- [Eliminar un usuario por ID](https://docs.ugps.io/api-reference/usuarios--usuarios/eliminar-un-usuario-por-id.md): Elimina un usuario del sistema.
- [Obtener un usuario por ID](https://docs.ugps.io/api-reference/usuarios--usuarios/obtener-un-usuario-por-id.md): Obtiene los detalles de un usuario específico por su ID.
- [Obtener usuarios creados por un usuario específico](https://docs.ugps.io/api-reference/usuarios--usuarios/obtener-usuarios-creados-por-un-usuario-específico.md): Obtiene todos los usuarios que han sido creados por un usuario específico usando su ID.
- [Obtener usuarios del cliente actual](https://docs.ugps.io/api-reference/usuarios--usuarios/obtener-usuarios-del-cliente-actual.md): Obtiene todos los usuarios que pertenecen al `clientId` del usuario autenticado.
- [Detalle de importación](https://docs.ugps.io/api-reference/work--importaciones/detalle-de-importación.md): Obtiene el detalle completo de una importación específica, incluyendo resultados y errores.
- [Historial de importaciones](https://docs.ugps.io/api-reference/work--importaciones/historial-de-importaciones.md): Obtiene el historial de todas las importaciones realizadas por el cliente.
- [Iniciar importación de datos](https://docs.ugps.io/api-reference/work--importaciones/iniciar-importación-de-datos.md): Inicia el proceso de importación definitiva de los datos previamente validados.
- [Re-geocodificar direcciones de importación](https://docs.ugps.io/api-reference/work--importaciones/re-geocodificar-direcciones-de-importación.md): Vuelve a geocodificar direcciones que fallaron en el proceso inicial de importación.
- [Vista previa de importación de datos](https://docs.ugps.io/api-reference/work--importaciones/vista-previa-de-importación-de-datos.md): Procesa un archivo Excel/CSV y muestra una vista previa de los datos antes de importar.
- [Actualizar plantilla de importación](https://docs.ugps.io/api-reference/work--plantillas/actualizar-plantilla-de-importación.md): Actualiza una plantilla de importación existente.
- [Crear plantilla de importación](https://docs.ugps.io/api-reference/work--plantillas/crear-plantilla-de-importación.md): Crea una nueva plantilla de importación personalizada.
- [Eliminar plantilla de importación](https://docs.ugps.io/api-reference/work--plantillas/eliminar-plantilla-de-importación.md): Elimina una plantilla de importación.
- [Listar plantillas de importación](https://docs.ugps.io/api-reference/work--plantillas/listar-plantillas-de-importación.md): Obtiene las plantillas de importación configuradas para el cliente.
- [Autenticación](https://docs.ugps.io/autenticacion.md): API tokens y sesiones: los dos esquemas que acepta la API de UGPS Atlas.
- [Códigos de error](https://docs.ugps.io/errores.md): Contrato del body de error de la API y catálogo de códigos estables.
- [Introducción](https://docs.ugps.io/introduccion.md): La API REST de UGPS Atlas: qué expone, dónde vive y cómo está organizada.
- [Quickstart](https://docs.ugps.io/quickstart.md): Tu primer request autenticado a la API de UGPS Atlas.

## OpenAPI Specs

- [openapi](https://docs.ugps.io/openapi.json)