SSY-Rechner

Ein negativer Jahresbeitrag wird mit invalid_input zurückgewiesen statt eines stillen negativen Vermögens.

Eingabevertrag, Antwortform und Fehlerverhalten

Fehlgeschlagene Prüfung wird nicht berechnet. Senden Sie per POST einen JSON-Körper mit drei Pflichtzahlen, die endlich sein müssen. yearly ist der wiederkehrende SSY-Beitrag in einer Währung, üblicherweise indische Rupien, obwohl die Identität selbst einheitenlos ist; die Aliase yearly_deposit, deposit, annual, pmt und amount werden akzeptiert, damit Tabellen vertraute Spaltennamen behalten, und der Wert muss zwischen null und einer Billion inklusive liegen. Ein negativer yearly-Beitrag wird mit invalid_input zurückgewiesen und yearly benannt; das ist der vertragliche Fehler und er wird nicht berechnet, weil ein SSY-Konto keinen negativen Beitrag aufnehmen kann. rate ist der Jahreszins in Prozent —acht Punkt zwei bedeutet acht Punkt zwei Prozent pro Jahr, nicht ein Dezimal 0.082, es sei denn, Sie meinen wirklich acht Hundertstel Prozent; die Aliase interest_rate und annual_rate zeigen auf dasselbe Feld. rate muss von null bis einhundert inklusive liegen, damit eins plus der Jahressatz positiv bleibt und die Potenz endlich bleibt. years ist das Einzahlungsfenster, eine ganze Zahl von eins bis fünfzehn inklusive; die Aliase deposit_years, tenure und n werden akzeptiert. Das Schema nimmt nach Jahr fünfzehn keine Einzahlungen mehr an, und dieser Vertrag lehnt eine Zahl außerhalb dieses Fensters ab, statt sie still zu kappen. Fehlt yearly, rate oder years, ist sie nicht endlich oder liegt außerhalb der Spanne, schlägt die Aufgabe mit invalid_input fehl und benennt das Feld. Jedes Feld darf als JSON-Zahl oder als numerische Zeichenkette ankommen. Bei Erfolg gibt der Körper yearly, rate und years als Echo zurück, meldet maturity_years als einundzwanzig und remaining_years als einundzwanzig minus years, und liefert maturity_value, total_deposited und interest_earned half-up auf zwei Dezimalstellen gerundet für stabile währungsartige Goldens, plus eine formula-Zeichenkette, die die vorschüssige geschlossene Form mit Leerlaufkapitalisierung wiederholt. Beispiel: einhundertfünfzigtausend in yearly, acht Punkt zwei Prozent und fünfzehn years Einzahlung sind sechs remaining_years, zweiundzwanzig Lakh fünfzigtausend eingezahlt und eine Fälligkeit im Jahr einundzwanzig.

Wo ein SSY-Rechner seinen Platz verdient

Haushalte in Indien nutzen einen SSY-Rechner, wenn sie einen Fünfzigtausend-Rupien-Jahresplan mit der Eineinhalb-Lakh-Obergrenze über zehn oder fünfzehn Einzahlungsjahre vergleichen und eine Zahl für das Fälligkeitsvermögen plus das Bargeld brauchen, das sie wirklich binden. Postangestellte, Bankbetreuer und zielbasierte Planer brauchen ein deterministisches Orakel, das einen negativen yearly-Beitrag zurückweist, statt still ein negatives Vermögen zu zeigen, das ein fehlerhaftes Formular als Erfolg werten könnte. Wenn Sie später einen monatlichen Fonds-SIP oder einen Sparplan mit Ersteinlage neben wiederkehrenden Beiträgen brauchen, wechseln Sie zu jenen Identitäten, statt diesen Drei-Felder-Vertrag für Sukanya Samriddhi zu überdehnen. Produktteams verdrahten denselben Vertrag in Onboarding-Demos, sodass jemand, der einen Jahresbeitrag, einen bekannt gegebenen Prozentsatz und eine Einzahlungsjahrzahl eingibt, denselben maturity_value sieht, den die API später in Produktionstests zurückgibt. Weil die Umsetzung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Token und ohne ausgehendes Netz. Halten Sie Anfragen klein, nageln Sie gerundete maturity_value- und total_deposited-Werte in Tests fest, und Sie erhalten reproduzierbare SSY-Zahlen für Arbeitsblätter, LMS-Erweiterungen und Edge-Worker, ohne einen eigenen Tabellendienst aufzustellen.