Portal de Desarrolladores de GeoTareas
Bienvenido al portal de integración de la API de GeoTareas. Esta documentación cubre la API apidev/v1 — autenticación, gestión de tareas (alta, actualización, cancelación, lectura, multimedia), gesti ón de flota, catálogos, geocoding, ingesta de telemetría y reportes operativos.
Todos los endpoints de este portal están incluidos en tu plan excepto la API de Geocoding — esa se cobra por uso: cada solicitud resuelta se descuenta de tu cupo de geocodificación contratado. El autocompletado, la consulta de saldo y los aciertos de caché son gratis. Mirá la página de Geocoding para el detalle del costo.
Qué está disponible
- 149 endpoints en la superficie pública de integración
- Autenticación dual: JWT + clave de API en cada solicitud protegida
- Ingesta de telemetría para dispositivos IoT/GPS
- Gestión de flota: dispositivos, conductores, posiciones (lectura y escritura)
- Gestión de tareas: alta (por lote), actualización, cancelación, listado y detalle, y adjuntos/PDF de formularios — ver Tareas
- Catálogos: 25 endpoints de consulta para resolver IDs reales (cascada geográfica, procedencias, productos, causas, OAV…) — ver Catálogos
- Geocoding (de pago, por uso): forward, reverse, autocompletado y saldo — ver Geocoding
- Mensajería a móviles: enviar un mensaje a un móvil y buscar dispositivos cercanos
- Cuentas y Clientes: CRUD completo — ver Cuentas y Clientes
- Workflow y Kanban en tiempo de ejecución: definiciones, instancias, tareas, tableros, tarjetas y comentarios
- Portal de proveedores: facturas, declaraciones, tolerancia y liquidaciones
- Auditoría: historial de cambios de configuración y de tareas
- 54 endpoints de reportes: AVL (9), GT (26: operativos, analíticos y avanzados), CPM (4), General (3), Workflow (7) y Portal de proveedores (5)
- Legacy Despacho: capa de compatibilidad compatible con GeneXus para migrar integraciones existentes
- Límite de solicitudes centralizado con encabezados en la respuesta
- Caché Redis en todos los endpoints GET
Ruta de lectura recomendada
- Autenticación — Entendé el modelo de autenticación dual (JWT + clave de API) y el flujo de inicio de sesión.
- Quickstart — Configurá tu entorno local y ejecutá tu primera llamada a la API.
- Conceptos — Leé Manejo de errores, Límite de solicitudes, Paginación y Actualizaciones parciales.
- Referencia de la API — Explorá los endpoints por dominio: Tareas, Flota y Telemetría, Cuentas y Clientes, Catálogos, Geocoding, Workflow, Kanban, Portal de proveedores, Reportes.
- Colección de Postman — Importá la colección lista para usar y hacer pruebas manuales.
La API de un vistazo
149 endpoints bajo apidev/v1, más 6 servicios de compatibilidad en apidev/legacy/*.
| Dominio | Endpoints | Descripción |
|---|---|---|
| Autenticación | 1 | Inicio de sesión — emisión de JWT + clave de API |
| Tareas | 8 | Alta (por lote), actualización, cancelación, listado y detalle, adjuntos, PDF de formularios |
| Flota y Telemetría | 10 | Dispositivos, conductores, posiciones, ingesta GPS, mensajería a móviles, cercanos |
| Cuentas | 4 | Cuentas de clientes — listado, detalle, alta, actualización |
| Clientes | 4 | Clientes — listado, detalle, alta, actualización |
| Catálogos | 25 | Consultas para resolver IDs reales (geografía, procedencias, productos, causas, OAV…) |
| Geocoding (de pago) | 5 | Forward, reverse, interno, autocompletado, saldo — se cobra por uso |
| Workflow | 12 | Definiciones, instancias, línea de tiempo, datos capturados, tareas (completar, reasignar) |
| Kanban | 12 | Espacios de trabajo, tableros, estado de tarea, tarjetas (alta, edición, mover) y comentarios |
| Portal de proveedores | 12 | Facturas, declaraciones (individual y por lote), tolerancia, liquidaciones |
| Auditoría | 2 | Historial de cambios de configuración y de tareas |
| Reportes — AVL | 9 | Kilómetros, geocercas, viajes, velocidad, detenido, temperatura, mantenimiento, ignición, rendimiento |
| Reportes — GT | 26 | Operativos (9), analíticos (10) y avanzados (7): SLA, benchmark, eficiencia de flota, quality score, revisitas… |
| Reportes — CPM | 4 | Detalle de actividad del personal móvil, resumen de trabajo, rendimiento del personal, resumen de actividad |
| Reportes — General | 3 | Mensajes de hardware, inicios de sesión, alertas generadas |
| Reportes — Workflow | 7 | Instancias, tareas, cumplimiento de SLA, productividad, rendimiento, actividad por grupo, línea de tiempo |
| Reportes — Portal de proveedores | 5 | Panel, diferencias, facturación, liquidaciones, tolerancia |
| Legacy Despacho | 6 | Servicios compatibles con GeneXus bajo apidev/legacy/* |
Planner (optimización de recorridos) y Billing están documentados como anticipo pero
no expuestos: llamarlos devuelve 404. Consultá con el equipo de GeoTareas antes de
integrar contra ellos.
Principios de diseño
Este portal se actualiza junto con el desarrollo. Cada nueva funcionalidad en apidev se documenta aquí con su solicitud de Postman correspondiente. La página Cobertura de la API mantiene el inventario completo de endpoints.