Antrag Import API

Beschreibung

Die Antrag Import API dient zum Prozessieren Lead Daten, die wir von der Postbank bekommen. Hier finden Sie die Nutzungsbedingungen.

Authentifizierung und Autorisierung

Oauth2 API verwenden

Um einen Client zu registrieren brauchen wir die folgenden Daten:

Wert	Beschreibung
email	E-Mail des Partners.
name	Vor- und Zuname des Partners.
telefonnummer	Telefonnummer des Partners.
organisation	Organisationsname des Partners.

Wende dich mit den Daten bitte an den Bestkredit-Service Support. Nach einer Verifizierung unsererseits stellen wir dir eine client-id und ein client-secret zur Verfügung.

Die Authentifizierung erfolgt über OAuth2 und benötigt antrag/antrag-import-api-service-scope als Scope.

Stage	Access Token Url
production	`https://drkleinrk-antrag-api.auth.eu-central-1.amazoncognito.com/oauth2/token`
development	`https://drkleinrk-antrag-api-dev.auth.eu-central-1.amazoncognito.com/oauth2/token`

API

Ein neues Antrag wird über HTTP application/json.

Stage	Url
production	`https://api.antrag.drkleinservice.de/v1/antrag`
development	`https://api.antrag-dev.drkleinservice.de/v1/antrag`

Header

Content-Type:application/json

Die Daten werden als HTTP application/json im Request übermittelt. Ein erfolgreicher Aufruf resultiert in einer Response mit dem HTTP Statuscode 201.

Beispiel

Request

Request-Header Name: Authorization
Request Header Value: Bearer {jwt}

Request-Header Name: content-type
Request Header Value: application/json

POST
https://api.antrag-dev.drkleinservice.de/v1/antrag

Request Body:

{
  "deutschebank": {
    "creditApplicationId": "PBDECOFI 525-11-00000000 240522-134320 01602287-5"
  },
  "antrag": {
    "antragsteller1": {
      "haushalt": {
        "gemeinsam": {
          "vorhanden": true
        },
        "kindergeldberechtigteKinder": 0,
        "wohnart": "MIETE",
        "personen": 2
      },
      "kontaktdaten": {
        "telefon": {
          "nummer": "0123123123"
        },
        "email": "entw-pbk@it-p.de"
      },
      "personenDaten": {
        "adresse": {
          "strasse": "Berliner Str.",
          "hausnummer": "1",
          "plz": "30457",
          "ort": "Hannover",
          "land": "DE"
        },
        "anrede": "HERR",
        "vorname": "Max",
        "nachname": "Mustermann",
        "geburtsdatum": "1999-01-01T00:00:00",
        "familienstand": "LEDIG",
        "geburtsort": "Hannover",
        "staatsangehoerigkeit": "DE"
      },
      "beschaeftigung": {
        "arbeitgeber": {
          "name": "IT-P"
        },
        "beschaeftigungsArt": "ANGESTELLTER",
        "beschaeftigtSeit": "2000-02-01T00:00:00",
        "beruf": "Tester",
        "befristet": false,
        "vorbeschaeftigung": false
      },
      "einnahmen": {
        "nettoeinkommen": 3000,
        "sonstiges": 0
      },
      "ausgaben": {
        "unterhaltsverpflichtung": {
          "betrag": 0
        },
        "warmmiete": 600,
        "baufinanzierungsrate": 0,
        "krankenPflegeversicherung": 0
      },
      "bankverbindung": {
        "iban": "DE44300800000623399500"
      },
      "steuer": {}
    },
    "antragsteller2": {
      "haushalt": {
        "gemeinsam": {
          "vorhanden": true
        },
        "kindergeldberechtigteKinder": 0,
        "wohnart": "MIETE",
        "personen": 2
      },
      "kontaktdaten": {
        "telefon": {
          "nummer": "0321321321"
        },
        "email": "entw-pbk@it-p.de"
      },
      "personenDaten": {
        "adresse": {
          "strasse": "Berliner Str.",
          "hausnummer": "1",
          "plz": "30457",
          "ort": "Hannover",
          "land": "DE"
        },
        "anrede": "HERR",
        "vorname": "Maxi",
        "nachname": "Musterfrau",
        "geburtsdatum": "1990-02-01T00:00:00",
        "familienstand": "LEDIG",
        "geburtsort": "Hannover",
        "staatsangehoerigkeit": "DE"
      },
      "beschaeftigung": {
        "arbeitgeber": {
          "name": "IT-P"
        },
        "beschaeftigungsArt": "ANGESTELLTER",
        "beschaeftigtSeit": "2000-02-01T00:00:00",
        "beruf": "auch Tester",
        "befristet": false,
        "vorbeschaeftigung": false
      },
      "einnahmen": {
        "nettoeinkommen": 1000,
        "sonstiges": 0
      },
      "ausgaben": {
        "warmmiete": 600,
        "baufinanzierungsrate": 0
      },
      "steuer": {}
    },
    "zustimmung": {
      "datenweitergabe": true
    },
    "vertriebsschluessel": "0038301100",
    "anzahlAntragsteller": 2
  },
  "kredit": {
    "wunsch": {
      "kreditbetrag": 10000,
      "laufzeit": 48
    },
    "verwendungszweck": "FREIE_VERWENDUNG",
    "kontoinhaber": "AN1",
    "einzugstermin": "MONAT_MITTE"
  }
}

Response

Status Code	Beschreibung	Response JSON
201	Lead Daten wurden erfolgreich übermittelt	{ “link”: “https://antragstrecke.drkleinservice.de/{leadstreckenIdentifier}/40f41ffd-d5ea-47ce-b9b2-bc84a1d155cb”}