> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Operaciones

> Modulo operativo: suscripciones, GPS, visitas, actividades, transfers, tecnicos y ejecucion tecnica

## Alcance

En el producto, **Operaciones** agrupa la ejecucion diaria del servicio.

Incluye principalmente:

* suscripciones
* GPS y dispositivos
* visitas
* actividades
* tecnicos y soporte
* transfers y tareas internas
* SIMs y conectividad

## Submenus principales

* Suscripciones
* GPS
* Catalogos GPS
* Actividades
* Visitas
* Tecnicos y soporte
* Transfers
* Tareas internas
* Inactive devices
* SIMs y conectividad

## Suscripciones

Endpoints clave:

* `GET /api/v1/subscription_details/all/paginated`
* `GET /api/v1/subscription_details/all/cursor`
* `GET /api/v1/subscription_details/get/{subscription_detail_id}`
* `GET /api/v1/subscription_details/summary`
* `POST /api/v1/subscription_details/create`
* `POST /api/v1/subscription_details/transfer`

## GPS y dispositivos

Endpoints clave:

* `GET /api/v1/gps_details/all/paginated`
* `GET /api/v1/gps_details/all/cursor`
* `GET /api/v1/gps_details/{gps_details_id}`
* `POST /api/v1/gps_details/create`
* `GET /api/v1/gps_details/related-data/{gps_details_id}`
* `GET /api/v1/gps_details/summary`

## Actividades

Endpoints clave:

* `POST /api/v1/activity/create`
* `PUT /api/v1/activity/{activityId}`
* `GET /api/v1/activity/by-client/{clientId}`
* `GET /api/v1/activity/by-contact/{contactId}`
* `GET /api/v1/activity/by-visit/{visitId}`

## Visitas

Endpoints clave:

* `GET /api/v1/visit_detail`
* `POST /api/v1/visit_detail`
* `GET /api/v1/visit_detail/paginated`
* `GET /api/v1/visit_detail/summary`
* `GET /api/v1/visit_detail/by-technicians`
* `GET /api/v1/visit_detail/technicians`
* `GET /api/v1/visit_detail/client/{clientId}`
* `GET /api/v1/visit_detail/subscription/{subscriptionDetailId}`
* `GET /api/v1/visit_detail/client/{clientId}/with-cost`
* `GET /api/v1/visit_detail/images/{visitDetailId}`
* `POST /api/v1/visit_detail/upload/{visitDetailId}`
* `GET /api/v1/visit_detail/{id}/pdf`
* `GET /api/v1/visit_detail/{id}`
* `PUT /api/v1/visit_detail/{id}`
* `DELETE /api/v1/visit_detail/{id}`

Usalo para:

* agenda tecnica
* ejecucion de visitas
* relacion entre actividad, tecnico, GPS y cliente
* generar o descargar respaldos de visita

## Tecnicos y transfers

Endpoints clave:

* `GET /api/v1/technician/all/paginated`
* `GET /api/v1/technician/all`
* `GET /api/v1/technician/get/{id}`
* `POST /api/v1/technician/create`
* `PUT /api/v1/technician/update/{id}`
* `DELETE /api/v1/technician/delete/{id}`
* `POST /api/v1/transfers`
* `GET /api/v1/transfers`
* `GET /api/v1/transfers/{id}`
* `PUT /api/v1/transfers/{id}/withdrawal`
* `PUT /api/v1/transfers/{id}/installation`
* `DELETE /api/v1/transfers/{id}/cancel`

Usalo para:

* administrar cuadrillas o tecnicos
* mover equipos entre retiro e instalacion
* mantener trazabilidad de transferencias tecnicas

## Tareas e inactive devices

Endpoints clave:

* `POST /api/v1/tasks`
* `GET /api/v1/tasks`
* `PUT /api/v1/tasks/{id}`
* `DELETE /api/v1/tasks/{id}`
* `GET /api/v1/inactive-devices`
* `POST /api/v1/inactive-devices/sync`

Usalo para:

* coordinar pendientes operativos internos
* detectar brechas entre inventario activo e inactivo
* sincronizar estados tecnicos antes de corregir datos manualmente

## SIMs y conectividad

Parte del backend operativo tambien expone:

* SIM management
* connectivity
* endpoint stats
* catalogo de chips

## Recomendaciones

* Usa paginacion o cursor en listados grandes.
* Separa estado comercial de estado operativo.
* Para trazabilidad temporal usa Activities y Visits, no solo Subscription Details.
* Usa Transfers para el ciclo tecnico y no como reemplazo de cambio comercial de cliente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.