mcp-hypotheken-berekenen

{ "properties": { "aanvragers": { "description": "Gegevens van de aanvrager(s). Vraag altijd naar inkomen en leeftijd. Bij 'heeft_partner: true' ook naar inkomen en leeftijd van partner vragen.", "properties": { "geboortedatum_aanvrager": { "description": "Geboortedatum aanvrager in formaat YYYY-MM-DD. TIP: Vraag de gebruiker naar zijn/haar leeftijd en reken dit om naar een geboortedatum waarbij de persoon morgen jarig wordt. Bijvoorbeeld: leeftijd 20 → morgen 21, dus gebruik vandaag als geboortedatum (24 oktober 2005).", "type": "string" }, "geboortedatum_partner": { "description": "OPTIONEEL - Geboortedatum partner in formaat YYYY-MM-DD. Alleen vereist indien heeft_partner: true. TIP: Vraag naar leeftijd en reken om zoals bij hoofdaanvrager.", "type": "string" }, "heeft_partner": { "description": "Heeft de aanvrager een partner? Als true, vraag dan ook naar inkomen_partner en geboortedatum_partner.", "type": "boolean" }, "inkomen_aanvrager": { "description": "Jaarinkomen van de hoofdaanvrager in euro's", "type": "number" }, "inkomen_partner": { "description": "OPTIONEEL - Jaarinkomen van de partner in euro's. Alleen vereist indien heeft_partner: true", "type": "number" }, "verplichtingen_pm": { "description": "Maandelijkse verplichtingen in euro's (bijv. andere leningen, alimentatie). Als niets wordt genoemd, gebruik 0.", "type": "number" } }, "required": [ "inkomen_aanvrager", "heeft_partner", "geboortedatum_aanvrager", "verplichtingen_pm" ], "type": "object" }, "bestaande_lening": { "description": "OPTIONEEL - Alleen voor doorstromers (mensen met een huidige koopwoning en hypotheek). Voor starters (eerste woning) dit object NIET meesturen. Er zijn twee invulmogelijkheden: 1) SIMPEL: Vraag naar totale schuld, gemiddelde rente, en resterende looptijd. Gebruik dan 1 leningdeel met rvp_months: 10 en loan_type: 'annuiteit'. 2) GEDETAILLEERD: Als gebruiker alle details van verschillende leningdelen deelt, voer deze allemaal in voor een nauwkeurigere berekening.", "properties": { "existing_loan_parts": { "description": "Bestaande leningdelen. Voor simpele berekening: 1 leningdeel met totale schuld, gemiddelde rente, resterende looptijd, rvp_months: 10, loan_type: 'annuiteit'. Voor gedetailleerde berekening: alle leningdelen apart invoeren.", "items": { "properties": { "contract_rate": { "description": "Contractrente als decimaal (bijv. 0.02 voor 2%, 0.041 voor 4.1%)", "type": "number" }, "loan_type": { "description": "Type lening: 'annuiteit' (vaste maandlast), 'lineair' (aflopende maandlast), of 'aflossingsvrij' (alleen rente). Bij simpele berekening: gebruik 'annuiteit'.", "enum": [ "annuiteit", "lineair", "aflossingsvrij" ], "type": "string" }, "principal": { "description": "Hoofdsom van het leningdeel (restschuld in euro's)", "type": "number" }, "rvp_months": { "description": "Resterende rentevaste periode in maanden. Bij simpele berekening: gebruik 10 maanden.", "type": "number" }, "term_months": { "description": "Resterende looptijd in maanden", "type": "number" } }, "required": [ "principal", "contract_rate", "term_months", "rvp_months", "loan_type" ], "type": "object" }, "type": "array" }, "waarde_huidige_woning": { "description": "Huidige waarde van de woning in euro's", "type": "number" } }, "required": [ "waarde_huidige_woning", "existing_loan_parts" ], "type": "object" }, "nieuwe_lening": { "description": "OPTIONEEL - Parameters voor de nieuwe lening. Alleen invullen als de gebruiker specifieke vragen stelt over looptijd, rente, energielabel, NHG, LTV of leningtype. Als de gebruiker hier niets over zegt, dan dit object NIET meesturen - de API gebruikt dan standaardwaarden. Je kunt ook maar een deel van de velden invullen (bijv. alleen rente), de rest wordt dan standaard ingevuld.", "properties": { "energielabel": { "description": "OPTIONEEL - Energielabel van de nieuwe woning (A, B, C, D, E, F, of G), of null als onbekend. Alleen invullen als gebruiker dit noemt.", "type": [ "string", "null" ] }, "loan_type": { "description": "OPTIONEEL - Type nieuwe lening: 'annuiteit' (vaste maandlast, meest gebruikt), 'lineair' (aflopende maandlast), of 'aflossingsvrij' (alleen rente betalen). Alleen invullen als gebruiker hier specifiek naar vraagt.", "enum": [ "annuiteit", "lineair", "aflossingsvrij" ], "type": "string" }, "looptijd_jaren": { "description": "OPTIONEEL - Looptijd van de nieuwe lening in jaren (bijv. 30). Alleen invullen als gebruiker hierover vraagt.", "type": "number" }, "ltv": { "description": "OPTIONEEL - Loan-to-Value percentage (bijv. '100%', '90%', '80%'). Alleen invullen als gebruiker hierover vraagt.", "type": "string" }, "nhg": { "description": "OPTIONEEL - Nationale Hypotheek Garantie van toepassing? Alleen invullen als gebruiker hierover vraagt.", "type": "boolean" }, "rente": { "description": "OPTIONEEL - Rentepercentage als getal (bijv. 4.1 voor 4.1%, 3.5 voor 3.5%). Alleen invullen als gebruiker een specifieke rente noemt.", "type": "number" }, "rentevast_periode_jaren": { "description": "OPTIONEEL - Rentevaste periode in jaren (bijv. 10, 15, 20). Alleen invullen als gebruiker hierover vraagt.", "type": "number" } }, "type": "object" } }, "required": [ "aanvragers" ], "type": "object" }