Aanvragen en intrekken activatiecode

Titel

Aanvragen en intrekken activatiecode

Use case

#18 Aanvragen en intrekken van een activatiecode

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

  • Geen openstaande 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.

Figuur 1. Interactieanalyse ActivatiecodeVerzoek of ActivatiecodeIntrekkingVerzoek

Het proces voor het plaatsen van een ActivatiecodeVerzoek bestaat uit de volgende stappen:

Stap

Toelichting

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

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:

  1. 0.0.1: Outline van de pagina is gemaakt op basis van bestaande content.

  2. 0.0.2: Tekstuele wijzigingen op basis van herziening conceptueel model.

  3. 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.

Â