DISTRIBUTIE EN TOEGANG VAN DIGITALE LEERMIDDELEN Deel II: Functioneel en Technisch model

Transcriptie

1 DISTRIBUTIE EN TOEGANG VAN DIGITALE LEERMIDDELEN Deel II: Functioneel en Technisch model Distributie van en toegang tot digitale leermiddelen in de educatieve contentketen Auteur(s) : Wijnand Derks Erwin Reinhoud Versienummer : Zie documentgeschiedenis Totstandkoming : Dit document is tot stand gekomen in samenwerking met vertegenwoordigers van aanbieders en afnemers van digitale leermiddelen 2012 Kennisnet, SLO, GEU

2 2 / 68 Documentgeschiedenis Versie Datum Omschrijving november 2011 Eerste versie van de referentiearchitectuur december 2011 Verdere inpassing in ECK-sjabloon Inhoudelijke aanpassingen januari 2012 Aanpassingen Deel II en figuur januari 2012 Invoegen Deel I v0.93 (versie GEU) en diversen januari 2012 Diverse wijzigingen, met name rond Identiteitsverstrekker en ProfileService. 0.96/7 10 februari 2012 Aanpassingen obv korte consultatieronde april 2012 Aanpassingen nav afspraken LiMBO-programma Deze versie is niet verschenen, omdat er geen afgestemde tussenversie is gecreëerd mei 2012 Eerste volledige versie (met de technische specificaties in bijlagen) mei 2012 Introductie van de concepten Eenheid en Contract nav gesprek met ThiemeMeulenhoff mei 2012 Vertaling van ICT-gerelateerde onderdelen in Functioneel en Technisch model naar het Engels mei 2012 Wijzigingen in vertalingen naar Engels verwerkt mei 2012 Aanpassingen o.b.v. input GEU (w/o Catalogusservice) Eerste volledige concept voor ketenbrede consultatie d.d. 5 juni juni 2012 Aanpassingen o.b.v. feedback ketenbrede consultatie d.d. 5 juni 2012 en afstemming met GEU, Van Dijk Educatie, Kennisnetfederatie juni 2012 Document gesplitst in twee delen, t.w.: Definities en Procesmodel (toelichting bij basisafspraak) Functioneel en Technisch model (basisafspraak) Aanvullingen van Malmberg, m.n. t.b.v. autorisaties (via ProfileService) en Service-resolutie. Tevens ketenbreed unieke identifiers (UserId, UnitId e.d.) expliciet opgebouwd uit lokale identifier en identifier van de Administratie. Profielgegevens uitgebreid met initialen en fysieke adresgegevens. Identificatie van Tegoeden eenduidig gemaakt. CouponCode toegevoegd aan OrderService. AccountService: AuthenticateUser verwijderd omdat het een interne functie betreft. RequestAuthentication vernoemd naar de SAML-naam AuthnRequest.

3 3 / 68 Inhoudsopgave Documentgeschiedenis Inhoudsopgave Inleiding Aanleiding Waarom een referentiearchitectuur? Voordelen van een brede afspraak over distributie en toegang De afspraak Doelstelling Afbakening Toepasselijkheid Opbouw Leeswijzer 6 2. Functioneel model (I) AccountService ProfileService ProductListService EducationalContentListService OrderService PaymentService DistributionService LicenseService EntryLocationService EducationalContentService Technisch model (T) Identificatie Gebruikers identificeren, authenticeren en ophalen van profielinformatie Authenticatie van Ketenpartners Beveiliging web service koppelvlakken Web service standaarden Diakrieten, de tekenset en encoding Foutafhandeling Vrijwaring gebruik afspraak Bronnen 56 Bijlage: Deelnemers aan het standaardisatieproces Bijlage: Algemene web service specificaties Bijlage: ProfileService web service specificatie Bijlage: AccountService web service specificatie Bijlage: ProductListService web service specificatie

4 4 / 68 Bijlage: EducationalContentListService web service specificatie Bijlage: OrderService web service specificatie Bijlage: PaymentService web service specificatie Bijlage: DistributionService web service specificatie Bijlage: LicenseService web service specificatie Bijlage: EntryLocationServicehuis web service specificatie

5 5 / Inleiding 1.1 Aanleiding Digitale leermiddelen nemen ieder jaar een belangrijkere plaats in op de leermiddelenlijst van onderwijsinstellingen. Nu scholen steeds meer vertrouwen op digitale leermiddelen voor hun primaire onderwijsproces, wordt het steeds belangrijker dat deze leermiddelen ook tijdig beschikbaar zijn in de klas. 1.2 Waarom een referentiearchitectuur? Voor een foutloze distributie en toegang zijn de LAS- en ELO-leveranciers, distributeurs en uitgeverijen onderling afhankelijk van elkaar. Hiermee ontstaat de noodzaak om afspraken te maken over de samenwerking. 1.3 Voordelen van een brede afspraak over distributie en toegang Een ketenbrede afspraak heeft als voordeel dat partijen eenvoudiger met elkaar kunnen samenwerken. Hierdoor wordt het voor ketenpartijen makkelijker om hun toegevoegde waarde binnen de keten te realiseren. Dit levert betere kwaliteit en lagere kosten voor iedereen, en in het bijzonder de scholen. 1.4 De afspraak De afspraak omvat een referentiearchitectuur met daarin een lijst van begrippen, een procesmodel, functioneel model en technisch model. Ieder model kent een aantal principes die richtinggevend zijn voor marktoplossingen. De referentiearchitectuur vormt een basis voor dienstverlening door marktpartijen. 1.5 Doelstelling De afspraak dient ervoor om de gewenste vormen van dienstverlening mogelijk te maken. Voor de gewenste vormen van dienstverlening verwijzen we naar de ECK-DTDL-wensenlijst [1] en het pakket van eisen van het LiMBO-programma [2]. 1.6 Afbakening De referentiearchitectuur bestrijkt het volgende domein binnen de educatieve contentketen: De referentiearchitectuur beschouwt web-gebaseerd digitale leermiddelen die onder licentie wordt uitgegeven, al dan niet tegen vergoeding. De referentiearchitectuur beoogd wel compatibel te zijn met de werkwijzen rondom fysieke leermiddelen. De referentiearchitectuur beoogt wel compatibel te zijn met de werkwijzen rondom fysieke leermiddelen. De distributie en toegang van digitale leermiddelen omvat de processen en systemen van het bepalen van de leermiddelenlijst tot en met het moment van toegang van de gebruiker tot het digitaal leermateriaal. De referentiearchitectuur is van toepassing op digitale leermiddelen voor het primair onderwijs 1 (PO), voortgezet onderwijs (VO) en middelbaar beroepsonderwijs (MBO). 1 Het primair onderwijs is beperkt betrokken geweest bij de totstandkoming van deze versie van de referentiearchitectuur. Dientengevolge kan voor deze sector de referentiearchitectuur vooralsnog niet als richtinggevend worden beschouwd.

6 6 / Toepasselijkheid De referentiearchitectuur is als volgt van toepassing: De referentiearchitectuur is van toepassing op alle organisaties die betrokken zijn bij distributie en toegang van digitaal leermateriaal in de educatieve contentketen, waaronder scholen en instellingen, leveranciers van voorzieningen, distributeurs en overige handelspartijen en uitgeverijen. De referentiearchitectuur is van toepassing op de samenwerking tussen deze organisaties. De referentiearchitectuur is niet van toepassing op inrichting en/of werkwijzen binnen organisaties. Organisaties zijn niet verplicht alle functionaliteit van de referentiearchitectuur aan te bieden of te gebruiken. 1.8 Opbouw De referentiearchitectuur omvat de volgende onderdelen: Deel I: Definities en Procesmodel Definities: omvat de begrippen die in deze afspraak worden gebruikt, Procesmodel: omvat de processtappen en werkingsprincipes binnen de distributie en toegangsketen. Deel II: Functioneel en technisch model (dit document) Functioneel model: omvat de functionele bouwblokken en hun koppelvlakken binnen de distributie en toegangsketen, Technisch model: omvat de technische beschrijvingen van de koppelvlakken van de functionele bouwblokken. 1.9 Leeswijzer In ieder hoofdstuk zijn zogenaamde Best practices benoemd. Een Best practice dient te worden gelezen als een advies voor het gebruik van een bepaald onderdeel van de referentiearchitectuur.

7 7 / Functioneel model (I) In dit hoofdstuk worden de functionele bouwblokken beschreven die de processtappen ondersteunen. De functionele bouwblokken noemen we Services. 2 Ketenpartners zijn vrij in hun keuze welke Service zij aanbieden. Indien een Service wordt aangeboden, dan dienen ook alle bijbehorende functies te worden aangeboden, behalve de optionele functies (Optional). De manier waarop Services gevonden kunnen worden door ketenpartners is beschreven in het Technisch Model. In figuur 1 wordt de relatie tussen de processtappen en Services weergegeven in termen van gegevensstromen. Payment- Service Betalen Distribueren Bestellen Order- Service Educational ContentList Service Bepalen ProductList Service Profileren Configureren Distribution Service Identificeren Entry- Location- Service Vermenigvuldigen Profile- Service Koppelen License- Service Activeren Authenticeren Account- Service Toegang Educational Content Service Figuur 1 Overzicht van processtappen en Services s (1) Het Functioneel model is service georiënteerd opgezet. Conform breed toegepaste referentiearchitecturen, dienen services servicegeoriënteerd opgezet te worden ( Services moeten service georiënteerd opgezet zijn. Deze opzet voorziet in modulariteit waardoor herbruikbaarheid en vervangbaarheid worden verhoogd. 2 We kiezen niet voor de term dienst om verwarring met (zakelijke) dienstverlening door ketenpartners te vermijden.

8 8 / 68 (2) Het Functioneel model omvat de noodzakelijke koppelvlakken om de gewenste vormen van dienstverlening te faciliteren. Het Functioneel model biedt de minimale functionaliteit om de gewenste dienstverlening in de keten te faciliteren. Dit principe dient als leidraad voor de afbakening van het functioneel model: er volgt uit welke informatie op welke wijze tussen services en applicaties uitgewisseld kan en moet worden. (3) De services dragen de verantwoordelijk voor de zakelijke consistentieregels. Eventuele applicaties bovenop de services leveren aanvullende dienstverlening, maar de verantwoordelijkheid voor de correctheid van de werkwijze is belegd bij de services. Dit principe dient als leidraad voor de afbakening van het functioneel model: er volgt uit welke informatie op welke wijze tussen services en applicaties uitgewisseld kan en moet worden. (4) De volgende services worden onderkend: AccountService ProfileService ProductListService EducationalContentListService OrderService PaymentService LicenseService DistributionService EntryLocationService EducationalContentService Binnen de keten worden de betreffende services en functies onderkend De services vormen eenheden die door ketenpartners als aparte dienst in de keten (zouden kunnen) worden aangeboden. (5) De identifiers die zijn benoemd in de invoer- en uitvoerparameters van service-functies zijn ketenbreed uniek. Een identifier die voorkomt als invoer- of uitvoerparameter heeft een dusdanige vorm dat deze herleid kan worden tot een unieke identiteit binnen de keten. Op deze manier wordt niet voorgeschreven hoe een ketenbreed unieke identifier wordt bepaald. (6) De identifier van een Rechtspersoon is geen onderdeel van Functioneel Model. De PartyId wordt slechts binnen het Technisch model gebruikt. De combinatie van AdministratieId en lokale identifier is voldoende voor ketenbrede identificatie van Deelnemers en Eenheden. Indien de Rechtspersoon verandert, hoeven de gekoppelde licenties niet per definitie te worden verhuisd.

9 9 / AccountService De AccountService beheert accounts en biedt authenticatiefuncties voor identiteiten van natuurlijke personen. Authenticatie van voorzieningen verloopt via certificaten. Voor details verwijzen we naar het Technisch model. Authenticatie vindt plaats op basis van gebruikersnaam en wachtwoord. Nadat een natuurlijk persoon zich heeft geauthenticeerd voor een bepaalde identiteit, verstrekt de AccountService de ketenbreed unieke identifier van de gebruiker. Op basis van deze identifier kunnen in een ProfileService kenmerken van de betreffende identiteit worden gelezen. Figuur 2 Overzicht van AccountServicefuncties s (1) De AccountService authenticeert identiteiten van natuurlijke personen. Een AccountService beheert accounts van identiteiten van natuurlijke personen. Naast de authenticatiefunctie worden er functies voor het creëren en activeren van een account ondersteund. Er zijn ook beheerfuncties voorzien. De AccountService is met name bedoeld voor het kunnen authenticeren van identiteiten van natuurlijke personen. Natuurlijke personen maken veelal gebruik van Portalen via web browsers. Via deze browsers moet de achterliggende identiteit van de gebruiker kunnen worden bepaald. Voor authenticatie van Rechtspersonen worden andere authenticatievoorzieningen gebruikt. Dit wordt in het technisch model toegelicht.

10 10 / 68 (2) De AccountService beheert alleen accountgegevens van een gebruiker. De AccountService beheert geen nadere gegevens dan de identifier (UserId en UserAdministrationId) van een gebruiker. Aanvullende gegevens over gebruikers worden in een ProfileService geregistreerd. Hierdoor wordt het mogelijk om authenticatiediensten en het beheren van (aanvullende) persoonsgegevens van elkaar te scheiden en door verschillende aanbieders te laten uitvoeren. Bijvoorbeeld kan de AccountService centraal worden aangeboden, en de ProfileServices door individuele ketenpartners. (3) De authenticatiefunctie van de AccountService ondersteunt zekerheidsniveau Basis. Indien voor een functie authenticatie vereist is, geldt dat de mate van zekerheid die gewenst is over de identiteit van een gebruiker van zekerheidsniveau Basis is. Voor de indeling van zekerheidsniveaus bij het authenticeren van gebruikers wordt aangesloten op de betreffende definities van DigiD 3 hiervoor. Binnen de keten worden authenticatiemiddelen toegepast die onder zekerheidsniveau Basis vallen. Dit zijn bijvoorbeeld de UserName en Password combinatie. Er zijn andere zekerheidsniveaus als Midden en Hoog waarbij respectievelijk authenticatie plaats vindt op basis van SMS en een persoonsgebonden elektronische identiteitskaart. Deze vormen zijn niet noodzakelijk. De zekerheid op niveau basis wordt momenteel als voldoende geacht. Het streven is om zoveel mogelijk binnen de keten te standaardiseren. Zekerheidsniveau Basis is voldoende om alle functies binnen de keten te kunnen uitvoeren (4) De UserName moet uniek zijn binnen het domein van de AccountService De geregistreerde accounts in een AccountService worden uniek onderkend op basis van de UserName. De UserName moet uniek zijn om de gebruiker en bijbehorende account ook uniek te kunnen identificeren. (5) Federatieve authenticatie wordt ondersteund Een AccountService kan een ander AccountService vragen om authenticatie van een gebruiker. Federatieve authenticatie kan gewenst zijn om het onderhoud van AccountServices te minimaliseren NewAccount (Optional) Bij het creëren van een nieuw account wordt een authenticatiemiddel aan een UserId gekoppeld. Het hier beschreven authenticatiemiddel is een UserName en een Password-combinatie. Er bestaat de keuze dat er direct door de gebruiker een account wordt aangemaakt en een Password ingegeven wordt, of dat door een beheerder bij een Instelling het account wordt 3

11 11 / 68 aangemaakt. Als een Instelling nieuwe accounts aanmaakt wordt en een tijdelijk wachtwoord (TempPassword) gegenereerd welk de gebruiker nodig heeft bij het activeren van het account. De invoergegevens voor deze functie zijn: 1 UserName: gebruikersnaam 2 Password (Optional): wachtwoord 3 UserId: identifier van de gebruiker, uniek binnen de betreffende Administratie 4 UserAdministrationId: de Administratie bij de UserId De uitvoergegevens voor deze functie zijn: 1 TempPassword (Optional): tijdelijk wachtwoord; indien Password niet is ingevoerd DeleteAccount (Optional) Deze functie verwijdert een bestaand account. Merk op dat als identifier van het account de UserName wordt aangehouden en niet de combinatie UserId met UserAdministrationId. Op deze wijze kunnen meerdere accounts worden ondersteund voor eenzelfde identiteit. De invoergegevens voor deze functie zijn: 1 UserName: gebruikersnaam De uitvoergegevens voor deze functie zijn: 1 Confirmation: bevestiging ActivateAccount (Optional) Indien bij het creëren van een nieuwe account voor later activeren is gekozen kan de account via deze functie geactiveerd te worden. Bij later activeren wordt bij het creëren een tijdelijk Password aangemaakt welke de gebruiker nodig heeft om zijn account te kunnen activeren en moet hierbij een nieuw Password ingeven. De invoergegevens voor deze functie zijn: 1 UserName: gebruikersnaam 2 TempPassword: tijdelijk wachtwoord 3 NewPassword: nieuw wachtwoord De uitvoergegevens voor deze functie zijn: 1 Confirmation: bevestiging AuthnRequest 4 Dit is de vraag zoals deze door de dienstaanbieder aan de AccountService wordt doorgegeven via het door de gebruiker gebruikte platform. Het authenticeren van gebruikers wordt op basis van het SAML 2.0 Web Browser SSO profiel (SP initiated SSO with POST/artifact bindings) geïmplementeerd. Na authenticatie, worden de volgende gegevens teruggegeven: UserId: identifier van de gebruiker, uniek binnen de betreffende Administratie UserAdministrationId: de Administratie bij de UserId Zie voor verdere details de bijlage AccountService web service specificatie. 4 Vernoemd naar de betreffende SAML-functie.

12 12 / ProfileService Een ProfileService beheert aanvullende gegevens over identiteiten in profielen. Deze gegevens kunnen vervolgens selectief beschikbaar worden gesteld aan derden. De gegevens omvatten persoonsgegevens, maar ook machtigingen die zijn toegekend aan de betreffende identiteit. Een voorbeeld hiervan is de machtiging aan een leerling om van een bepaald schooltegoed te mogen afboeken. Meerdere ProfileServices kunnen gegevens bewaren over dezelfde identiteiten. Figuur 3 Overzicht van de functies van de ProfileService s (1) Een ProfileService is een registratie waarop de Wet Bescherming Persoonsgegevens van toepassing is. Indien een ProfileService persoonsgegevens gaat beheren, moet deze conform de richtlijnen van Achtergrondstudies en Verkenningen 23 worden ontworpen en ontwikkeld. Het AV-23 is beschikbaar gesteld door het College voor Persoonsbescherming ( Gegevens die herleidbaar zijn naar natuurlijke personen vallen onder de Wet Bescherming Persoonsgegevens. (2) Een profiel kan aan de hand van een UserLocalId en UserAdministrationId worden gezocht. Een Profiel is altijd aan één gebruiker gekoppeld. Een Profiel omvat kenmerken van een gebruiker.

13 13 / 68 (3) Een gebruiker hoeft geen Profiel te hebben. Er hoeft geen Profiel te zijn geregistreerd bij een gebruiker. Een identiteit kan ook zonder profiel bestaan NewProfile (Optional) De invoergegevens voor deze functie zijn: 1 UserId: identifier van de gebruiker die uniek is binnen de betreffende Administratie 2 UserAdministrationId: de Administratie bij de UserId De uitvoergegevens voor deze functie zijn: 1 Confirmation: bevestiging UpdateProfile (Optional) Deze functie schrijft kenmerken van een identiteit in een profiel. De waarden van de invoerparameters vervangen de oude waarden. Een lege invoerparameter resulteert in het wissen van de oude waarde. Een gebruiker kan slechts een enkele rol vervullen. Een gebruiker in verschillende rollen heeft verschillende identiteiten. De velden EducationalCourseId, EducationalSubjectId, EducationalLevelId, EducationalGroupId geven het onderwijskundige domein aan van de gebruiker: Leerling - Indien het een leerling betreft, bepalen deze velden welke leermiddelenlijsten van toepassing zijn op de leerling, en in welke onderwijskundige context hij zijn materialen gebruikt (bijv. t.b.v. docentenoverzichten). Leermiddelenlijstbeheerder - Indien het een leermiddelencoördinator betreft, geven deze velden aan binnen welke context deze leermiddelencoördinator leermiddelenlijsten mag beheren. Docent - Indien het een docent betreft, geven deze velden aan binnen welke context hij de rol van docent vervult. We merken op dat de velden EducationalCourseId, EducationalSubjectId, EducationalLevelId, EducationalGroupId niet hoeven te voldoen aan vocabulaires, en dat zij dus kunnen verschillen per school. De begunstigde (CreditorId) in het profiel van een gebruiker kunnen door ketenpartners onder andere worden gebruikt voor: Bestellen - de gebruiker mag bestellen volgens de voorwaarden die voor deze begunstigde(n) zijn afgesproken, Distribueren - de gebruiker mag (verzamel-) tegoeden van deze begunstigde(n) verzilveren in een licentie. Dit is met name gebruikelijk in IBF-scenario s.

14 14 / 68 De invoergegevens voor deze functie zijn: 1 UserId: identifier van de gebruiker of organisatorische eenheid 2 UserAdministrationId: de Administratie bij de UserId 3 Role (Optional): de rol van de gebruiker 4 0..n: 1 UnitId: organisatorische eenheid van de gebruiker 2 UnitAdministrationId: de Administratie bij de UnitId 5 0..n: 1 CreditorId: begunstigde waarvan de gebruiker tegoed mag afboeken 2 CreditorAdministrationId: de Administratie bij de CreditorId 6 0..n: 1 EducationalCourseId: opleiding bij de gebruiker 2 EducationalCourseAdministrationId: de Administratie bij EducationalCourseId 3 EducationalSubjectId: vak bij de gebruiker 4 EducationalSubjectAdministrationId: de Administratie bij EducationalSubjectId 5 EducationalLevelId: leerniveau/jaargang bij de gebruiker 6 EducationalLevelAdministrationId: de Administratie bij EducationalLevelId 7 EducationalGroupId: onderwijsgerelateerde klas/groep bij de gebruiker 8 EducationalGroupAdministrationId: de Administratie bij EducationalGroupId 7 Initials (Optional): initialen van de gebruiker 8 FirstName (Optional): voornaam van de gebruiker 9 MiddleName (Optional): tussenvoegsel van de gebruiker 10 LastName (Optional): achternaam van de gebruiker 11 BirthDate (Optional): geboortedatum van de gebruiker 12 Street (Optional): straatnaam bij de gebruiker 13 StreetNumber (Optional): huisnummer bij de gebruiker 14 StreetNumberExtra (Optional): huisnummertoevoeging bij de gebruiker 15 PostalCode (Optional): postcode bij de gebruiker 16 City (Optional): woonplaats bij de gebruiker 17 (Optional): adres voor correspondentie met de gebruiker 18 PhoneNumber (Optional): telefoonnummer van de gebruiker De uitvoergegevens voor deze functie zijn: 1 Confirmation: bevestiging ReadProfile De profielgegevens kunnen worden uitgelezen worden op basis van een UserId en bijbehorende UserAdministrationId, of op basis van andere profielkenmerken. Bij de invoerparameters geldt indien geen waarde is opgegeven, alle waarden worden aangenomen. Verder worden alleen die gegevens geleverd worden, waarvoor de afnemer is geautoriseerd.

15 15 / 68 De invoergegevens voor deze functie zijn: 1 UserId (Optional): identifier van de gebruiker, uniek binnen de betreffende Administratie 2 UserAdministrationId (Optional 5 ): de Administratie bij de UserId 3 Role (Optional): de rol van de gebruiker 4 0..n: 5 0..n: 6 0..n: 1 UnitId: organisatorische eenheden van de gebruiker 2 UnitAdministrationId: de Administratie van de UnitId 1 CreditorId: begunstigde waarvan de gebruiker tegoed mag afboeken 6 2 CreditorAdministrationId: de Administratie bij de CreditorId 1 EducationalCourseId (Optional): opleiding van de gebruiker 2 EducatialCourseAdministrationId (Optional): de Administratie bij de EducationalCourseId 3 EducationalSubjectId (Optional): vak van de gebruiker 4 EducationalSubjectAdministrationId (Optional): de Administratie bij EducationalSubjectId 5 EducationalLevelId (Optional): leerniveau/jaargang van de gebruiker 6 EducationalLevelAdministrationId (Optional): de Administratie bij EducationalLevelId 7 EducationalGroupId (Optional): onderwijsgerelateerde klas/groep van de gebruiker 8 EducationalGroupAdministrationId (Optional): de Administratie bij EducationalGroupId 7 Initials (Optional): initialen van de gebruiker 8 FirstName (Optional): voornaam van de gebruiker 9 MiddleName (Optional): tussenvoegsel van de gebruiker 10 LastName (Optional): achternaam van de gebruiker 11 BirthDate (Optional): geboortedatum van de gebruiker 12 Street (Optional): straatnaam bij de gebruiker 13 StreetNumber (Optional): huisnummer bij de gebruiker 14 StreetNumberExtra (Optional): huisnummertoevoeging bij de gebruiker 15 PostalCode (Optional): postcode bij de gebruiker 16 City (Optional): woonplaats bij de gebruiker 17 (Optional): adres voor correspondentie met de gebruiker 18 PhoneNumber (Optional): telefoonnummer van de gebruiker 5 Verplicht als UserId is ingevuld. 6 Mogelijk beperkt een leverancier de mogelijke CreditorId/CreditorAdministrationId s om te voorkomen dat tegoeden willekeurig van derden worden afgeboekt.

16 16 / 68 De uitvoergegevens voor deze functie zijn: 1 0..n: 1 UserId: identifier van de gebruiker, uniek binnen de betreffende Administratie 2 UserAdministrationId: de Administratie bij de UserId 3 Role (Optional): de rol van de gebruiker 4 0..n: 5 0..n: 6 0..n: 1 UnitId: organisatorische eenheden van de gebruiker 2 UnitAdministrationId: de Administratie bij de UnitId 1 CreditorId: begunstigde waarvan de gebruiker tegoed mag afboeken 2 CreditorAdministrationId: de Administratie bij de CreditorId 1 EducationalCourseId (Optional): opleiding(en) van de gebruiker 2 EducationalCourseAdministrationId (Optional): de Administratie bij de EducationalCourseId 3 EducationalSubjectId (Optional): vak van de gebruiker 4 EducationalSubjectAdministrationId (Optional): de Administratie bij EducationalSubjectId 5 EducationalLevelId (Optional): leerniveau/jaargang van de gebruiker 6 EducationalLevelAdministrationId (Optional): de Administratie bij EducationalLevelId 7 EducationalGroupId (Optional): onderwijsgerelateerde klas/groep van de gebruiker 8 EducationalGroupAdministrationId (Optional): de Administratie bij EducationalGroupId 7 Initials (Optional): initialen van de gebruiker 8 FirstName (Optional): voornaam van de gebruiker 9 MiddleName (Optional): tussenvoegsel van de gebruiker 10 LastName (Optional): achternaam van de gebruiker 11 BirthDate (Optional): geboortedatum van de gebruiker 12 Street (Optional): straatnaam bij de gebruiker 13 StreetNumber (Optional): huisnummer bij de gebruiker 14 StreetNumberExtra (Optional): huisnummertoevoeging bij de gebruiker 15 PostalCode (Optional): postcode bij de gebruiker 16 City (Optional): woonplaats bij de gebruiker 17 (Optional): adres voor correspondentie met de gebruiker 18 PhoneNumber (Optional): telefoonnummer van de gebruiker

17 17 / DeleteProfile (Optional) De invoergegevens voor deze functie zijn: 1 UserId: identifier van de gebruiker 2 UserAdministrationId: de Administratie bij de UserId De uitvoergegevens voor deze functie zijn: 1 Confirmation: bevestiging

18 18 / ProductListService De ProductListService 7 ontsluit het actuele aanbod van Leermiddelen van een Ketenpartner, waaronder distributeurs, boekhandels en uitgevers. De ProductListService dient ter ondersteuning van de processtappen Bepalen en Bestellen. De ProductListService is niet bedoeld voor marketingdoeleinden. De ProductListService beschrijft enkelvoudige en samengestelde leermiddelen. Beide worden geïdentificeerd met een EducationalContentId. We merken op dat de ProductListService leermiddelen kan bevatten, die niet door de aanbieder als product worden verkocht. Zo kan een enkelvoudig leermiddel alleen samengesteld in combinatie met andere leermiddelen als product worden verkocht. Indien het een digitaal leermiddel betreft, kan bij het leermiddel een beperking in periode (LicenseStartDate, LicenseEndDate), in gebruiksduur (LicenseDuration) of aantal maal gebruik (LicenseCount) zijn bepaald. Op dit moment worden digitale leermiddelen als product vaak nog gecombineerd aangeboden met fysieke leermiddelen. De ProductListService ondersteunt daarom samengestelde leermiddelen die bestaan uit fysieke en digitale leermiddelen. De ProductListService kan mogelijk worden gevoed door externe Catalogi. Figuur 4 Overzicht van ProductListServicefuncties s (1) De EducationalContentId identificeert een enkelvoudig of samengesteld Leermiddel. Een EducationalContentId is een verwijzing naar een product in de ProductListService. Deze verwijzing kan naar een product verwijzen dat uit meerdere Leermiddelen bestaat. De EducationalContentId verwijst naar een product. 7 Er is bewust gekozen voor de naam ProductListService in plaats van CatalogueService, om verwarring te voorkomen met een (toekomstige) standaard voor catalogi van uitgevers. De ProductListService heeft alleen toepassing binnen de context van deze afspraak.

19 19 / 68 (2) Een EducationalContentId impliceert het type content en de bijbehorende licentievorm. De EducationalContentId identificeert het leermiddel en de licentievorm. De EducationalContentId bepaalt niet per definitie de licentieperiode. De licentievorm wordt door de aanbieder van het leermiddel bepaald en hoeft bij het zoeken en bestellen niet apart gespecificeerd te worden. Een EducationalContentId identificeert eenduidig het product en licentievorm en de gebruiksmogelijkheden die hier aan verbonden zijn. Omdat het een licentie betreft, kan de gebruiksperiode variëren. (3) Een aanbieder ontsluit via zijn ProductListService het actuele aanbod van leermiddelen. De ProductListService presenteert de leermiddelen die bij de aanbieder van de ProductListService kunnen worden besteld. Afnemers van de informatie moeten kunnen vertrouwen op de kwaliteit van de gegevens. (4) De ProductListService presenteert algemene productinformatie. De aanbieder van de ProductListService presenteert zijn algemeen geldende contractvoorwaarden voor de leermiddelen, zoals levereenheden, adviesprijzen en beschikbaarheid. Individuele afspraken met afnemers worden niet door de ProductListService verstrekt. Speciale, individuele contractvoorwaarden zijn gebonden aan contractpartijen. Deze zijn bekend bij de OrderService en identiteit-gebonden en passen om dit reden beter bij de OrderService. (4) Veranderingen in de kenmerken van een leermiddel verstoren de ketenprocessen niet. Webgebaseerd materiaal kan wijzigen nadat het is besteld. Voorbeelden zijn updates m.b.t. inhoud of prijzen. Wijzigingen mogen niet leiden tot ongewenste effecten, zoals grote afwijkingen van de inhoud, of tussentijdse prijsverhogingen. Ketenpartners moeten er vanuit kunnen gaan dat een leermiddel niet ongewenst tijdens de rit verandert. Dit zou immers ertoe kunnen leiden dat een bepaald leermiddel met een bepaald EducationalContentId wordt besteld, en het leermiddel later wijzigt ReadProductListEntry Deze functie is bedoeld ter ondersteuning van de processtappen Bepalen en Bestellen. De functie is niet bedoeld om informatie te verstrekken voor marketingdoeleinden. Ter ondersteuning van deze stappen biedt de service niet alleen algemene productinformatie maar ook handelsinformatie. We wijzen erop, dat de functie actuele informatie teruggeeft over producten. De waarden van de uitvoervelden kunnen dus verschillen per aanroep. De invoerparameters bepalen de kenmerken van de leermiddelen die worden gelezen. De uitvoerparameters zijn gemarkeerd met de wenselijkheid waarmee zij gevuld zijn (Nice, Should). Die parameters die niet nader zijn gemarkeerd zijn verplicht gevuld.

20 20 / 68 Bij digitale leermiddelen worden soms ook aanvullende rechten verkocht. Voorbeelden hiervan zijn beheerrechten, overdrachtsrechten, verlenging van licentieperiode e.d. De standaard gaat er vanuit dat deze aanvullende rechten als aparte producten worden verkocht onder een eigen EducationalContentId. De invoergegevens voor deze functie zijn: 1 EducationalContentId (Optional): uniek nummer van het leermiddel 2 EducationalContentAdministrationId (Optional 8 ): de Administratie bij de EducationalContentId 3 PublisherId (Optional): identificatie van de uitgever als Rechtspersoon 4 PublisherName (Optional): naam van de uitgever als Rechtspersoon 5 Title (Optional): titel van het product 6 Author (Optional): de personen en/of organisatie die hebben gewerkt aan de totstandkoming 7 Description (Optional): Korte (inhoudelijke) beschrijving of samenvatting van het leermiddel. 8 EducationalSubject (Optional): Vak, onderwerp van het leermiddel. 9 Classification (Optional): classificatie van de inhoud van het leermiddel. 10 Medium (Optional): gegevensdrager van het product 11 EducationalContentUsageType (Optional): de indicatie of het materiaal gebruik-, of verbruikmateriaal is 12 LicenseStartDate (Optional): startdatum van de licentie 13 LicenseEndDate (Optional): einddatum van de licentie 14 LicenseDuration (Optional): aantal dagen dat de licentie geldig is vanaf start 15 LicenseCount (Optional): aantal maal dat de licentie mag worden gebruikt 16 IntendedUserRole (Optional): indicatie of het materiaal is bedoeld voor gebruik door leerling of voor docent 17 FirstPublishedDate (Optional): de eerste verschijningsdatum van het leermateriaal op de markt 18 LastRevisionDate (Optional): de laatste herzieningsdatum van het leermateriaal 19 EntryLocation (Optional): referentie (URL) naar plaats van het webgebaseerd leermiddel 20 InformationLocation (Optional): referentie (URL) naar de plaats van nadere productinformatie 21 ThumbnailLocation (Optional): Publieke referentie naar thumbnail van het product 22 Copyright (Optional): Leermiddel is wel/niet belast met auteursrechten 23 CopyrightDescription (Optional): Omschrijving van de auteursrechten die van toepassing zijn n: 1 EducationalContentChildId: de leermiddelen waaruit dit product bestaat (in het geval van een gecombineerd product) 2 EducationalContentChildAdministrationId: de Administratie bij de EducationalContentChildId 8 Verplicht als EducationalContentId is ingevuld.

21 21 / SupplierId (Optional): de Rechtspersoon die het leerobject voor genoemde prijs voor verkoop aanbiedt 26 SupplierName (Optional): de naam van de Rechtspersoon bij de SupplierId 27 SaleUnitSize (Optional): het aantal exemplaren van het (mogelijk samengesteld) product dat als eenheid wordt verkocht. 28 HasCost (Optional): indicator om aan te geven of aan de leermiddelen kosten zijn verbonden 29 Currency (Optional): de valuta van de prijs 30 PriceVATHigh (Optional): de prijs per verkoopeenheid van het product (excl. BTW) in centen waarover hoog BTW-tarief wordt gerekend 31 PriceVATLow (Optional): de prijs per verkoopeenheid van het product (excl. BTW) in centen waarover laag BTW-tarief wordt gerekend 32 AvailabilityStatus (Optional): status leverbaarheid van product 33 AvailabilityDate (Optional): datum vanaf wanneer het product leverbaar is 34 LastModifiedDate (Optional): laatste keer dat de productinformatie is aangepast door de uitgever. De uitvoergegevens voor deze functie zijn: 0..n: 1 EducationalContentId: uniek productnummer van het leermateriaal 2 EducationalContentAdministrationId: de Administratie bij de EducationalContentId 3 PublisherId: identificatie van de uitgever 4 PublisherName: naam van de uitgever 5 Title (Should): titel van het product 6 Author (Should 9 ): de personen en/of organisatie die hebben gewerkt aan de totstandkoming 7 Description (Should): Korte (inhoudelijke) beschrijving of samenvatting van het leermiddel. 8 EducationalSubject (Nice): Vak, onderwerp van het leermiddel. 9 Classification (Should): classificatie van de inhoud van het leermiddel. 10 Medium (Should): gegevensdrager van het product 11 EducationalContentUsageType (Nice): de indicatie of het materiaal gebruik-, of verbruikmateriaal is 12 LicenseStartDate (Should): startdatum van de licentie 13 LicenseEndDate (Should): einddatum van de licentie 14 LicenseDuration (Should): aantal dagen dat de licentie geldig is vanaf start 15 LicenseCount (Should): aantal maal dat het product mag worden gebruikt 16 IntendedUserRole (Should): indicatie of het materiaal is bedoeld voor gebruik door leerling of voor docent 17 FirstPublishedDate (Should): de eerste verschijningsdatum van het leermateriaal op de markt 18 LastRevisionDate (Should): de laatste herzieningsdatum van het leermateriaal 19 EntryLocation (Should): referentie (URL) naar plaats van het webgebaseerd leermiddel 9 Verplicht volgens NL-LOM.

22 22 / InformationLocation (Should): referentie (URL) naar de plaats van nadere productinformatie 21 ThumbnailLocation (Nice): Publieke referentie naar thumbnail van het product 22 Copyright (Should): Leermiddel is wel/niet belast met auteursrechten 23 CopyrightDescription (Should): Omschrijving van de auteursrechten die van toepassing zijn n: 1 EducationalContentChildId: de leermiddelen waaruit dit product bestaat (in het geval van een gecombineerd product) 2 EducationalContentChildAdministrationId: de Administratie bij de EducationalContentChildId 25 SupplierId: de persoon, groep of organisatie die het leerobject voor genoemde prijs voor verkoop aanbiedt 26 SupplierName: de naam bij de SupplierId 27 SaleUnitSize (Should): het aantal exemplaren van het (mogelijk samengesteld) product dat als eenheid wordt verkocht. 28 HasCost (Should): indicator om aan te geven of aan de leermiddelen kosten zijn verbonden 29 Currency (Should): de valuta van de prijs 30 PriceVATHigh (Should): de prijs per verkoopeenheid van het product (excl. BTW) in centen waarover hoog BTW-tarief wordt gerekend 31 PriceVATLow (Should): de prijs per verkoopeenheid van het product (excl. BTW) in centen waarover laag BTW-tarief wordt gerekend 32 AvailabilityStatus (Should): status leverbaarheid van product 33 AvailabilityDate (Should): datum vanaf wanneer het product leverbaar is 34 LastModifiedDate (Nice): laatste keer dat de productinformatie is aangepast door de uitgever.

23 23 / EducationalContentListService Tijdens de processtap Bepalen oriënteert een instelling zich op welke digitale leermiddelen er de komende periode gebruikt gaan worden. Een Leermiddelenbeheerder bij een Instelling zal hier via het Portaal gebruik van maken om de Leermiddelen te selecteren. De gecreëerde Leermiddelenlijst kan bij het bestellen gebruikt worden om de te bestellen leermiddelen te kunnen identificeren. Figuur 5 Overzicht van EducationalContentListServicefuncties s Er zijn geen principes bepaald NewEducationalContentList (Optional) Met deze functie kan er een nieuwe leermiddelenlijst in de EducationalContentListService geregistreerd worden. Leermiddelenlijsten worden opgesteld in de context van administraties en daarbinnen toegeschreven naar organisatorische eenheden (optioneel), opleidingen, vakken en/of groepsindelingen. Leermiddelenlijsten hebben een beperkte geldigheid als basis voor bestellingen: onderliggende contractuele afspraken zijn mogelijk slechts een beperkte tijd geldig. De rechten van een beheerder van een leermiddelenlijst kunnen worden ingeperkt door zijn profiel in de ProfileService. Daar kan zijn profiel aangeven voor welke UnitId, EducationalCourseId, EducationalSubjectId en EducationalLevelId de beheerder leermiddelenlijsten mag opstellen (zie ook ProfileService).

24 24 / 68 Een besteller krijgt op zijn beurt op basis van de UnitId, EducationalCourseId, EducationalSubjectId en EducationalLevelId in zijn profiel de betreffende leermiddelenlijsten gepresenteerd. Merk op dat voor EducationalCourse, EducationalSubject en EducationalLevel identifiers zijn voorzien en hier geen vocabulaires voor worden gebruikt. Hiermee kunnen onderwijsinstellingen hun eigen onderwijskundige context blijven gebruiken, zonder dat zij in een standaard structuur worden gedwongen. De invoergegevens voor deze functie zijn: 1 AdministratorId 10 : beheerder van de leermiddelenlijst 2 AdministratorAdministrationId: de Administratie bij de AdministratorId 3 UnitId (Optional): organisatorische eenheid waarvoor de leermiddelenlijst is bestemd 4 UnitAdministrationId (Optional 11 ): de Administratie van de UnitId 5 0..n: 1 EducationalCourseId (Optional): opleiding aan welke de leermiddelenlijst ter beschikking wordt gesteld 2 EducationalCourseAdministrationId (Optional 12 ): de Administratie bij de EducationalCourseId 3 EducationalSubjectId (Optional): vak aan welke de leermiddelenlijst ter beschikking wordt gesteld 4 EducationalSubjectAdministrationId (Optional 13 ): de Administratie bij EducationalSubjectId 5 EducationalLevelId (Optional): leerjaar aan welke de leermiddelenlijst ter beschikking wordt gesteld 6 EducationalLevelAdministrationId (Optional 14 ): de Administratie bij EducationalLevelId 6 StartDate: datum vanaf wanneer de leermiddelenlijst geldig is 7 EndDate: datum vanaf wanneer de leermiddelenlijst niet meer geldig is De uitvoergegevens voor deze functie zijn: 1 EducationalContentListId: identifier van de leermiddelenlijst 2 EducationalContentListAdministrationId: de Administratie bij de EducationalContentListId DeleteEducationalContentList (Optional) De invoergegevens voor deze functie zijn: 1 EducationalContentListId: identifier van de leermiddelenlijst 2 EducationalContentListAdministrationId: de Administratie bij de EducationalContentListId De uitvoergegevens voor deze functie zijn: 1 Confirmation: bevestiging 10 We beschouwen de opsteller van de leermiddelenlijst ook als de beheerder. 11 Verplicht indien UnitId is ingevuld. 12 Verplicht indien EducationalCourseId is ingevuld. 13 Verplicht indien EducationalSubjectId is ingevuld. 14 Verplicht indien EducationalLevelId is ingevuld.

25 25 / NewEducationalContentListEntry (Optional) Toevoegen van een leermiddel aan een reeds bestaande leermiddelenlijst. De leermiddelenlijst kan per leermiddel meerdere verkopers (SupplierId) onderkennen, ieder mogelijk met andere bestelaantallen, prijzen en andere karakteristieken. De invoergegevens voor deze functie zijn: 1 EducationalContentListId: de identifier van de leermiddelenlijst 2 EducationalContentListAdministrationId: de Administratie bij de EducationalContentListId 3 EducationalContentId: het betreffende leermiddel op de leermiddelenlijst 4 EducationalContentAdministrationId: de Administratie bij de EducationalContentId 5 SupplierId: verkoper waarbij het leermiddel besteld moet worden 15 6 PayerId (Optional 16 ): de betaler van het leermiddel. 7 PayerAdministrationId (Optional 17 ): de Administratie bij de PayerId 8 MinQuantity: minimaal aantal leermiddelen dat moet worden besteld 9 MaxQuantity: maximaal aantal leermiddelen dat mag worden besteld 10 PriceVATLow: deel van de prijs 18 van het leermiddel met laag BTW-tarief 11 PriceVATHigh: deel van de prijs 19 van het leermiddel met hoog BTW-tarief 12 Discount: het kortingspercentage dat is toegepast op PriceVATLow en PriceVATHigh 13 AdditionalInfo: omschrijving en/of instructie aan de besteller voor dit leermiddel 14 ContractId (Optional): speciale voorwaarden die zijn afgesproken met de verkoper 15 ContractAdministrationId (Optional 20 ): de Administratie bij de ContractId De uitvoergegevens voor deze functie zijn: 1 Confirmation DeleteEducationalContentListEntry (Optional) Verwijderen van een leermiddel aan een reeds bestaande leermiddelenlijst. De invoergegevens voor deze functie zijn: 1 EducationalContentListId: leermiddelenlijst waarin het leermiddel staat benoemd 2 EducationalContentListAdministrationId: de Administratie van de EducationalContentListId 3 EducationalContentId: het leermiddel dat wordt verwijderd uit de lijst 4 EducationalContentAdministrationId: de Administratie van de EducationalContentId 5 SupplierId: de leveranciers van het leermiddel De uitvoergegevens voor deze functie zijn: 1 Confirmation 15 De combinatie EducationalContentId en SupplierId maakt de regel in de Leermiddelenlijst uniek. 16 Indien de betaler niet is ingevuld, wordt de besteller aangesproken als betaler. 17 Verplicht als PayerId is ingevuld. 18 Mogelijk wijkt deze prijs af van de catalogusprijs. 19 Mogelijk wijkt deze prijs af van de catalogusprijs. 20 Verplicht als ContractId is ingevuld.

26 26 / ReadEducationalContentList Leermiddelenlijsten kunnen bijvoorbeeld gezocht worden op basis van ondermeer AdministratorId, EducationalCourse, EducationalSubject of EducationalLevel. De invoergegevens voor deze functie zijn: 1 EducationalContentListId (Optional): identifier van de leermiddelenlijst 2 EducationalContentListAdministrationId (Optional): de Administratie bij de EducationalContentListId 3 AdministratorId (Optional): beheerder van de leermiddelenlijst 4 AdministratorAdministrationId (Optional): de Administratie bij de AdministratorId 5 UnitId (Optional): organisatorische eenheid waarvoor de leermiddelenlijst is bestemd 6 UnitAdministrationId (Optional): de Administratie bij de UnitId 7 0..n: 1 EducationalCourseId (Optional): opleiding aan welke de LML ter beschikking wordt gesteld 2 EducationalCourseAdministrationId (Optional): de Administratie bij de EducationalCourseId 3 EducationalSubjectId (Optional): vak aan welke de LML ter beschikking wordt gesteld 4 EducationalSubjectAdministrationId (Optional): de Administratie bij EducationalSubjectId 5 EducationalLevelId (Optional): leerjaar aan welke de LML ter beschikking wordt gesteld 6 EducationalLevelAdministrationId (Optional): de Administratie bij EducationalLevelId 8 StartDate (Optional): datum vanaf wanneer de leermiddelenlijst geldig is 9 EndDate (Optional) datum vanaf wanneer de leermiddelenlijst niet meer geldig is

27 27 / 68 De uitvoergegevens voor deze functie zijn: 0..n: 1 EducationalContentListId: identifier van de leermiddelenlijst 2 EducationalContentListAdministrationId: de Administratie bij de EducationalContentListId 3 AdministratorId: beheerder van de leermiddelenlijst 4 AdministratorAdministrationId: de Administratie bij de AdministratorId 5 UnitId (Optional): organisatorische eenheid waarvoor de leermiddelenlijst is bestemd 6 UnitAdministrationId (Optional): de Administratie bij de UnitId 7 0..n: 1 EducationalCourseId (Optional): opleiding aan welke de LML ter beschikking wordt gesteld 2 EducationalCourseAdministrationId (Optional): de Administratie bij de EducationalCourseId 3 EducationalSubjectId (Optional): vak aan welke de LML ter beschikking wordt gesteld 4 EducationalSubjectAdministrationId (Optional): de Administratie bij EducationalSubjectId 5 EducationalLevelId (Optional): klas aan welke de LML ter beschikking wordt gesteld 6 EducationalLevelAdministrationId (Optional): de Administratie bij EducationalLevelId 8 StartDate (Optional): datum vanaf wanneer de leermiddelenlijst geldig is 9 EndDate (Optional): datum vanaf wanneer de leermiddelenlijst niet meer geldig is n: 1 EducationalContentId: het betreffende leermiddel op de leermiddelenlijst 2 EducationalContentAdministrationId: de Administratie bij de EducationalContentId 3 SupplierId: verkoper waarbij het leermiddel besteld moet worden 4 PayerId (Optional): de betaler van het leermiddel 5 PayerAdministrationId (Optional): de Administratie bij de PayerId 6 MinQuantity: minimaal aantal leermiddelen dat moet worden besteld 7 MaxQuantity: maximaal aantal leermiddelen dat mag worden besteld 8 PriceVATLow: deel van de prijs van het leermiddel met laag BTW-tarief 9 PriceVATHigh: deel van de prijs van het leermiddel met hoog BTW-tarief 10 Discount: het kortingspercentage dat is toegepast op PriceVATLow en PriceVATHigh 11 AdditionalInfo: omschrijving en/of instructie aan de besteller voor dit leermiddel 12 ContractId (Optional): speciale voorwaarden die zijn afgesproken met de verkoper 13 ContractAdministrationId (Optional): de Administratie bij de ContractId

28 28 / OrderService Via de OrderService worden bestellingen geplaatst bij een ketenpartner. Bij een Bestelling kunnen de Besteller, Betaler en Begunstigde apart worden gespecificeerd. Een Bestelling resulteert altijd in een Tegoed bij een DistributionService. Dit Tegoed kan worden omgezet in een Licentie. Figuur 6 Overzicht van OrderServicefuncties s Er zijn geen principes vastgesteld NewOrder Een besteller plaatst een bestelling bij de OrderService. De besteller hoeft zich hierbij niet noodzakelijkerwijs te identificeren of authenticeren. Met de operatie NewOrder kan men alleen enkelvoudige leermiddelen bestellen. Voor samengestelde leermiddelen, dient men de ProductListService te raadplegen om de enkelvoudige leermiddelen te bepalen. De NewOrder kent geen samenstelling van orders in orderregels. Mogelijke relaties tussen verschillende orders dienen dus buiten de OrderService geadministreerd te worden. Bij een Order kan een CouponCode worden meegegeven, waarmee de besteller zich kan beroepen op speciale voorwaarden, zoals kortingen. Daarnaast kunnen bestellingen expliciet in de context van speciale contractvoorwaarden worden geplaatst. Aan deze speciale contractvoorwaarden kan expliciet worden gerefereerd tijdens de bestelling door de ContractId. Eventueel kan de ketenpartner die de bestelling ontvangt in het betreffende ProfileService nadere gegevens opvragen over de besteller en/of betaler om de contractvoorwaarden te verifiëren. Voorbeelden van dergelijke gegevens zijn de rol en organisatorische eenheid (zie ProfileService).

29 29 / 68 Bij de functie NewOrder kan een DeliveryMethod worden opgegeven die bepaalt hoe de bestelling van de digitale materialen geleverd wordt, te weten: 21 Direct: de licentierechten worden onmiddellijk gekoppeld aan de CreditorId (zonder tegoed als tussenstap) Credit: uitlevering als tegoed CodeSend: verzenden van codes (bijv. op papier, of via ); het afleveradres wordt door aanbieder van NewOrder bepaald, bijvoorbeeld door het adres of de uit het profiel van de Creditor te lezen. CodeRead: uitlezen van codes (via de functie ReadCode van de DistributionService). Het bestelde product (EducationalContentId) kan een samengesteld product zijn. Een samengesteld product wordt altijd geleverd als enkelvoudige producten. De invoergegevens voor deze functie zijn: 1 BuyerId (Optional 22 ): de besteller 2 BuyerAdministrationId (Optional 23 ): de Administratie bij de BuyerId 3 PayerId (Optional 24 ): de betaler 4 PayerAdministrationId (Optional 25 ): de Administratie bij de PayerId 5 CreditorId: de begunstigde (gebruiker of organisatorische eenheid) van de bestelling 26 6 CreditorAdministrationId: de Administratie bij de CreditorId 7 EducationalContentId: het enkelvoudige leermiddel dat wordt besteld 8 EducationalContentAdministrationId: de Administratie bij de EducationalContentId 9 Quantity: het aantal 27 leermiddelen dat wordt besteld 10 DeliveryMethod: levermethode van het leermiddel 11 DeliveryDate (Optional 28 ): datum vanaf wanneer de tegoeden/codes worden geleverd 12 CouponCode (Optional): code voor speciale voorwaarden, bijvoorbeeld een korting 13 ContractId (Optional): contractuele context van de bestelling 14 ContractAdministrationId (Optional 29 ): de Administratie bij de ContractId De uitvoergegevens voor deze functie zijn: 1 OrderId: referentie van de geplaatste order. 2 OrderAdministrationId: de Administratie bij de OrderId Of een PayerId kan worden opgegeven is afhankelijk van de contractuele afspraken zijn gemaakt. Eventueel zijn de mogelijke PayerId s ingeperkt. 21 Zie Technisch model. 22 Anoniem bestellen is mogelijk. 23 Verplicht als BuyerId is ingevuld. 24 Afhankelijk van de geldende contractvoorwaarden. 25 Verplicht als PayerId is ingevuld. 26 Indien DeliveryMethod=CodeSend, dan wordt het afleveradres mogelijk uit het profiel van de identiteit gelezen. 27 Indien DeliveryMethod=Direct, geldt dat Quantity=1. 28 Geen waarde betekent onmiddellijk. 29 Verplicht als ContractId is ingevuld.