Übersicht

SingleSignOn

Produktauswahlprozess

Abruf von Kriterien

Abruf der Gesamtbewertung

Beste Produkt am Markt

Indikation Produktqualität

Profilermittlung

productselector/getproductconfiguration

Liefert die Produktkonfiguration zu den angegebenen Daten zurück. Diese ergibt sich aus dem gewählten Hauptprodukt und den gewählten Optionen.

Request

Endpoint: POST https://v7.fb-vertragscheck.fb-preview.de/external/productselector/getproductconfiguration

Schema: GET https://v7.fb-vertragscheck.fb-preview.de/external/productselector/getproductconfiguration/request/schema


property default description options
[ token ] * required
string
Token zur Authentifizierung mit der Schnittstelle
[ producttype ] * required
string
Kurzform des Produkttyps (über Schnittstelle "/getproducttypes" zu erhalten)
[ mainproduct_id_version ] * required
string
Produkt ID und Version des Hauptproduktes
[ productoptions ]
array
Produkt ID und Version der Optionen zum Hauptprodukt
[ profile ] * required
string
ID des anzuwendenden Bewertungsprofils
[ show_max_options ]
boolean
Ermittlung einer passenden Konfiguration zu dem Hauptprodukt mit maximaler Ausprägung. Wenn options angegeben werden wird dieser Parameter ignoriert.
[ benefits_enabled ]
array
Aktivierte Leistungsmerkmale
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "producttype": "TYPE_BU",
    "mainproduct_id_version": "500_1",
    "productoptions": [
        "600_2"
    ],
    "profile": "11",
    "show_max_options": true
}
example:

mime-type: application/json, text/json

{
    "token": "a1s2d3f4g5h6j7k8l9",
    "producttype": "TYPE_BU",
    "mainproduct_id_version": "500_1",
    "profile": "11"
}

Response

Schema: GET https://v7.fb-vertragscheck.fb-preview.de/external/productselector/getproductconfiguration/response/schema


property description options
[ status ] * required
string
Status des Aufrufs
OK: Anfrage erfolgreich
ERROR: Anfrage verlief fehlerhaft
[ errors ]
array
Aufgetretene Fehler (Wird nur bei "status: ERROR" gefüllt!

object
Produktkonfigurationen
property description options
productconfiguration[ company ]
string
Name der Gesellschaft
productconfiguration[ is_current ]
integer
Produkt ist aktuell
Value Label
0 nicht aktuell
1 aktuell
productconfiguration[ pkfg ]
integer
Produktkonfigurations-ID
productconfiguration[ year ]
integer
Jahr
productconfiguration[ name ]
string
Produktname
productconfiguration[ percentage ]
integer
Erfüllungsgrad der Kriterien in Prozent
productconfiguration[ benefit_surplus ]
array
Leistungsmerkmale die gegen Mehrbeitrag abgeschlossen werden können.
productconfiguration[ benefit_advance ]
array
Leistungsmerkmale die gegen Mehrbeitrag erhöht werden können.
productconfiguration[ products ]
array
example:

mime-type: application/json, text/json

{
    "status": "OK",
    "errors": [
        "Bitte geben Sie ein gültiges Profil ein."
    ],
    "productconfiguration": {
        "company": "Pfefferminzia",
        "is_current": 0,
        "pkfg": 100000,
        "year": 2010,
        "name": "Produktname",
        "percentage": 65,
        "benefit_surplus": [
            "fahrraddiebstahl"
        ],
        "benefit_advance": [
            "fahrraddiebstahl"
        ],
        "products": [
            {
                "pkfg": 987654321,
                "name": "Tarifname (lang)",
                "productname": "Tarifname (kurz)",
                "product_id": 1234,
                "product_version": 4,
                "product_level": 1,
                "is_option": true,
                "info": "Beitragsbefreiung HV + BU-Rente"
            }
        ]
    }
}