From f44be2c9c12ff81c0aa872d7de18e66ee6baba54 Mon Sep 17 00:00:00 2001 From: rogerbacon Date: Wed, 22 Jul 2026 20:58:25 +0000 Subject: [PATCH] =?UTF-8?q?Update=20informe=20TED:=20API=20no=20requiere?= =?UTF-8?q?=20autenticaci=C3=B3n?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ted-portal-licitaciones.md | 228 ++++++++++++++----------------------- 1 file changed, 88 insertions(+), 140 deletions(-) diff --git a/ted-portal-licitaciones.md b/ted-portal-licitaciones.md index 54515cd..76d2436 100644 --- a/ted-portal-licitaciones.md +++ b/ted-portal-licitaciones.md @@ -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 | |---------------|---------| -| **Página de configuración** | https://ted.europa.eu/en/simap/rss-feed | -| **Patrón de URL** | `https://ted.europa.eu/en/simap/rss-feed/-/rss/search/{CÓDIGO}` | -| **Códigos** | Sector económico, país, tipo de contrato | -| **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) +| **Página** | https://ted.europa.eu/en/simap/rss-feed | +| **Requisito** | Cuenta TED (gratuita) | +| **Funcionamiento** | Guardar búsqueda → activar RSS → URL generada | --- -## Formato de los Avisos +## Descarga Masiva XML -TED publica avisos en dos formatos: - -| Formato | Descripción | Desde | -|---------|-------------|-------| -| **eForms** | Formulario electrónico estándar (Reglamento UE 2019/1780) | Noviembre 2022 | -| **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 | +| 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 -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) -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. +**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. ---