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

# Modulos de la API

> Que hace cada modulo principal de Raul API y cuando usarlo

## Resumen

Raul API esta organizada por modulos funcionales. Esta pagina explica el objetivo de cada uno y cuando conviene usarlo.

## Auth

Gestiona autenticacion y acceso.

Usalo para:

* iniciar sesion
* renovar tokens
* cerrar sesion
* consultar usuario actual
* administrar usuarios, avatar y password reset

## Clients

Gestiona clientes comerciales.

Usalo para:

* crear clientes
* listarlos y filtrarlos
* actualizarlos o eliminarlos
* subir logo

## Client Father

Representa clientes padre o empresas matriz.

Usalo para:

* agrupar clientes hijos
* consultar estructuras comerciales grandes
* revisar contexto agregado de suscripciones por grupo

## Client Addresses

Gestiona direcciones asociadas a clientes.

Usalo para:

* registrar direccion principal o secundaria
* consultar direcciones por cliente
* actualizar o eliminar direcciones

## Contact

Gestiona personas de contacto y relacion con clientes.

Usalo para:

* crear contactos
* asociarlos a empresas
* consultar leads
* definir roles funcionales
* resolver duplicados con merge

## Vehicle / Asset

Gestiona vehiculos o activos vinculados al negocio.

Usalo para:

* crear y consultar vehiculos
* filtrar listados
* navegar catalogos de tipo de vehiculo

## Activities

Gestiona timeline operativo y trazabilidad comercial o tecnica.

Usalo para:

* registrar actividades
* consultarlas por cliente, contacto o visita
* adjuntar archivos
* administrar tipos de actividad

## Omnichannel / Inbox

Gestiona bandejas convergentes de email y WhatsApp.

Usalo para:

* consultar inbox unificado
* leer threads y mensajes
* marcar mensajes como leidos
* cerrar o reabrir conversaciones
* asignar conversaciones a usuarios
* enviar respuestas por email, WhatsApp o bandeja compartida
* consultar estadisticas operativas

## Shared Mailboxes

Gestiona bandejas compartidas para envio y atencion colaborativa.

Usalo para:

* crear bandejas compartidas
* asignar usuarios a la bandeja
* validar permisos de envio
* disparar sincronizacion

## Email Sync

Gestiona sincronizacion de correo hacia Omnichannel.

Usalo para:

* disparar sincronizacion inicial
* consultar estado por job
* revisar estado actual de sincronizacion
* reparar delta o backfill

## Spam Management

Gestiona remitentes bloqueados y limpieza de ruido operativo.

Usalo para:

* listar bloqueados
* bloquear remitentes
* desbloquear remitentes

## Omnichannel Tags

Gestiona etiquetado operativo de conversaciones.

Usalo para:

* crear tags
* editar o eliminar tags
* asignar tags a threads
* operar en bulk

## GPS Details

Es el modulo principal de dispositivos GPS.

Usalo para:

* registrar equipos
* consultar detalle tecnico y operativo
* listar grandes volumenes
* obtener resumenes, conteos y datos relacionados

## GPS Catalogos

Agrupa catalogos auxiliares de GPS.

Incluye:

* modelos
* plataformas
* inventario
* marcas
* categorias
* estados
* historial

Usalo antes de crear o actualizar equipos GPS.

## Subscriptions

Gestiona planes y suscripciones comerciales.

Usalo para:

* crear suscripciones
* consultar estado por cliente o por ID
* transferir entre clientes
* revertir cancelaciones
* consultar planes, monedas y estados

## Visits

Agrupa visitas tecnicas y seguimiento en terreno.

Usalo cuando el proceso involucre:

* agenda tecnica
* ejecucion de visita
* relacion entre visita, actividad y GPS

## Billing

Gestiona cobros y documentos asociados.

Usalo para:

* facturacion
* pagos
* DTE y documentos tributarios
* operaciones financieras derivadas del servicio

## Ventas y cotizaciones

Gestiona el ciclo comercial previo a la facturacion.

Incluye:

* cotizaciones
* dispositivos cotizables
* etapas de pipeline
* ventas de equipamiento
* envios y cotizacion de despacho
* generacion de PDF y correo de cotizaciones
* funciones de IA para contenido comercial y outreach

Usalo para:

* crear y administrar cotizaciones
* mover oportunidades en pipeline
* clonar o duplicar cotizaciones
* generar PDF
* enviar cotizaciones por email
* apoyar prospeccion comercial con IA

## MailgunWebhook

Gestiona recepcion de eventos de Mailgun hacia el sistema.

Usalo para:

* procesar webhooks de email entrante o eventos relacionados
* alimentar trazabilidad de correo en flujos omnicanal

## Catalogs

Agrupa datos maestros del negocio.

Incluye:

* rubro
* ciudad
* tipo de contrato
* cargo
* comunicacion
* lifecycle

Usalo como soporte de formularios y validaciones.

## Analytics

Entrega vistas agregadas e indicadores.

Usalo para:

* dashboards
* reportes
* consultas consolidadas

No lo uses como reemplazo de endpoints transaccionales de detalle.

## Recomendacion de uso

* Si necesitas contrato exacto, usa la pestaña **API**.
* Si necesitas entender que modulo elegir, empieza por esta pagina.
* Si necesitas integrar un flujo completo, usa [Flujos comunes](/common-workflows).