OSO:2022/Initiëren sessie: verschil tussen versies

Uit Kennisnet Developers Documentatie
Naar navigatie springen Naar zoeken springen
(Nieuwe pagina aangemaakt met '==Preconditie== *DoelSysteem is aangesloten op OSO keten *DoelSysteem heeft DocumentRequest ontvangen van Bronsysteem (en SessieID hiervan geregistreerd) *DoelSyste...')
 
Regel 1: Regel 1:
  +
{|class="wikitable"
−
==Preconditie==
  
  +
! style="text-align:left;"| Actor(s)
−
*DoelSysteem is aangesloten op OSO keten
  
  +
! style="text-align:left;"| Goal(s)
−
*DoelSysteem heeft DocumentRequest ontvangen van Bronsysteem (en SessieID hiervan geregistreerd)
  
  +
|-
−
*DoelSysteem heeft Dossier klaargezet uit DocumentRequest van Bronsysteem
 
  +
| DoelSysteem
  +
| Geldige sessie toegekend krijgen voor opvragen specifiek dossier. Zowel in de variant met zoeksleutel als die met een koppelsleutel geldt dat een sessie altijd over één specifiek dossier gaat.
  +
|-
  +
| Traffic Center
  +
| Sessie toekennen aan systeem voor geldig verzoek van systeem voor specifiek dossier door school tbv overstap of aanvraag bij samenwerkingsverband
  +
|}
  +
  +
==Basisvariant: Overstapdossier==
  +
  +
Een Doelsysteem vraagt een Sessie aan om een specifiek Dossier op te vragen bij een School (BRIN(4)). Het TC verstrekt een Sessie wanneer de School bekend en actief is; er zijn actieve Aanleverpunten bij deze school die bevraagd kunnen worden. Het TC geeft de lijst met Aanleverpunten terug aan het Sessie aanvragende systeem. Het aanvragen van een Sessie voor deze variant wordt [[OSO:2018/Initiëren_sessie/overstap|hier]] verder uitgewerkt.
  +
  +
===Variant: Specifiek Aanleverpunt bevragen===
  +
Een Doelsysteem kan specifiek één Aanleverpunt bevragen door de APindex van dit Aanleverpunt mee te geven (samen met de BronBRIN). In dit geval geeft het TC geen lijst met Aanleverpunten terug, maar alleen de informatie van dit specifieke Aaneleverpunt (mits actief).
  +
  +
==Basisvariant: Aanvraag bij Samenwerkingsverbanden==
  +
Een Doelsysteem vraag een Sessie aan na ontvangst van een Notificatie met een Koppelsleutel. De KoppelSleutel wordt gebruikt bij deze uitwisseling als aanduiding van het over te dragen Dossier. Het aanvragen van een Sessie voor deze variant wordt [[OSO:2018/Initiëren_sessie/aanvraag|hier]] verder uitgewerkt.
  +
  +
==Basis scenario==
  +
# Doelsysteem vraagt Sessie aan bij TC
  +
# '''IF''' het Doelsysteem is valide<sup>*</sup> '''AND ''' Doel Aanleverpunt is actief ''' AND ''' Bron School is actief ''' AND '''(zoeksleutel is correct<sup>****</sup> '''XOR''' koppelsleutel is gevuld) '''AND''' (Overdrachtsoort correct ingevuld) ''' THEN '''
  +
## Traffic Center kent een sessie toe aan het Bronsysteem
  +
## Traffic Center verstrekt lijst met te bevragen Aanleverpunten <sup>**</sup>
  +
#'''Else'''
  +
## Traffic Center geeft foutcode terug
  +
## Doelsysteem geeft foutmelding aan Eindgebruiker <sup>***</sup>
  +
<p>
  +
<sup>*</sup>Valide systeem houdt oa in dat het systeem gekwalificeerd is, een correct certificaat heeft en toegelaten is op de OSO keten. <br />
  +
<sup>**</sup>Als specifiek aanleverpunt bevraagd wordt, dan wordt alleen de gegevens van dit aanleverpunt doorgegeven door TC.<br />
  +
<sup>***</sup>In dit geval kan de Sessie niet afgemeld worden.<br />
  +
<sup>****</sup>De zoeksleutel wordt door het TC gedecrypt en de BSN ('11 test') of het Onderwijsnummer ('DUO test') wordt gecontroleerd. Alleen als deze stappen goed doorlopen (kunnen) wordt, geeft het TC een sessie terug én worden de laatste/rechter vier karakters van het BSN of Onderwijsnummer opgeslagen in het PGNfrag voor de Sessie controle. ([[:Bestand:Zoeksleutel_encryptie_aanpassing.201800207.pdf |Link naar beschrijving]])
  +
  +
== Uitzonderingen en meldingen==
  +
Hieronder worden alternatieve scenario's en de bijbehorende meldingen opgesomd:<BR>.
  +
  +
{|class="wikitable"
  +
! style="text-align:left;"| Resultaat
  +
! style="text-align:left;"| Omschrijving
  +
! style="text-align:left;"| Toelichting
  +
! style="text-align:left;"| ''Melding aan Eindgebruiker''
  +
|-
  +
| AanvragerNietBekend
  +
| De aanvrager (doelBrin) is niet gerechtigd om de overstapservice te gebruiken
  +
| Het doelBrin is niet bekend in het register van het Traffic Center.
  +
| Je school is niet aangesloten op OSO. Neem contact op met de servicedesk van OSO.
  +
|-
  +
  +
| AanvragerAanleverpuntNietBekend
  +
| Het aanleverpunt van het doelsysteem (aanvragend aanleverpunt) is niet bekend bij het Traffic Center
  +
| In het Register is de combinatie van doelBrin en doelAanleverpuntIndex niet aanwezig.
  +
| Het aanleverpunt waarop je de leerling wilt ophalen is niet (goed) geregistreerd in je LAS.
  +
|-
  +
  +
| AanvragerNietBeschikbaar
  +
| De aanvrager (doelBrin) is niet gerechtigd om de overstapservice te gebruiken.
  +
| De Doelschool (BRIN) is niet gerechtigd gebruik te maken van OSO.
  +
| Je school is niet aangesloten op OSO. Neem contact op met de servicedesk van OSO.
  +
|-
  +
  +
| VerstrekkerNietBekend
  +
| Het bronBrin is niet bekend bij het Traffic Center.
  +
| De opgegeven bronschool is (nog) niet opgenomen in het Register van het Traffic Center.
  +
| De school waar je de leerling ophaalt, is niet aangesloten op OSO. Neem contact op met de betreffende school.
  +
|-
  +
  +
| VerstrekkerAanleverpuntNietBekend
  +
| De bronBrin/APindex combinatie is niet bekend bij het Traffic Center.
  +
| Het opgegeven aanleverpunt van de bronschool is (nog) niet opgenomen in het Register van het Traffic Center.
  +
| De school waar je de leerling ophaalt, is niet aangesloten op OSO. Neem contact op met de betreffende school.
  +
|-
  +
  +
  +
| VerstrekkerNietBeschikbaar
  +
| Bronsysteem is niet gerechtigd om de overstapservice te gebruiken. Voorbeeld hiervan: de URL van het bronssysteem is niet (goed) geregistreerd.
  +
| De bronschool is bekend in het register, maar er zijn geen actieve aanleverpunten beschikbaar. Voorbeeld hiervan: de URL van het bronssysteem niet (goed) is geregistreerd.
  +
| De school waar je de leerling ophaalt, heeft geen actieve aanleverpunten bij OSO. Neem contact op met de betreffende school.
  +
|-
  +
| GeenRelatieMetDoel
  +
| De overdrachtSoort in het overdrachtsRequest is "overdrachtbinnenbrin" of "SWVaanvraag", maar het bronBrin en doelBrin verschillen van elkaar.
  +
| Een overdracht binnenbrin mag alleen tussen systemen met eenzelfde BRIN plaats vinden.
  +
| Een overdracht "binnenbrin" mag alleen tussen systemen met eenzelfde BRIN-nummer plaatsvinden.
  +
|-
  +
| OverdrachtReedsActief
  +
| Er is reeds een sessie actief voor dezelfde parameters.
  +
| Een sessie voor een identieke overdracht is nog actief. Geldt ''alleen'' voor aanvraag met zoeksleutel.
  +
| Er is al een dossieroverdracht gestart. Probeer het over 10 minuten nog eens.
  +
|-
  +
  +
| OVaanvraagMetKoppelsleutel
  +
| De aanvraag heeft een andere waarde voor overdrachtsoort dan 'SWVaanvraag' maar wel een Koppelsleutel ipv een Zoeksleutel ingevuld.
  +
| Een sessie wordt alleen toegekend bij een KoppelSleutel als de overdrachtsoort 'SWVaanvraag' is.
  +
| Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
| OVaanvraagMetIncorrectAPtype
  +
| De aanvraag heeft een andere waarde voor overdrachtsoort dan 'SWVaanvraag' maar het Doelaanleverpunt is van type 'SWV'
  +
| Een sessie wordt alleen toegekend bij een aanvraag met als doelaanleverpunt van type 'SWV' als de overdrachtsoort 'SWVaanvraag' is.
  +
| Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
| SWVaanvraagMetZoeksleutel
  +
| De aanvraag heeft overdrachtsoort 'SWVaanvraag' maar een Zoeksleutel ipv een KoppelSleutel ingevuld.
  +
| Een sessie voor een overdracht van overdrachtsoort 'SWVaanvraag' mag alleen een KoppelSleutel gebruiken.
  +
| Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
| SWVaanvraagNietSpecifiek
  +
| De aanvraag van maakt gebruik van een Koppelsleutel maar specificeert geen Bronaanleverpunt.
  +
| Een sessie voor een overdracht van overdrachtsoort 'SWVaanvraag' moet een specifiek Bronaanleverpunt bevragen.
  +
| Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
| SWVaanvraagMetIncorrectAPtype
  +
| De aanvraag heeft als waarde voor overdrachtsoort 'SWVaanvraag' maar het Doelaanleverpunt is van type 'LAS'
  +
| Een sessie wordt alleen toegekend bij een aanvraag met overdrachtsoort 'SWVaanvraag' als het doelaanleverpunt van type 'RP' of 'SWV' is.
  +
| Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
| KoppelSleutelNietBekend
  +
| De aanvraag gebruikt een combinatie BronAP--Koppelsleutel--DoelAP die niet bekend is bij het TC.
  +
| Een koppelsleutel wordt door het TC gegenereerd bij het NotificatieRequest en moet daarom bekend zijn bij het TC.
  +
| Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
| OngeautoriseerdAanleverpunt
  +
| Het OIN van het certificaat komt niet overeen met die van de geregistreerde leverancier
  +
| Het Aanleverpunt (BronBRIN/APindex) is bekend bij OSO, maar in het Register is een andere Leverancier bekend dat die deze sessie aanvraag indient.
  +
| Het aanleverpunt waarop je de leerling wilt ophalen is niet (goed) geregistreerd in je LAS.
  +
|-
  +
  +
| '''ZoeksleutelNietCorrect'''
  +
| De Zoeksleutel is niet correct encrypt of bevat een PGN of Onderwijsnummer dat niet correct is.
  +
| Het TC heeft bij het controleren van de Zoeksleutel vastgesteld dat de Zoeksleutel niet correct is [[OSO:2018/beveiliging/versleuteling_bsn|versleuteld]] of het BSN of PGN in de Zoeksleutel blijkt niet correct.
  +
| Er heeft zich een interne fout voorgedaan tijdens de OV aanvraag. Neem contact op met je software leverancier.
  +
|-
  +
  +
|<Geen response>
  +
|Het Traffic Center geeft een time out of technische fout.
  +
|Het aanvragende Bronsysteem staakt de verdere aanvraag en geeft de eindgebruiker hierover een foutmelding.
  +
|Er kan geen verbinding gemaakt worden met het OSO systeem.
  +
|}
  +
<sup>*</sup> A: Alternatief, E: Exceptie (fout)
  +
   
−
==Postconditie==
  
−
*Traffic Center heeft Notificatie Melding geregistreerd
  
−
*Doelsysteem heeft correcte url van Bronsysteem ontvangen
  
   
 
==Aanroep en antwoord==
  
==Aanroep en antwoord==
   
−
*Request:
  
   
  +
*Request (voorbeeld van OV overdrachtsRequest):
 
<syntaxhighlight lang="xml">
  
<syntaxhighlight lang="xml">
−
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20180404">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
 
<soapenv:Header/>
  
<soapenv:Header/>
 
<soapenv:Body>
  
<soapenv:Body>
−
<ns:meldenNotificatieRequest>
 +
<ns:overdrachtRequest>
−
<ns:bronBrin>00AH</ns:bronBrin>
 +
<ns:bronBrin>00YY</ns:bronBrin>
−
<ns:bronAanleverpuntIndex>18</ns:bronAanleverpuntIndex>
 +
<bronRouteringsKenmerk>0000000700000YY00001</ns:bronRouteringsKenmerk>
−
<ns:doelBrin>12SS</ns:doelBrin>
 +
<ns:doelBrin>00SS</ns:doelBrin>
−
<ns:doelAanleverpuntIndex>1</ns:doelAanleverpuntIndex>
 +
<doelRouteringsKenmerk>0000000700000SS00931</ns:doelRouteringsKenmerk>
  +
<ns:zoeksleutel>sEdSD95Pkxji0FpSC2ZTvqSk4aHiiWuiV8NDavqrAouUOkzXLOkZVdR8WpROnMhl0QyZkMph7YZkGTPeAznajzTdT9Y0EBxGbf1HeDWjATC8yKeH9dGCiDO65uwLB0ly2hNmsZX/aZoefjdJbu7GhoWQjHoxOuSRJzvnzoXDrAI=</ns:zoeksleutel>
−
<ns:sessieId>b8b9a132-51ca-4188-8de7-323842336156</ns:sessieId>
  
−
<ns:aanvraagdatum>2016-03-06T14:19:39.977+02:00</ns:aanvraagdatum>
 +
<ns:overdrachtsoort>overstapdossier</ns:overdrachtsoort>
−
<ns:doel>OV</ns:doel>
 +
</ns:overdrachtRequest>
  +
</soapenv:Body>
−
</ns:meldenNotificatieRequest>
  
  +
</soapenv:Envelope>
  +
</syntaxhighlight>
  +
<br>
  +
*Request (voorbeeld van SWV overdrachtsRequest):
  +
<syntaxhighlight lang="xml">
  +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
  +
<soapenv:Header/>
  +
<soapenv:Body>
  +
<ns1:overdrachtRequest xmlns:ns1="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
  +
<ns1:bronBrin>00YY</ns1:bronBrin>
  +
<ns1:bronRouteringsKenmerk>0000000700000YY00001</ns1:bronRouteringsKenmerk>
  +
<ns1:doelBrin>00YY</ns1:doelBrin>
  +
<ns1:doelRouteringsKenmerk>0000000700000YY00931</ns1:doelRouteringsKenmerk>
  +
<ns1:koppelsleutel>da6cb121-f855-453b-a21b-9936de5b4809</ns1:koppelsleutel>
  +
<ns1:overdrachtsoort>swv-dossier</ns1:overdrachtsoort>
  +
</ns1:overdrachtRequest>
 
</soapenv:Body>
  
</soapenv:Body>
 
</soapenv:Envelope>
  
</soapenv:Envelope>
   
 
</syntaxhighlight>
  
</syntaxhighlight>
  +
<br>
−  
   
 
{|class="wikitable"
  
{|class="wikitable"
Regel 38: Regel 193:
 
|-
  
|-
 
| bronBRIN
  
| bronBRIN
−
| Dit is het BRINnummer van de Bronschool dat het DocumentRequest heeft ontvangen en een Notificatie naar het Doelsysteem wil sturen.
 +
| Dit is het brinnummer van de bronschool die het het dossier moet uitleveren.
  +
| De bronschool kan meerdere aanleverpunten hebben.
−
| Verplicht
  
   
 
|-
  
|-
  +
| bronRouteringsKenmerk
−
| bronAanleverpuntIndex
  
−
| Dit is de index van het Aanleverpunt van het Bronsysteem dat het DocumentRequest naar het Bronsysteem heeft verstuurd.
 +
| Dit is het doelRouteringsKenmerk van het bronsysteem dat bevraagd wordt (optioneel).
  +
| Deze parameter kan meegegeven worden als het doelsysteem één specifiek aanleverpunt van de school wil bevragen.
−
| Verplicht
  
   
 
|-
  
|-
 
| doelBrin
  
| doelBrin
−
| Dit is het brinnummer van het Doelsysteem dat het documentRequest heeft ingediend bij het Bronsyteem.
 +
| Dit is het brinnummer van het doelsysteem dat de sessie aanvraagt. Het TC controleert of het doelsysteem bekend en actief is in het deelnemersregister.
  +
|
−
| Verplicht
  
   
 
|-
  
|-
  +
| doelRouteringsKenmerk
−
| doelAanleverpuntIndex
  
−
| Dit is de index van het Aanleverpunt van het Doelsysteem dat de Sessie aanvraagt.
 +
| Dit is het doelRouteringsKenmerk van het doelsysteem dat de sessie aanvraagt.
  +
|
−
| Verplicht
  
−  
 
|-
  
|-
  +
| zoeksleutel
−
| sessieId
  
  +
| De zoeksleutel wordt is het geencrypte pgn
−
| Het sessieId van het laastste documentRequest dat het bronSysteem van het doelsysteem heeft ontvangen. Dus het sessieId dat de laatste keer gebruikt is bij het opvragen van het dossier.
  
  +
| Afhankelijk van de overdrachtsoort zal of de zoeksleutel of de koppelsleutel gevuld (moeten) zijn.
−
| Verplicht
  
−  
 
|-
  
|-
  +
| koppelsleutel
−
| aanvraagdatum
  
  +
| De koppelsleutel wordt overgenomen uit het notificatiebericht.
−
| Het tijdstip van het laastste documentRequest dat door het doelssysteem is gestuurd om het dossier op te vragen. Het bronssysteem heeft dit tijdstip bewaard.
  
  +
| Afhankelijk van de overdrachtsoort zal of de zoeksleutel of de koppelsleutel gevuld (moeten) zijn.
−
| Verplicht
  
−  
 
|-
  
|-
  +
| overdrachtsoort
−
| doel
  
  +
| De overdrachtsoort is "overstapdossier", "overdrachtbinnenbrin" of "swv-dossier"
−
| Geeft het doel waarvoor de Notificatie wordt verstuurd.
 
  +
| Het brinnummer van het bron- en doelBrin moet hetzelfde zijn voor een binnenbrin overdracht en SWVaanvraag.
−
| Verplicht. '''Voor deze overdracht moet de waarde 'OV' gebruikt.'''
  
−  
 
|}
  
|}
   
  +
*Response van een OV overdracht. SWV overdrachtResponse is hetzelfde, echter met 1 aanleverpunt.
−
*Response
  
−  
 
<syntaxhighlight lang="xml">
  
<syntaxhighlight lang="xml">
 
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
 
<SOAP-ENV:Header/>
  
<SOAP-ENV:Header/>
 
<SOAP-ENV:Body>
  
<SOAP-ENV:Body>
−
<over:meldenNotificatieResponse xmlns:over="http://xml.kennisnet.nl/schemas/Overstapservice/20180404">
 +
<overdrachtResponse xmlns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
−
<over:notificatie>
 +
<overdracht>
−
<over:aanleverpunt>
 +
<aanleverpunt>
−
<over:code>1</over:code>
 +
<routeringsKenmerk>0000000700000YY00932</routeringsKenmerk>
−
<over:url>https://aanleverpunturl.nl</over:url>
 +
<url>https://ott-t.kennisnet.nl/aanleverpunt/932</url>
−
<over:type>RIS</over:type>
 +
<type>RIS</type>
−
<over:label>12SS00001 RIS Testschool Triple W ICT PO</over:label>
 +
<label>00YY 0000000700000YY00932 RIS Testschool Kennisnet</label>
−
</over:aanleverpunt>
 +
</aanleverpunt>
−
</over:notificatie>
 +
<aanleverpunt>
  +
<routeringsKenmerk>0000000700000YY00931</routeringsKenmerk>
−
</over:meldenNotificatieResponse>
  
  +
<url>https://ott-t.kennisnet.nl/aanleverpunt/931</url>
  +
<type>RIS</type>
  +
<label>00YY 0000000700000YY00931 RIS Testschool Kennisnet</label>
  +
</aanleverpunt>
  +
<aanleverpunt>
  +
<routeringsKenmerk>0000000700000YY00144</routeringsKenmerk>
  +
<url>https://test.com</url>
  +
<type>RIS</type>
  +
<label>00YY 0000000700000YY00144 RIS Testschool Kennisnet</label>
  +
</aanleverpunt>
  +
<sessieId>8a27aa6c-6a8d-4bdd-ad1a-6dd1f5250125</sessieId>
  +
</overdracht>
  +
</overdrachtResponse>
 
</SOAP-ENV:Body>
  
</SOAP-ENV:Body>
 
</SOAP-ENV:Envelope>
  
</SOAP-ENV:Envelope>
−  
 
</syntaxhighlight>
  
</syntaxhighlight>
   
   
 
[[Categorie:Overstapservice Onderwijs]]
  
[[Categorie:Overstapservice Onderwijs]]
−
[[Category:Book OSO|622]]
 +
[[Category:Book OSO|72]]

Versie van 24 jan 2022 09:43

Actor(s) Goal(s)
DoelSysteem Geldige sessie toegekend krijgen voor opvragen specifiek dossier. Zowel in de variant met zoeksleutel als die met een koppelsleutel geldt dat een sessie altijd over één specifiek dossier gaat.
Traffic Center Sessie toekennen aan systeem voor geldig verzoek van systeem voor specifiek dossier door school tbv overstap of aanvraag bij samenwerkingsverband

Basisvariant: Overstapdossier

Een Doelsysteem vraagt een Sessie aan om een specifiek Dossier op te vragen bij een School (BRIN(4)). Het TC verstrekt een Sessie wanneer de School bekend en actief is; er zijn actieve Aanleverpunten bij deze school die bevraagd kunnen worden. Het TC geeft de lijst met Aanleverpunten terug aan het Sessie aanvragende systeem. Het aanvragen van een Sessie voor deze variant wordt hier verder uitgewerkt.

Variant: Specifiek Aanleverpunt bevragen

Een Doelsysteem kan specifiek één Aanleverpunt bevragen door de APindex van dit Aanleverpunt mee te geven (samen met de BronBRIN). In dit geval geeft het TC geen lijst met Aanleverpunten terug, maar alleen de informatie van dit specifieke Aaneleverpunt (mits actief).

Basisvariant: Aanvraag bij Samenwerkingsverbanden

Een Doelsysteem vraag een Sessie aan na ontvangst van een Notificatie met een Koppelsleutel. De KoppelSleutel wordt gebruikt bij deze uitwisseling als aanduiding van het over te dragen Dossier. Het aanvragen van een Sessie voor deze variant wordt hier verder uitgewerkt.

Basis scenario

  1. Doelsysteem vraagt Sessie aan bij TC
  2. IF het Doelsysteem is valide* AND Doel Aanleverpunt is actief AND Bron School is actief AND (zoeksleutel is correct**** XOR koppelsleutel is gevuld) AND (Overdrachtsoort correct ingevuld) THEN
    1. Traffic Center kent een sessie toe aan het Bronsysteem
    2. Traffic Center verstrekt lijst met te bevragen Aanleverpunten **
  3. Else
    1. Traffic Center geeft foutcode terug
    2. Doelsysteem geeft foutmelding aan Eindgebruiker ***

*Valide systeem houdt oa in dat het systeem gekwalificeerd is, een correct certificaat heeft en toegelaten is op de OSO keten.
**Als specifiek aanleverpunt bevraagd wordt, dan wordt alleen de gegevens van dit aanleverpunt doorgegeven door TC.
***In dit geval kan de Sessie niet afgemeld worden.
****De zoeksleutel wordt door het TC gedecrypt en de BSN ('11 test') of het Onderwijsnummer ('DUO test') wordt gecontroleerd. Alleen als deze stappen goed doorlopen (kunnen) wordt, geeft het TC een sessie terug én worden de laatste/rechter vier karakters van het BSN of Onderwijsnummer opgeslagen in het PGNfrag voor de Sessie controle. (Link naar beschrijving)

Uitzonderingen en meldingen

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

Resultaat Omschrijving Toelichting Melding aan Eindgebruiker
AanvragerNietBekend De aanvrager (doelBrin) is niet gerechtigd om de overstapservice te gebruiken Het doelBrin is niet bekend in het register van het Traffic Center. Je school is niet aangesloten op OSO. Neem contact op met de servicedesk van OSO.
AanvragerAanleverpuntNietBekend Het aanleverpunt van het doelsysteem (aanvragend aanleverpunt) is niet bekend bij het Traffic Center In het Register is de combinatie van doelBrin en doelAanleverpuntIndex niet aanwezig. Het aanleverpunt waarop je de leerling wilt ophalen is niet (goed) geregistreerd in je LAS.
AanvragerNietBeschikbaar De aanvrager (doelBrin) is niet gerechtigd om de overstapservice te gebruiken. De Doelschool (BRIN) is niet gerechtigd gebruik te maken van OSO. Je school is niet aangesloten op OSO. Neem contact op met de servicedesk van OSO.
VerstrekkerNietBekend Het bronBrin is niet bekend bij het Traffic Center. De opgegeven bronschool is (nog) niet opgenomen in het Register van het Traffic Center. De school waar je de leerling ophaalt, is niet aangesloten op OSO. Neem contact op met de betreffende school.
VerstrekkerAanleverpuntNietBekend De bronBrin/APindex combinatie is niet bekend bij het Traffic Center. Het opgegeven aanleverpunt van de bronschool is (nog) niet opgenomen in het Register van het Traffic Center. De school waar je de leerling ophaalt, is niet aangesloten op OSO. Neem contact op met de betreffende school.
VerstrekkerNietBeschikbaar Bronsysteem is niet gerechtigd om de overstapservice te gebruiken. Voorbeeld hiervan: de URL van het bronssysteem is niet (goed) geregistreerd. De bronschool is bekend in het register, maar er zijn geen actieve aanleverpunten beschikbaar. Voorbeeld hiervan: de URL van het bronssysteem niet (goed) is geregistreerd. De school waar je de leerling ophaalt, heeft geen actieve aanleverpunten bij OSO. Neem contact op met de betreffende school.
GeenRelatieMetDoel De overdrachtSoort in het overdrachtsRequest is "overdrachtbinnenbrin" of "SWVaanvraag", maar het bronBrin en doelBrin verschillen van elkaar. Een overdracht binnenbrin mag alleen tussen systemen met eenzelfde BRIN plaats vinden. Een overdracht "binnenbrin" mag alleen tussen systemen met eenzelfde BRIN-nummer plaatsvinden.
OverdrachtReedsActief Er is reeds een sessie actief voor dezelfde parameters. Een sessie voor een identieke overdracht is nog actief. Geldt alleen voor aanvraag met zoeksleutel. Er is al een dossieroverdracht gestart. Probeer het over 10 minuten nog eens.
OVaanvraagMetKoppelsleutel De aanvraag heeft een andere waarde voor overdrachtsoort dan 'SWVaanvraag' maar wel een Koppelsleutel ipv een Zoeksleutel ingevuld. Een sessie wordt alleen toegekend bij een KoppelSleutel als de overdrachtsoort 'SWVaanvraag' is. Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
OVaanvraagMetIncorrectAPtype De aanvraag heeft een andere waarde voor overdrachtsoort dan 'SWVaanvraag' maar het Doelaanleverpunt is van type 'SWV' Een sessie wordt alleen toegekend bij een aanvraag met als doelaanleverpunt van type 'SWV' als de overdrachtsoort 'SWVaanvraag' is. Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
SWVaanvraagMetZoeksleutel De aanvraag heeft overdrachtsoort 'SWVaanvraag' maar een Zoeksleutel ipv een KoppelSleutel ingevuld. Een sessie voor een overdracht van overdrachtsoort 'SWVaanvraag' mag alleen een KoppelSleutel gebruiken. Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
SWVaanvraagNietSpecifiek De aanvraag van maakt gebruik van een Koppelsleutel maar specificeert geen Bronaanleverpunt. Een sessie voor een overdracht van overdrachtsoort 'SWVaanvraag' moet een specifiek Bronaanleverpunt bevragen. Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
SWVaanvraagMetIncorrectAPtype De aanvraag heeft als waarde voor overdrachtsoort 'SWVaanvraag' maar het Doelaanleverpunt is van type 'LAS' Een sessie wordt alleen toegekend bij een aanvraag met overdrachtsoort 'SWVaanvraag' als het doelaanleverpunt van type 'RP' of 'SWV' is. Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
KoppelSleutelNietBekend De aanvraag gebruikt een combinatie BronAP--Koppelsleutel--DoelAP die niet bekend is bij het TC. Een koppelsleutel wordt door het TC gegenereerd bij het NotificatieRequest en moet daarom bekend zijn bij het TC. Er heeft zich een interne fout voorgedaan tijdens de SWV aanvraag. Neem contact op met je software leverancier.
OngeautoriseerdAanleverpunt Het OIN van het certificaat komt niet overeen met die van de geregistreerde leverancier Het Aanleverpunt (BronBRIN/APindex) is bekend bij OSO, maar in het Register is een andere Leverancier bekend dat die deze sessie aanvraag indient. Het aanleverpunt waarop je de leerling wilt ophalen is niet (goed) geregistreerd in je LAS.
ZoeksleutelNietCorrect De Zoeksleutel is niet correct encrypt of bevat een PGN of Onderwijsnummer dat niet correct is. Het TC heeft bij het controleren van de Zoeksleutel vastgesteld dat de Zoeksleutel niet correct is versleuteld of het BSN of PGN in de Zoeksleutel blijkt niet correct. Er heeft zich een interne fout voorgedaan tijdens de OV aanvraag. Neem contact op met je software leverancier.
<Geen response> Het Traffic Center geeft een time out of technische fout. Het aanvragende Bronsysteem staakt de verdere aanvraag en geeft de eindgebruiker hierover een foutmelding. Er kan geen verbinding gemaakt worden met het OSO systeem.

* A: Alternatief, E: Exceptie (fout)


Aanroep en antwoord

  • Request (voorbeeld van OV overdrachtsRequest):
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:overdrachtRequest>
         <ns:bronBrin>00YY</ns:bronBrin>
         <bronRouteringsKenmerk>0000000700000YY00001</ns:bronRouteringsKenmerk>
         <ns:doelBrin>00SS</ns:doelBrin>
         <doelRouteringsKenmerk>0000000700000SS00931</ns:doelRouteringsKenmerk>
         <ns:zoeksleutel>sEdSD95Pkxji0FpSC2ZTvqSk4aHiiWuiV8NDavqrAouUOkzXLOkZVdR8WpROnMhl0QyZkMph7YZkGTPeAznajzTdT9Y0EBxGbf1HeDWjATC8yKeH9dGCiDO65uwLB0ly2hNmsZX/aZoefjdJbu7GhoWQjHoxOuSRJzvnzoXDrAI=</ns:zoeksleutel>
         <ns:overdrachtsoort>overstapdossier</ns:overdrachtsoort>
      </ns:overdrachtRequest>
   </soapenv:Body>
</soapenv:Envelope>


  • Request (voorbeeld van SWV overdrachtsRequest):
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
   <soapenv:Header/>
   <soapenv:Body>
      <ns1:overdrachtRequest xmlns:ns1="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
         <ns1:bronBrin>00YY</ns1:bronBrin>
         <ns1:bronRouteringsKenmerk>0000000700000YY00001</ns1:bronRouteringsKenmerk>
         <ns1:doelBrin>00YY</ns1:doelBrin>
         <ns1:doelRouteringsKenmerk>0000000700000YY00931</ns1:doelRouteringsKenmerk>
         <ns1:koppelsleutel>da6cb121-f855-453b-a21b-9936de5b4809</ns1:koppelsleutel>
         <ns1:overdrachtsoort>swv-dossier</ns1:overdrachtsoort>
      </ns1:overdrachtRequest>
   </soapenv:Body>
</soapenv:Envelope>


Element Uitleg Opmerkingen
bronBRIN Dit is het brinnummer van de bronschool die het het dossier moet uitleveren. De bronschool kan meerdere aanleverpunten hebben.
bronRouteringsKenmerk Dit is het doelRouteringsKenmerk van het bronsysteem dat bevraagd wordt (optioneel). Deze parameter kan meegegeven worden als het doelsysteem één specifiek aanleverpunt van de school wil bevragen.
doelBrin Dit is het brinnummer van het doelsysteem dat de sessie aanvraagt. Het TC controleert of het doelsysteem bekend en actief is in het deelnemersregister.
doelRouteringsKenmerk Dit is het doelRouteringsKenmerk van het doelsysteem dat de sessie aanvraagt.
zoeksleutel De zoeksleutel wordt is het geencrypte pgn Afhankelijk van de overdrachtsoort zal of de zoeksleutel of de koppelsleutel gevuld (moeten) zijn.
koppelsleutel De koppelsleutel wordt overgenomen uit het notificatiebericht. Afhankelijk van de overdrachtsoort zal of de zoeksleutel of de koppelsleutel gevuld (moeten) zijn.
overdrachtsoort De overdrachtsoort is "overstapdossier", "overdrachtbinnenbrin" of "swv-dossier" Het brinnummer van het bron- en doelBrin moet hetzelfde zijn voor een binnenbrin overdracht en SWVaanvraag.
  • Response van een OV overdracht. SWV overdrachtResponse is hetzelfde, echter met 1 aanleverpunt.
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <overdrachtResponse xmlns="http://xml.kennisnet.nl/schemas/Overstapservice/20200910">
         <overdracht>
            <aanleverpunt>
               <routeringsKenmerk>0000000700000YY00932</routeringsKenmerk>
               <url>https://ott-t.kennisnet.nl/aanleverpunt/932</url>
               <type>RIS</type>
               <label>00YY 0000000700000YY00932 RIS Testschool Kennisnet</label>
            </aanleverpunt>
            <aanleverpunt>
               <routeringsKenmerk>0000000700000YY00931</routeringsKenmerk>
               <url>https://ott-t.kennisnet.nl/aanleverpunt/931</url>
               <type>RIS</type>
               <label>00YY 0000000700000YY00931 RIS Testschool Kennisnet</label>
            </aanleverpunt>
            <aanleverpunt>
               <routeringsKenmerk>0000000700000YY00144</routeringsKenmerk>
               <url>https://test.com</url>
               <type>RIS</type>
               <label>00YY 0000000700000YY00144 RIS Testschool Kennisnet</label>
            </aanleverpunt>
            <sessieId>8a27aa6c-6a8d-4bdd-ad1a-6dd1f5250125</sessieId>
         </overdracht>
      </overdrachtResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSO:2022/Initiëren_sessie&oldid=12198"