Update informe TED: API no requiere autenticación

This commit is contained in:
rogerbacon 2026-07-22 20:58:25 +00:00
parent 9eca0c1c0e
commit f44be2c9c1

View file

@ -15,161 +15,109 @@
--- ---
## Métodos de Acceso a los Datos ## API de TED (Sin Autenticación)
### 1. RSS Feeds **La API de TED no requiere cuenta ni API key.** Es completamente abierta.
TED dispone de feeds RSS para recibir actualizaciones automáticas de licitaciones. ### Endpoints
| Servidor | URL |
|----------|-----|
| **Producción** | `https://api.ted.europa.eu/` |
| **Alternativo** | `https://tedweb.api.ted.europa.eu/` |
### Búsqueda de Avisos
```
POST https://api.ted.europa.eu/v3/notices/search
Content-Type: application/json
```
**Ejemplo — Avisos de hoy:**
```json
{
"query": "publication-date >= 20260720",
"fields": ["BT-21-Procedure", "publication-date"],
"limit": 10
}
```
**Formato de fecha:** `YYYYMMDD` (ej: `20260720`)
**Formato de consulta:** Expert search query
- `publication-date >= 20260720`
- `publication-date = today(0)` (hoy)
- `publication-date = today(-7)` (última semana)
### Campos Disponibles (ejemplos)
| Campo | Descripción |
|-------|-------------|
| `BT-21-Procedure` | Nombre del procedimiento |
| `publication-date` | Fecha de publicación |
| `notice-type` | Tipo de aviso |
| `country` | País |
| `cpv-code` | Código CPV |
### Respuesta
```json
{
"notices": [
{
"publication-number": "497792-2026",
"publication-date": "2026-07-20+02:00",
"links": {
"xml": {"MUL": "https://ted.europa.eu/en/notice/497792-2026/xml"},
"html": {"ENG": "https://ted.europa.eu/en/notice/-/detail/497792-2026"}
}
}
],
"total": 1234
}
```
### Prueba Rápida
```bash
curl -X POST "https://api.ted.europa.eu/v3/notices/search" \
-H "Content-Type: application/json" \
-d '{"query":"publication-date >= 20260720","fields":["BT-21-Procedure"],"limit":2}'
```
**Documentación Swagger:** https://ted.europa.eu/api/documentation/index.html
---
## RSS Feeds (Requiere Cuenta)
| Característica | Detalle | | Característica | Detalle |
|---------------|---------| |---------------|---------|
| **Página de configuración** | https://ted.europa.eu/en/simap/rss-feed | | **Página** | https://ted.europa.eu/en/simap/rss-feed |
| **Patrón de URL** | `https://ted.europa.eu/en/simap/rss-feed/-/rss/search/{CÓDIGO}` | | **Requisito** | Cuenta TED (gratuita) |
| **Códigos** | Sector económico, país, tipo de contrato | | **Funcionamiento** | Guardar búsqueda → activar RSS → URL generada |
| **Requisito** | Cuenta TED gratuita |
| **Funcionamiento** | Guardar búsqueda → activar RSS → URL generada automáticamente |
**Limitaciones:**
- Los feeds se generan dinámicamente vía JavaScript
- No hay feeds RSS públicos predefinidos (hay que crearlos con cuenta)
- Los feeds personalizados se limitan a 50 ítems por defecto (configurable)
### 2. API de Búsqueda (TED Search API)
API RESTful para buscar y descargar avisos de licitación.
| Característica | Detalle |
|---------------|---------|
| **Documentación** | https://ted.europa.eu/en/simap/developers-corner-for-reusers |
| **Formato** | JSON/XML |
| **Filtros** | País, código CPV, fechas, tipo de aviso, texto libre |
| **Límites** | Política de uso razonable |
**Ejemplo de búsqueda:**
```
GET https://ted.europa.eu/api/v3.0/notices/search?q=*&fields=BT-21-Procedure&limit=100
```
### 3. Descarga Masiva XML
Descarga completa de avisos en formato XML.
| Tipo | URL | Descripción |
|------|-----|-------------|
| **Diario** | `https://ted.europa.eu/packages/daily/{YYYYMMDD}` | Paquete diario |
| **Mensual** | `https://ted.europa.eu/packages/monthly/{YYYY-MM}` | Paquete mensual |
| **Todos** | https://data.europa.eu | Repositorio completo |
**Ejemplo:**
```
https://ted.europa.eu/packages/daily/202600001
https://ted.europa.eu/packages/monthly/2026-07
```
### 4. Datos Abiertos (Open Data)
Todos los avisos TED están disponibles en:
- **data.europa.eu** — Formato XML, descarga masiva
- **DG Empresa** — Subconjunto en CSV (años, países, tipos seleccionados)
--- ---
## Formato de los Avisos ## Descarga Masiva XML
TED publica avisos en dos formatos: | Tipo | URL |
|------|-----|
| Formato | Descripción | Desde | | **Diario** | `https://ted.europa.eu/packages/daily/{YYYYMMDD}` |
|---------|-------------|-------| | **Mensual** | `https://ted.europa.eu/packages/monthly/{YYYY-MM}` |
| **eForms** | Formulario electrónico estándar (Reglamento UE 2019/1780) | Noviembre 2022 | | **Datos abiertos** | https://data.europa.eu |
| **Esquema TED** | Formato XML clásico | Original |
### Tipos de Aviso Principales
| Código | Tipo |
|--------|------|
| 1 | Licitación de contratos de obra |
| 2 | Licitación de contratos de suministro |
| 3 | Licitación de contratos de servicio |
| 4 | Adjudicación de contrato |
| 5 | Modificación de contrato |
| 7 | Licitación de contratos de concesión |
| 14 | Contrato de concesión de obra |
| 15 | Contrato de concesión de servicio |
---
## Código CPV (Common Procurement Vocabulary)
Sistema de clasificación estándar para productos y servicios:
| Código | Categoría |
|--------|-----------|
| 45000000 | Obras de construcción |
| 50000000 | Servicios de reparación y mantenimiento |
| 72000000 | Servicios de informática |
| 80000000 | Servicios de educación |
| 98000000 | Otros servicios comunitarios |
---
## Requisitos de Cuenta
| Acción | Cuenta necesaria |
|--------|-----------------|
| Buscar licitaciones | No |
| Ver avisos completos | No |
| Crear RSS feeds | Sí (gratuita) |
| Guardar búsquedas | Sí (gratuita) |
| Configurar alertas | Sí (gratuita) |
| Descargar XML masivo | No |
---
## Cómo Crear un Feed RSS
1. Ir a https://ted.europa.eu/en/simap/rss-feed
2. Crear cuenta TED (gratuita)
3. Ir a "Búsqueda avanzada"
4. Configurar filtros: país, código CPV, fechas, tipo de aviso
5. Ejecutar búsqueda
6. Clic en "Guardar búsqueda"
7. Activar "RSS feed" en las opciones
8. Copiar la URL del feed generada
9. Añadir a tu lector RSS (Feedly, Thunderbird, etc.)
---
## Alternativa: RSS vía data.europa.eu
data.europa.eu también ofrece feeds RSS para datos de contratación pública:
```
https://data.europa.eu/data/datasets?locale=en&catalog=ted
```
---
## Contacto y Soporte
| Recurso | URL |
|---------|-----|
| Portal TED | https://ted.europa.eu |
| Ayuda | https://ted.europa.eu/en/help |
| Desarrolladores | https://ted.europa.eu/en/simap/developers-corner-for-reusers |
| Datos abiertos | https://data.europa.eu |
| Contacto | https://ted.europa.eu/en/help/contact |
--- ---
## Conclusión ## Conclusión
TED es la fuente oficial y más completa de contratación pública en la UE. Los métodos de acceso más prácticos para monitorización continua son: | Método | Autenticación | Ideal para |
|--------|--------------|------------|
| **API de búsqueda** | ❌ No necesaria | Integración programática, monitorización |
| **RSS Feeds** | ✅ Cuenta TED | Notificaciones automáticas |
| **Descarga XML** | ❌ No necesaria | Análisis de datos completos |
1. **RSS feeds** — Para notificaciones automáticas (requiere cuenta) **La API de búsqueda es la opción más práctica:** no requiere cuenta, es RESTful, y devuelve resultados en JSON listos para procesar.
2. **API de búsqueda** — Para integración programática
3. **Descarga XML** — Para análisis de datos completos
Para un usuario técnico, la **API de búsqueda** es la opción más flexible. Para vigilancia pasiva, los **RSS feeds** son la opción más sencilla una vez configurados.
--- ---