カリフォルニア刺激給付計算機

負の調整総所得は invalid_input として拒否され、課金されません。成功した呼び出しは $0.002 で課金されます。

カリフォルニア刺激給付とは何か、FTB 表の仕組み

本エンドポイントが符号化するのは、FTB 公示 2022-13 のドル表です。世帯主と qualifying_widow（生存配偶者）は同じ合算上限を共有しますが、ドル列は低く、扶養なしで三百五十・二百五十・二百ドル、扶養があると倍になります。

入力契約・申告区分・エラー時の扱い

agi は還付が使った 2020 年申告の、合衆国ドル建てのカリフォルニア調整総所得です。負の金額も拒否され、所得は負にできないというメッセージになります。これが本ページの製品契約です。dependents はその申告で請求した扶養の整数で、ゼロから二十までです。整形文字列より裸の数字を使い、通貨記号や桁区切りは解析しません。必須の三欄を含む JSON 本体を POST してください。filing_status は公式の表を選び、single・married_joint・married_separate・head_of_household・qualifying_widow のいずれかでなければなりません。別名 status と filing を受け付け、mfj・mfs・hoh・qss などの略称は正規値に解決されます。qualifying_widow は head_of_household の生存配偶者表を使い、FTB の区分に合わせます。未知の区分は許容値を列挙して invalid_input で失敗します。ゼロ以上の有限数でなければならず、表計算の書き出しで列名を変えなくて済むよう income・adjusted_gross_income・california_agi の別名を受け付けます。agi が欠落、空、NaN、Infinity、非数値文字列、その他有限数でない場合、タスクは agi を名指しして invalid_input で失敗し、課金されません。別名 dependent_count と num_dependents を受け付けます。小数の人数、負の人数、公表上限を超える値は invalid_input で失敗します。成功時は正規の filing_status、丸めた agi、dependents を返し、表がゼロを払うときは偽になるブールの eligible、引き当てたドルの estimated_payment、その帯の扶養なし列の base_payment、扶養が一人以上のときの追加ドルの dependent_bonus、has_dependent、low・middle・upper・ineligible の income_band、married_joint・head_of_household・individual の schedule_group、middle_class_tax_refund の program、2020 の return_year と 2022 の payment_year、formula 文字列を返します。成功した一件の料金は定額の $0.002 です。

カリフォルニア刺激給付の計算機が真価を発揮する場面

JSON API で多くの世帯をまとめる計画スクリプトは、人がページで見るのと同じドルを得ます。実装は解析の parse レベル A の解析コードのため、成功した呼び出しはモデルトークンも外向きネットワークもなく $0.002 のまま安価です。リクエストを小さく保ち、テストで estimated_payment と eligible を固定すれば、自前の税エンジンを建てずに、ランディング、解説、軽い家計ノート向けに再現可能な中流層税還付の数字が得られます。