Espacio de desarrolladores para eSenders y reutilizadores

La Oficina de Publicaciones ofrece varias interfaces de programación de aplicaciones (API) web relacionadas con TED y con la contratación pública europea.

Las API permiten:

enlightened La Oficina de Publicaciones no puede ofrecer formación sobre cómo utilizar las API. Sin embargo, los enlaces anteriores proporcionan acceso a los documentos para los desarrolladores y otros perfiles técnicos.

 

Información general

Los requisitos de registro y los mecanismos de autenticación varían en función de la API. Es necesario registrarse para utilizar cualquiera de las API, excepto en el caso de la API para el sitio web de TED.

Para todas las API, excepto para lista de convocatorias de licitación publicadas por las instituciones de la UE, la Oficina de Publicaciones ofrece una descripción estructurada utilizando la especificación OpenAPI (también denominada «Swagger»).

Cuando el contenido XML de un anuncio está incluido en una carga útil JSON, se codifica en Base64 y se trata como una cadena. Así se evitan problemas debidos a caracteres que tienen significados específicos en JSON (comillas, comas, etc.).

 
Versiones

Cuando se aplica un cambio que no es retrocompatible, se crea una nueva versión. La versión aparece en cada URL; por ejemplo, «/v2/…».

Los siguientes cambios son retrocompatibles:

  • añadir nuevas operaciones de la API
  • añadir nuevos parámetros opcionales de entrada (en JSON o en la cadena de búsqueda) a métodos API existentes
  • añadir nuevas propiedades JSON a las respuestas API existentes
  • cambiar el orden de las propiedades en respuestas API existentes.
 
Recomendaciones para las implementaciones de clientes

Dada la política de compatibilidad anteriormente descrita, al implementar un cliente, le rogamos compruebe que se ignora cualquier campo inesperado en las respuestas. No se base en el orden de los campos en JSON.

Toda petición HTTP a nuestras API debe contener el encabezado «User-Agent». Para ayudarnos a investigar posibles problemas, rogamos especifique el valor de este encabezado con la mayor precisión posible.

 

Enviar anuncios a publicación

La Oficina de Publicaciones ofrece operaciones que permiten a organismos públicos o privados («eSenders» de TED) enviar anuncios para su publicación en el sitio web de TED a través de sus propios sistemas informáticos. Consulte la página «Actuar como TED eSender».

 

Ver los anuncios en varios formatos

A partir de un anuncio en formato XML, es posible obtenerlo en formato HTML o PDF y en un determinado idioma. El acceso es anónimo.

Hay disponibles dos API distintas:

 

Buscar y recuperar datos publicados en la web de TED

Desde el 14 de noviembre de 2022, para los anuncios disponibles en el sitio web de TED se utilizan los formularios y los formularios electrónicos («eForms») del esquema de TED.

Si reutiliza los anuncios de TED, debe adaptar sus sistemas para que sean compatibles con los anuncios en formato eForms.

 
Búsqueda y recuperación de anuncios publicados: API del sitio web de TED

Se puede acceder a la API del sitio web de TED de forma anónima, de modo que puede utilizar el motor de búsqueda del sitio web para encontrar anuncios de contratación pública específicos. Utilice la «búsqueda especializada» para buscar y filtrar los resultados utilizando diferentes criterios. Dado que el Reglamento sobre formularios electrónicos introdujo un nuevo esquema de TED, se han modificado algunos criterios de búsqueda. La API de búsqueda introdujo un controlador de búsqueda v3 para encontrar tanto anuncios con esquema TED como anuncios con formularios electrónicos. Para más información, véase la documentación sobre la API del sitio web de TED.

Además, se han adaptado los siguientes criterios de búsqueda para encontrar anuncios: tipo de comprador, criterio de adjudicación, base jurídica, actividad principal, tipo de contrato, tipo de procedimiento, tipo de anuncio y tipo de documento, entidad jurídica, país, lugar de ejecución, lengua en la que pueden presentarse las solicitudes de participación u ofertas.

Para obtener una visión pormenorizada, consulte este documento con la correspondencia detallada entre los valores de los códigos utilizados hasta el 2 de noviembre de 2022 y los utilizados después de esa fecha. Para más información, consulte las páginas de ayuda o póngase en contacto con el servicio de asistencia.

La API del sitio web de TED también le permite buscar información sobre el número de anuncios en cada zona geográfica (código NUTS), y puede proporcionar esta información en forma de mapa del «lugar de ejecución».

 
Descargas en masa en formato XML

Si está conectado, puede descargar anuncios en formato XML en bloque desde el sitio web TED. Un solo archivo contiene todos los anuncios de cada día y cada mes.

Esta funcionalidad también está disponible en el servidor FTP de TED.

 
Ampliación del número de publicación del anuncio a ocho dígitos

El sitio web de TED solía permitir la publicación de un máximo de 999 999 anuncios al año (es decir, seis dígitos; por ejemplo, 1-2022, 654321-2022).

Para permitir la publicación de más de un millón de anuncios al año, hemos aumentado a ocho dígitos el número de publicación (por ejemplo, 1-2024, 87654321-2024).

Debido a esta ampliación, los paquetes XML siguen dos modos de numeración de archivos XML:

  • en el caso de los anuncios en formato eForms, el formato es de ocho dígitos (por ejemplo, 00654321_2022.xml)
  • en el caso de los anuncios del esquema de TED, el formato es de seis dígitos (por ejemplo, 123456_2022.xml)

El número de publicación tiene ocho dígitos en el caso de los anuncios en formato eForms y seis dígitos en el caso de los anuncios del esquema de TED.

 
Archivos CSV

También está disponible en formato CSV (valores separados por comas) un subconjunto de datos de los anuncios publicados en el sitio web de TED como conjunto de datos en data.europa.eu.

 

Buscar y recuperar licitaciones publicadas por las instituciones de la UE

Es posible obtener una lista de convocatorias publicadas por las instituciones de la UE en el sitio web de eTendering.

La lista ofrece información básica sobre cada convocatoria y puede filtrarse por:

  • nombre del poder adjudicador
  • estado de la convocatoria
  • lengua

Para más información, véase la documentación de la API en formato PDF.