Esta función es la encargada de registrar las cuentas favoritas de un usuario en la base de datos. Se utiliza tanto para registrar cuentas nuevas como para modificar las cuentas ya asociadas a favoritos.
Nombre parámetro | Tipo | Descripción | Ejemplo |
dataJSON | JSON |
Json que contiene en su interior toda la información de la cuenta que se asignará como favorita la siguiente estructura. idato: Identificador del registro, cuando se está asignando una cuenta a favoritos no se debe enviar nada, pero cuando se está modificando se debe enviar el respectivo código que se obtuvo del agente. (opcional) nombre: Nombre que se asigna a la cuenta favorita. (requerido). categoria: Nombre de la categoría a la que pertenece la cuenta o cuentas favoritas. (requerido) cuentas: Arreglo que contiene el código de la cuenta o cuentas que se agregarán a favoritos. orden: Número que permite especificar el orden en que se visualizará el favorito en el listado de favoritos. iclasifop: Especifica la clase de operación por la cual se filtrará el saldo de la cuenta favorita. ccs: Arreglo que contiene los centros de costos que se utilizaran para filtrar el saldo de la cuenta favorita. filtro: Permite especificar un filtro SQL que se aplicará para el cálculo del saldo de la cuenta favorita. |
{ "idato": "", "nombre": "Ingresos venta computadores", "categoria": "Ingresos", "cuentas": [ "415530" ], "orden": "2", "iclasifop": "5", "ccs": [ "10102" ] } |
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 arreglo “datos” que se describe a continuación: datos (varchar): Contiene True cuando la cuenta favorita se asigna satisfactoriamente o False cuando no se pudo asignar. |
{ "result":[{ "encabezado":{"resultado":"false","imensaje":"40","mensaje":"Usuario no logueado."}, "respuesta":{"datos":""} }] }