4.3.1. Stap-2A: aanroep doeFunctie vanuit 2e Omgeving of 3e Omgeving

De 2e Omgeving stuurt het resultaat middels de doeFunctieVraag naar de Koppelservice. In de gimData-sectie wordt het AFD-databestand opgenomen.

AFD-berichtsoorten

Het is hier toegestaan om in plaats van Contractdocument ook andere AFD-berichtsoorten op te nemen. De volgende varianten worden onderkend:

Verplichte attributen

Het uitgangspunt is dat het AFD-bericht binnen de gimData-sectie alle informatie bevat die ontvanger nodig heeft voor het afhandelen van het bericht. Dit kan handmatig of via een binnen de 1e Omgeving ingerichte workflow. Onderstaand het overzicht van de minimaal vereiste entiteiten en attributen in de gimData-sectie van een SKP-UITGEBREID bericht.

Bericht Algemeen (AL)

Bijlage (BY)

Het toevoegen van een bijlage is optioneel binnen SKP-UITGEBREID. Wanneer een bijlage wordt bijgesloten is de entiteit Bijlage (BY) verplicht en moeten onderstaande attributen opgenomen worden.

Identificerende gegevens

Indien een bijlage wordt opgenomen dan worden identificerende gegevens uit de onderstaande entiteiten gebruikt.

Contract Polis (PP)

Als het databericht gekoppeld kan worden aan een bestaand contract, moet de 2e Omgeving of de 3e Omgeving verplicht de onderstaande identificerende gegevens (attributen) opnemen.

Contract Pakket (PK)

Als het databericht gekoppeld kan worden aan een bestaande pakketpolis, moet de 2e Omgeving of 3e Omgeving verplicht de onderstaande attributen opnemen.

Schadedossier (SD)

Als het databericht gekoppeld kan worden aan een bestaand schadedossier, moet de 2e Omgeving of 3e Omgeving verplicht het schadenummer van de betreffende ontvanger opnemen.

Verzekeringnemer (VP)

Indien het databericht (nog) niet contractgebonden is, moet de 2e Omgeving of 3e Omgeving minimaal de volgende attributen verplicht opnemen. Let op: in deze gevallen dient er dus toch een (fictieve) entiteit PP (Polis/Onderdeel) te worden opgenomen met daaronder genest de entiteit VP (Verzekeringnemer).

*Merk op: er mogen meer AFD-attributen en AFD-entiteiten in het bericht zijn opgenomen dan de minimaal vereiste set. In de samenwerking met specifieke partijen (1e Omgevingen) kan zo meer functionaliteit geboden worden. Het is alleen zinvol als ten minste een deel van de ontvangende 1e Omgevingen ook daadwerkelijk deze data verwerkt. Deze werkwijze voorkomt dat berichtvarianten met meer en minder data moeten worden aangeboden. In Bijlage: GimData-sectie en in Bijlage: Bijlagen in resultaatberichten wordt de mogelijke inhoud in meer detail toegelicht.

!De ontvangende software (1e Omgeving) moet altijd ingesteld zijn op onbekende attributen en entiteiten. De attributen die niet verwerkt kunnen worden kunnen genegeerd worden (zie ook Stap-4B: geefResultatenAntwoord door Koppelservice bij SKP-BASIS).

Voorbeeldbericht

<doeFunctie xmlns="urn:sivi:standards:skp:ws">
  <doeFunctieVraag xmlns="urn:sivi:standards:skp:schemas">
    <procesInfo>
      <procesId>1234567890|a.gebruiker@tussenpersoon.nl</procesId>
      <functie>
        <productId>1</productId>
        <contextId>100</contextId>
        <functieId>2000</functieId>
      </functie>
    </procesInfo>
    <inhoud>
      <gimData><![CDATA[
        <Contractdocument>
          <AL>
            <AL_VRWRKCD>0</AL_VRWRKCD>
            <AL_VOLGNUM>1</AL_VOLGNUM>
            <AL_FUNCTIE>09</AL_FUNCTIE>
            <AL_PFUNK>002</AL_PFUNK>
            <AL_COREF>a.gebruiker@tussenpersoon.nl</AL_COREF>
            <AL_ADATMSG>20180101</AL_ADATMSG>
            <AL_ATYDMSG>1010</AL_ATYDMSG>
            <AL_SKPSID>99999999</AL_SKPSID>
          </AL>
          <PP>
            <PP_VRWRKCD>0</PP_VRWRKCD>
            <PP_VOLGNUM>1</PP_VOLGNUM>
            <PP_NUMMER>123456789</PP_NUMMER>
            <PP_BETTERM>12</PP_BETTERM>
            <PP_BRANCHE>021</PP_BRANCHE>
            <PP_HVVDAT>20190101</PP_HVVDAT>
            <PP_MYAAND>A001</PP_MYAAND>
            <PP_INGDAT>20180405</PP_INGDAT>
            <VP>
              <VP_VRWRKCD>0</VP_VRWRKCD>
              <VP_VOLGNUM>1</VP_VOLGNUM>
              <VP_VOORL>J.</VP_VOORL>
              <VP_ANAAM>Janssen</VP_ANAAM>
              <VP_STRAAT>Pythagoraslaan</VP_STRAAT>
              <VP_HUISNR>101</VP_HUISNR>
              <VP_PCODE>3584BB</VP_PCODE>
              <VP_PLAATS>UTRECHT</VP_PLAATS>
              <VP_RELNUM>4500124</VP_RELNUM>
              <VP_GEBDAT>19590507</VP_GEBDAT>
            </VP>
            <OB>
              <OB_VRWRKCD>0</OB_VRWRKCD>
              <OB_VOLGNUM>1</OB_VOLGNUM>
              <OB_KENTEKE>AB-123-A</OB_KENTEKE>
              <OB_MLDCODE>4684</OB_MLDCODE>
              <OB_MERK>VOLVO</OB_MERK>
              <OB_MODEL>V70</OB_MODEL>
              <OB_TYPE>Cross Country</OB_TYPE>
              <OB_BOUWJR>2002</OB_BOUWJR>
              <OB_BRANSTO>B</OB_BRANSTO>
              <OB_AFMWE>1660</OB_AFMWE>
            </OB>
              <WA>
                <WA_VRWRKCD>0</WA_VRWRKCD>
                <WA_VOLGNUM>1</WA_VOLGNUM>
                <WA_CODE>2001</WA_CODE>
                <WA_BTP>495</WA_BTP>
                <WA_ERB>150</WA_ERB>
                <WA_VZBMATS>2500000</WA_VZBMATS>
                <WA_VZBLETS>7500000</WA_VZBLETS>
              </WA>
              <CA>
                <CA_VRWRKCD>0</CA_VRWRKCD>
                <CA_VOLGNUM>1</CA_VOLGNUM>
                <CA_CODE>2002</CA_CODE>
                <CA_ERB>500</CA_ERB>
                <CA_NWEGAR>J</CA_NWEGAR>
                <CA_BTP>1250</CA_BTP>
                <CA_VERZSOM>47125</CA_VERZSOM>
              </CA>
          </PP>
        </Contractdocument>]]>
      </gimData>
    </inhoud>
  </doeFunctieVraag>
</doeFunctie>

*Merk op: De namespaces in bovenstaand bericht zijn als voorbeeld bedoeld. Het is aan de aanbieder van de service om hier eigen namespaces te gebruiken.