Documentation

Endpoints

Environment	URL
Production	https://cr.directetoegang.nl/soap/1.1/registration
Acceptance (school year 2021-2022)	https://acc-cr.directetoegang.nl/soap/1.1/registration

Test


Acceptance (school year 2022-2023)	https://

test

acc-cr.directetoegang.nl/2022-2023/soap/1.1/registration

*Extend the URL with /wsdl to retrieve the WSDL

Important: end of life!

This service will be shutdown on 1-8-2022, so only Registration 3.1 can be used after this date.
See the Migration page for a list a changes between version 1.1 and 3.1 service.

Authorization

In order to access the Registration service you need an account which is provided by support@edu-ix.nl

...

Authentication

Identifies the Supplier

Name

Type

Cardinality

AuthenticationHeader

1...1

Source

Code Block
<urn:AuthenticationHeader> <SupplierId>?</SupplierId> <SupplierCode>?</SupplierCode> </urn:AuthenticationHeader>

Request

Specify DistributorSchool to retrieve one specific customer record.
Specify a timestamp in ModifiedSince to retrieve all changes since this timestamp.
Send an empty request to retrieve alle customer records

Name

Type

Cardinality

DistributorSchool

0...1

ModifiedSince

dateTime

0...1

Source

Code Block

<urn:GetCustomerRequest>
         <!--Optional:-->
         <DistributorSchool>
            <DistributorId>?</DistributorId>
            <DistributorSchoolId>?</DistributorSchoolId>
         </DistributorSchool>
         <!--Optional:-->
         <ModifiedSince>?</ModifiedSince>
</urn:GetCustomerRequest>

Response

In case of an error, a RegistrationFault is returned.

Name	Type	Cardinality
Customer	Customer	0...n

...

getRegistration

Description

This operation allows to retrieve 1 or more Registration records.

Authentication

Name

Type

Cardinality

AuthenticationHeader

1...1

Source

Code Block
<urn:AuthenticationHeader> <SupplierId>?</SupplierId> <SupplierCode>?</SupplierCode> </urn:AuthenticationHeader>

Request

Specify HubPortal to retrieve one specific Registration record.
Specify a timestamp in ModifiedSince to retrieve all changes since this timestamp.
Send an empty request to retrieve alle registration records.

Name

Type

Cardinality

HubPortal

0...1

ModifiedSince

dateTime

0...1

RegistrationId

string

0…1

Source

Code Block

<urn:GetRegistrationRequest>
     <!--Optional:-->
     <HubPortal>
        <HubId>?</HubId>
        <PortalId>?</PortalId>
     </HubPortal>
     <!--Optional:-->
     <ModifiedSince>?</ModifiedSince>
     <!--Optional:-->
     <RegistrationId>?</RegistrationId>
</urn:GetRegistrationRequest>

Response

In case of an error, a RegistrationFault is returned.

Name	Type	Cardinality
Registration	Registration	0...n

...

Errors

General errors

General errors may occur within every operation.

Error code

Description

-1

Generic Error

-2

Authentication Error

For instance when invalid credentials are provided.

Specific errors

Specific errors are bound to the given input or request and depend on the operation you execute.

Error code	Description
-	-

...

Complex types

AuthenticationHeader

Name

Type

Cardinality

Description

SupplierId

string

1...1

Username

SupplierCode

string

1...1

Password

Source

Code Block

<xsd:element name="AuthenticationHeader">
	<xsd:complexType>
		<xsd:sequence>
			<xsd:element name="SupplierId" type="xsd:string"/>
			<xsd:element name="SupplierCode" type="xsd:string"/>
		</xsd:sequence>
	</xsd:complexType>
</xsd:element>

Address

Name

Type

Cardinality

Street

string

0...1

HouseNumber

string

0...1

HouseNumberSuffix

string

0…1

PostalCode

0…1

City

string

0…1

Source

Code Block

<xsd:complexType name="Address">
		<xsd:sequence>
			<xsd:element name="Street" type="xsd:string" minOccurs="0" />
			<xsd:element name="HouseNumber" type="xsd:int" minOccurs="0" />
			<xsd:element name="HouseNumberSuffix" type="xsd:string" minOccurs="0" />
			<xsd:element name="PostalCode" type="types:PostalCode" minOccurs="0" />
			<xsd:element name="City" type="xsd:string" minOccurs="0" />
		</xsd:sequence>
</xsd:complexType>

Customer

Name

Type

Cardinality

Description

Active

boolean

1...1

Activation state

DateCreated

dateTime

0...1

DateModified

dateTime

1…1

DistributorId

string

1…1

Unique identifier of the distributor linked to the customer

DistributorSchoolId

string

1…1

Unique identifier of the school linked to the customer

DeliveryType

1…1

IBF or EBF

Name

NotEmptyString

1…1

Address

1…1

Brin

0…1

see simple types

Contact

0…n

contact details

Source

Code Block

<xsd:complexType name="Customer">
		<xsd:sequence>
			<xsd:element name="Active" type="xsd:boolean" />
			<xsd:element name="DateCreated" type="xsd:dateTime" />
			<xsd:element name="DateModified" type="xsd:dateTime" />
			<xsd:element name="DistributorId" type="xsd:string" />
			<xsd:element name="DistributorSchoolId" type="xsd:string" />
			<xsd:element name="DeliveryType" type="types:DeliveryType" />
			<xsd:element name="Name" type="types:NotEmptyString" />
			<xsd:element name="Address" type="types:Address" />
			<xsd:element name="Brin" type="types:Brin" minOccurs="0" />
			<xsd:element name="Contact" type="types:Contact" maxOccurs="unbounded" minOccurs="0" />
		</xsd:sequence>
</xsd:complexType>

Contact

Name

Type

Cardinality

Name

string

1...1

Role

string

1...1

JobTitle

string

0…1

Email

0…1

PhoneNumber

Phone

0…1

SchoolName

string

0…1

Source

Code Block

<xsd:complexType name="Contact">
		<xsd:sequence>
			<xsd:element name="Name" type="xsd:string" />
			<xsd:element name="Role" type="xsd:string" />
			<xsd:element name="JobTitle" type="xsd:string" minOccurs="0" />
			<xsd:element name="Email" type="types:Email" minOccurs="0" />
			<xsd:element name="PhoneNumber" type="types:Phone" minOccurs="0" />
			<xsd:element name="SchoolName" type="xsd:string" minOccurs="0" />
		</xsd:sequence>
</xsd:complexType>

DistributorSchool

Name

Type

Cardinality

Description

DistributorId

string

1...1

Unique identifier of a distributor

DistributorSchoolID

string

1...1

Unique identifier for a school

Source

Code Block

<xsd:complexType name="DistributorSchool">
		<xsd:sequence>
			<xsd:element name="DistributorId" type="xsd:string" />
			<xsd:element name="DistributorSchoolId" type="xsd:string" />
		</xsd:sequence>
</xsd:complexType>

HubPortal

Name

Type

Cardinality

Description

HubId

1...1

Unique identifier of the hub

PortalId

0...1

Unique identifier of the portal

Source

Code Block
<xsd:complexType name="HubPortal"> <xsd:sequence> <xsd:element name="HubId" type="types:HubId" /> <xsd:element name="PortalId" type="types:PortalId" /> </xsd:sequence> </xsd:complexType>

PortalConfiguration

Name

Type

Cardinality

Description

DateCreated

dateTime

1...1

HubId

string

1...1

Unique identifier of the hub

PortalId

1...1

Unique identifier of the portal

Contact

PortalContact

1...1

Primary contact of the portal

PortalUrl

string

0...1

Source

Code Block

<xsd:complexType name="PortalConfiguration">
		<xsd:sequence>
			<xsd:element name="DateCreated" type="xsd:dateTime" />
			<xsd:element name="HubId" type="types:HubId" />
			<xsd:element name="PortalId" type="types:PortalId" />
			<xsd:element name="Contact" type="types:PortalContact" />
			<xsd:element name="PortalUrl" type="xsd:string" minOccurs="0" />
		</xsd:sequence>
</xsd:complexType>

Portal

Name

Type

Cardinality

Description

PortalType

1...1

Enum, see simpleTypes

PortalDescription

string

1...1

Source

Code Block
<xsd:complexType name="Portal"> <xsd:sequence> <xsd:element name="PortalType" type="types:PortalType" /> <xsd:element name="PortalDescription" type="xsd:string" /> </xsd:sequence> </xsd:complexType>

PortalContact

Name

Type

Cardinality

Description

PortalUserID

string

1...1

Unique identifier of the user

Name

string

1...1

Source

Code Block
<xsd:complexType name="PortalContact"> <xsd:sequence> <xsd:element name="PortalUserID" type="xsd:string" /> <xsd:element name="Name" type="xsd:string" /> </xsd:sequence> </xsd:complexType>

PrimaryContact

Name

Type

Cardinality

Name

string

1...1

Role

string

1...1

JobTitle

string

0...1

Email

1...1

PhoneNumber

Phone

0...1

SchoolName

string

0...1

Source

Code Block

<xsd:complexType name="PrimaryContact">
		<xsd:complexContent>
			<xsd:restriction base="types:Contact">
				<xsd:sequence>
					<xsd:element name="Name" type="xsd:string" />
					<xsd:element name="Role" type="xsd:string" />
					<xsd:element name="JobTitle" type="xsd:string" minOccurs="0" />
					<xsd:element name="Email" type="types:Email" />
					<xsd:element name="PhoneNumber" type="types:Phone" minOccurs="0" />
					<xsd:element name="SchoolName" type="xsd:string" minOccurs="0" />
				</xsd:sequence>
			</xsd:restriction>
		</xsd:complexContent>
</xsd:complexType>

Registration

Name

Type

Cardinality

Description

RegitrationId

string

1...1

Unique Identifier

DateCreated

dateTime

1...1

DateModified

dateTime

1...1

StartDate

date

1...1

EndDate

date

1...1

Description

string

1...1

Portal

1...1

Status

RegistrationStatus

1...1

PrimaryContact

0…1

contact details

Customer

RegistrationCustomer

0…n

customer details

PortalConfiguration

0…1

portal configuration details

Source

Code Block

<xsd:complexType name="Registration">
		<xsd:sequence>
			<xsd:element name="RegistrationId" type="xsd:string" />
			<xsd:element name="DateCreated" type="xsd:dateTime" />
			<xsd:element name="DateModified" type="xsd:dateTime" />
			<xsd:element name="StartDate" type="xsd:date" />
			<xsd:element name="EndDate" type="xsd:date" />
			<xsd:element name="Description" type="xsd:string" />
			<xsd:element name="Portal" type="types:Portal" />
			<xsd:element name="Status" type="types:RegistrationStatus" />
			<xsd:element name="PrimaryContact" type="types:PrimaryContact" minOccurs="0" />
			<xsd:element name="Customer" type="types:RegistrationCustomer" minOccurs="0" maxOccurs="unbounded" />
			<xsd:element name="PortalConfiguration" type="types:PortalConfiguration" minOccurs="0" />
		</xsd:sequence>
</xsd:complexType>

RegistrationCustomer

Name

Type

Cardinality

Description

Active

boolean

1...1

DateCreated

dateTime

1...1

DateModified

dateTime

1...1

StartDate

date

1...1

EndDate

date

1...1

DistributorId

string

1...1

DistributorSchoolId

string

1...1

DeliveryType

1...1

EBF or IBF

Name

NotEmptyString

1…1

Address

1…1

Brin

0…1

see: simple types

Contact

0…n

Source

Code Block

<xsd:complexType name="RegistrationCustomer">
		<xsd:sequence>
			<xsd:element name="Active" type="xsd:boolean"></xsd:element>
			<xsd:element name="DateCreated" type="xsd:dateTime"></xsd:element>
			<xsd:element name="DateModified" type="xsd:dateTime"></xsd:element>
			<xsd:element name="StartDate" type="xsd:date"></xsd:element>
			<xsd:element name="EndDate" type="xsd:date"></xsd:element>
			<xsd:element name="DistributorId" type="xsd:string" />
			<xsd:element name="DistributorSchoolId" type="xsd:string" />
			<xsd:element name="DeliveryType" type="types:DeliveryType" />
			<xsd:element name="Name" type="types:NotEmptyString" />
			<xsd:element name="Address" type="types:Address" />
			<xsd:element name="Brin" type="types:Brin" minOccurs="0" />
			<xsd:element name="Contact" type="types:Contact" maxOccurs="unbounded" minOccurs="0" />
		</xsd:sequence>
</xsd:complexType>

RegistrationStatus

Name

Type

Cardinality

Active

boolean

1...1

Source

Code Block
<xsd:complexType name="RegistrationStatus"> <xsd:sequence> <xsd:element name="Active" type="xsd:boolean"></xsd:element> </xsd:sequence> </xsd:complexType>

RegistrationFault

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

<xsd:element name="RegistrationFault">
		<xsd:complexType>
			<xsd:sequence>
				<xsd:element name="Code" type="xsd:int"/>
				<xsd:element name="Message" type="xsd:string"/>
			</xsd:sequence>
		</xsd:complexType>
	</xsd:element>

...

Simple types

Name	Type	Possible values / format	Description
Brin	String		The BRIN(Basisregistratie instellingen) is an identifier. The first four characters are alphanumerical and represent an educational institution. The last characters are numerical and represent an identifier for the location of a educational institution.
DeliveryType	Enum	Possible values: EBF IBF	EBF = External Book Fund IBF = Internal Book Fund
Email	String	Max length: 254 characters	String limited by a number of maximum allowed characters.
HubId	Enum	Possible values: DAF Eduroute Kennisnet OpenID
NotEmptyString	string	Min length: 1 character	String limited by a number of minimum allowed characters.
PortalId	String	Max length: 256 characters	String limited by a number of maximum allowed characters.
PortalType	Enum	Possible values: SCHOOL_PORTAL DISTRIBUTOR_PORTAL DOWNLOAD
Phone	String	Max length: 15 characters	String limited by a number of maximum allowed characters.
PostalCode	String		The following regex should be applied: [0-9]{4} [A-Z]{2}

...

Versions Compared

Old Version 3

New Version Current

Key

Documentation

Endpoints

Important: end of life!

Authorization

Authentication

Request

Response

getRegistration

Description

Authentication

Request

Response

Errors

General errors

Specific errors

Complex types

AuthenticationHeader

Address

Customer

Contact

DistributorSchool

HubPortal

PortalConfiguration

Portal

PortalContact

PrimaryContact

Registration

RegistrationCustomer

RegistrationStatus

RegistrationFault

Simple types

Page Comparison

Versions Compared

Old Version 3

New Version Current

Key

Documentation

Endpoints

Important: end of life!

Authorization

Authentication

Request

Response

getRegistration

Description

Authentication

Request

Response

Errors

General errors

Specific errors

Complex types

AuthenticationHeader

Address

Customer

Contact

DistributorSchool

HubPortal

PortalConfiguration

Portal

PortalContact

PrimaryContact

Registration

RegistrationCustomer

RegistrationStatus

RegistrationFault

Simple types