Publicado 2026-10-23
# Código QR para eventos: campos de vEvent y errores de calendario
Un código QR para eventos codifica un vEvent, el mismo formato de calendario que los teléfonos importan al tocar un enlace de «Añadir evento», de modo que un escaneo mete la sesión directamente en el calendario. El formato es de la familia vCalendar (RFC 5545, sucesor del linaje de vCard); la capa de matriz sigue ISO/IEC 18004, por lo que cualquier escáner conforme lo decodifica.
Cómo funciona vEvent
El registro empieza con BEGIN:VEVENT y termina con END:VEVENT. DTSTAMP es el momento de creación; DTSTART y DTEND son la ventana. Las horas pueden ser flotantes (sin zona), locales (TZID) o UTC (sufijo Z): mezclarlas entre campos es donde fallan las importaciones. La matriz que lo transporta es un código QR estándar según ISO/IEC 18004 (consulta ¿Qué es un código QR?).
Referencia de campos de vEvent
| Campo | Sintaxis | Obligatorio | Ejemplo | Notas |
|---|---|---|---|---|
| Versión | VERSION:2.0 | Sí | VERSION:2.0 | Línea vCalendar 2.0 |
| UID | UID:unique@host | Sí | UID:conf-42@codeboxhub.com | Debe ser único por evento |
| DTSTAMP | DTSTAMP:20260801T090000Z | Sí | DTSTAMP:20260801T090000Z | Hora de creación, UTC |
| SUMMARY | SUMMARY:Keynote | No | SUMMARY:Keynote | El título que muestra el calendario |
| DTSTART | DTSTART;TZID=...:… | No* | DTSTART:20260801T090000 | *La mayoría de los teléfonos la exige |
| DTEND | DTEND:… | No | DTEND:20260801T103000 | Día completo: omítela, usa VALUE=DATE |
| LOCATION | LOCATION:Hall B | No | LOCATION:Hall B, Center | Texto plano, sin geocodificación |
| DESCRIPTION | DESCRIPTION:Agenda inside | No | DESCRIPTION:Agenda inside | Saltos de línea escapados como \n |
| URL | URL:https://… | No | URL:https://conf.example/ | Página asociada o registro |
| STATUS | STATUS:CONFIRMED | No | STATUS:CONFIRMED | TENTATIVE / CANCELLED también válidos |
Errores habituales de vEvent
| Error | Qué pasa | Solución |
|---|---|---|
| UID duplicado entre eventos | Los calendarios tratan las actualizaciones como un solo evento | Haz el UID único por evento |
| DTSTART sin DTEND en un evento con hora | Algunos clientes muestran un evento de duración cero | Define ambos, incluso para 15 minutos |
| Evento de día completo con hora en DTSTART | El calendario muestra 00:00, no día completo | Usa VALUE=DATE y campos solo de fecha |
| Zonas horarias mezcladas en un evento | La importación falla en iOS o Android | Una sola zona, o todo en UTC |
| Comas y saltos de línea sin escapar en DESCRIPTION | Los campos se dividen a mitad del texto | Escápalos como \, y \n |
| DTSTAMP ausente | Los importadores estrictos rechazan el registro | Inclúyela siempre, en UTC |
| UID con espacios o puntuación | Los importadores estrictos rechazan el registro | Usa solo alfanuméricos, guiones y puntos |
| DTSTART en el pasado | Los clientes pueden importarlo como expirado o rechazarlo | Recodifica con una hora futura; las reimpresiones necesitan un DTSTAMP nuevo |
El Generador de QR para eventos de calendario construye el registro con un UID y un DTSTAMP válidos por ti.
Tutorial de 3 pasos
- Rellena título, fecha, hora, lugar y notas en el generador de QR de eventos.
- Exporta en PNG o SVG; el payload se queda por debajo de ~250 bytes para una sesión típica.
- Escanea con un iPhone y un teléfono Android, o decodifica en el Lector de códigos QR gratuito, y confirma que el calendario ofrece añadir el evento con la ventana correcta. Para un programa de varias sesiones, genera por lotes un código por sesión en el Generador de códigos QR por lotes.
Dónde usar un código QR de eventos
- Credenciales de congresos y carteles de sala: cada sesión tiene su propio código.
- Carteles de talleres: «Escanea para añadir el taller a tu calendario».
- Reservas de restaurantes y teatros: la ventana de reserva como bloque de calendario.
- Horarios de clases y gimnasios: el hueco recurrente, un escaneo por trimestre.
- Reuniones corporativas: la invitación, el lugar y el enlace de acceso en un solo registro.
Lo que medimos
Codificamos 400 vEvents, una sesión de 90 minutos con título, lugar, descripción y una URL, y escaneamos cada uno en 40 calendarios de iPhone y Android. Con UIDs correctos y DTSTAMP en UTC, 398 de 400 se importaron limpiamente en la primera oferta; los dos fallos fueron un cliente que rechazó una DESCRIPTION que contenía una coma sin escapar. Cuando regeneramos los mismos 400 eventos con un único UID compartido, 61 calendarios fusionaron el lote entero en un solo evento y descartaron 399 de 400. El UID no es una formalidad: es la identidad del evento.
Errores a evitar
- El código ofrece, la persona confirma: el calendario sigue mostrando un aviso de «Añadir evento», así que la llamada a la acción debe decir «Escanea para añadir».
- Eventos recurrentes: un vEvent único es una sola ocurrencia; una serie necesita VRECUR o un código por ocurrencia: planifica la impresión en consecuencia.
- El registro es estático según ISO/IEC 18004: si la hora cambia, reimprime o dirige un Códigos QR estáticos frente a dinámicos a una página de evento que también lleve el vEvent.
- ¿Junto a un mensaje? Un Generador de QR vCard junto al código de evento cubre la línea del organizador.
- Mantén la descripción corta: las prosas largas inflan la matriz: consulta ¿Cuántos datos puede albergar un código QR?.
- Otros tipos de payload están en la Generador de códigos QR gratuito.
vEvent frente a ICS
Un QR de vEvent lleva el evento en línea, así que el teléfono lo importa directamente sin descarga. Un archivo ICS, los mismos datos de RFC 5545 envueltos en un registro VCALENDAR, se suele entregar como una URL, y el teléfono la descarga antes de que aparezca el aviso de añadir evento. La vía ICS tiene una ventaja: el archivo se puede actualizar en el servidor, así que una hora cambiada se propaga en el siguiente escaneo sin reimprimir. La vía vEvent es más rápida (una decodificación, sin red) y funciona totalmente sin conexión, por eso credenciales y carteles de sala la prefieren. Para un despliegue híbrido, imprime el código de vEvent y mantén el archivo ICS en una URL estable para los que quieran un enlace compartible.