Status- en foutcodes

Titel	Status- en foutcodes
Status	IN ONTWIKKELING BESLUITVORMING IN BEHEER
Versie	0.0.1
Datum	20 December 2023
Auteur	Architectenraad Edu-V
Acties	Geen openstaande acties

In het afsprakenstelsel zijn diverse APIs gedefinieerd. Binnen deze APIs zijn status- en foutcodes op een uniforme wijze gespecificeerd. Op deze pagina zijn alle status- en foutcodes terug te vinden. Er wordt onderscheid gemaakt in de volgende categorieën:

00xx: Algemeen

Voor alle APIs gelden de HTTP Status Codes en een aantal aanvullende status en statusmessages specifiek voor de gegevensuitwisselingen binnen Edu-V. Deze zijn hieronder weergegeven.

HTTP Status Code	Status	statusMessage	Omschrijving
200	0000	OK	Bevraging succesvol.
201	0001	Created	Bericht heeft geleid tot registratie van een nieuwe entiteit.
202	0002	Accepted	Bericht geaccepteerd.
400	0011	Schema incorrect	Schemavalidatie niet succesvol
400	0012	schemaVersion not supported	De ontvanger kan de gehanteerde schemaVersion niet verwerken
401	0021	scope required	Leverancier is niet geautoriseerd voor scope
403	0022	consent required	De gegevenssoort is van classificatie IV. Dit vereist een activering van de gegevensuitwisseling. Dit is in dit foutscenario niet het geval.
400	0023	edu_org_id unknown	De client communiceert in de context van een Onderwijsorganisatie die niet bekend is bij server
400	0099	Vullingsregel: in statusMessage een beschrijving van de reden opnemen	Overige reden

10xx: Consent API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in bevestigingsberichten uit de Consent API.

Status	statusMessage	Omschrijving
1001	providerReferenceId unknown	De providerReferenceId is onbekend.
1002	providerReferenceId already used	De providerReferenceId is al eerder gebruikt.
1003	consumerReferenceId unknown	De consumerReferenceId is onbekend.
1004	consumerReferenceId already used	De consumerReferenceId is al eerder gebruikt.
1011	edu_org_id unknown	Onderwijsaanbieder onbekend
1012	api not supported	API wordt niet aangeboden door Data Provider
1013	scope not supported	Scope wordt niet aangeboden door Data Provider.
1021	api not authorised	Data Consumer is niet geautoriseerd om gegevens uit te wisselen voor de gespecificeerde api.
1022	scope not authorised	Data Consumer is niet geautoriseerd om gegevens uit te wisselen voor de gespecificeerde scope.
1031	ConsentRequests not supported	Consentverzoeken worden niet ondersteund door Data Provider.

11xx: DPA (Data Processing Agreement) API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging uit de DPA API.

Status	statusMessage	Omschrijving
1111	School Board unkown	Onderwijsbestuur onbekend
1112	Supplier unknown	Leverancier onbekend
1121	No agreement with School Board	De bevrager van het endpoint heeft zelf geen verwerkersovereenkomst met het onderwijsbestuur.

20xx: SIS API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging uit de SIS API.

Status	statusMessage	Omschrijving
2001	School unknown	De identifier van de onderwijsorganisatie is onbekend.
2002	Student unknown	De identifier van de onderwijsdeelnemer is onbekend.
2003	Employee unknown	De identifier van de onderwijsmedewerker is onbekend.
2004	Class unknown	De identifier van de stamklas of stamgroep is onbekend.
2005	Group unknown	De identifier van de lesgroep is onbekend.
2006	SchoolSubject unknown	De identifier van het SchoolVak is onbekend.
2007	SchoolPeriod unknown	De schoolperiode is onbekend.

30xx: Catalogue API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging uit de Catalogue API.

Status	statusMessage	Omschrijving
3001	Product unknown	De identifier van het Product is onbekend.

31xx: Course API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging uit de Course API.

Status	statusMessage	Omschrijving
3101	Course unknown	De identifier van de Course is onbekend.
3102	CourseStructure unknown	De identifier van de CourseStructure is onbekend.

40xx: Entitlement API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging en in de bevestigingsberichten uit de Entitlement API.

Status	statusMessage	EntitlementTypes	Omschrijving
4001	entitlementReferenceId unknown	–	Het entitlementReferenceId is onbekend.
4002	entitlementReferenceId already used	–	Het entitlementReferenceId is al eerder gebruikt.
4003	entitlementReceiveId unknown	–	Het entitlementReferenceId is onbekend.
4004	entitlementReceiveId already used	–	Het entitlementReceiveId is al eerder gebruikt.
4005	entitlementAndLicenseReferenceId unknown	–	Het entitlementAndLicenseReferenceId is onbekend
4006	entitlementAndLicenseReferenceId already used	–	Het entitlementAndLicenseReferenceId is al eerder gebruikt.
4007	entitlementAndLicenseReceiveId unknown	–	Het entitlementAndLicenseReceiveId is onbekend
4008	entitlementAndLicenseReceiveId already used	–	Het entitlementAndLicenseReceiveId is al eerder gebruikt.
4011	entitlementId unknown	–	Het entitlementId is onbekend.
4021	productId missing	Allen	Specificatie van Product ontbreekt
4022	productId unknown	Allen	Gespecificeerd Product onbekend bij Ontvanger
4023	Product not yet for sale	Allen	Gespecificeerd Product is nog niet in de verkoop
4024	Product not available	Allen	Gespecificeerd Product is niet beschikbaar.
4025	Product no longer for sale	Allen	Gespecificeerd Product is niet langer in de verkoop
4031	School unknown	–	De identifier van de onderwijsorganisatie is onbekend.
4032	User unknown	–	De identifier van de onderwijsdeelnemer of onderwijsmederker is onbekend.
4033	userId, eckID or activationCode missing	Personal, SchoolStudent, SchoolEmployee	Specificatie van entitlees of activatiecodes niet volledig
4034	userId or eckId unknown	Personal, SchoolStudent, SchoolEmployee	Gespecificeerde entitlees zijn niet bekend bij Ontvanger
4035	schoolSubject missing	SchoolSubject	Specificatie van schoolSubjects ontbreekt
4035	schoolSubject unknown	SchoolSubject	Gespecificeerde schoolSubjects zijn niet bekend bij Ontvanger
4036	Group missing	SchoolGroup	Specificatie van Groups ontbreekt
4037	Group unknown	SchoolGroup	Gespecificeerde Groups zijn niet bekend bij Ontvanger
4038	schoolId missing	School SchoolSubject SchoolGroup SchoolStudent	Onderwijsorganisatie is niet gespecificeerd
4039	schoolId unknown	School SchoolSubject SchoolGroup SchoolStudent	Gespecificeerde Onderwijsorganisatie is niet bekend bij Ontvanger
4041	contractId unknown	Allen	Gespecificeerd contractId is onbekend bij de ontvangende Licentieregistratie
4042	Contract restrictions	Allen	Bericht niet toegestaan als gevolg van contractuele afspraken tussen de leverancier van het leermiddel en de leverancier die de verwerving faciliteert.
4051	startDate before firstPublishedDate	Allen	Gespecificeerde startdatum van de activatieperiode ligt voor de datum dat het product op de markt verschijnt
4052	Quantity at least 1	School SchoolSubject SchoolGroup	Het gespecificeerde aantal voor open School aanspraken is minimaal 1
4053	newAmount is not allowed	School SchoolSubject SchoolGroup	Indien het aantal door de Aanspraakmanager wordt gewijzigd in een wijzigingsbericht dan dient deze: lager te zijn dan het huidige aantal hoger te zijn dan het aantal geactiveerde licenties
4061	License registered on Entitlement	SchoolStudent SchoolEmployee Personal	Indien een Aanspraakmanager een aanspraak wil annuleren dan mag er geen licentie geregistreerd zijn op de aanspraak
4071	activationCode unknown	SchoolStudent SchoolEmployee Personal	Gespecificeerde activatiecode is onbekend bij de ontvangende Licentieregistratie
4072	activationCode already used	SchoolStudent SchoolEmployee Personal	Gespecificeerde activatiecode is reeds gebruikt voor een aanspraak
4073	activationCode revoked	SchoolStudent SchoolEmployee Personal	Gespecificeerde activatiecode is ingetrokken

41xx: Delivery API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging en in de bevestigingsberichten uit de Delivery API.

Status	statusMessage	EntitlementTypes	Omschrijving
4101	deliveryOrderReferenceId unknown	–	Het deliveryOrderReferenceId is onbekend.
4102	deliveryOrderReferenceId already used	–	Het deliveryOrderReferenceId is al eerder gebruikt.
4103	deliveryOrderReceiveId unknown	–	Het deliveryOrderReceiveId is onbekend.
4104	deliveryOrderReceiveId already used	–	Het deliveryOrderReceiveId is al eerder gebruikt.
4111	deliveryOrderId unknown	–	Het deliveryOrderId is onbekend.
4112	deliveryOrderLineId unkown	–	Het deliveryOrderLineId is onbekend
4121	productId missing	Allen	Specificatie van Product ontbreekt
4122	productId unknown	Allen	Gespecificeerd Product onbekend bij Ontvanger
4123	Product not yet for sale	Allen	Gespecificeerd Product is nog niet in de verkoop
4124	Product not available	Allen	Gespecificeerd Product is niet beschikbaar.
4125	Product no longer for sale	Allen	Gespecificeerd Product is niet langer in de verkoop
4131	School unknown	–	De identifier van de onderwijsorganisatie is onbekend.
4132	User unknown	–	De identifier van de onderwijsdeelnemer of onderwijsmederker is onbekend.
4133	userId, eckID or activationCode missing	Personal, SchoolStudent, SchoolEmployee	Specificatie van entitlees of activatiecodes niet volledig
4134	userId or eckId unknown	Personal, SchoolStudent, SchoolEmployee	Gespecificeerde entitlees zijn niet bekend bij Ontvanger
4135	schoolSubject missing	SchoolSubject	Specificatie van schoolSubjects ontbreekt
4135	schoolSubject unknown	SchoolSubject	Gespecificeerde schoolSubjects zijn niet bekend bij Ontvanger
4136	Group missing	SchoolGroup	Specificatie van Groups ontbreekt
4137	Group unknown	SchoolGroup	Gespecificeerde Groups zijn niet bekend bij Ontvanger
4138	schoolId missing	School SchoolSubject SchoolGroup SchoolStudent	Onderwijsorganisatie is niet gespecificeerd
4139	schoolId unknown	School SchoolSubject SchoolGroup SchoolStudent	Gespecificeerde Onderwijsorganisatie is niet bekend bij Ontvanger
4141	contractId unknown	Allen	Gespecificeerd contractId is onbekend bij de ontvangende Licentieregistratie
4142	Contract restrictions	Allen	Bericht niet toegestaan als gevolg van contractuele afspraken tussen de leverancier van het leermiddel en de leverancier die de verwerving faciliteert.
4151	startDate before firstPublishedDate	Allen	Gespecificeerde startdatum van de activatieperiode ligt voor de datum dat het product op de markt verschijnt
4152	Quantity at least 1	School SchoolSubject SchoolGroup	Het gespecificeerde aantal voor open School aanspraken is minimaal 1
4153	newAmount is not allowed	School SchoolSubject SchoolGroup	Indien het aantal door de Aanspraakmanager wordt gewijzigd in een wijzigingsbericht dan dient deze: lager te zijn dan het huidige aantal hoger te zijn dan het aantal geactiveerde licenties
4161	License registered on Entitlement	SchoolStudent SchoolEmployee Personal	Indien een Aanspraakmanager een aanspraak wil annuleren dan mag er geen licentie geregistreerd zijn op de aanspraak
4171	activationCode unknown	SchoolStudent SchoolEmployee Personal	Gespecificeerde activatiecode is onbekend bij de ontvangende Licentieregistratie
4172	activationCode already used	SchoolStudent SchoolEmployee Personal	Gespecificeerde activatiecode is reeds gebruikt voor een aanspraak
4173	activationCode revoked	SchoolStudent SchoolEmployee Personal	Gespecificeerde activatiecode is ingetrokken

50xx: ActivationCode API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de bevestigingsberichten uit de ActivationCode API.

Status	statusMessage	Omschrijving
5001	requestReferenceId unknown	requestReferenceId onbekend
5002	requestReferenceId already used	requestReferenceId is al eerder gebruikt.
5003	responseReferenceId unknown	responseReferenceId onbekend
5004	responseReferenceId already used	responseReferenceId is al eerder gebruikt.
5011	activationCode unknown	Activatiecode is onbekend
5021	productId missing	Specificatie van Product ontbreekt
5022	productId unknown	Gespecificeerd Product onbekend bij Ontvanger
5023	Product not yet for sale	Gespecificeerd Product is nog niet in de verkoop
5024	Product not available	Gespecificeerd Product is niet beschikbaar.
5025	Product no longer for sale	Gespecificeerd Product is niet langer in de verkoop
5026	Product does not support activation codes	Gespecificeerd Product kan niet worden verkocht middels een activatiecode.
5041	contractId unknown	Gespecificeerd contractId is onbekend bij de ontvangende Licentieregistratie
5042	Contract restrictions	Bericht niet toegestaan als gevolg van contractuele afspraken tussen de leverancier van het leermiddel en de leverancier die de verwerving faciliteert.
5051	License registered on activationCode	Het annuleren van een activatiecode is niet mogelijk zodra het leermiddel in gebruik is genomen.

60xx: Order API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de bevestigingsberichten uit de Order API.

Status	statusMessage	Omschrijving
6001	requestReferenceId unknown	requestReferenceId onbekend
6002	requestReferenceId already used	requestReferenceId is al eerder gebruikt.
6003	responseReferenceId unknown	responseReferenceId onbekend
6004	responseReferenceId already used	responseReferenceId is al eerder gebruikt.
6011	purchaseOrderId unknown	Gespecificeerd inkoopordernummer is onbekend
6012	purchaseOrderLineId unknown	Gespecificeerd inkooporderregelnummer onbekend
6013	salesOrderId unknown	Gespecificeerd inkoopordernummer is onbekend
6014	salesOrderLineId unknown	Gespecificeerd inkooporderregelnummer is onbekend
6021	productId missing	Specificatie van Product ontbreekt
6022	productId unknown	Gespecificeerd Product onbekend bij Ontvanger
6023	Product not yet for sale	Gespecificeerd Product is nog niet in de verkoop
6024	Product not available	Gespecificeerd Product is niet beschikbaar.
6025	Product no longer for sale	Gespecificeerd Product is niet langer in de verkoop
6041	contractId unknown	Gespecificeerd contractId is onbekend bij de ontvangende Licentieregistratie
6042	Contract restrictions	Bericht niet toegestaan als gevolg van contractuele afspraken tussen de leverancier van het leermiddel en de leverancier die de verwerving faciliteert.
6043	Return period expired	Retourtermijn is verlopen

70xx: Usage API

In onderstaande tabel zijn de foutcodes opgenomen die opgenomen kunnen worden in de response op een bevraging en in de bevestigingsberichten uit de Usage API.

Status	statusMessage	Omschrijving
7011	entitlementId unknown	Het entitlementId is onbekend.
7032	User unknown	De identifier van de onderwijsdeelnemer of onderwijsmederker is onbekend.
7041	contractId unknown	Gespecificeerd contractId is onbekend bij de ontvangende Licentieregistratie
7042	Contract restrictions	Bericht niet toegestaan als gevolg van contractuele afspraken tussen de leverancier van het leermiddel en de leverancier die de verwerving faciliteert.

Release notes

0.0.1: Foutcodes uit de API zijn samengevoegd en ontdubbeld op deze pagina. Vanuit de APIs is een verwijzing gedaan naar deze pagina..