OSO:2017/Afmelden Sessie

Actor(s)	Goal(s)
Doelsysteem	Afronden opvraagsessie
Traffic Center	Afronden opvraagsessie en vastleggen resultaat van sessie

Context

Afmelden sessie is de laatste stap in het doorlopen van een transactie voor het opvragen van een dossier of het doorgeven van een notificatie.

• Dossier opvragen: Doelsysteem meldt sessie af bij Traffic Center en geeft 'beste resultaat': Het 'hoogste resultaat' op de resultaat tabel [reultaten] dat binnen de sessie teruggegeven is door een bevraagd Aanleverpunt.

Er kunnen meerdere aanleverpunten bevraagd zijn. Wanneer het beste resultaat bij meerdere aanleverpunten is behaald, dan moet het laatst bevraagde aanleverpunt met dat resultaat worden teruggegeven.

Preconditie

• Doelsysteem heeft een geldige sessie aangevraagd en toegekend gekregen
• Bronsysteem heeft een verzoek voor een specifiek dossier van Systeem (doelschool) ontvangen
• Bronsysteem heeft verzoek tegen sessie laten controleren door Traffic Center
• Bronsysteem heeft verzoek voor dossier afgehandeld
• Er zijn geen Bronsysteem meer beschikbaar die binnen deze sessie bevraagd kunnen worden.

Postconditie

1. Sessie is geregistreerd als afgerond door Traffic Center
2. 'Beste resultaat' is vastgelegd door Traffic Center

Basic Scenario

1. Doelsysteem verzoekt Traffic Center om sessie als afgerond te registreren
2. IF de sessie bekend is AND de sessie gegevens komen overeen met de gegevens in het verzoek
   1. Traffic Center registreert de sessie als afgerond
3. ELSE afwijking in sessie gegevens
   1. Traffic Center geeft foutmelding
   2. Doelsysteem beëindigt Sessie (geen terugkoppeling naar eindgebruiker)
4. ENDIF

Alternatieve scenario's:

Hieronder worden alternatieve scenario's en de bijbehorende melding opgesomd:
.

Resultaat	A/E*	Omschrijving	Toelichting
AanvragerNietBekend	A	Doelsysteem is niet bekend bij het Traffic Center	In het Register is de combinatie van DoelBRIN en APindex niet aanwezig.
AanvragerAanleverpuntNietBekend	A	Het meegegeven Aanleverpunt is niet geregistreerd voor deze aanvrager	Het Aanleverpunt is in het Register niet gekoppeld voor aan dit Doelsysteem/Leverancier
AanvragerNietBeschikbaar	A	Doelsysteem (aanvragend AP) is (nog) niet gerechtigd om gebruik te maken van de overstapservice	Het doelsysteem is bekend bij het TC, maar (nog) niet toegelaten op het OSO netwerk. Mogelijke oorzaken: Het aanleverpunt is aangemaakt in de back office en doorgegeven aan het TC. De school kan (nog) niet gekwalificeerd zijn of het aanleverpunt is op inactief gesteld.
AanvragerNietGeautoriseerd	A	Doelsysteem (aanvragend AP) is in het Register geregistreerd met andere Leverancier.	Het Aanleverpunt (BronBRIN/APindex) is bekend bij OSO, maar in het Register is een andere Leverancier bekend dat die deze sessie aanvraag indient.
OnbekendAanleverpunt	A	Er is in 'SessiecontroleRequest' een aanleverpunt gebruikt, dat niet in de bijbehorende 'OverdrachtResponse' verkregen is.	Bij het initiëren van de Sessie geeft het TC een lijst met te bevragen Aanleverpunten terug. Dit meegestuurde Aanleverpunt was niet aanwezig in die lijst.
VerstrekkerNietBekend	A	De verstrekker is niet bekend bij het Traffic Center	De gemelde Bronschool (BRIN) is niet geregistreerd.
VerstrekkerAanleverpuntNietBekend	A	Het meegegeven aanleverpunt is niet geregistreerd voor deze verstrekker	Het Aanleverpunt (BRIN + APindex) van de Bronschool is niet bekend in het Register.
VerstrekkerNietBeschikbaar	A	De verstrekker is niet gerechtigd om de overstapservice te gebruiken
SessieVerlopen	A	De sessie is verlopen; de sessie-time-out is verstreken.
SessieNietGecontroleerd	A	Bij de sessiecontrole is door het TC een sessiefout geconstateerd.	Het bevraagde Aanleverpunt kreeg deze fout terug bij het controleren van de Sessie
SessieOngeldig	E	De sessie is ongeldig; het ID is nooit uitgedeeld.	Het sessieId komt niet overeen met datgene wat verstrekt is in het overdrachtsResponse.
SessieReedsAfgemeld	E	De sessie is al eerder afgemeld.
OngeautoriseerdAanleverpunt	E	Bronsysteem (aanvragend AP) is in het Register geregistreerd met andere Leverancier.
<Geen response>	E	Het Traffic Center geeft een time out of technische fout.	Het aanvragende Bronsysteem staakt de verdere aanvraag en geeft de eindgebruiker hierover een foutmelding.

^* A: Alternatief, E: Exceptie (fout)

Aanroep en antwoord

• Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.eld.nl/schemas/Overstapservice/20160411">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:afmeldingRequest>
         <ns:bronBrin>00YY</ns:bronBrin>
         <ns:bronAanleverpuntIndex>0</ns:bronAanleverpuntIndex>
         <ns:doelBrin>12SS</ns:doelBrin>
         <ns:doelAanleverpuntIndex>102</ns:doelAanleverpuntIndex>
         <ns:sessieId>fe6b2710-3fe5-468e-822d-e2b409a9f0d0</ns:sessieId>
         <ns:status>LeerlingInfoNietBeschikbaar</ns:status>
      </ns:afmeldingRequest>
   </soapenv:Body>
</soapenv:Envelope>

• Response:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<over:afmeldingResponse xmlns:over="http://xml.eld.nl/schemas/Overstapservice/20160411">
  <over:resultaat>OverdrachtGeslaagd</over:resultaat>
</over:afmeldingResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Element	Uitleg	Opmerkingen
bronBrin	Dit is het brinnummer van het Bronsysteem. Het TC controleert of het Bronsysteem bekend en actief is in het deelnemersregister. (Verplicht)
bronAanleverpuntIndex	(Verplicht). Dit is het aanleverpuntnummer van het bronSysteem, dat (als laatste aanleverpunt) het overeenkomstige resultaat (uit de de documentResponse) heeft gegeven aan het doelSysteem.	Er kunnen meerdere aanleverpunten bevraagd zijn. Wanneer de beste resultaat bij meerdere aanleverpunten is behaald, dan moet het laatst bevraagde aanleverpunt met dat resultaat worden teruggegeven.
doelBrin	Dit is het brinnummer van het Doelsysteem. Het TC controleert of het Doelsysteem bekend en actief is in het deelnemersregister.
doelAanleverpuntIndex	Dit is de index van het Aanleverpunt van het Doelsysteem.
sessieId	Dit is de sessieId die ontvangen is in de overdrachtsResponse en gebruikt is in de communicatie met het bronSysteem.
status	Dit is het resultaatbericht dat het doelsysteem heeft ontvangen bij het aflopen van de aanleverpunten bij het opvragen van een dossier in de documentRequest. Als het doelSysteem het dossier succesvol heeft ontvangen, dan stuurt het bronSysteem geen foutmelding en moet het doelSysteem het resultaat 'VerstrekkingGeslaagd' meegegeven in het statusveld.	Bij meerdere meldingen van meerdere aanleverpunten wordt het 'beste resultaat' doorgegeven, bepaald door de hoogste plaats in de tabel Meldingen bij opvragen Dossier.