OCDS for the European Union¶
This website describes how to express, in OCDS, the information in Tenders Electronic Daily (TED) notices.
The primary legislation for public contracting in the European Union includes:
Directive 2014/24/EU on public procurement
Directive 2014/23/EU on the award of concession contracts
Directive 2014/25/EU on procurement by entities operating in the water, energy, transport and postal services sectors
The secondary legislation includes the Commission Implementing Regulation (EU) 2019/1780 (eForms), which establishes standard forms for the publication of procurement notices, and repeals the earlier Commission Implementing Regulation (EU) 2015/1986.
This guidance does not cover:
Directive 2009/81/EC on the coordination of procedures for the award of certain works contracts, supply contracts and service contracts by contracting authorities or entities in the fields of defence and security
PDF files of the forms are provided by the European Commission, for reference only (Prior information notice, for example). However, the PDF files don't formally specify the form fields and their possible values (numbers, dates, codes, etc.). These are specified in the Tenders Electronic Daily (TED) XML schemas. Of particular interest is the Publication Schema, which is used to publish notices.
Reading the schema, however, is challenging, unless you're familiar with XML Schema and related tools. To make it easier to understand the structure of the notices, we generated XML files for the notices, which provide validation rules in comments, and retain XML Schema elements like
<choice> only where necessary.
The European Commission also provides template PDF files, in which label keys like
ca stand for labels like 'Contracting authority', and provides an Excel file that maps the label keys to labels in official languages of the European Union.
This guidance is based on the TED publication XML schema R2.0.9 (S05, 2021-07-30). It does not cover XML schema R2.0.8, used for the standard forms related to Directive 2009/81/EC, which are:
F16: Prior information notice for contracts in the field of defence and security
F17: Contract notice for contracts in the field of defence and security
F18: Contract award notice for contracts in the field of defence and security
F19: Subcontract notice
This website takes the human-readable form labels from the standard form PDF files, pairs them with the machine-readable element names from the TED XML files, and provides guidance on how to express the information in OCDS.
In this way, a policy analyst can see the relationship to the standard forms established in the Implementing Regulation, and a software developer can see the relationship to the elements defined in the TED XML schema.
- Standard forms
- F01: Prior information notice
- F02: Contract notice
- F03: Contract award notice
- F04: Periodic indicative notice – utilities
- F05: Contract notice – utilities
- F06: Contract award notice – utilities
- F07: Qualification system – utilities
- F08: Notice on a buyer profile
- F12: Design contest notice
- F13: Results of design contest
- F14: Corrigendum
- F15: Voluntary ex ante transparency notice
- F20: Modification notice
- F21: Social and other specific services – public contracts
- F22: Social and other specific services – utilities
- F23: Social and other specific services – concessions
- F24: Concession notice
- F25: Concession award notice
- T01: Prior information notice for public service contract
- T02: Information notice for award of public service contract
- Common operations
Reading this website¶
The guidance on each page above follows the same order as a standard form and is organized into the same sections. Within each section, there is a table with three columns. For example:
|Index||Label and XPath||OCDS guidance|
Index makes it easy to find the content at the same index in the form
Label and XPath contains a paired form label and XML path
OCDS guidance describes how to transform TED XML to OCDS JSON (in most cases, the transformation is reversible)
Most fields map simply and directly from TED XML to OCDS JSON. Badges are used to call attention to special cases:
Attention If there is a potential issue with the guidance, it is described briefly, and a link is provided to a GitHub issue to acknowledge or dismiss the potential issue.
Issue If there is a reported issue with the guidance, it is described briefly, and a link is provided to the GitHub issue.
When reading the guidance on this website, it may be useful to refer to the notice's PDF file (be sure to open the new, not old, form), to see whether the field is a check box, radio button, etc. and to its XML file, to see the validation rules and other context.
Understanding the concepts in the forms¶
In many cases, the form labels from the PDF files and the element names from the XML files are both short and ambiguous, and therefore difficult to interpret. In such cases, it is useful to refer to:
We want your feedback!¶
To contribute, please first read this page, and then dive into the guidance. Feedback is discussed openly on GitHub. To browse all issues or to open another issue, visit this website's GitHub issues.