Espaço dos programadores para Reutilizadores

Informações gerais

O sítio Web do Diário Eletrónico dos Concursos (TED) disponibiliza várias interfaces de programação de aplicações Web (API).

Estas API permitem:

• Procurar e obter dados publicados no portal TED (API de pesquisa do TED)
• Descarregar anúncios em vários formatos utilizando ligações diretas
• Descarregar anúncios XML em massa
• Descarregar o calendário de publicação

O sítio Web TED também disponibiliza alertas RSS.

Desde 14 de novembro de 2022 que os anúncios disponíveis no sítio TED utilizam tanto os formulários eletrónicos como formulários de esquema TED.

• Os formulários eletrónicos estão definidos no Regulamento (UE) 2019/1780, que introduz novos formulários-tipo para a contratação pública (válidos desde 14 de novembro de 2022).
• Os formulários de esquema TED estão definidos no Regulamento (UE) 2015/1986 e baseiam-se numa norma de interoperabilidade do Serviço das Publicações.

Estão disponíveis informações sobre os formulários eletrónicos e formulários de esquema TED na documentação para programadores TED Developer Docs.

Procurar e obter dados publicados no portal TED (API de pesquisa do TED)

É possível aceder à API de pesquisa do TED anonimamente para utilizar o motor de pesquisa do sítio Web para encontrar anúncios de concurso específicos.
A documentação da API de pesquisa do TED está disponível em https://ted.europa.eu/api/documentation/index.html

Descarregar anúncios em vários formatos utilizando ligações diretas

Pode descarregar um anúncio utilizando uma ligação direta, em qualquer língua oficial da UE, nos seguintes formatos: HTML, HTML descarregado, PDF assinado e PDF não assinado.

O formato dos URL da ligação direta é o seguinte:

https://ted.europa.eu/{lang}/notice/{publication-number}/{format}

em que:

• {lang} é a língua (por exemplo, «en», «pt»);
• {publication-number} é o número de publicação (por exemplo, 1-2024, 87654321-2024);
• {format} pode ser:
• html: para visualizar o ficheiro HTML descarregado,
• pdf: para descarregar o anúncio em formato PDF,
• pdfs: para descarregar o anúncio em formato PDF assinado.

Pode ainda descarregar anúncios em formato XML utilizando uma ligação direta.

O formato do URL da ligação direta é o seguinte:

https://ted.europa.eu/en/notice/{publication-number}/xml

Descarregar anúncios XML em massa

Pode descarregar anúncios XML em massa do portal do Diário Eletrónico de Concursos através da página Descarregamento em massa XML do sítio TED.

Um arquivo único (pacote XML) contém todos os anúncios para o dia ou mês escolhido.

Os pacotes XML contêm ficheiros XML numerados de duas formas:

• para anúncios de formulários eletrónicos, os ficheiros têm 8 algarismos, seguidos do ano (por exemplo, 00654321_2022.xml)
• para anúncios de esquema TED, os ficheiros XML têm 6 algarismos, seguidos do ano (por exemplo, 123456_2022.xml).

O formato dos URL para descarregar pacotes é o seguinte:

• Formato URL para pacotes diários:

https://ted.europa.eu/packages/notice/daily/{yyyynnnnn}

em que {yyyynnnnn} é o número do suplemento do JO.

Exemplo: Descarregar o pacote diário do JO S 1 / 2024: https://ted.europa.eu/packages/daily/202400001

• Formato URL para pacotes mensais:

https://ted.europa.eu/packages/notice/monthly/{yyyy-n}

em que {yyyy-n} é o ano e o mês.

Exemplo: Descarregar o pacote mensal de janeiro de 2024: https://ted.europa.eu/packages/monthly/2024-1

Descarregar o calendário de publicação

Pode descarregar a lista de publicações do suplemento do JO por ano através da página Calendário de Publicação no sítio TED.

O formato dos URL para descarregar o calendário de publicação é o seguinte:

https://ted.europa.eu/{lang}/release-calendar/-/download/file/{format}/{year}

em que:

• {lang} é a língua (por exemplo, «en», «pt»)
• {format} pode ser: XLS, PDF ou CSV
• {year} é o ano (por exemplo: 2023, 2024)

Exemplo: https://ted.europa.eu/en/release-calendar/-/download/file/XLS/2024

Subconjuntos TED em formato CSV

Está disponível em data.europa.eu/data/datasets/ted-csv?locale=pt um subconjunto de dados TED que abrange os campos mais importantes dos Anúncios de concurso e dos Anúncios de adjudicação de contratos em formato de valores separados por vírgulas (CSV).

Política de utilização responsável do TED

A arquitetura do portal TED foi concebida da seguinte forma:

— As páginas Web são totalmente construídas com base num CMS que permite uma experiência de utilizador melhorada e personalizada. Este CMS é eficiente dentro de um intervalo de cargas específico.

— Uma API pública específica, eficiente e escalável, para pesquisar anúncios e descarregar os respetivos conteúdos através de ligações diretas.

Com base nisto, o Serviço das Publicações recomenda vivamente que os utilizadores técnicos utilizem as API públicas para beneficiarem do seu desempenho e escalabilidade, libertando os recursos do CMS para os utilizadores comuns.