ANNEX III, Regulation (EU) 2016/68

In forcesince 2 Mar 2018cited 1×

1.1.

The central hub shall provide both synchronous and asynchronous interfaces for the exchange of messages. Member States may choose the most suitable technology to interface with their own applications.

1.2.

All messages exchanged between the central hub and the national systems must be UTF-8 encoded.

1.3.

National systems shall be capable of receiving and processing messages containing Greek or Cyrillic characters.

2.1.

The general structure of XML messages shall follow the format defined by the XSD schemas installed in the central hub.

2.2.

The central hub and the national systems shall transmit and receive messages that conform to the message XSD schema.

2.3.

National systems shall be capable of sending, receiving and processing all messages corresponding to any of the functionalities set out in Annex II.

2.4.

The XML messages shall include at least the minimum requirements laid down in the Appendix to this Annex.

Common header | Mandatory

Version | The official version of the XML specifications shall be specified through the namespace defined in the message XSD and in the version attribute of the Header element of any XML message. The version number (‘n.m’) shall be defined as fixed value in every release of the XML Schema Definition file (xsd). | Yes

Test Identifier | Optional id for testing. The originator of the test shall populate the identifier and all participants in the workflow shall forward/return the same identifier. In production it shall be ignored and shall not be used if it is supplied. | No

Technical Identifier | A UUID uniquely identifying each individual message. The sender shall generate a UUID and shall populate this attribute. This data shall not be used in any business capacity. | Yes

Workflow Identifier | The workflowId is a UUID and shall be generated by the requesting Member State. This identifier shall be then used in all messages to correlate the workflow. | Yes

Sent At | The date and time (in UTC format) that the message was sent. | Yes

Timeout | This is an optional date and time (in UTC format) attribute. This value shall be set only by the central hub for forwarded requests and is calculated based on the date/time the initial request has been received by the hub. This shall inform the responding Member State of the time when the request shall be timed out. This value is not required in initial requests sent to the hub and all response messages. | No

From | The ISO 3166-1 Alpha 2 code of the Member State sending the message or ‘EU’. | Yes

To | The ISO 3166-1 Alpha 2 code of the Member State to which the message is being sent or ‘EU’. | Yes

Check Issued Cards Request | Mandatory

Family Name | Driver's family name. | Yes

First Name | Driver's first/given name. | No

Date of Birth | Driver's date of birth. | Yes

Place of Birth | Driver's place of birth. | No

Driving Licence Number | Driver's driving licence number. | No

Driving Licence Issuing Country | The country that issued the driver's driving licence. | No

Check Issued Cards Response | Mandatory

Status Code | The status code of the response. | Yes

Status Message | An explanatory status description. | No

Search Mechanism | Was the card found by the NYSIIS search or a custom search. | Yes

Found Driver Details | Yes if the driver is found

Family Name | The family name of any found drivers. | Yes

First Name | The first name of any found drivers. | No

Date of Birth | The date of birth of any found drivers. | Yes

Place of Birth | The place of birth of any found drivers. | No

Card Details | Yes if the driver is found

Card Number | The found card number. | Yes

Card Status | The found card status. | Yes

Valid for driving | The found card is/is not valid for driving. | Yes

Card Issuing Authority | The name of the authority that issued the found card. | Yes

Card Start of Validity Date | The date of the start of validity of the found card. | Yes

Card Expiry Date | The date of expiry of the found card. | Yes

Card Status Modified Date | The date that the found card was last modified. | Yes

Temporary Card | The found card is a temporary card. | No

Driving Licence Details | Yes if a driver card is found

Driving Licence Number | The found driver's driving licence number. | Yes

Driving Licence Issuing Country | The issuing country of the found driver's driving licence. | Yes

Driving Licence Status | The status of the found driver's driving licence. | No

Driving Licence Issuing Date | The issuing date of the found driver's driving licence. | No

Driving Licence Expiry Date | The expiry date of the found driver's driving licence. | No

Workshop Card Details | Yes if a workshop card is found

Workshop name | The name of the workshop to which the found workshop card was issued. | Yes

Workshop address | The address of the workshop to which the found workshop card was issued. | Yes

Check Card Status Request | Mandatory

Card Number | The number of the card for which details are required. | Yes

Check Card Status Response | Mandatory

Status Code | The status code of the response. | Yes

Status Message | An explanatory status description. | No

Requested Card Details | Yes if the requested card is found

Card number | The requested card number. | Yes

Card Status | The status of the requested card. | Yes

Valid for driving | The requested card is/is not valid for driving. | Yes

Card Issuing Authority | The name of the authority that issued the requested card. | Yes

Card Start of Validity Date | The date of the start of validity of the requested card. | Yes

Card Expiry Date | The date of expiry the requested card. | Yes

Card Status Modified Date | The date that the requested card was last modified. | Yes

Temporary Card | The requested card is a temporary card. | No

Workshop Card Details | Yes if a workshop card is found

Workshop Name | The name of the workshop to which the card was issued. | Yes

Workshop Address | The address of the workshop to which the card was issued. | Yes

Card Holder Details |

Family Name | The family name of the driver to whom the card was issued. | Yes

First Name | The first name of the driver to whom the card was issued. | No

Date of Birth | The date of birth of the driver to whom the card was issued. | Yes

Place of Birth | The place of birth of the driver to whom the card was issued. | No

Driving Licence Details | Yes if a driver card is found

Driving Licence Number | The driving licence number of the driver to whom the card was issued. | Yes

Driving Licence Issuing Country | The country that issued driving licence number to the driver to whom the card was issued. | Yes

Driving Licence Status | The status of the driving licence of the driver to whom the card was issued. | No

Driving Licence Issuing Date | The issuing date of the driving licence of the driver to whom the card was issued. | No

Driving Licence Expiry Date | The expiry date of the driving licence of the driver to whom the card was issued. | No

Modify Card Status Request | Mandatory

Card Number | The number of the card of which the status has changed. | Yes

New Card Status | The status to which the card has been changed. | Yes

Card Status Modified Date | The date and time that the card status was modified. | Yes

Declared by |

Authority | The name of the authority that made the card status change. | Yes

Authority address | The address of the authority that made the card status change. | Yes

Family Name | The family name of the person who made the card status change. | No

First Name | The first name of the person who made the card status change. | No

Phone | The phone number of the person who made the card status change. | No

Email | The email address of the person who made the card status change. | No

Modify Card Status Acknowledgement | Mandatory

Status Code | The status code of the acknowledgement. | Yes

Status Message | An explanatory status description. | No

Acknowledgement type | The type of the acknowledgment: for request or response. | Yes

Modify Card Status Response | Mandatory

Status Code | The status code of the response. | Yes

Status Message | An explanatory status description. | No

Card Number | The requested driver card number. | Yes

Card Status | The status of the requested card as it exists in the tachograph card register. | Yes

Issued Card Driving Licence Request | Mandatory

Card Number | The number of the card that has been issued. | Yes

Driving Licence Number | The number of the foreign driving licence that was used to apply for the driver card. | Yes

Family Name | The family name of the driver to whom the card was issued. | Yes

First Name | The first name of the driver to whom the card was issued. | No

Date of Birth | The date of birth of the driver to whom the card was issued. | Yes

Place of Birth | The place of birth of the driver to whom the card was issued. | No

Issued Card Driving Licence Response | Mandatory

Status Code | The status code of the response. | Yes

Status Message | An explanatory status description. | No