Esta función es la encargada de eliminar un elemento de inventario 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 del elemento de inventario a eliminar y la acción “verificar”, esto con el fin de validar si el elemento existe y si es posible eliminarlo. Un elemento de inventario no se puede eliminar cuando esté asociado a operaciones en el sistema. Si el resultado de esta primera petición es “eliminar”:”false” no se podrá eliminar el elemento 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 DoEliminarElemInv enviando el código del elemento de inventario a eliminar y la acción “eliminar”, para que así se elimine efectivamente el elemento de la base de datos.
Resultado
Retorna un Json con la confirmación de la eliminación de un elemento de inventario.
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:
irecurso: Código del elemento de inventario 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)
{
"irecurso": "01536",
"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/TCatElemInv/"DoEliminarElemInv"/';
//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 = {
"irecurso": "01536",
"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/TCatElemInv/"DoEliminarElemInv"/';
//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 = {
"irecurso": "01536",
"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 el elemento de inventario se puede eliminar o false cuando no es posible eliminarlo.
eliminado (varchar): resultado del segundo llamado de la función, contiene true cuando el elemento de inventario se eliminó satisfactoriamente o false cuando no se pudo eliminar.