SID:Servicebeschrijvingen

Create ECK ID

SERVICE DESCRIPTION	retrieveEckId
CONTEXT	This service is called by allowed LAS systems to obtain a ECK ID for, for instance, a just enrolled student. This function is called during the process of enrollment, and its availability is business critical.
INPUT	hpgn: HPgn, oblig, hashed PGN; chainID: xsd:string, oblig, Identifier for ECK chain sectorID: xsd:string, oblig, Identifier for educational sector
VALIDATIONS	The calling system, identified by its OIN in the SerialNumber field of the Certificate, is checked against the list of allowed callers (NotAllowedCallerException on failure) The calling school is identified from the OIN in the wsa:from SOAP header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown hashed PGN, SectorID, ChainID: format validations (Format Exception specific for argument on failure, e.g. InvalidHPgnException, InvalidChainIdException and InvalidSectorIdException). SectorID is one of the IDs of educational sectors (InvalidSectorIdException on failure). ChainID is one of the IDs in chains (InvalidChainIdException on failure) Hashed PGN is not in substitutionList.old (BlockedHPgnException on failure)
OPERATION	The service combines the three inputs and from the result derives a valid ECK ID. The derivation of a valid ECK ID is performed by a component that is specified in software configuration. If the provided hashed PGN is in substitutionList.new and sectorID is equal to the substitutionlist.sectorID and today is later than substitutiontable.effectivedate, the previous hashed PGN is used to derive the ECK ID from.
OUTPUT	eckID: EckID, The derived ECK ID
EXCEPTIONS	InvalidSectorIdException InvalidChainIdException InvalidHPgnException BlockedHPgnException NotAllowedCallerException HashOperationException (indicates server configuration error)
REMARKS	hpgn is created using scrypt with the prescribed parameters. See the developer documentation on the wiki. chainID, sectorID are in the form of OBK URN’s. Retrieve these values using the retrieveChains, retrieveSectors operations respectively. 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.

Change ECK ID (subsitution)

SERVICE DESCRIPTION	replaceEckId
CONTEXT	This service is called when a school administration needs to indicate that a student is assigned a new PGN by the authorities. A change of PGN number is handled as follows: the old and the new hashed PGN, the sectorID and chainID are recorded in the database; subsequent requests for the old PGN are rejected, and for requests with the new hashed PGN and the same SectorID, the old hashed PGN is used to derive the ECK ID from. See also service description Create ECK ID.
INPUT	hpgnOld, hpgnNew: HPgn, oblig, resp. Old hashed PGN and new Hashed PGN chainID: xsd:string, oblig, Identifier for ECK chain sectorID: xsd:string, oblig, Identifier for educational sector effectiveDate: xsd:date, optional, ‘now’ if not given, date and time that the change should take effect
VALIDATIONS	The calling system identified by its OIN in the Certificate is checked against the list of allowed callers (NotAllowedCallerException on failure) The calling school is identified from the OIN in the wsa:from header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown Format validations on input arguments (format Exception specific for argument on failure). SectorID is one of the IDs of educational sectors (InvalidSectorIdException on failure). ChainID is one of the IDs in chains (InvalidChainIdException on failure) Old hashed pgn is not already in the substitution table (old and new) (InvalidPgnException otherwise) New hashed pgn is not already in the substitution table (old and new) (InvalidPgnException otherwise) Effective date: if given, is valid and in the future(xml parse error in case of invalid date format))
OPERATION	Old hashed PGN, new Hashed PGN, chain ID and sectorID are recorded in the substitution table, and a ECK ID for the new hashed PGN is derived using function ‘Create ECK ID’.
OUTPUT	eckID: EckId, The derived ECK ID for the new hpgn
EXCEPTIONS	InvalidSectorIdException InvalidChainIdException InvalidPgnException with information on which hashed PGN is invalid, and why BlockedHPgnException NotAllowedCallerException HashOperationException (indicates server configuration error)
REMARKS	hpgnOld, hpgnNew is created using scrypt with the prescribed parameters. See the developer documentation on the wiki. chainID, sectorID are in the form of OBK URN’s. Retrieve these values using the retrieveChains, retrieveSectors operations respectively. 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 info about the ECK ID.

Batch creation of ECK IDs

SERVICE DESCRIPTION	submitEckIdBatch
CONTEXT	This service is called by allowed LAS systems to submit a list of hashed PGNs, for a single Sector and a single Chain. The system processes the list and makes a corresponding list of ECK IDs available for retrieval (see retrieveEckBatch).
INPUT	hpgnList: a list of 1..20.000 int: xsd:int, oblig, sequence number hPgn: HPgn hashed PGNs chainID: xsd:string, oblig, Identifier for ECK chain sectorID: xsd:string, oblig, Identifier for educational sector
VALIDATIONS	The calling system identified by its OIN in the Certificate is checked against the list of allowed callers (NotAllowedCaller Exception on failure) The calling school is identified from the OIN in the wsa:from header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown The system validates the size of the input (TemporaryBannedException if too many hPgns are submitted) SectorID is one of the IDs of educational sectors (InvalidSectorIdException on failure). ChainID is one of the IDs in chains (InvalidChainIdException on failure) Hashed PGN is not in substitutionList.old (offending hPgn is added to the failed list for output)
OPERATION	The service creates a ECK ID for each hashed PGN in the input list and adds it to the list of generated ECK IDs for output. If the list does not contain a hashed PGN or if the hashed PGN was previously indicated as changed, no ECK ID will be created and a message to indicate the nature of the failure will be added to the list of failed PGNs for output. If the provided hashed PGN is in substitutionList.new and sectorID is equal to the substitutionlist.sectorID and today is later than substitutiontable.effectivedate, the previous hashed PGN is used to derive the ECK ID from.
OUTPUT	batchIdentifier: xsd:string, identifier of the batch request. This identifier can be used to obtain the result, using retrieveEckBatch
EXCEPTIONS	InvalidSectorIdException InvalidChainIdException InvalidHPgnException BlockedHPgnException NotAllowedCallerException HashOperationException (indicates server configuration error)
REMARKS	The use of this service is limited to prevent abuse: A batch may contain at most 20.000 hashed PGNs A batch operation may be submitted at most 3 times per 24 hours These limits are configured in the software and can be modified. Schools that exceed these limits are temporarily banned from submitting batch requests. Schools may contact Kennisnet servicedesk for information and for lifting of the bans. Schools may submit multiple batch requests, as long as the limits are observed. Batches are processed in the order in which they occur. A batch result is available within one hour after submission of the request. Batch results are removed after successful retrieval. The system may remove batch results that are not retrieved within 24 hours.

SERVICE DESCRIPTION	retrieveEckIdBatch
CONTEXT	This service is called by allowed LAS systems to retrieve the status and result of a batch request.
INPUT	batchIdentifier: xsd:string, oblig, the batch identifier obtained in the response from a batch submission (see submitEckIdBatch)
VALIDATIONS	The calling system identified by its OIN in the Certificate is checked against the list of allowed callers (NotAllowedCallerException on failure) The calling school is identified from the OIN in the wsa:from header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown The system validates the frequency of calls (SchoolTemporaryBlockedException or BatchTemporaryBlockedException if there are too many calls registered) If the batch indicated by the input is purged, already retrieved, or not ready yet, a BatchRetrieveException is returned
OPERATION	The service creates a ECK ID for each hashed PGN in the input list and adds it to the list of generated ECK IDs for output. If the list does not contain a hashed PGN or if the hashed PGN was previously indicated as changed, no ECK ID will be created and a message to indicate the nature of the failure will be added to the list of failed PGNs for output.
OUTPUT	Success: an optional list of 1..20000: Index: int, the sequence number of the corresponding hPgn from the input EckId: EckId, the ECK ID of the hPgn indicated by the sequence number from the input Failed: an optional list of 1..20000: Index: int, the sequence number of the corresponding hPgn from the input errorMessage: string, indication of the error that occurred when computing the ECK ID
EXCEPTIONS	InvalidSectorIdException InvalidChainIdException InvalidHPgnException BlockedHPgnException NotAllowedCallerException HashOperationException (indicates server configuration error) SchoolTemporaryBlockedException, BatchTemporaryBlockedException BatchRetrieveException
REMARKS	The use of this service is limited to prevent abuse: a batch retrieval may be attempted at most once per 15 minutes (software configurable; actual limit may differ). In case this limit is exceeded, the offending school is temporarily banned from using this service. Schools may contact Kennisnet servicedesk for more information and to lift the ban. A batch result is available within one hour after submission of the request. Batch results are removed after successful retrieval. Batch results that are not retrieved can be removed after 24 hours. In the output of this function, both success and failure are optional arrays. If none of the input fail, the response will contain only ‘success’ values. If none of the input succeed, the response will contain only ‘failure’.

Retrieving chains and sectors

SERVICE DESCRIPTION	retrieveChains
CONTEXT	This service is called by allowed LAS systems to obtain the list of chain parties for which an ECK ID can be derived. As this list changes rarely, this service will not be called often, probably not more than once per day per LAS.
INPUT	none
VALIDATIONS	The calling system identified by its OIN in the Certificate is checked against the list of allowed callers (NotAllowedCallerException on failure) The calling school is identified from the OIN in the wsa:from header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown
OPERATION	The service retrieves the list of active Chain Parties
OUTPUT	List of 1 or more : Id: xsd:string, Identifier of chain that can be used to create ECK IDs for this chain Name: xsd:string, unique and short name for this chain Description: xsd:string, human-readable description for this chain lastEdited: xsd:date, last time this entry was modified
EXCEPTIONS	NotAllowedCallerException
REMARKS	Currently, only one chain is available in the system, the ECK chain. It’s value is http://purl.edustandaard.nl/begrippenkader/e7ec7d3c-c235-4513-bfb6-e54e66854795

SERVICE DESCRIPTION	retrieveSectors
CONTEXT	This service is called by allowed LAS systems to obtain the list of school types for which an ECK ID can be derived. As this list changes rarely, this service will not be called often, probably not more than once per day per LAS.
INPUT	none
VALIDATIONS	The calling system identified by its OIN in the Certificate is checked against the list of allowed callers (NotAllowedCallerException on failure) The calling school is identified from the OIN in the wsa:from header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown
OPERATION	Retrieve the list of active SectorIDs from the database.
OUTPUT	List of 1 or more : Id: xsd:string, Identifier of sector that can be used to create ECK IDs for this sector Name: xsd:string, unique and short name for this sector Description: xsd:string, human-readable description for this sector lastEdited: xsd:date, last time this entry was modified
EXCEPTIONS	NotAllowedCallerException
REMARKS	Currently, thee educational sectors are available in the system: Primair onderwijs: http://purl.edustandaard.nl/begrippenkader/512e4729-03a4-43a2-95ba-758071d1b725 VO: http://purl.edustandaard.nl/begrippenkader/2a1401e9-c223-493b-9b86-78f6993b1a8d MBO: http://purl.edustandaard.nl/begrippenkader/f3ac3fbb-5eae-49e0-8494-0a44855fff25 The names, descriptions and values are taken from OBK.

Ping operation

SERVICE DESCRIPTION	pingRequest
CONTEXT	This service is called by allowed LAS systems to verify the service is alive.
INPUT	none
VALIDATIONS	The calling system identified by its OIN in the Certificate is checked against the list of allowed callers (NotAllowedCallerException on failure) The calling school is identified from the OIN in the wsa:from header. If the school is not in the list of allowed schools, a NotAllowedCallerException will be thrown
OPERATION	Verify the database is available for operation
OUTPUT	Available: Boolean, the system is available (true) or not (false) applicationVersion: string, identifier for the implementation version systemTime: xsd:dateTime, timestamp of the current system time
EXCEPTIONS	NotAllowedCallerException
REMARKS

Sample Messages

Please note, input arguments are provided as sample only and may not be valid in production environments.

RetrieveEckID

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:v1="http://id.school/eck/schemas/v1_0" 
  xmlns:a="http://www.w3.org/2005/08/addressing">
  <soapenv:Header>
    <a:Action soapenv:mustUnderstand="1">
      http://id.school/eck/schemas/v1_0/retrieveEckId
    </a:Action>
    <a:From soapenv:mustUnderstand="1">
      <a:Address>
      http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
      </a:Address>
    </a:From>
    <a:MessageID soapenv:mustUnderstand="1">
      uuid:218f8239-9952-4e19-8176-38f629967e3c
    </a:MessageID>
    <a:To soapenv:mustUnderstand="1">
      https://service-a.id.school/eck/ws/201509
    </a:To>
    </soapenv:Header>
  <soapenv:Body>
    <v1:retrieveEckIdRequest>
      <v1:hpgn>123456789</v1:hpgn>
      <v1:chainId>
        http://purl.edustandaard.nl/begrippenkader/e7ec7d3c-c235-4513-bfb6-e54e66854795
      </v1:chainId>
      <v1:sectorId>
        http://purl.edustandaard.nl/begrippenkader/512e4729-03a4-43a2-95ba-758071d1b725
      </v1:sectorId>
    </v1:retrieveEckIdRequest>
  </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <Action xmlns="http://www.w3.org/2005/08/addressing">
         http://id.school/eck/schemas/v1_0/SchoolID/retrieveEckIdResponse
      </Action>
      <MessageID xmlns="http://www.w3.org/2005/08/addressing">
         urn:uuid:f80d16f5-e526-4754-b3f8-76995138de7c
      </MessageID>
      <To xmlns="http://www.w3.org/2005/08/addressing">
         http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
      </To>
      <RelatesTo xmlns="http://www.w3.org/2005/08/addressing">
         uuid:7b44c0c9-a8eb-45ae-9aa1-2af9599f3375
      </RelatesTo>
      <From xmlns="http://www.w3.org/2005/08/addressing">
         <Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin= 00000003272400000000
         </Address>
      </From>
   </soap:Header>
   <soap:Body>
      <retrieveEckIdResponse xmlns="http://id.school/eck/schemas/v1_0">
         <eckId>
            https://id.school/pilot/8078d3...28bc85
         </eckId>
      </retrieveEckIdResponse>
   </soap:Body>
</soap:Envelope>

Example error response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <Action xmlns="http://www.w3.org/2005/08/addressing">
           http://id.school/eck/schemas/v1_0/SchoolID/retrieveEckId/Fault/NotAllowedCallerException
       </Action>
      <MessageID xmlns="http://www.w3.org/2005/08/addressing">
            urn:uuid:f8a78500-5e82-4fe5-9853-eaab78d819aa</MessageID>
      <To xmlns="http://www.w3.org/2005/08/addressing">
            http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
      </To>
      <RelatesTo xmlns="http://www.w3.org/2005/08/addressing">
            uuid:218f8239-9952-4e19-8176-38f629967e3c</RelatesTo>
      <From xmlns="http://www.w3.org/2005/08/addressing">
         <Address>
          http://www.w3.org/2005/08/addressing/anonymous?oin= 00000003272400000000
        </Address>
      </From>
   </soap:Header>
   <soap:Body>
      <soap:Fault>
         <faultcode>soap:Server</faultcode>
         <faultstring>
             Uw Bevoegd Gezag is nog niet geautoriseerd voor het gebruik van de Nummervoorziening.
         </faultstring>
      </soap:Fault>
   </soap:Body>
</soap:Envelope>

Replace EckID

Sample request

<soapenv:Envelope 
   xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
   xmlns:v1="http://id.school/eck/schemas/v1_0">
   <soapenv:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
      <wsa:Action soapenv:mustUnderstand="1">
         http://id.school/eck/schemas/v1_0/replaceEckId
      </wsa:Action>
      <wsa:From soapenv:mustUnderstand="1">
         <wsa:Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
         </wsa:Address>
      </wsa:From>
      <wsa:MessageID soapenv:mustUnderstand="1">
         uuid:bb3af1a4-55fe-418f-9d65-87217ebe4cc7
      </wsa:MessageID>
      <wsa:To soapenv:mustUnderstand="1">
         https://service-a.id.school/eck/ws/201509
      </wsa:To>
   </soapenv:Header>
   <soapenv:Body>
      <v1:replaceEckIdRequest>
         <v1:hpgnOld>Antoinette</v1:hpgnOld>
         <v1:hpgnNew>Beatrijs</v1:hpgnNew>
         <v1:chainId>
            http://purl.edustandaard.nl/begrippenkader/e7ec7d3c-c235-4513-bfb6-e54e66854795
         </v1:chainId>
         <v1:sectorId>
            http://purl.edustandaard.nl/begrippenkader/2a1401e9-c223-493b-9b86-78f6993b1a8d
         </v1:sectorId>
      </v1:replaceEckIdRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <Action xmlns="http://www.w3.org/2005/08/addressing">
         http://id.school/eck/schemas/v1_0/SchoolID/replaceEckIdResponse
      </Action>
      <MessageID xmlns="http://www.w3.org/2005/08/addressing">
         urn:uuid:d906b6fd-3806-45e8-b9c9-d8775fbb6fd7
      </MessageID>
      <To xmlns="http://www.w3.org/2005/08/addressing">
         http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
      </To>
      <RelatesTo xmlns="http://www.w3.org/2005/08/addressing">
         uuid:bb3af1a4-55fe-418f-9d65-87217ebe4cc7
      </RelatesTo>
      <From xmlns="http://www.w3.org/2005/08/addressing">
         <Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin= 00000003272400000000
         </Address>
      </From>
   </soap:Header>
   <soap:Body>
      <replaceEckIdResponse xmlns="http://id.school/eck/schemas/v1_0">
         <eckId>
            https://id.school/pilot/8a8781...96260e
         </eckId>
      </replaceEckIdResponse>
   </soap:Body>
</soap:Envelope>

Batch operations

Submit batch request

<soapenv:Envelope 
   xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
   xmlns:v1="http://id.school/eck/schemas/v1_0" 
   xmlns:a="http://www.w3.org/2005/08/addressing">
   <soapenv:Header>
      <a:Action soapenv:mustUnderstand="1">
         http://id.school/eck/schemas/v1_0/submitEckIdBatch
      </a:Action>
      <a:From soapenv:mustUnderstand="1">
         <a:Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin=12345678901234567890
         </a:Address>
      </a:From>
      <a:MessageID soapenv:mustUnderstand="1">
         uuid:47d17105-5aae-4c36-98ed-fe1147f89ee6
      </a:MessageID>
      <a:To soapenv:mustUnderstand="1">
         https://service-a.id.school/eck/ws/201509
      </a:To>
   </soapenv:Header>
   <soapenv:Body>
      <v1:submitEckIdBatchRequest>
         <!--1 or more repetitions:-->
         <v1:hpgnList>
            <v1:index>1</v1:index>
            <v1:hPgn>Alexa</v1:hPgn>
         </v1:hpgnList>
         <v1:hpgnList>
            <v1:index>3</v1:index>
            <v1:hPgn>Bernadette</v1:hPgn>
         </v1:hpgnList>
         <v1:hpgnList>
            <v1:index>5</v1:index>
            <v1:hPgn>Christina</v1:hPgn>
         </v1:hpgnList>
         <v1:hpgnList>
            <v1:index>7</v1:index>
            <v1:hPgn>Delaney</v1:hPgn>
         </v1:hpgnList>
         <v1:chainId>http://purl.edustandaard.nl/begrippenkader/e7ec7d3c-c235-4513-bfb6-e54e66854795</v1:chainId>
         <v1:sectorId>http://purl.edustandaard.nl/begrippenkader/f3ac3fbb-5eae-49e0-8494-0a44855fff25</v1:sectorId>
      </v1:submitEckIdBatchRequest>
   </soapenv:Body>
</soapenv:Envelope>

Submit batch response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <Action xmlns="http://www.w3.org/2005/08/addressing">
         http://id.school/eck/schemas/v1_0/SchoolID/submitEckIdBatchResponse
      </Action>
      <MessageID xmlns="http://www.w3.org/2005/08/addressing">
         urn:uuid:add7a36a-ceac-41f9-a9fc-1c2fd54543d0
      </MessageID>
      <To xmlns="http://www.w3.org/2005/08/addressing">
         http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
      </To>
      <RelatesTo xmlns="http://www.w3.org/2005/08/addressing">
         uuid:47d17105-5aae-4c36-98ed-fe1147f89ee6
      </RelatesTo>
      <From xmlns="http://www.w3.org/2005/08/addressing">
         <Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin= 00000003272400000000
         </Address>
      </From>
   </soap:Header>
   <soap:Body>
      <submitEckIdBatchResponse xmlns="http://id.school/eck/schemas/v1_0">
         <batchIdentifier>
            2016062216374691e0ed3ba7544c71ac7856be9279f15f
         </batchIdentifier>
      </submitEckIdBatchResponse>
   </soap:Body>
</soap:Envelope>

Retrieve batch request

<soapenv:Envelope 
   xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
   xmlns:v1="http://id.school/eck/schemas/v1_0" 
   xmlns:a="http://www.w3.org/2005/08/addressing">
   <soapenv:Header>
      <a:Action soapenv:mustUnderstand="1">
         http://id.school/eck/schemas/v1_0/retrieveEckIdBatch
      </a:Action>
      <a:From soapenv:mustUnderstand="1">
         <a:Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
         </a:Address>
      </a:From>
      <a:MessageID soapenv:mustUnderstand="1">
         uuid:4e2a772e-6b6b-4dcf-ab15-58193678e69a
      </a:MessageID>
      <a:To soapenv:mustUnderstand="1">
         https://service-a.id.school/eck/ws/201509
      </a:To>
   </soapenv:Header>
   <soapenv:Body>
      <v1:retrieveEckIdBatchRequest>
         <v1:batchIdentifier>2016062216374691e0ed3ba7544c71ac7856be9279f15f</v1:batchIdentifier>
      </v1:retrieveEckIdBatchRequest>
   </soapenv:Body>
</soapenv:Envelope>

Retrieve batch response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <Action xmlns="http://www.w3.org/2005/08/addressing">
         http://id.school/eck/schemas/v1_0/SchoolID/retrieveEckIdBatchResponse
      </Action>
      <MessageID xmlns="http://www.w3.org/2005/08/addressing">
         urn:uuid:5cd37eef-cb58-4b2c-b8bc-6ccf4cc479ea
      </MessageID>
      <To xmlns="http://www.w3.org/2005/08/addressing">
         http://www.w3.org/2005/08/addressing/anonymous?oin=  12345678901234567890
      </To>
      <RelatesTo xmlns="http://www.w3.org/2005/08/addressing">
         uuid:4e2a772e-6b6b-4dcf-ab15-58193678e69a
      </RelatesTo>
      <From xmlns="http://www.w3.org/2005/08/addressing">
         <Address>
            http://www.w3.org/2005/08/addressing/anonymous?oin= 00000003272400000000
         </Address>
      </From>
   </soap:Header>
   <soap:Body>
      <retrieveEckIdBatchResponse xmlns="http://id.school/eck/schemas/v1_0">
         <success>
            <index>1</index>
            <eckId>https://id.school/pilot/bcd2a9...12b5b3</eckId>
         </success>
         <success>
            <index>3</index>
            <eckId>https://id.school/pilot/6f4411...fb2cbb</eckId>
         </success>
         <success>
            <index>5</index>
            <eckId>https://id.school/pilot/50e115...212395</eckId>
         </success>
         <success>
            <index>7</index>
            <eckId>https://id.school/pilot/742668...b6cb4</eckId>
         </success>
      </retrieveEckIdBatchResponse>
   </soap:Body>
</soap:Envelope>

Common types

Name	HPgn
Fields	xsd:string
Constraints	Consists of 64 hex characters ([0-9][A-Z][[a-z]){64}
Remarks	Contains the result of the prescribed hash function SCrypt

Name	EckId
Fields	xsd:string
Constraints	Is not empty
Remarks

Exceptions

Exceptions will be presented by the Nummervoorziening Service as Soap faults. To distinguish the cause Exception of an operation at the client, the element faultactor will hold the specific Exception. In the detail node, a message node is added with additional information regarding the Exception.

Example of a Soap fault as a response from the Nummervoorziening Service (omitting the Soap Headers):

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body> 
      <soap:Fault> 
         <faultcode>soap:SERVER</faultcode> 
         <faultstring>RetrieveEckIdBatch has thrown an exception while building the response</faultstring> 
         <faultactor>InvalidBatchIdentifierException</faultactor> 
         <detail> 
            <message>Batch with specified identifier does not exist</message> 
         </detail> 
      </soap:Fault> 
   </soap:Body> 
</soap:Envelope>

The reference clients will contain code in Java and C# to handle these faults and distinguish root causes.