bacontest/ted-portal-licitaciones.md

124 lines
3.2 KiB
Markdown

# Portal de Licitaciones de la Unión Europea — TED (Tenders Electronic Daily)
*Informe técnico — 2026-07-20*
---
## ¿Qué es TED?
**Tenders Electronic Daily (TED)** es el portal oficial de contratación pública de la Unión Europea. Contiene todas las licitaciones y contratos publicados en el Suplemento del Diario Oficial de la UE.
- **URL:** https://ted.europa.eu
- **Cobertura:** 27 países miembros + Islandia, Liechtenstein y Noruega (EEE)
- **Volumen:** ~700.000 licitaciones/año
- **Coste:** Gratuito
---
## API de TED (Sin Autenticación)
**La API de TED no requiere cuenta ni API key.** Es completamente abierta.
### 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 |
|---------------|---------|
| **Página** | https://ted.europa.eu/en/simap/rss-feed |
| **Requisito** | Cuenta TED (gratuita) |
| **Funcionamiento** | Guardar búsqueda → activar RSS → URL generada |
---
## Descarga Masiva XML
| Tipo | URL |
|------|-----|
| **Diario** | `https://ted.europa.eu/packages/daily/{YYYYMMDD}` |
| **Mensual** | `https://ted.europa.eu/packages/monthly/{YYYY-MM}` |
| **Datos abiertos** | https://data.europa.eu |
---
## Conclusión
| 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 |
**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.
---
*Informe generado por Hermes Agent — 2026-07-20*