Calculadora de financiamento imobiliário

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

O que a parcela mensal de um financiamento a taxa fixa significa e como a fórmula de amortização funciona

A parcela mensal de um financiamento imobiliário a taxa fixa é o pagamento constante que o tomador envia para que um principal P a uma taxa nominal anual i por cento fique amortizado em n meses num calendário de saldo decrescente. Essa identidade é a parcela amortizável que os credores publicam para hipotecas convencionais: cada vencimento cobre primeiro os juros sobre o capital em aberto e depois reduz o saldo, de modo que a fatia de juros cai e a de principal sobe embora o caixa da parcela não mude. Os campos de dinheiro arredondam a duas casas para coincidir com a moeda. Tarifas de originação, pontos de desconto, IPTU e seguro residencial não se inventam: some-os ao principal se forem financiados; senão, deixe-os fora do capital. 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 o empréstimo habitacional se cotiza em anos e se amortiza 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. A resposta também informa total_repayment, que é monthly_payment vezes term_months, e total_interest, que é total_repayment menos principal, para que o comprador veja o custo extra real de alongar um título de quinze anos para trinta.

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

Zero, uma fração como trinta ponto cinco, 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 número inteiro de anos não é um financiamento imobiliário a taxa fixa válido. 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 inteiro positivo de anos de um a 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 um inteiro 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, total_repayment, total_interest e uma string de fórmula que reafirma a identidade de amortização e o caso de taxa zero. Exemplo: principal trezentos 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, com total_repayment igual a essa parcela vezes trezentos e sessenta. 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 financiamento imobiliário 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 é um inteiro positivo, em vez de tratar em silêncio um ano fracionário como hipoteca válida. Validação falha, inclusive um prazo que não é inteiro 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 parcela mensal, total a pagar e juros totais para que um conselheiro veja se uma cotação de trinta anos sai mais barata em caixa 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 número inteiro de anos, fixe os campos de dinheiro arredondados nos testes e obtenha parcelas de financiamento imobiliário reproduzíveis para widgets, módulos LMS e workers na borda sem um stack próprio de originação.