WSGetServicios
Consulta servicios/tareas del sistema GeoTareas usando el contrato heredado de GeneXus Despacho.
Target route
POST /apidev/legacy/WSGetServicios
Status
Implemented — El bridge GeneXus → GeoTareas ya está en producción. El backend NestJS conserva los alias getservicios y WSGetServicios bajo /api/despacho/. La normalización de ruta bajo /apidev/legacy/ es el único paso pendiente.
Authentication
Este endpoint usa autenticación legacy basada en WSAutorizacion, no JWT Bearer.
{
"WSAutorizacion": {
"Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"Usuario": "usuario@empresa.com",
"Password": "contraseña"
}
}
El Guid se valida contra la tabla companiaapikey del tenant correspondiente.
Request body
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
WSAutorizacion | object | Sí | Credenciales de autenticación legacy |
FechaDesde | string (YYYY-MM-DD) | No | Fecha de inicio del filtro |
FechaHasta | string (YYYY-MM-DD) | No | Fecha de fin del filtro |
NroServicio | string | No | Número de servicio específico |
IdExterno | string | No | ID externo del servicio |
Estado | string | No | Estado del servicio (ej: FIN, INI, CAN) |
Prestador | string | No | Nombre o ID del prestador |
Limit | integer | No | Máximo de registros (default: 50) |
Offset | integer | No | Desplazamiento para paginación |
{
"WSAutorizacion": {
"Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"Usuario": "usuario@empresa.com",
"Password": "contraseña"
},
"FechaDesde": "2026-04-01",
"FechaHasta": "2026-04-03",
"Estado": "FIN",
"Limit": 50,
"Offset": 0
}
Response body
| Campo | Tipo | Descripción |
|---|---|---|
Resultado | string | "OK" o código de error |
Mensaje | string | Descripción del resultado |
Servicios | array | Lista de servicios |
Servicios[].NroServicio | string | Número del servicio |
Servicios[].NroAsistencia | string | Número de asistencia |
Servicios[].IdExterno | string | ID externo |
Servicios[].Estado | string | Estado actual |
Servicios[].FechaCreacion | string | Fecha de creación |
Servicios[].Prestador | string | Nombre del prestador |
Servicios[].Cuenta | string | Nombre de la cuenta |
Servicios[].Origen | object | Dirección y coordenadas de origen |
Servicios[].Destino | object | Dirección y coordenadas de destino |
{
"Resultado": "OK",
"Mensaje": "",
"Servicios": [
{
"NroServicio": "103878",
"NroAsistencia": "103490",
"IdExterno": "EXT-001",
"Estado": "FIN",
"FechaCreacion": "2026-04-03T10:30:00",
"Prestador": "Taller Sanca",
"Cuenta": "Juan Pérez",
"Origen": {
"Direccion": "Av. 18 de Julio 1234",
"Latitud": -34.9011,
"Longitud": -56.1645
},
"Destino": {
"Direccion": "Gral. Rivera 2200",
"Latitud": -34.8833,
"Longitud": -56.1670
}
}
]
}
Backend implementation
- Alias actuales:
POST /api/despacho/getservicios,POST /api/despacho/WSGetServicios - Servicio NestJS:
ApiDespachoService.getServicios(...) - Evidencia:
wsgetservicios_geotareas.javaserializaSDTServicioInvocaciony hace POST al backend GeoTareas
Migration note
Este endpoint es el patrón de referencia para migrar los demás ws legacy. El bridge ya opera en producción, por lo que el riesgo de regresión es bajo.
Pasos pendientes:
- Normalizar la ruta bajo
/apidev/legacy/WSGetServicios - Incluir en el middleware con validación
WSAutorizacion - Agregar ejemplos definitivos al Postman collection