ForHosting KIT · Strumenti per sviluppatori

Stima Social Security

Questo stimatore della prestazione Social Security converte la media mensile dei guadagni indicizzati in un importo assicurativo primario stimato, cioè il valore mensile calcolato prima delle rettifiche legate all’età di decorrenza.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Suddivide l’AIME fra le fasce inferiore, intermedia e superiore, applica a ciascuna una percentuale di sostituzione e mostra ogni subtotale. Lei può mantenere i punti predefiniti, indicati con chiarezza, oppure inserire quelli relativi all’anno di idoneità pertinente.

Parta dall’AIME e dall’anno dei punti di flesso corretti

La media mensile dei guadagni indicizzati, abbreviata in AIME, non coincide con lo stipendio attuale, l’ultima paga mensile o una semplice media dell’intera carriera. Il procedimento sullo storico Social Security indicizza prima i guadagni coperti, seleziona gli anni di calcolo applicabili, li somma e converte il totale in una media mensile secondo le regole del programma. Questo stimatore parte dal risultato di quel procedimento; inserisca quindi un AIME ricavato da uno storico o da un calcolo adeguato. Lo strumento non ricostruisce l’AIME partendo dalle retribuzioni annuali. Anche i punti di flesso dipendono dall’anno in cui la persona diventa idonea per la prima volta, non necessariamente dall’anno solare in cui viene richiesta la stima o inizia la prestazione. I valori predefiniti inferiore e superiore sono espressamente quelli del 2025: 1,226 e 7,391 dollari. Per un altro anno di idoneità, li sostituisca entrambi con la coppia pubblicata ufficialmente. Allineare AIME e punti è essenziale, perché associare un punto recente a un anno precedente può generare un risultato credibile ma errato.

Verifichi come le tre aliquote determinano il PIA

La formula è progressiva: sostituisce una quota maggiore dei guadagni nella prima fascia rispetto alle successive. Lo stimatore assegna l’AIME fino al primo punto di flesso, distribuisce il residuo sulla distanza fra i due punti e colloca nella terza fascia qualsiasi importo superiore al secondo. Per impostazione predefinita, queste quote vengono moltiplicate per 90, 32 e 15 per cento. Il risultato include la quota AIME e il contributo di ciascuna fascia, così Lei può verificare il calcolo invece di accettare un numero opaco. Se l’AIME è inferiore al primo punto, i contributi intermedio e superiore sono pari a zero; se si trova fra i due punti, contribuiscono solo le prime due fasce. I tre contributi vengono sommati in `pia_before_dime_rounding`, mostrato con i centesimi per chiarire il calcolo. Il PIA mensile stimato viene poi arrotondato per difetto al decimo di dollaro inferiore. È diverso dall’arrotondamento ordinario: un totale grezzo di 2,345.67 diventa 2,345.60. Le aliquote modificabili consentono scenari controllati, ma per la formula ordinaria vanno generalmente mantenuti i valori standard.

Interpreti la stima senza attribuirle una portata eccessiva

Il PIA mensile stimato è un passaggio della formula, non necessariamente l’importo che verrà accreditato sul conto. In genere rappresenta il valore iniziale associato all’età pensionabile piena prima di altre disposizioni e scelte temporali. Richiedere la pensione in anticipo può ridurre il pagamento, mentre i crediti per il rinvio possono aumentarlo. Adeguamenti al costo della vita, premi Medicare, ritenute, massimali familiari, prestazioni accessorie o ai superstiti, regole di invalidità e disposizioni speciali possono modificare il pagamento effettivo. Questa capacità non modella tali elementi, non prevede una data di richiesta e non offre consulenza finanziaria. Il suo scopo è più circoscritto: dati un AIME, due punti e tre aliquote, produce sempre un calcolo deterministico e verificabile per fasce. Usi il dettaglio per controllare un foglio di calcolo, illustrare la sostituzione progressiva, collaudare un’interfaccia di pianificazione o confrontare anni ufficiali diversi. Per una decisione personale, confermi lo storico e le ipotesi tramite fonti ufficiali o un professionista qualificato. Il browser è gratuito; le richieste automatizzate costano $0.002.

Casi d'uso

Controllare un prospetto pensionistico

Ricalcoli il PIA con un AIME noto e i punti dell’anno di idoneità, quindi confronti ogni fascia con il Suo prospetto di pianificazione.

Spiegare la sostituzione progressiva

Mostri come le fasce del 90, 32 e 15 per cento contribuiscono con importi diversi a un’unica prestazione mensile stimata.

Collaudare un’applicazione previdenziale

Usi l’API deterministica per generare risultati attesi e verificabili per moduli, calcolatori e software didattici sulla pensione.

Domande frequenti

Che cos’è l’AIME?

L’AIME è la media mensile dei guadagni indicizzati. Deriva dai guadagni coperti secondo le regole di indicizzazione e calcolo Social Security; non è semplicemente l’ultimo stipendio mensile.

Quali punti di flesso devo usare?

Usi quelli dell’anno in cui la persona diventa idonea per la prima volta secondo le regole applicabili. I valori predefiniti sono indicati come valori del 2025 e possono essere sostituiti.

Perché il calcolatore arrotonda per difetto al decimo?

La formula del PIA arrotonda per difetto ai dieci centesimi inferiori. La risposta include anche il totale precedente, affinché Lei possa verificare la differenza.

Il PIA mensile stimato sarà il mio pagamento?

Non necessariamente. Età della richiesta, adeguamenti, trattenute Medicare, ritenute, regole familiari e altre disposizioni possono modificare l’importo reale.

Quanto costa lo stimatore?

Lei può utilizzarlo gratuitamente nel browser. Ogni richiesta API costa $0.002 e il calcolo non impiega servizi di rete esterni.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/finance/social-security-estimate

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/finance/social-security-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"aime":5000}'

const res = await fetch("https://api.kit.forhosting.com/finance/social-security-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "aime": 5000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/social-security-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "aime": 5000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/social-security-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"aime":5000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"aime":5000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/social-security-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "aime": 5000
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.social_security_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →