CodeBox Hub
GRATIS

Código QR para eventos: campos de vEvent y errores de calendario

Añade un evento al calendario del teléfono con el formato vEvent: tabla de campos, errores de UID/DURATION y un tutorial de 3 pasos.

# 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

CampoSintaxisObligatorioEjemploNotas
VersiónVERSION:2.0SíVERSION:2.0Línea vCalendar 2.0
UIDUID:unique@hostSíUID:conf-42@codeboxhub.comDebe ser único por evento
DTSTAMPDTSTAMP:20260801T090000ZSíDTSTAMP:20260801T090000ZHora de creación, UTC
SUMMARYSUMMARY:KeynoteNoSUMMARY:KeynoteEl título que muestra el calendario
DTSTARTDTSTART;TZID=...:…No*DTSTART:20260801T090000*La mayoría de los teléfonos la exige
DTENDDTEND:…NoDTEND:20260801T103000Día completo: omítela, usa VALUE=DATE
LOCATIONLOCATION:Hall BNoLOCATION:Hall B, CenterTexto plano, sin geocodificación
DESCRIPTIONDESCRIPTION:Agenda insideNoDESCRIPTION:Agenda insideSaltos de línea escapados como \n
URLURL:https://…NoURL:https://conf.example/Página asociada o registro
STATUSSTATUS:CONFIRMEDNoSTATUS:CONFIRMEDTENTATIVE / CANCELLED también válidos

Errores habituales de vEvent

ErrorQué pasaSolución
UID duplicado entre eventosLos calendarios tratan las actualizaciones como un solo eventoHaz el UID único por evento
DTSTART sin DTEND en un evento con horaAlgunos clientes muestran un evento de duración ceroDefine ambos, incluso para 15 minutos
Evento de día completo con hora en DTSTARTEl calendario muestra 00:00, no día completoUsa VALUE=DATE y campos solo de fecha
Zonas horarias mezcladas en un eventoLa importación falla en iOS o AndroidUna sola zona, o todo en UTC
Comas y saltos de línea sin escapar en DESCRIPTIONLos campos se dividen a mitad del textoEscápalos como \, y \n
DTSTAMP ausenteLos importadores estrictos rechazan el registroInclúyela siempre, en UTC
UID con espacios o puntuaciónLos importadores estrictos rechazan el registroUsa solo alfanuméricos, guiones y puntos
DTSTART en el pasadoLos clientes pueden importarlo como expirado o rechazarloRecodifica 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

  1. Rellena título, fecha, hora, lugar y notas en el generador de QR de eventos.
  2. Exporta en PNG o SVG; el payload se queda por debajo de ~250 bytes para una sesión típica.
  3. 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.

FAQ

¿Qué hace un código QR de eventos?

Ofrece añadir un evento de calendario, título, hora, lugar y notas, al calendario del teléfono.

¿Qué formato usa un código QR de eventos?

vEvent, la familia vCalendar definida por RFC 5545: los mismos datos que los teléfonos importan de los enlaces de «Añadir evento».

¿Puede un código QR de eventos ser de día completo?

Sí. Usa un DTSTART solo de fecha con VALUE=DATE y omite la hora; nunca mezcles una hora en un campo de día completo.

¿Puede un código QR crear un evento recurrente?

Un vEvent único es una sola ocurrencia; la recurrencia necesita VRECUR o un código aparte por ocurrencia.

¿Los códigos QR de eventos funcionan en iPhone y Android?

Sí. Ambos calendarios importan vEvent de forma nativa y muestran el aviso estándar de añadir evento.

¿Por qué algunos calendarios fusionan mis eventos?

UIDs compartidos. Cada evento necesita su propio UID único, o el cliente los trata como uno solo.

¿En qué se diferencia un QR de eventos de un QR de contacto?

Un vEvent añade una cita con bloque de tiempo; una vCard añade una persona a la agenda.

Sigue leyendo

Contáctanos