Esta función es la encargada de loguear a un usuario en el Agente y retornar un código único para la sesión del usuario (keyAgente). Ésta es la primera función que se debe ejecutar para establecer comunicación con el Agente.
Nombre parámetro | Tipo | Descripción | Ejemplo |
dataJSON | JSON |
Json que contiene en su interior la siguiente estructura. email: Correo electrónico con el cual se encuentra registrado el usuario en la aplicación ContaPyme/AgroWin. (requerido) password: Contraseña del usuario asignada en el sistema. Para enviar este parámetro en el llamado de la función se debe convertir a mayúscula y encriptarlo en MD5. (requerido) idmaquina: Código que se genera por cada equipo, se debe generar con las características del equipo desde el cual se está accediendo. El idmaquina permite restringir el acceso de varios usuarios con los mismos datos de logueo. (email y password). (opcional) |
{ "email": "pperez@gmail.com ", "password": "c4ca4238a0b923820dcc509a6f75849b", "idmaquina": "537.22_136301143299" } |
controlkey | Varchar | Corresponde al keyagente obtenido en el logueo (requerido). | "564654" |
iapp | Varchar | Código que identifica a la aplicación que interactúa con el Agente (requerido) | "1068" |
random | Varchar | Cadena aleatoria que se crea en el lado del cliente, esto con el fin de que las peticiones no sean cacheadas por el navegador Internet Explorer (para aplicaciones web). (Opcional). | "54654" |
Nombre parámetro | Tipo | Descripción |
encabezado | JSON |
Json que contiene en su interior los siguientes datos: resultado (varchar): Retorna true siempre que la petición se ejecute satisfactoriamente. |
respuesta | JSON |
Json que contiene en su interior el objeto “datos” que se describe a continuación: keyagente (varchar): Identificador único que se asigna a cada usuario cuando se loguea en el Agente. versión (varchar): Número de versión en la que se encuentra el sistema ContaPyme / AgroWin. release (varchar): Número de release en el que se encuentra el sistema ContaPyme / AgroWin. actualizacion (varchar): Número de la actualización en la que se encuentra el sistema ContaPyme / AgroWin. |
{ "result":[{ "encabezado":{"resultado":"false","imensaje":"40","mensaje":"Usuario no logueado."}, "respuesta":{"datos":""} }] }