Releases: europace/baufismart-antraege-api
Anträge API Release 2.36
Es gibt ein neues Feld vollTilger
in der Tilgung
(Teil des Darlehens) bei Darlehen vom Darlehenstyp ANNUITAETEN_DARLEHEN
oder FORWARD_DARLEHEN
. Dieses Feld, wenn vorhanden, kann, entweder true
oder false
sein.
Beispiel-Response
...
"tilgung": {
...
"vollTilger": true
...
}
...
Anträge API Release 2.35
Änderungen in Version 2.35
Es gibt ein neues Feld tarifId
im Bausparvertrag
(Teil des Angebots). Dieses enthält die produktanbieter-spezifische Tarif-ID des Bauspartarifs.
Beispiel-Response:
"angebot": {
"bausparvertraege": [
{
"tarif": "BHW WohnBausparen (FI2N) 0,10% | 2,35%",
"tarifId": "FI2N",
"produktAnbieter": {
"produktAnbieterId": "BHW",
"produktAnbieterKurzName": "BHW Bausparkasse",
// ...
},
// ...
}
]
}
Anträge API Release 2.34
Änderungen in Version 2.34
Der bereits als deprecated markierte und ungenutzte Endpunkt /v2/antraege/{vorgang}/{antrag}/angebot
ist entfernt worden.
Anträge API Release 2.33
Änderungen in Version 2.33
Um die Werte der automatischen Kfw Konditionsreservierung mitzuliefern, wurde das AngebotsPruefungsErgebnis um ein neue KfwKonditionsReservierungs-Feld erweitert. Dieses wiederum enthält folgende Felder:
- sofortbestaetigungId: SofortbestätigungID der Kfw für die erfolgreiche Reservierung
- gueltigBis: Gültigkeitsdatum für die erfolgte Reservierung
- erfolgreichReserviert: TRUE bei erfolgter Freischaltung der Konditionsreservierung durch die Kfw Schnittstelle, FALSE bei Fehler, null, wenn keine Sofortbestätigung aufgerufen wurde
- reservierungsMeldung: Detaillierte Meldung im Fehlerfall. Null, wenn kein Fehler aufgetreten ist
{
"pruefungsErgebnisse": [
{
"kfwKonditionsReservierung": {
"sofortbestaetigungId": "100000002428755",
"gueltigBis": "2021-03-01",
"erfolgreichReserviert": true
}
}
]
}
Anträge API Release 2.32
Änderungen in Version 2.32
Für ein bestehendes Darlehen an einer Immobilien liefern wir jetzt 3 neue Felder:
- wirdAbgeloest: true, wenn Darlehen abgelöst werden soll, sonst immer false
- restschuldAktuell: aktuelle Restschuld
- restschuldZumAbloeseTermin: Restschuld zum Ablösetermin
Die beiden Felder abzuloesendeRestschuld, aktuelleRestschuldWennNichtAbzuloesen behalten ihre bisherige Funktion, sind nun aber deprecated und sollten nicht mehr verwendet werden.
{
"finanzierungsObjekt": {
"bestehendeDarlehen": [
{
"wirdAbgeloest": true,
"restschuldAktuell": 25000.00,
"restschuldZumAbloeseTermin": 20000.00
}
]
}
}
Korrekturen
Das Feld darlehensTyp des Objekts AnnuitaetenDarlehen ist nun korrekterweise als required deklariert.
Anträge API Release 2.31
Änderungen in Version 2.31
Ein Gegenangebot ist ein angepasster Finanzierungsvorschlag seitens des Produktanbieters.
Sobald ein Gegenangebot gestellt wird, wird der ursprüngliche Antrag als ABGELEHNT
markiert und ein neuer Antrag erzeugt.
Der neue Antrag wird automatisch markiert als UNTERSCHRIEBEN
seitens des Produktanbieters.
Für ein Gegenangebot kann ein einzelnes Darlehen oder auch eine Kombination von Darlehen angeboten werden.
Die URL zum Senden eines Gegenangebots lautet:
POST https://baufismart.api.europace.de/v2/antraege/AB1234/1/1/gegenangebot
Die Pfadvariable AB1234/1/1
entspricht dem ursprünglichen Antrag für den ein Gegenangebot erstellt werden soll.
Bei Erfolg wird als Antwort ein Link auf den neuen Antrag geliefert.
Beispiel: Erforderlicher RequestBody
{
"kennung": "Gegenangebot zum existierenden Angebot",
"darlehen": [
{
"darlehensTyp": "ANNUITAETEN_DARLEHEN",
"sollZins": 1.17,
"effektivZins": 1.2,
"rateMonatlich": 264.17,
"darlehensBetrag": 100000.00,
"vertriebsProvisionGesamtAbsolut": 1010.00,
"zinsBindungInJahren": 10,
"sonderTilgungJaehrlich": 10.0,
"tilgungsBeginnAm": "2020-11-30",
"produktDetails": "Angepasstes Finanzierung (weitere Beschriebung möglich)",
"anfaenglicheTilgung": 2.0,
"bereitstellungsZinsFreieZeitInMonaten": 3,
"bereitstellungsZins": 3.0,
"laufzeitKalkulatorischInJahren": 39
}
]
}
Anträge API Release 2.30
Änderungen in Version 2.30
Es gibt neue abgesicherte Risiken (abgesichertesRisiko
) in RisikoAbsicherung
:
SCHWERE_KRANKHEIT
ASSISTANCE_ARBEITSUNFAEHIGKEIT
ASSISTANCE_ARBEITSLOSIGKEIT
Beispiel Response:
"angebot": {
"absicherungen": [
{
"abgesicherteRisiken": [
{
"abgesichertesRisiko": "SCHWERE_KRANKHEIT",
"auszahlungsBetrag": 1000.00,
"auszahlungsTurnus": "MONATLICH",
"praemienAnteil": 250.00
}
]
}
]
}
Anträge API Release 2.29
Änderungen in Version 2.29
Das Darlehen wird erweitert.
Es gibt ein neues Number-Attribut konditionsAnpassungsDelta
. Sollte eine Kondition angepasst worden sein, gibt
dieses die Prozentpunkte des Anpassungs-Deltas an. D.h. die Differenz aus jetziger, angepasster Kondition, und der ursprünglichen Kondition.
Z.b. angepasste Kondition 1,45%, ursprüngliche Konditionn 1,50% -> Anpassungsdelta = -0,05%
Außerdem wird nun bei jedem Darlehen, unabhängig von der Art, das Attribut auszahlungsDatum
gefüllt. Dieses wird entweder vom Kunden ausgefüllt oder von uns berechnet.
"darlehen":
[
{
"konditionWurdeManuellAngepasst": true,
"konditionsAnpassungsDelta": 0.18,
"auszahlungsDatum": "2020-11-30"
}
]
Anträge API Release 2.28
Änderungen in Version 2.28
Erweiterung des Antrags um das boolean entscheidungsreifeVomVertriebSignalisiert
. Dieses Feld wird vom Vertrieb gesetzt und soll dem Kreditsachbearbeiter anzeigen, dass der Antrag fertig zur Bearbeitung ist.
"antraege":
[
{
"entscheidungsreifeVomVertriebSignalisiert": false,
}
]
Anträge API Release 2.27
Folgende Änderungen sind in Version 2.27 enthalten
Erweiterung von AngebotZumAntrag
um Prüfungsergebnisse. Diese bilden eine Bewertung der Machbarkeit bei der Angebotsermittlung seitens des Produktanbieters ab. (Momentan ist dieses Feld nur für die Deutsche Bank relevant.)
Beispiel-Resonse
"angebot" : {
// ...
"pruefungsErgebnisse" : [{
"produktAnbieterId" : "PRODKUTANBIETER_ID",
"bewertung" : {
"id" : "<bewertungs_id_im_system_des_produktanbieters"
}
}]
}