Anträge API Release 2.38

Neuer Parameter angenommenVor

Für den Such-Endpunkt /v2/antraege gibt es den neuen Parameter angenommenVor.
Der Parameter schränkt auf Anträge ein, die vor dem übergebenen Zeitpunkt angenommen worden sind. Mit den beiden Parametern angenommenVor und angenommenNach kann man einen genauen Zeitraum festlegen. Wenn der neue Parameter gesetzt wird, erzwingt dies das Zulu-Datumsformat für beide Parameter.

Wir empfehlen Anträge nicht bis zum aktuellen Zeitpunkt abzufragen, da Anträge nicht sofort in der API auftauchen. Es kann mehrere Sekunden dauern, bis diese ausgegeben werden - während der Erzeugungszeitpunkt der gleiche bleibt. Dadurch können Anträge verpasst werden.

Daher ist unsere Empfehlung für die Suche nach neuen Anträgen immer den angenommenVor Parameter mit mindestens 1 Minute Versatz zu verwenden. (Aktueller Zeitpunkt -1 Minute)

Anträge API Release 2.37

Neue KfW EnergieEffizienzklassen und -gruppen

Es gibt neue KfW Programme.
Mit den neuen Programmen kommen neue EnergieEffizienzKlassen (EEK) dazu.

Die neuen EEK sind in verschiedene Gruppen (NEUBAU, SANIERUNG) gegliedert. Altfälle erhalten die Gruppe 'STANDARD'.
Mit der neuen Version werden neue Felder eingeführt, sowie die vorhandenen erweitert. Dies betrifft die Anträge, wie auch die Gegenangebote.

Die neuen Felder und Werte können ab dem 01.07.2021 auftreten.

Neue Felder:

kfwEnergieEffizienzGruppe
kfwSanierungsFahrplanLiegtVor

Neue Werte:

kfwProgramm
kfwEnergieEffizienzStandard

Beispiel:

"angebot": {
  "darlehen": [
    {
     //...
        "kfwProgramm": "PROGRAMM_262",
        "kfwEnergieEffizienzStandard": "STANDARD_40_EEK",
        "kfwEnergieEffizienzGruppe": "NEUBAU",
        "kfwSanierungsFahrplanLiegtVor": true,
    //...
    }
  ]
}

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 auszahlungsDatumgefüllt. Dieses wird entweder vom Kunden ausgefüllt oder von uns berechnet.

"darlehen": 
[
  {
    "konditionWurdeManuellAngepasst": true,
    "konditionsAnpassungsDelta": 0.18,
    "auszahlungsDatum": "2020-11-30"
  }
]