INEX XML-Schnittstelle Externe Navigation in Portale der Versicherungsgesellschaften und Pools

Über diese XML-Schnittstelle können Links zu den Extranets der Gesellschaften und Pools über INEX ohne eine aufwändige BiPRO-Implementierung abgerufen werden. Links enthalten zum Beispiel Einstiegspunkte zur Anzeige einer Kundenakte, einer Versicherungspolice oder zu einem Vergleichsrechner oder Formular für einen Onlineantrag. Je nach Portal, können mit dem Aufruf Daten zum Kunden oder Vertrag übergeben werden.

 

nach obenAllgemeines

Sparten

Die Links der Links kann zu einer speziellen Sparte abgerufen werden: Liste der möglichen Sparten

ZielID

Jeder zurückgegebene Link ist durch eine ZielID gekennzeichnet. Die ZielIDs sind dreistellige Nummern. Die Nummern 001 bis 049 entsprechen der BiPRO-Spezifikation. Zusätzliche haben wir folgende ZielIDs definiert:

000 - Dashboard (Eine Übersicht, der möglichen Links)

050 - Link zu einem Vergleich

051 - Link zur Antragserfassung

052 - Link zur Liste der Vorgänge, die unter dem aktuellen Vorgang angelegt wurden

053 - Link um Daten zum aktuellen Vorgang als XML abzurufen

054 - Link auf Dokumente (PDF), die zum aktuellen Vorgang erzeugt wurden

Vorgangsnummer

Mit der Vorgangsnummer wird die Verbindung zwischen dem Aufruf eines Deeplinks und den damit erzeugten bzw. erfassten Daten hergestellt. So kann nach Aufruf eines Vergleichs oder einer Antragserfassung auf die erfassten Daten und generierten PDF-Dokumente zugegriffen werden.

Mit jedem Speichervorgang wird eine neue Vorgangsnummer erzeugt, die der Haupt-Vorgangsnummer untergeordnet ist.

Man kann beim ersten Aufruf eine eigene Vorgangsnummer mitschicken oder sich die Vorgangssnummer aus dem Abruf der Deeplinks merken.

Wird die übergebene Vorgangsnummer auf dem INEX gefunden, liefert dieser Links auf die untergeordneten Vorgänge, Daten und Dokumente zurück.

 

nach obenSicherheits-Token abrufen

Benutzername und Passwort entsprechen den Zugangsdaten zum INEX-Account. Es wird empfohlen, das Passwort in der eigenen Software nicht zu speichern und stattdessen das Token für wiederholte Abrufe zu speichern.

URL: 

https://inex.inveda.net/services/SecurityTokenService_1_0_0_0/

Schema: 

https://inex.inveda.net/services/SecurityTokenService_1_0_0_0/?wsdl

https://inex.inveda.net/services/SecurityTokenService_1_0_0_0/?xsd=inex/1.0.0/SecurityTokenService_1.0.0.0.xsd

Request: 

<inex:Message xmlns:inex="http://inex.inveda.net">
  <inex:Header>
    <inex:Security>
      <inex:UsernameToken>
        <inex:Username>[Benutzername]</inex:Username>
        <inex:Password>[Passwort]</inex:Password>
      </inex:UsernameToken>
    </inex:Security>
  </inex:Header>
  <inex:Body>
    <inex:RequestSecurityToken>
      <inex:TokenType>http://inex.inveda.net/token</inex:TokenType>
    </inex:RequestSecurityToken>
  </inex:Body>
</inex:Message>


Response: 

<inex:Message xmlns="http://inex.inveda.net" xmlns:inex="http://inex.inveda.net">
  <inex:Header/>
  <inex:Body>
    <inex:RequestSecurityTokenResponse>
      <inex:TokenType>http://inex.inveda.net/token</inex:TokenType>
      <inex:RequestedSecurityToken>
        <inex:SecurityContextToken>
          <inex:Identifier>0eadd7e1846c05efef54a85f49a4d673-2c3b4d0f-b66a-4023-8377-e164a55d145e</inex:Identifier>
        </inex:SecurityContextToken>
      </inex:RequestedSecurityToken>
      <inex:Lifetime>
        <inex:Created>2020-05-11 10:17:15</inex:Created>
        <inex:Expires>2020-05-12 10:17:15</inex:Expires>
      </inex:Lifetime>
    </inex:RequestSecurityTokenResponse>
  </inex:Body>
</inex:Message>
 

nach obenListe der Links abrufen

Es wird eine Liste der möglichen Links zurückgegeben. Optional können bereits begonnene Vorgänge fortgesetzt werden.

URL: 

https://inex.inveda.net/services/LinkService_1_0_0_0/

Schema: 

https://inex.inveda.net/services/LinkService_1_0_0_0/?wsdl

https://inex.inveda.net/services/LinkService_1_0_0_0/?xsd=inex/1.0.0/LinkService_1.0.0.0.xsd


https://inex.inveda.net/services/LinkService_1_0_0_0/?xsd=inex/1.0.0/INEX_1.0.0.0.xsd
https://inex.inveda.net/services/LinkService_1_0_0_0/?xsd=inex/1.0.0/IMA_1.0.0.0.xsd


Request: 

<inex:Message xmlns:inex="http://inex.inveda.net" xmlns="http://inex.inveda.net">
  <inex:Header>
    <inex:Security>
      <inex:SecurityContextToken>
        <inex:Identifier>[Token]</inex:Identifier>
      </inex:SecurityContextToken>
    </inex:Security>
  </inex:Header>
  <inex:Body>
    <inex:getLinks>
      <inex:Request>
        <inex:Version>1.0.0.0</inex:Version>
        <inex:ConsumerID>[CONSUMER]</inex:ConsumerID>
        <inex:Vorgangsnummer>[optional: Vorgangsnummer]</inex:Vorgangsnummer>

        <Template>
         <Values>
         <Risks>
           <Risk id="/db/ima/Risk/KfzHaftpflicht.xml">yes</Risk>
          </Risks><
          <Contract><
            <Parameter key="Anwendungsfall">Fahrzeugwechsel</Parameter>
          </Contract>
          <Questions>
             <Question key="..">
                   <Answer>...<Answer>
                  <Contribution>...<Contribution>
             </Question>
          </Questions>

          </Values>
        </Template>

        <Person id="/db/ima/Person/inex-959721.xml">
          <Anrede>Frau</Anrede>
          <Name>K...</Name>
          <Vorname>A...</Vorname>
          <Strasse>L...</Strasse>
          <PLZ>0...</PLZ>
          <Ort>L...</Ort>
          <Geboren>1...</Geboren>
        </Person>

        <Asset id="/db/ima/Asset/inex+595e25d2.xml">
          <Name>PKW 1</Name>
          <PLZ>004315</PLZ>
          <Ort>Leipzig</Ort>
          <Strasse>Reclamstraße</Strasse>
          <Hausnummer>42</Hausnummer>
          <Bundesland>Sachsen</Bundesland>
          <HSN>1480</HSN>
          <TSN>ABA</TSN>
          <Fahrzeugidentnummer>4897...</Fahrzeugidentnummer>
          <Saison>no</Saison>
          <Zulassung>Neuzulassung (Neuwagen)</Zulassung>
          <Stadt-Landkennung>Stadt</Stadt-Landkennung>
          <Zulassung_auf_VN>2022-11-25</Zulassung_auf_VN>
          <Fahrzeugneuwert>50000</Fahrzeugneuwert>
          <Sonderausstattung>700</Sonderausstattung>
          <Baujahr>1990</Baujahr>
          <Sitzplaetze>5</Sitzplaetze>
          <Kraftstoffart>Elektro</Kraftstoffart>
          <Finanzierungsart>Eigenfinanziert</Finanzierungsart>
          <Stellplatz>Einzelgarage</Stellplatz>
          <KM_Stand>10000</KM_Stand>
          <Wegfahrsperre>serienmaessig</Wegfahrsperre>
          <Fahrzeugnutzung>privat</Fahrzeugnutzung>
          <Betriebsausgabe>no</Betriebsausgabe>
          <References>
            <Reference id="/db/ima/Assetgroup/Auto.xml" relation="Group"/>
            <Reference id="/db/ima/Person/98245+e5cb0f21.xml" relation="Eigentuemer"/>
          </References>
        </Asset>

        <Contract id="/db/ima/Contract/inex-2342560.xml">
          <VSNR>V...</VSNR>
          <Status>vertrag</Status>
          <References>
            <Reference id="/db/ima/Person/inex-959721.xml" relation="Kunde"/>
            <Reference id="/db/ima/Class/inex-19.xml" relation="Sparte"/>
            <Reference id="/db/ima/Product/inex-2853.xml" relation="Produkt"/>
            <Reference id="/db/ima/Supplier/da-direkt.xml" relation="Anbieter"/>
          </References>
        </Contract>

        <Document id="/db/ima/Document/inex-3456789.xml">
          <Name>Police.pdf</Name>
          <Date>2024-02-21 10:02:00</Date>
          <Type>pdf</Type>
          <Category>Police</Category>
          <Compression>NONE</Compression>
          <Checksum>
            <Method>MD5</Method>
            <Value>d41d8cd98f00b204e9800998ecf8427e</Value>
          </Checksum>
          <Data>[base64]</Data>
          <References>
            <Reference id="/db/ima/Contract/inex-2342560.xml" relation="Objekt"/>
          </References>
        </Document>

      </inex:Request>
    </inex:getLinks>
  </inex:Body>
</inex:Message>


Response: 

<inex:Message xmlns="http://inex.inveda.net" xmlns:inex="http://inex.inveda.net">
  <inex:Header/>
  <inex:Body>
    <inex:getLinksResponse>
      <inex:Response>
        <inex:Version>1.0.0.0</inex:Version>
        <inex:Status>
          <inex:StatusID>OK</inex:StatusID>
        </inex:Status>
        <inex:Vorgangsnummer>Vorgangsnummer</inex:Vorgangsnummer>
        <inex:Link>
          <inex:ZielID>001</inex:ZielID>  
          <inex:URL>https://....</inex:URL>
          <inex:Beschreibung>Hauptmenü</inex:Beschreibung>
        </inex:Link>

        <inex:Link>
          <inex:ZielID>009</inex:ZielID>  
          <inex:URL>https://....</inex:URL>
          <inex:Beschreibung>Produktvergleich</inex:Beschreibung>
        </inex:Link>

      </inex:Response>
    </inex:getLinksResponse>
  </inex:Body>
</inex:Message>