Esta función es la encargada de calcular y retornar la cantidad de días hábiles que hay entre dos fechas o la fecha hábil de acuerdo a un número de días dados.
El sistema permite configurar los días hábiles de trabajo en la semana, teniendo en cuenta esta configuración la función calculará las fechas o el número de días hábiles.
Hay dos posibilidades de respuesta de acuerdo a los parámetros que se envíen a la función:
Si se envían dos fechas (fecha inicial y fecha final) el sistema retornará la cantidad de días hábiles que hay entre estas dos fechas.
Si se envía la fecha inicial y el número de días el sistema retornará la fecha hábil que arroja el cálculo.
Esta función se utiliza para calcular la fecha estimada de entrega de las órdenes de producción, pedidos, etc. También se utiliza para calcular la fecha de vigencia de una cotización.
Resultado
Retorna un Json con la cantidad de días hábiles a partir de la fecha especificada.
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 información.
fechainicial: Fecha inicial a partir de la cual se iniciará el cálculo de días hábiles. Este parámetro puede ir acompañado de una fecha final o de un número de días. La fecha debe estar en formato mm/dd/aaaa. (requerido)
dias: Cantidad de días para realizar el cálculo de la fecha hábil. Debe ir acompañado de la fecha inicial.
fechafinal: Fecha hasta la cual se realizará el cálculo de los días hábiles. Debe ir acompañado de la fecha inicial para poder obtener la diferencia de días que hay entre las dos fechas. La fecha debe estar en formato mm/dd/aaaa.
{
"fechainicial": "04/03/2014",
"dias": "15"
}
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/TCatOperaciones/"GetDiasHabiles"/';
//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 = {
"fechainicial": "04/03/2014",
"dias": "15"
};
//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/TCatOperaciones/"GetDiasHabiles"/';
//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 = {
"fechainicial": "04/03/2014",
"fechafinal": "04/18/2014"
};
//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:
dato (varchar): Puede contener una fecha hábil o un número de días.