Skip to content

europace/baufismart-vorgaenge-api

Repository files navigation

Vorgaenge-API

As an advisor, I can use Vorgaenge API to read all the data from my cases and get furthermore links to applications, loans, documents and events.

advisor mortgageLoan

Authentication GitHub release

Pattern

Documentation

YAML YAML YAML

Usecases

  • get data to:
    • create own financing proposals with individual structure and design
    • keep own CRM system up to date
    • create individual notifications
  • set data to:
    • change advisor and editor to control the workload of employees
    • mark applications as ready-to-check
    • set your own case reference

Quick Start

To test our APIs and your use cases as quickly as possible, we have created a Postman Collection for you.

Authentication

Please use Authentication to get access to the APIs. The OAuth2 client requires the following scopes:

Scope API Use case
baufinanzierung:vorgang:lesen to get case data
baufinanzierung:echtgeschaeft to use api in production mode
baufinanzierung:vorgang:schreiben to update case data (eg role)

Get data

Get case data

As advisor I can read out the data of the case, to create an individual financial proposal for a convincing sales story.

Requirements:

  • authenticated as advisor, editor or sales organisation with access to the case

example-request:

GET /v2/vorgaenge/CH6407 HTTP/1.1
Host: api.europace2.de
Content-Type: application/json
Authorization: Bearer {{access-token}} 

example-response:

{
  "_links": { ... },
  "vorgangsNummer": "CH6407",
  "erstelltAm": "2022-02-16",
  "letztesEreignis": "2022-02-22T08:31:01.37Z",
  "status": "AKTIV",
  "bankverbindung": { ... },
  "haushalte": [ ... ],
  "finanzierungsObjekt": { ... },
  "vorhaben": { ... },
  "datenKontext": "TEST_MODUS",
  "aufbewahrungBis": "2025-02-27",
  "kundenBetreuer": { ... },
  "antraege": [ ... ],
  "vorgangsBearbeiter": { ... }
}

For the full model see API-Specification

Get last changed cases

As advisor I will get a list of the last changed cases, to keep your CRM system up to date for a seamless, efficent and high quality sales process. The list of cases contains all cases where accessible for the caller and is descent ordered by lastchanged date and paged.

Requirements:

  • authenticated as advisor, editor or sales organisation with access to the cases

example-request:

GET /v2/vorgaenge HTTP/1.1
Host: api.europace2.de
Content-Type: application/json
Authorization: Bearer {{access-token}}

example-response:

{
    "vorgaenge": [
        {
            "datenKontext": "ECHT_GESCHAEFT",
            "vorgangsNummer": "A74QK3",
            "letztesEreignis": "2020-12-30T09:53:16.165Z",
            "letzteAenderung": "2020-12-30T09:53:16.126Z",
            "_links": {
                "self": {
                    "href": "https://baufismart.api.europace.de/v2/vorgaenge/A74QK3"
                }
            }
        },
        {
            "datenKontext": "TEST_MODUS",
            "vorgangsNummer": "ED7PIS",
            "letztesEreignis": "2020-12-30T09:52:34.557Z",
            "letzteAenderung": "2020-12-30T09:53:15.331Z",
            "_links": {
                "self": {
                    "href": "https://baufismart.api.europace.de/v2/vorgaenge/ED7PIS"
                }
            }
        },
        {
            "datenKontext": "ECHT_GESCHAEFT",
            "vorgangsNummer": "JA624A"
            ...
        }
    ]
}

Pls note: the list is paged.

You can filter the results by using the following parameters:

  • datenkontext (using test- or production-mode)
  • aenderungSeit (lastChangeUntil for getting all changes after the last call)
  • and many more - see documentation

Set data

Changes to some metadata on a case are possible using JSON Patch. The path represents the path in the JSON model separated with /. The default operation supported is replace. Patch operations are an array, so multiple patch commands can be sent with a PATCH request.

Set own reference

example-request:

PATCH /v2/vorgaenge/CH6407 HTTP/1.1
Host: api.europace2.de
Content-Type: application/json-patch+json
Authorization: Bearer {{access-token}}
Content-Length: 75

[
	{"op":"replace","path":"/externeVorgangsNummer","value":"ext_VN_4711"}
]

example-response:

200 Okay

see example-response of get case data

Set state of case

As advisor you can set the state, to archive outdated cases and hide them for the advisors. example-request:

PATCH /v2/vorgaenge/CH6407 HTTP/1.1
Host: api.europace2.de
Content-Type: application/json-patch+json
Authorization: Bearer {{access-token}}
Content-Length: 59

[
    {"op":"replace","path":"/status","value":"ARCHIVIERT"}
]

example-response:

200 Okay

see example-response of get case data

Allowed values are AKTIV and ARCHIVIERT.

Set advisor

As sales organsisation you can set the advisor to control the workload of the colleagues.

example-request:

PUT /v2/vorgaenge/CH6407/kundenBetreuer HTTP/1.1
Host: api.europace2.de
Authorization: Bearer {{access-token}}
Content-Type: application/json
Content-Length: 26

{
"partnerId": "AAV43"
}

A valid partnerId of our platform must be transferred in the partnerId field. Furthermore, the corresponding partner need also the authorization to access the case.

example-response:

201 Created

Set editor

As advisor you can set the editor eg to a clerk, to check the case and application or to a teammate to enrich the data of the case.

example-request:

PUT /v2/vorgaenge/CH6407/vorgangsBearbeiter HTTP/1.1
Host: api.europace2.de
Authorization: Bearer {{access-token}}
Content-Type: application/json
Content-Length: 26

{
    "partnerId": "MNC81"
}

A valid partnerId of our platform must be transferred in the partnerId field. Furthermore, the corresponding partner need also the authorization to access the case.

example-response:

201 Created

Terms of use

The APIs are provided under the following Terms of Use.

Support

If you have any questions or problems, you can contact [email protected].