ForHosting KIT · Finanças e dinheiro

AGI

Calcule o AGI que sustenta o resto da declaração de imposto: renda bruta de 85.000 menos 2.500 de juros de crédito estudantil e 6.500 de aportes a uma IRA deixa 76.000. A dedução padrão e os créditos vêm depois e ficam de fora. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve

Roda direto no seu navegador. Grátis, sem cadastro — seus dados não são enviados para lugar nenhum.

A calculadora de renda bruta ajustada pega a sua renda bruta e uma lista de deduções above-the-line — juros de empréstimos estudantis, contribuições para contas IRA, despesas de educadores, aportes em contas de poupança de saúde e itens semelhantes — e devolve o AGI que ancora o restante de uma declaração de imposto de renda. O AGI é o número que determina a elegibilidade para créditos, os limites de dedução e muitos cálculos fiscais estaduais, por isso é importante acertá-lo antes de qualquer etapa posterior. O mesmo código determinístico roda de graça no seu navegador nesta página, então você só paga quando automatiza o processo.

O que a renda bruta ajustada realmente é

A renda bruta ajustada não é um palpite nem uma estimativa — é uma subtração definida. Começa-se pela renda bruta, que é a soma de tudo o que foi ganho no período: salários, rendimentos de trabalho autônomo, juros, dividendos, aluguéis, distribuições de aposentadoria e qualquer outra entrada tributável. Sobre esse total, as regras fiscais permitem uma lista específica de subtrações chamadas deduções above-the-line, porque são aplicadas antes da linha da renda bruta ajustada na declaração, e não depois.

Entre os itens mais comuns estão os juros de empréstimos estudantis, as contribuições para contas IRA tradicionais e para contas de poupança de saúde, a parte dedutível do imposto sobre o trabalho autônomo, as despesas de educadores e a pensão alimentícia paga sob acordos antigos. O que sobra depois de subtraí-las é o AGI. A calculadora de renda bruta ajustada executa exatamente essa operação: pega o valor bruto e as deduções itemizadas, valida cada entrada e devolve a diferença.

Ela não aplica deduções padrão ou itemizadas, regras de estado civil nem créditos — tudo isso vem depois do AGI, e confundir esses conceitos é o erro mais comum na matemática fiscal informal.

Como funcionam o cálculo e a sua validação

Os valores das deduções são somados e comparados com a renda bruta: quando o total ultrapassa o que foi ganho, a requisição é rejeitada com um erro tipado, porque um AGI abaixo de zero vindo apenas de deduções above-the-line indica que as entradas foram misturadas, normalmente pela inclusão de itens below-the-line como a dedução padrão ou juros de hipoteca.

Quando as entradas passam, a resposta devolve o AGI, a renda bruta, o total das deduções e a lista itemizada conforme recebida, tudo arredondado para duas casas decimais, de modo que a saída seja estável byte a byte entre máquinas e segura para guardar em uma trilha de auditoria.

O cálculo é aritmética pura, sem chamadas de rede, sem aleatoriedade e sem relógio, o que significa que a mesma requisição sempre produz a mesma resposta — uma propriedade que importa quando um resultado precisa ser reproduzido meses depois em uma revisão ou auditoria.

Onde o AGI se encaixa em fluxos de trabalho reais

O AGI é o número central de uma declaração de imposto de renda: a elegibilidade para créditos educacionais, contribuições para contas Roth IRA, créditos fiscais para prêmios e muitos limites de dedução é expressa como um limiar sobre o AGI ou sobre o AGI modificado, que parte dele. Ferramentas de folha de pagamento e benefícios o recalculam quando um funcionário ajusta uma contribuição pré-imposto; formulários de ajuda financeira o pedem literalmente; credores o usam como verificação de coerência diante da renda declarada.

Incorporar esta calculadora nesses fluxos substitui uma célula de planilha por um contrato validado: quem chama recebe um AGI correto ou um erro claro que nomeia o campo problemático, nunca um número errado com aparência plausível. Como o mesmo módulo roda no navegador nesta página, um desenvolvedor pode colar exatamente a carga que a sua integração vai enviar e confirmar o resultado antes de escrever qualquer código.

Estimar a elegibilidade para créditos fiscais

Calcule primeiro o AGI e depois compare com os limiares dos créditos educacionais ou dos limites de contribuição para aposentadoria.

Simular uma mudança em contribuição pré-imposto

Adicione ou remova uma contribuição para conta IRA ou HSA da lista de deduções e veja imediatamente como o AGI se move.

Quanto custa?

Também é grátis rodar no seu navegador nesta página — o mesmo código produz as duas respostas.

Quais deduções contam como above-the-line?

Itens como juros de empréstimos estudantis, contribuições para contas IRA tradicionais e HSA, despesas de educadores e a parte dedutível do imposto sobre trabalho autônomo. A ferramenta aceita qualquer lista que você fornecer; decidir o que se qualifica é trabalho do seu contador.

O que acontece se as deduções superarem a renda bruta?

O AGI vindo apenas de deduções above-the-line não pode ficar abaixo de zero, então essa situação significa que as entradas foram misturadas.

Valores negativos são permitidos?

Não. A renda bruta e cada valor de dedução devem ser finitos e maiores ou iguais a zero. Um valor negativo dispara um erro tipado que nomeia o campo.

Os meus dados de renda ficam armazenados?

Não. Os números são processados em memória e descartados; apenas o resultado calculado é devolvido.

Ele calcula imposto a pagar ou restituição?

Não. Ele para no AGI. Renda tributável, faixas de imposto, créditos e restituições vêm depois do AGI e estão fora do escopo desta capacidade.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/fin/agi

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/fin/agi \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gross_income":85000,"deductions":[{"label":"student loan interest","amount":2500},{"label":"traditional IRA contribution","amount":6500}]}'
{
  "gross_income": 85000,
  "deductions": [
    {
      "label": "student loan interest",
      "amount": 2500
    },
    {
      "label": "traditional IRA contribution",
      "amount": 6500
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.agi",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Você envia a renda bruta e as deduções como dados estruturados; o API valida cada valor, soma as deduções, subtrai e devolve o AGI junto com o detalhamento itemizado.

Como funcionam o cálculo e a sua validação

O endpoint aceita dois campos: um valor de renda bruta e um array de registros de dedução, cada um com um rótulo e um valor. Todo número precisa ser finito e maior ou igual a zero — uma dedução negativa não é um crédito, é um erro de dados, e o API aponta isso em vez de somar renda silenciosamente.

Onde o AGI se encaixa em fluxos de trabalho reais

Em seguida, o API cobra US$ 0,002 por requisição pela resposta idêntica, sem mínimos e sem reter dados — os números são processados e descartados, e apenas o resultado calculado volta para quem chamou.

Validar os números antes de declarar

Envie a renda bruta e as deduções exatamente como foram levantadas e deixe o API detectar valores negativos ou deduções que superam a renda.

Ver a documentação completa do KIT →