Compatibilidad y autenticación

Qué es esta superficie

Los web services de Legacy Despacho son compatibles con el protocolo de integración de GeneXus Despacho. Si tenés una integración existente, solo necesitás actualizar el dominio. La estructura del cuerpo de la solicitud, los nombres de los campos y el formato de la respuesta permanecen idénticos.

Mismos contratos, plataforma actual. Estos servicios son una capa de compatibilidad delgada por delante de la plataforma GeoTareas actual. Tus solicitudes y respuestas se ven exactamente igual que las de GeneXus Despacho, pero los datos que leen y escriben son los datos vivos de GeoTareas (las mismas tareas y cuentas que administrás en la app). No necesitás saber nada sobre los cambios de plataforma: simplemente mantené tus payloads y actualizá la ruta base.

Ruta base

POST /apidev/legacy/<WSName>

Ejemplo:

POST https://$TENANT/apidev/legacy/WSGetServicios

Modelo de autenticación — WSAutorizacion

Toda solicitud debe incluir un objeto WSAutorizacion en la raíz del cuerpo de la solicitud:

{
  "WSAutorizacion": {
    "Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "Usuario": "usuario@empresa.com",
    "Password": "contraseña"
  }
}

Campo	Tipo	Descripción
Guid	string (UUID)	Clave de API emitida para tu compañía
Usuario	string	Email o nombre de usuario del usuario de integración
Password	string	Contraseña del usuario de integración

Si falta WSAutorizacion o las credenciales son inválidas, el servicio devuelve un Resultado de error con un Mensaje descriptivo.

Apuntar al nuevo dominio

Para migrar una integración existente, reemplazá únicamente el host en la URL del endpoint:

Antes	Después
https://legacy-host/WSGetServicios	https://$TENANT/apidev/legacy/WSGetServicios

No se necesitan cambios en el cuerpo de la solicitud, los nombres de los campos ni el código que parsea la respuesta.

Dominio ($TENANT)

A lo largo de la documentación, $TENANT representa el dominio que Logicsat le asigna a tu integración — cada cliente recibe el suyo. Reemplazá $TENANT por ese dominio en todas las llamadas. La documentación nunca usa un dominio fijo a propósito.