Calculadora de hipoteca

Se o principal não for positivo, a tarefa falha com invalid_input em vez de inventar uma cotação.

O que significa a parcela de uma hipoteca residencial a taxa fixa e como os totais de amortização são montados

A parcela mensal de uma hipoteca residencial a taxa fixa é o pagamento constante que o mutuário envia para que um principal P a uma taxa nominal anual i por cento fique amortizado em n meses num cronograma de saldo decrescente. Essa identidade é a parcela amortizável que as instituições 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 capital sobe embora o caixa da parcela não mude. Taxas de originação, pontos de desconto, IPTU e seguro residencial não são inventados: 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 a hipoteca residencial é cotada em anos e amortizada 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. Depois de arredondar a parcela para centavos, este endpoint percorre o cronograma em centavos inteiros em vez de multiplicar a parcela arredondada por n e torcer para os centavos sobrantes sumirem. Cada mês o juro é arredondado a partir do saldo atual, o principal da parcela é o pagamento menos esse juro, e o último pagamento (ou uma quitação antecipada) absorve o resto para que total_principal, total_interest e total_paid sejam os totais de amortização do título que o mutuário realmente paga.

Contrato de entrada, a regra do principal positivo e a forma da resposta

Zero, um valor negativo, um booleano ou uma cadeia não numérica nunca produzem um cronograma fictício, porque uma hipoteca sem capital não é uma cotação que ninguém consiga fechar. 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.75 para seis e três quartos 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 cadeia numérica. Campos ausentes, cadeias vazias, valores não finitos e um annual_rate negativo falham com invalid_input nomeando o campo e não são faturados. A regra distintiva do produto é o principal: principal 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, payments (quantas parcelas o percurso realmente lançou), total_principal, total_interest, total_paid, final_payment (a última parcela após o arredondamento) e uma cadeia de fórmula que reafirma a identidade de amortização, o caso de taxa zero e que os totais vêm do percurso de saldo decrescente. Exemplo: principal duzentos e cinquenta mil, annual_rate 6.75, term_years trinta produz uma taxa mensal de um doze avos de seis e três quartos por cento e uma parcela arredondada a dois decimais, com totais de amortização tomados de trezentos e sessenta passos de saldo decrescente em vez de uma única multiplicação. Junte a cifra à 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 residencial vale o seu lugar

Educadores que ensinam amortização versus hipotecas só de juros podem semear exemplos de aula que falhem alto quando o principal não é positivo, em vez de tratar em silêncio um empréstimo nulo ou negativo como hipoteca válida. A validação falha, inclusive um principal que não é positivo, não consome saldo. Ferramentas de cotação e CRMs de originação podem chamar o mesmo módulo puro a partir do navegador para prévias gratuitas e a partir da 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 monthly_payment, total_principal, total_interest e total_paid para um consultor ver se uma cotação de trinta anos sai mais barata em caixa do que um título de quinze com um golpe mensal maior. Equipes de conteúdo podem ilustrar financiamento do vendedor a zero por cento com annual_rate zero, em que monthly_payment se reduz a principal sobre term_months e o percurso de amortização informa total_interest de zero salvo o arredondamento. Como a implementação é parse pura de tier 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 um número inteiro de anos, fixe os campos de dinheiro arredondados nos testes, e você obtém parcelas de hipoteca residencial reproduzíveis para widgets, módulos LMS e workers na borda sem um stack próprio de originação.