Annuleren leveringsorder digitaal leermiddel

Titel	Annuleren leveringsorder digitaal leermiddel
Use case	#13 Leveringsorder annuleren
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 annuleren van een leveringsorder van een digitaal leermiddel.

De specificatie bestaat uit de volgende onderdelen:

1 Randvoorwaarden
2 Start: Bestelomgeving leermiddelen annuleert leveringsorders
3 Proces: Interactieanalyse Annuleren leveringsorder
4 Technisch: APIs

Randvoorwaarden

Dit scenario komt na het scenario van het Leveren van digitaal leermiddel. Dit betekent dat is voldaan aan de volgende randvoorwaarden:

Het leermiddel is correct geleverd bij alle betrokken referentiecomponenten, zijnde:
- Aanspraakmanager
- Licentieregistratie
- Leermiddelenportaal
De aanspraak die behoort bij het digitaal leermiddel dat in gebruik genomen gaat worden door een onderwijsdeelnemer (of -medewerker) heeft de entitlementStatus entitled en is nog niet eerder in gebruik genomen. Indien gebruik wordt gemaakt van een Leermiddelenportaal is de urlStatus processed.
De activatie- en gebruiksperioden voor de aanspraak zijn geldig.
Er is voldaan aan de randvoorwaarden voor activering van gegevensuitwisselingen en de randvoorwaarden voor aansluitingen en brongegevens uit het proces leveren van digitaal leermiddel.
Indien de leermiddelenaanbieder de verkoop laat verzorgen door een leermiddelenleverancier, dan hebben beide leveranciers bilaterale afspraken gemaakt en een overeenkomst gesloten.
- In deze overeenkomst zijn afspraken gemaakt over het annuleren van leveringsorders.
Besteller en Bestelomgeving leermiddelen hebben bilaterale afspraken gemaakt over de condities waaronder een bestelling geannuleerd kan worden. De Besteller voldoet aan deze condities.

Start: Bestelomgeving leermiddelen annuleert leveringsorders

Dit scenario start op het moment dat een Besteller (onderwijsorganisatie of een particulier) een bestelling heeft geannuleerd bij een Bestelomgeving leermiddelen. Een enkele bestelling kan bestaan uit meerdere leermiddelen. De Bestelomgeving leermiddelen heeft voor iedere leveringsorder die gekoppeld is aan de bestelling een bericht naar de Aanspraakmanager gestuurd om deze leveringen te annuleren.

Hierbij maakt het proces direct onderscheid tussen het type product: fysiek, digitaal of combi. Deze uitwerking gaat uit van het annuleren van de levering van digitale leermiddelen die onderdeel zijn van een digitaal of combi product. De annulering van de levering van fysieke producten is buiten scope van deze uitwerking. De annulering van de levering van fysieke deelproducten uit een Combi-product is ook buiten scope van deze uitwerking.

Proces: Interactieanalyse Annuleren leveringsorder

Een Besteller kan een bestelling van leermiddelen annuleren. Dit proces treedt bijvoorbeeld op zodra er een foutieve bestelling was bij een Bestelomgeving leermiddelen of zodra een bestelling binnen de afgesproken bedenktermijn door de Besteller wordt geannuleerd. Hierbij geldt als voorwaarde dat het leermiddel nog niet in gebruik is genomen. Dit proces is weergegeven in Figuur 1.

Figuur 1. Interactieanalyse Annuleren leveringsorder

Het proces van het annuleren van een leveringsorder bestaat uit de volgende stappen:

Stap	Toelichting

Stap	Toelichting
1.	De Bestelomgeving leermiddelen doet een melding bij de Aanspraakmanager om een leveringsorder te annuleren. De status van de leveringsorder wordt hierbij gewijzigd naar `cancelled`.
2.	De Aanspraakmanager verzamelt alle aanspraken die van toepassing zijn op de leveringsorder.
4.	De Aanspraakmanger controleert of één van de aanspraken de status `licensed` heeft. In dit voorbeeld gaan we ervan uit dat dit niet het geval is. Indien er een leermiddel wel al in gebruik is genomen dan kan de aanspraak niet geannuleerd worden. Afhankelijk van bilaterale afspraken kan de aanspraak wel geblokkeerd worden. Hiervoor kan de Aanspraakmanager gebruik maken van het proces #15. Aanspraak blokkeren. Indien er in een aanspraak gebruik is gemaakt van een activatiecode dan is het mogelijk om deze activatiecode bij de Licentieregistratie in te trekken. Na intrekken is de activatiecode niet meer geldig en kan deze niet meer gebruikt worden om een leermiddel in gebruik te nemen. Het intrekken van een activatiecode is uitgewerkt in het scenario #18. Aanvragen en intrekken van een activatiecode.
5.	Voor iedere aanspraak wordt er door de Aanspraakmanager een melding gestuurd naar de Licentieregistratie en het Leermiddelenportaal met de entitlementStatus `cancelled` en de urlStatus `cancelled`. In de melding wordt de status van de Aanspraak gewijzigd naar Cancelled. In de melding wordt ook de einddatum (in het datumveld endDate) voor het annuleren van de aanspraak opgenomen.
6.	De Licentieregistratie verwerkt de annulering van de aanspraak. Het leermiddel is niet langer in gebruik te nemen. Indien een eindgebruiker desondanks een poging doet om toegang te krijgen tot het leermiddel dan wordt een passende melding getoond.
7.	De Licentieregistratie stuurt een terugmelding naar de Aanspraakmanager dat de Aanspraak is geannuleerd. Indien er een fout optreedt bij het annuleren van de aanspraak door de Licentieregistratie dan kan er een afgesproken foutcode worden verstuurd.
8.	Het Leermiddelenportaal verwijdert de Toegangslink uit het overzicht van leermiddelen van eindgebruiker. Indien een leverancier de referentiecomponenten Leermiddelenportaal en Onderwijsleeromgeving combineert en ook gebruik maakt van deeplinks naar leermaterialen dan worden ook de deeplinks die zijn klaargezet voor de eindgebruiker verwijderd.
9.	Het Leermiddelenportaal stuurt een terugmelding naar de Aanspraakmanager dat de Toegangslinks zijn verwijderd. Indien er een fout optreedt kan er een afgesproken foutcode worden verstuurd naar de Aanspraakmanager.
10.	De Aanspraakmanager wijzigt de entitlementStatus en de urlStatus van de aanspraak naar `cancelled.`
11.	Zodra alle aanspraken op de leveringsorder zijn geannuleerd stuurt de Aanspraakmanager een terugmelding naar de Bestelomgeving leermiddelen dat de leveringsorder is geannuleerd.
12.	De Bestelomgeving leermiddelen wijzigt de status van de leveringsorder naar `cancelled.`
13.	De Besteller kan de nieuwe status van de leveringsorder en de nieuwe statussen van de aanspraken inzien bij de Bestelomgeving leermiddelen.

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: Delivery API toegevoegd voor communicatie tussen Bestelomgeving leermiddelen en Aanspraakmanager.
0.0.3: De interactieanalyse is aangepast op basis van de herziening van het 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.