Santander-lsch NPM

Librería de Simulador Hipotecario Santander

Librería que contiene las funciones necesarios para el simulador hipotecario requerido por Santander

Cómo instalar?

Basta con descargar el archivo index.js, agregarlo a tu proyecto con algún otro nombre de ser necesario, e importarlo dónde sea necesario, por ejemplo, en la raíz del proyecto lo guardas con el nombre:

santander-sch.js

Entonces para importarlo en un archivo js dónde se desea usar debe ser de la siguiente manera:

import { generaTablaNanios } from './santander-sch.js';

De esa manera podremo hacer uso de la función:

generaTablaNanios

Otra forma de instalar

Puede instalarse como un paquete de npm usando un servidor repositorio de paquetes de npm local como sinopia:

https://github.com/rlidwka/sinopia

Constantes globales

Las constantes globales se definen en el archivo constants.js:

PERIODICIDAD: Constante que define la periodicidad de los pagos hipotecarios.

TASA_DE_INTERES_BASE: Tasa de interés base, por default el valor es del 7.0%.

TABLA_DE_PORCENTAJES: Tabla de porcentajes de descuento por plan por cada año, a continuación se muestra la estrutura que debe de tener, dicha tablas de descuentos puede cambiarse de acuerdo a lo que se desea mientras se respete la estructura definida que a continuación se presenta:

{
  "10": {
    "1": 3,
    "2": 5,
    "3": 6,
    "4": 7,
    "5": 9,
    "6": 11,
    "7": 12,
    "8": 14,
    "9": 16,
    "10": 17
  },
  "15": {
    "1": 2,
    "2": 2,
    "3": 3,
    "4": 3,
    "5": 4,
    "6": 5,
    "7": 6,
    "8": 7,
    "9": 8,
    "10": 10,
    "11": 10,
    "12": 10,
    "13": 10,
    "14": 10,
    "15": 10
  },
  "20": {
    "1": 1.5,
    "2": 1.5,
    "3": 2,
    "4": 2,
    "5": 3,
    "6": 3,
    "7": 4,
    "8": 4,
    "9": 4.5,
    "10": 4.5,
    "11": 5,
    "12": 5,
    "13": 6,
    "14": 6,
    "15": 7,
    "16": 7,
    "17": 8,
    "18": 8,
    "19": 9,
    "20": 9
  }
}

Donde '10', '15', '20' corresponden al plan en años, y los números de 1 a N, corresponden a los años del plan, y por cada año se especifica el porcentaje de descuento que se le dará en cada periodo.

Funciones implementadas

`calculaAbono`

Está función retorna un renglon de los que se conforma la tabla, se explican los parámetros que puede recibir:

parámetros

plan(str) : Plan hipotecario(años) como cadena.

importe(float|int): Importe total del préstamo hipotecario.

anio(int): Año en el que se está efectuando el abono o pago.

saldoActual(float|int): Saldo actual cuando se ejecuta el cálculo del abono.

periodicidad(float|int): Periodicidad, por lo gral será el valor guardado en la variable de ambiente.

tasaDeInteres(float|int): Tasa de interés que se aplicará para el cálculo del abono, definida como variable de ambiente.

pagoAdelantado(float|int|null): Monto del pago que se dese adelantar en el periodo deseado.

Valor de retorno

Retorna el siguiente javascript object:

{
    'porcentaje_descuento': porcentajeDescuento, 'anio': anio, 'saldo': saldoActual,
    'abono': abono, 'interes': pagoAIntereses, 'capital': pagoACapital,
    'pago_adelantado': pagoAdelantado, 'nuevo_saldo': nuevoSaldo
}

`generaTabla10anios`

Esta función recibe los mismos parámentros que la función anterior, sólo en parámetro de plan no lo recibe, debido a que se calcula para 10 años.

Parámetros

importe(float|int): Monto total del préstamo.

valorInmueble(float|int): Valor real del inmueble.

pagosAdelantados(list[floats]): Lista de pagos adelantados aplicados al simulador, el tamaño de la lista debe ser del mismo tamaño que la cantidad de periodos o pagos.

periodicidad(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la periodicidad definida como variable de ambiente.

tasaDeInteres(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la tasa de interés definidad como variable de ambiente.

Valor de retorno

Retorna el mismo javascript object que la función generaTablaNanios.

`generaTabla15anios`

Esta función recibe los mismos parámentros que la función anterior, sólo en parámetro de plan no lo recibe, debido a que se calcula para 15 años.

Parámetros

importe(float|int): Monto total del préstamo.

valorInmueble(float|int): Valor real del inmueble.

pagosAdelantados(list[floats]): Lista de pagos adelantados aplicados al simulador, el tamaño de la lista debe ser del mismo tamaño que la cantidad de periodos o pagos.

periodicidad(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la periodicidad definida como variable de ambiente.

tasaDeInteres(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la tasa de interés definidad como variable de ambiente.

Valor de retorno

Retorna el mismo javascript object que la función generaTablaNanios.

`generaTabla20anios`

Esta función recibe los mismos parámentros que la función anterior, sólo en parámetro de plan no lo recibe, debido a que se calcula para 20 años.

Parámetros

importe(float|int): Monto total del préstamo.

valorInmueble(float|int): Valor real del inmueble.

pagosAdelantados(list[floats]): Lista de pagos adelantados aplicados al simulador, el tamaño de la lista debe ser del mismo tamaño que la cantidad de periodos o pagos.

periodicidad(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la periodicidad definida como variable de ambiente.

tasaDeInteres(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la tasa de interés definidad como variable de ambiente.

Valor de retorno

Retorna el mismo javascript object que la función generaTablaNanios.

`generaTablaNanios`

Genera una tabla con la simulación de abonos que se realizarán para cubrir el importe recibido con sus respectivos intereses.

Parámetros

importe(float|int): Monto total del préstamo.

valorInmueble(float|int): Valor real del inmueble.

plan(str): Plan hipotecario en años, puede ser 10, 15, o 20 años.

pagosAdelantados(list[floats]): Lista de pagos adelantados aplicados al simulador, el tamaño de la lista debe ser del mismo tamaño que la cantidad de periodos o pagos.

periodicidad(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la periodicidad definida como variable de ambiente.

tasaDeInteres(float|int): Si este parámetro es pasado, sobreescribe el valor asignado a la tasa de interés definidad como variable de ambiente.

Valor de retorno

Retorna un javascript object con la siguiente estructura:

dotenv financejs html-pdf path

@everything-registry/sub-chunk-2708

0.1.10

7 months ago