Page Comparison

The getPersonCredits operation can be used to retrieve information about a specific EBF creditEBF credits of a person, using one of the identifiers.
Note: eduUID is the “uid” value of the getEduprofile response.

Authentication

Name

Type

Cardinality

authHeader

1...1

Source

Code Block
<urn:authHeader> <urn:loginHeader> <urn:username>?</urn:username> <urn:password>?</urn:password> </urn:loginHeader> </urn:authHeader>

Request

Name

Type

Cardinality

schoolYear

0...1

ean

string30

0...1

You have a CHOICE of the next 4 items at this level

redirectSessionID string64 1...1

eckID eckID 1...1

userID string100 1...1

eduUID string256 1…1

1...1

Source

Code Block

<xs:complexType>
	  <xs:sequence>
		<xs:choice minOccurs="1" maxOccurs="1">
			<xs:element name="redirectSessionID" type="types:string64" minOccurs="1" maxOccurs="1"/>
			<xs:element name="eckID" type="types:eckID" minOccurs="1" maxOccurs="1"/>
			<xs:element name="userID" type="types:string100" minOccurs="1" maxOccurs="1"/>
			<xs:element name="eduUID" type="types:string256" minOccurs="1" maxOccurs="1"/>
		</xs:choice>
		<xs:element name="ean" type="types:string30" minOccurs="0" maxOccurs="1"/>
		<xs:element name="schoolYear" type="types:schoolYear" minOccurs="0" maxOccurs="1"/>
	</xs:sequence>
  </xs:complexType>

Response

The response contains 0 to all person credits for a specific person. In case of an error, a Fault object is returned.

Name	Type	Cardinality
personCreditInformation	personCreditInformation	0...n

Error codes

Error code

Description

-200

Bad Request

0

General Error

for example: database errors or internal server errors.

1

Missing Fields
for example: missing one of UserID, EckID or RedirectSessionID

...

getSchoolCredit

Description

The getSchoolCredits operation can be used to retrieve information about a specific IBF creditIBF credits of a school.

Authentication

Name

Type

Cardinality

authHeader

1...1

Source

Code Block
<urn:authHeader> <urn:loginHeader> <urn:username>?</urn:username> <urn:password>?</urn:password> </urn:loginHeader> </urn:authHeader>

Request

Name

Type

Cardinality

organisationID

1...1

ean

string30

0...1

schoolYear

0...1

Source

Code Block

<xs:complexType>
    <xs:sequence>
       <xs:element name="organisationID" type="types:organisationID" minOccurs="1" maxOccurs="1"/>
       <xs:element name="ean" type="types:string30" minOccurs="0" maxOccurs="1"/>
       <xs:element name="schoolYear" type="types:schoolYear" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
 </xs:complexType>

Response

The response contains 0 to all school credits for a specific school. In case of an error, a Fault object is returned.

Name	Type	Cardinality
schoolCreditInformation	schoolCreditInformation	0...n

Error codes

Error code

Description

-200

Bad Request

0

General Error

for example: database errors or internal server errors.

5

Missing Fields: OrganisationID

...

Complex types

AuthHeader

Name

Type

Cardinality

Description

loginHeader

1...1

contains credentials.

Source

Code Block
<xs:complexType name="authHeader"> <xs:sequence> <xs:element name="loginHeader" type="types:loginHeader" minOccurs="1" maxOccurs="1"/> </xs:sequence> </xs:complexType>

LoginHeader

Name

Type

Cardinality

Description

username

string100

1...1

An identification used by a person to login.

password

string64

1...1

A secret word or phrase used for authentication.

Source

Code Block

<xs:complexType name="loginHeader">
    <xs:sequence>
			<xs:element name="username" type="types:string100" minOccurs="1" maxOccurs="1"/>
			<xs:element name="password" type="types:string64" minOccurs="1" maxOccurs="1"/>
    </xs:sequence>
</xs:complexType>

Fault

Name

Type

Cardinality

Description

code

integer

1...1

Code to identify the fault type.

message

string

1...1

Specific message which describes the fault.

Source

Code Block

<xs:element name="Fault">
	<xs:complexType>
	  <xs:sequence>
		<xs:element name="code" type="types:integer" minOccurs="1" maxOccurs="1"/>
		<xs:element name="message" type="types:string" minOccurs="1" maxOccurs="1"/>
	</xs:sequence>
  </xs:complexType>
</xs:element>

SchoolCreditInformation

Name	Type	Cardinality	Description

personCredit

schoolCredit

personCredit

schoolCredit

1...1

specification

0...1

license

0...n

Source

Code Block

<xs:complexType name="schoolCreditInformation">
    <xs:sequence>
			<xs:element name="schoolCredit" type="types:schoolCredit" minOccurs="1" maxOccurs="1"/>
			<xs:element name="specification" type="types:specification" minOccurs="0" maxOccurs="1"/>
			<xs:element name="license" type="types:license" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
</xs:complexType>

PersonCreditInformation

Name

Type

Cardinality

Description

schoolCredit

1...1

specification

0...1

license

0...1

Source

Code Block

<xs:complexType name="personCreditInformation">
    <xs:sequence>
			<xs:element name="personCredit" type="types:personCredit" minOccurs="1" maxOccurs="1"/>
			<xs:element name="specification" type="types:specification" minOccurs="0" maxOccurs="1"/>
			<xs:element name="license" type="types:license" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
</xs:complexType>

PersonCredit

Name

Type

Cardinality

Description

ean

string30

1...1

Unique identifier of the product. The credit gives right of use for the indicated ean.

creditStartDate

date

1...1

The start date. Until the start date the credit cannot be used.

creditEndDate

date

0...1

The end date. Until the end date the credit can be used.

personProductState

1...1

see simple types

schoolYear

1...1

School year during which the credit is started.

Source

Code Block

<xs:complexType name="personCredit">
    <xs:sequence>
			<xs:element name="ean" type="types:string30" minOccurs="1" maxOccurs="1"/>
			<xs:element name="creditStartDate" type="types:date" minOccurs="1" maxOccurs="1"/>
			<xs:element name="creditEndDate" type="types:date" minOccurs="0" maxOccurs="1"/>
			<xs:element name="personProductState" type="types:personProductState" minOccurs="1" maxOccurs="1"/>
			<xs:element name="schoolYear" type="types:schoolYear" minOccurs="1" maxOccurs="1"/>
    </xs:sequence>
  </xs:complexType>

SchoolCredit

Name

Type

Cardinality

Description

organisationID

1...1

Unique identifier of the school to which this credit is connected, e.g. “digiDeliveryId”.

ean

string30

1...1

Unique identifier of the product. The credit gives right of use for the indicated ean.

creditStartDate

date

1...1

The start date. Until the start date the credit cannot be used.

creditEndDate

date

0...1

The end date. Until the end date the credit can be used.

schoolYear

1...1

School year during which the credit is started.

amountNotActive

positiveInteger

1...1

amountActive

positiveInteger

1...1

amountInProcess

positiveInteger

1...1

amountExpired

positiveInteger

1...1

Source

Code Block

<xs:complexType name="schoolCredit">
    <xs:sequence>
			<xs:element name="organisationID" type="types:organisationID" minOccurs="1" maxOccurs="1"/>
			<xs:element name="ean" type="types:string30" minOccurs="1" maxOccurs="1"/>
			<xs:element name="creditStartDate" type="types:date" minOccurs="1" maxOccurs="1"/>
			<xs:element name="creditEndDate" type="types:date" minOccurs="0" maxOccurs="1"/>
			<xs:element name="schoolYear" type="types:schoolYear" minOccurs="1" maxOccurs="1"/>
			<xs:element name="amountNotActive" type="types:positiveInteger" minOccurs="1" maxOccurs="1"/>
			<xs:element name="amountActive" type="types:positiveInteger" minOccurs="1" maxOccurs="1"/>
			<xs:element name="amountInProcess" type="types:positiveInteger" minOccurs="1" maxOccurs="1"/>
			<xs:element name="amountExpired" type="types:positiveInteger" minOccurs="1" maxOccurs="1"/>
    </xs:sequence>
</xs:complexType>

Specification

Name

Type

Cardinality

Description

specificationState

0...1

The current state of the license in the specification process.

specificationStateDate

date

1...1

The specification date. This is the creation date of the license.

Source

Code Block

<xs:complexType name="specification">
    <xs:sequence>
			<xs:element name="specificationState" type="types:specificationState" minOccurs="0" maxOccurs="1"/>
			<xs:element name="specificationStateDate" type="types:date" minOccurs="1" maxOccurs="1"/>
    </xs:sequence>
</xs:complexType>

License

Name

Type

Cardinality

Description

activationDate

date

0...1

The activation date. At this date the license is first used.

licenseStartDate

date

0...1

The start date. Until the start date the license cannot be used.

licenseEndDate

date

0...1

The end date. Until the end date the license can be used.

Source

Code Block

<xs:complexType name="license">
    <xs:sequence>
			<xs:element name="activationDate" type="types:date" minOccurs="0" maxOccurs="1"/>
			<xs:element name="licenseStartDate" type="types:date" minOccurs="0" maxOccurs="1"/>
			<xs:element name="licenseEndDate" type="types:date" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
  </xs:complexType>

...

Simple types

Name	Type	Possible values / format	Description
string4-6	String	Min length: 4 characters Max length: 6 characters	String limited by a number of minimum and maximum allowed characters.
string15	String	Max length: 15 characters	String limited by a number of maximum allowed characters.
string50	String	Max length: 50 characters	String limited by a number of maximum allowed characters.
string64	String	Max length: 64 characters	String limited by a number of maximum allowed characters.
string100	String	Max length: 100 characters	String limited by a number of maximum allowed characters.
string256	String	Max length: 256 characters	String limited by a number of maximum allowed characters.
eckID	String	Exact length: 128 characters	eckID is in the form of a URL: https://id.school/2015-09/[128-char hex string]. Currently this url resolves to a static page containing general information about the ECK ID.
organisationID	String	Min length: 1 characters Max length: 40 characters	Unique identifier of a school, e.g. “digiDeliveryId”
specificationState	Enum	Possible values: Fault Specified	The specification state of a credit
personProductState	Enum	Possible values: Active Returned	State of a person product, i.e. Active or Returned
schoolYear	Integer	e.g. 1920	A representation of a school year by concatenating the last two numbers of both years, i.e. the school year 2019 - 2020 would be noted as 1920.
possitiveInteger	Integer	Greater then 0	Integer value, can only be positive

...

Appendix

Terms

Term	Description
EBF	External book fund
IBF	Internal book fund
ECK	Educatieve contentketen. More information on: https://www.eck-id.nl/
ECK ID	Unique identifier of a person according to the ECK standard
ELO	Elektronische leeromgeving (electronic learning environment)
Specification	Specification is the proces of sending credits from Edu-iX to the publisher. Each specification contains information about the end user and the credit itself. After the specification is completed the credit is available for user by the end user.
Prematch	Prematch is the process of connecting the unique identifier of the end user, available in the ELO, to order data (personal details and credit information) in Edu-iX.

Versions Compared

Old Version 5

New Version Current

Key

Endpoints

Operation overview

Operations

getPersonCredit

Authentication

Request

Response

Error codes

getSchoolCredit

Description

Authentication

Request

Response

Error codes

Complex types

AuthHeader

LoginHeader

Fault

SchoolCreditInformation

PersonCreditInformation

PersonCredit

SchoolCredit

Specification

License

Simple types

Appendix

Terms