Aanvragen en intrekken activatiecode
- Koen Voermans
Titel | Aanvragen en intrekken activatiecode |
Use case | |
Status | In ontwikkeling ROSA-Architectuurscan BEsluitvorming IMPLEMENTATIE in beheer |
Versie | 0.9.0 |
Datum | 27 Juni 2024 |
Auteur | Werkgroep Verwerven en in gebruik nemen |
Acties |
|
Op deze pagina is de functionele, operationele en technische specificatie te vinden voor het aanvragen en intrekken van een activatiecode.
De specificatie bestaat uit de volgende onderdelen:
Randvoorwaarden: aansluiting en beschikbare brongegevens
Leveranciers beschikken afhankelijk van de referentiecomponent die ze vervullen over actuele brongegevens en/of hebben onderling overeenkomsten afgesloten:
Indien de leermiddelenaanbieder de verkoop laat verzorgen door een leermiddelenverkoper, dan hebben beide leveranciers bilaterale afspraken gemaakt en een overeenkomst gesloten.
In deze overeenkomst zijn afspraken vastgelegd over het aanvragen en intrekken van activatiecodes.
Hierbij is een algemene afspraak dat het intrekken van een activatiecode niet mogelijk is zodra deze reeds is benut voor het in gebruik nemen van een leermiddel.
Alle betrokken referentiecomponenten zijn technisch op elkaar aangesloten.
De referentiecomponenten Bestelomgeving leermiddelen en Aanspraakmanager beschikken over actuele informatie uit de referentiecomponent Leveranciersspecfieke leermiddelencatalogus.
De leermiddelenaanbieder is verantwoordelijk voor actuele informatie in de Leveranciersspecifieke leermiddelencatalogus voor alle Producten die verworven kunnen worden. Dit betekent dat is voldaan aan de vullingsregels zoals toegelicht op de pagina Producten, Aanspraken en Licenties.
Start: Leverancier vraagt activatiecode aan bij aanbieder van leermiddelen
Dit scenario start op het moment dat een leermiddelenverkoper een activatiecode aanvraagt bij een leermiddelenaanbieder. De leermiddelenverkoper die de activatiecode aanvraagt kan deze vervolgens gaan gebruiken bij de verkoop van leermiddelen aan onderwijsorganisaties en/of particulieren waarbij levervarianten met een activatiecode worden gehanteerd.
Proces: Interactieanalyse ActivatiecodeVerzoek of ActivatiecodeIntrekkingVerzoek
Het aanvragen van een activatiecode gaat op basis van een ActivatiecodeVerzoek dat door de Bestelomgeving leermiddelen of de Aanspraakmanager wordt verstuurd naar de Licentieregistratie van de leermiddelenaanbieder. De Licentieregistratie reageert op dit ActivatieCodeVerzoek met een ActivatieCodeBevestiging.
Op een vergelijkbare wijze kan ook een ActivatieCodeIntrekkingsVerzoek gedaan worden om een activatiecode niet meer geldig te laten verklaren. Dit treedt bijvoorbeeld op bij het blokkeren van een aanspraak met een activatiecode. De Aanspraakmanager kan in dat geval voorkomen dat de activatiecode toch nog benut wordt voor het in gebruik nemen van een leermiddel.
Het proces is weergegeven in Figuur 1.
Het proces voor het plaatsen van een ActivatiecodeVerzoek bestaat uit de volgende stappen:
Stap | Toelichting |
|---|---|
1. | De Bestelomgeving leermiddelen of de Aanspraakmanager stuurt via een melding een ActivatiecodeVerzoek naar de Licentieregistratie en specificeert hierin het product. Optioneel kan ook een contractnummer toegevoegd worden aan het verzoek. |
2. | De Licentieregistratie verwerkt het ActivatiecodeVerzoek, genereert een activatiecode en verwerkt deze in de backofficesystemen. |
3. | De Licentieregistratie bevestigt via een terugmelding aan de Bestelomgeving leermiddelen of de Aanspraakmanager dat de aanvraag succesvol was en geeft de activatiecode retour in een ActivatiecodeBevestiging. Indien het ActivatiecodeVerzoek niet geaccepteerd wordt dan wordt een foutcode teruggegeven. |
Indien een Bestelomgeving leermiddelen of Aanspraakmanager een activatiecode wil intrekken kan – afhankelijk van bilaterale afspraken – een ActivatiecodeIntrekkingVerzoek verstuurd worden. Dit werkt op een vergelijkbare manier als het versturen van een regulier ActivatiecodeVerzoek:
Stap | Toelichting |
|---|---|
4. | De Bestelomgeving leermiddelen of de Aanspraakmanager stuurt via een melding een ActivatiecodeIntrekkingVerzoek naar de Licentieregistratie en specificeert hierin het product en de in te trekken activatiecode. Optioneel kan ook een contractnummer toegevoegd worden aan het verzoek. |
5. | De Licentieregistratie verwerkt het ActivatiecodeIntrekkingVerzoek, trekt de activatiecode in en verwerkt de intrekking in de backofficesystemen. |
6. | De Licentieregistratie bevestigt via een terugmelding aan de Bestelomgeving leermiddelen of de Aanspraakmanager dat de activatiecode is ingetrokken via een ActivatiecodeIntrrekkingBevestiging. Indien het ActivatiecodeIntrekkingVerzoek niet geaccepteerd wordt dan wordt een foutcode teruggegeven. |
Technisch: APIs
De interactieanalyse maakt gebruik van de:
Release notes
Deze uitwerking is gebaseerd op basis van de volgende stappen:
0.0.1: Outline van de pagina is gemaakt op basis van bestaande content.
0.0.2: Tekstuele wijzigingen op basis van herziening conceptueel model.
0.9.0: Het Bestuurlijk Overleg heeft tijdens de bijeenkomst van 27 juni 2024 het Afsprakenstelsel Edu-V als versie 0.9.0 goedgekeurd voor implementatie.