Calculadora de hipoteca simples

Um prazo que não seja positivo falha com invalid_input em vez de inventar um cronograma.

O que a parcela mensal de uma hipoteca simples significa e como a fórmula de amortização funciona

A taxa mensal r é o percentual anual dividido por mil e duzentos: r é igual a annual_rate dividido por doze e por cem. O número de pagamentos n é term_years vezes doze, porque hipotecas se cotizam em anos e se amortizam mês a mês. Quando r é maior que zero, a forma fechada é monthly_payment igual a P vezes r vezes (1 mais r) elevado a n, dividido por (1 mais r) elevado a n menos um. Quando a taxa anual é zero o denominador seria zero, então a calculadora passa ao caso especial honesto monthly_payment igual a P dividido por n, que é como se faturam títulos genuinamente sem juro e alguns contratos financiados pelo vendedor.

Contrato de entrada, a regra do prazo positivo e o formato da resposta

Zero, um número negativo, um booleano ou uma string não numérica nunca produzem um cronograma fictício, porque um prazo hipotecário que não seja um trecho positivo de anos não é uma hipoteca simples válida. Anos fracionários são aceitos quando ainda são positivos, de modo que um prazo restante de cinco anos e meio pode ser precificado sem arredondá-lo antes a um inteiro. Envie por POST um corpo JSON com três campos obrigatórios: principal, o valor financiado como número finito estritamente maior que zero (aliases amount e loan_amount); annual_rate, o juro nominal anual como percentual —6.5 para seis e meio por cento ao ano—, finito e pelo menos zero (aliases rate e interest_rate); e term_years, o prazo como número finito positivo de anos até cinquenta (aliases term e years). Cada campo numérico pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias, valores não finitos, um principal não positivo e um annual_rate negativo falham com invalid_input nomeando o campo e não são cobrados. A regra distintiva do produto é o prazo: term_years deve ser positivo. Em caso de sucesso o corpo ecoa principal, annual_rate e term_years, e acrescenta term_months (term_years vezes doze), monthly_rate (annual_rate dividido por mil e duzentos), monthly_payment arredondado a duas casas e uma string de fórmula que reafirma a identidade de amortização e o caso de taxa zero. Exemplo: principal duzentos e cinquenta mil, annual_rate 6.5, term_years trinta produz uma taxa mensal de um doze avos de seis e meio por cento e uma parcela arredondada a duas casas. Combine a cifra com a sua própria tabela de impostos e seguro; este endpoint calcula só a matemática da parcela e não emite um quadro de amortização linha a linha.

Onde uma calculadora de hipoteca simples agrega valor

Educadores que ensinam amortização versus empréstimos só de juros podem semear exemplos de aula que falhem alto quando o prazo não é positivo, em vez de tratar em silêncio um título de zero anos como hipoteca válida. Hipóteses de prazo restante que usam um ano fracionário, como um refinanciamento com cinco anos e meio pela frente, cabem no mesmo contrato porque a regra do prazo é a positividade, não uma restrição de inteiro. Validação falha, inclusive um prazo que não é positivo, não consome saldo. Ferramentas de cotação e CRMs de originação podem chamar o mesmo módulo puro no navegador para prévias gratuitas e na API ao gravar um cenário, garantindo que a parcela mensal que um visitante viu coincida com a parcela mensal armazenada depois de gravar a cotação. Planilhas de capacidade de pagamento já conhecem o valor financiado; enviar principal, annual_rate e term_years preenche um cartão com a parcela de principal e juros para que um conselheiro veja se uma cotação de trinta anos sai mais barata em caixa a cada mês do que um título de quinze com um golpe mensal mais alto. Equipes de conteúdo podem ilustrar financiamento do vendedor a zero por cento com annual_rate zero, onde monthly_payment se reduz a principal sobre term_months sem dividir por zero. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída. Mantenha o principal estritamente positivo e term_years como um trecho positivo de anos, fixe os campos de dinheiro arredondados nos testes e obtenha parcelas de hipoteca simples reproduzíveis para widgets, módulos LMS e workers na borda sem um stack próprio de originação.