Esta función es la encargada de eliminar una cuenta de la base de datos, esta función se debe ejecutar en dos pasos, así:
Paso 1: Se hace el llamado de la función enviando el código de la cuenta a eliminar y la acción “verificar”, esto con el fin de validar si la cuenta existe y si es posible eliminarla. Una cuenta no se puede eliminar cuando esté asociada a operaciones en el sistema. Si el resultado de esta primera petición es “eliminar”:”false” no se podrá eliminar la cuenta del sistema.
Paso 2: Una vez se ha obtenido respuesta de la función anterior y el resultado es “eliminar”:”true”, se hace el llamado de la función DoEliminarCuenta enviando el código de la cuenta a eliminar y la acción “eliminar”, para que así se elimine efectivamente la cuenta de la base de datos.
Resultado
Retorna un Json con la confirmación de la eliminación de una cuenta.
Seguridad
Aplica todas las configuraciones de seguridad de datos y de seguridad de acciones de ContaPyme / AgroWin.
Compatibilidad de la API
Función disponible desde ContaPyme/AgroWin Versión 4 - Release 7.
Petición
Requisitos
Debe haber realizado el logueo en el agente a través de la función GETAUTH().
Parámetros
Nombre parámetro
Tipo
Descripción
Ejemplo
dataJSON
JSON
Json que contiene en su interior la siguiente estructura:
icuenta: Identificador de la cuenta a eliminar. (requerido) accion: Acción a realizar, en el primer llamado de la función la acción debe ser "verificar" y en el segundo llamado la acción debe ser “eliminar”. (requerido)
{
"icuenta": "510516",
"accion": "verificar"
}
controlkey
Varchar
Corresponde al keyagente obtenido en el logueo (requerido).
"564654"
"222912"
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).
//Escriba a continuación la URL donde se encuentra su Agente de servicios web de ContaPyme.
var URLUbicacion = 'http://local.insoft.co:9000'
var URLFuncion = '/datasnap/rest/TCatPlanCuentas/"DoEliminarCuenta"/';
//Se construye la URL completa la cual es la concatenación de la ubicación y la función
var URL = URLUbicacion + URLFuncion;
//Invocamos la función que retorna controlKey para modo aprendizaje
var controlkey = getControlKey(URLUbicacion);
//1001 es el iapp configurado para agente de servicios web de ContaPyme.
var iapp = "1001";
//dataJSON: parámetros de entrada para la función
var dataJSON = {
"icuenta": "510516",
"accion": "verificar"
};
//Se arma los 4 parámetros de entrada de la funcion
var JSONSend ={ "_parameters" : [ JSON.stringify(dataJSON), controlkey, iapp ,"0" ] };
//se constuye objeto para realizar la petición desde JavaScript
var xhr = new XMLHttpRequest();
//Se inicializa la solicitud enviando el verbo y la URL a invocar
xhr.open("POST",URL);
//Se define el evento que se disparará cuando se resuelva la petición
xhr.onreadystatechange = function() {
//se verifica que la petición se hubiese terminado
if (xhr.readyState == 4 && xhr.status == 200) {
//se envia la respuesta del servidor para que se imprima
imprimirRespuesta(xhr.responseText)
}
};
//Envía la solicitud adjuntando el JSONSend que contiene los 4 parametros de la función
xhr.send(JSON.stringify(JSONSend));
//Escriba a continuación la URL donde se encuentra su Agente de servicios web de ContaPyme.
var URLUbicacion = 'http://local.insoft.co:9000'
var URLFuncion = '/datasnap/rest/TCatPlanCuentas/"DoEliminarCuenta"/';
//Se construye la URL completa la cual es la concatenación de la ubicación y la función
var URL = URLUbicacion + URLFuncion;
//Invocamos la función que retorna controlKey para modo aprendizaje
var controlkey = getControlKey(URLUbicacion);
//1001 es el iapp configurado para agente de servicios web de ContaPyme.
var iapp = "1001";
//dataJSON: parámetros de entrada para la función
var dataJSON ={
"icuenta": "510516",
"accion": "eliminar"
};
//Se arma los 4 parámetros de entrada de la funcion
var JSONSend ={ "_parameters" : [ JSON.stringify(dataJSON), controlkey, iapp ,"0" ] };
//se constuye objeto para realizar la petición desde JavaScript
var xhr = new XMLHttpRequest();
//Se inicializa la solicitud enviando el verbo y la URL a invocar
xhr.open("POST",URL);
//Se define el evento que se disparará cuando se resuelva la petición
xhr.onreadystatechange = function() {
//se verifica que la petición se hubiese terminado
if (xhr.readyState == 4 && xhr.status == 200) {
//se envia la respuesta del servidor para que se imprima
imprimirRespuesta(xhr.responseText)
}
};
//Envía la solicitud adjuntando el JSONSend que contiene los 4 parametros de la función
xhr.send(JSON.stringify(JSONSend));
Json que contiene en su interior los siguientes datos:
resultado (varchar): Retorna true siempre que la petición se ejecute satisfactoriamente. imensaje (varchar): Código del mensaje de eventualidad o error en caso de presentarse. mensaje (varchar): Mensaje de eventualidad o error en caso de presentarse. tiempo (varchar): Tiempo que se tardó el Agente en resolver la petición, este tiempo está dado en milisegundos.
respuesta
JSON
Json que contiene en su interior el objeto “datos” que se describe a continuación:
eliminar (varchar): resultado del primer llamado de la función, contiene true cuando la cuenta se puede eliminar o false cuando no es posible eliminarla.
eliminado (varchar): resultado del segundo llamado de la función, contiene true cuando la cuenta se eliminó satisfactoriamente o false cuando no se pudo eliminar.