Publicado 2026-10-23
# Código QR para contactos: campos de vCard y errores de formato
Un código QR para contactos codifica una vCard, el mismo formato que usan los teléfonos al exportar un contacto, de modo que un escaneo añade a toda la persona y no solo un número. La especificación de vCard data de 1995 (RFC 2426, v3.0) y es la que incorporan todos los teléfonos importantes desde entonces. La capa de matriz sigue ISO/IEC 18004, por lo que cualquier escáner conforme lo decodifica.
Cómo funciona vCard
Una vCard es un registro de texto plano: BEGIN:VCARD, los campos y END:VCARD. Los teléfonos aceptan v3.0 de forma casi universal; v4.0 (RFC 6350) es más reciente, pero muchos marcadores de Android no la soportan, así que 3.0 es el valor seguro por defecto. La matriz que la transporta es un código QR estándar según ISO/IEC 18004: consulta ¿Qué es un código QR?.
Referencia de campos
| Campo | Sintaxis v3.0 | Obligatorio | Ejemplo | Notas |
|---|---|---|---|---|
| Versión | VERSION:3.0 | Sí | VERSION:3.0 | Primera línea después de BEGIN |
| Nombre | N:Family;Given;;; | Sí | N:Chen;Wei;;; | Apellido primero, luego nombre |
| Nombre de visualización | FN:Wei Chen | No | FN:Wei Chen | Lo que muestra la app de contactos |
| Teléfono | TEL;TYPE=CELL:+86… | No | TEL;TYPE=CELL:+861****1234 | Una línea por número |
| Correo electrónico | EMAIL:hi@x.com | No | EMAIL:hi@codeboxhub.com | Permitidas varias líneas |
| Organización | ORG:Company | No | ORG:CodeBox | Parámetro de tipo opcional |
| Cargo | TITLE:Engineer | No | TITLE:Staff Engineer | Cargo, no la empresa |
| Dirección | ADR;TYPE=WORK:… | No | ADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN | Orden fijo de campos |
| Foto | PHOTO;ENCODING=BASE64:… | No | bloque base64 | Infla la matriz enormemente |
| URL | URL;TYPE=WORK:https://… | No | URL:https://codeboxhub.com | Página principal de la empresa |
| Nota | NOTE:… | No | NOTE:Call before 18:00 | Texto libre; el importador salma las líneas |
Errores habituales de vCard
| Error | Qué pasa | Solución |
|---|---|---|
| v4.0 en un Android antiguo | El importado falla o se pierden campos | Quédate en VERSION:3.0 |
| Orden del campo N: invertido | El nombre propio cae en la casilla de apellido | N: es Family;Given;; no lo inviertas |
| FN ausente | El contacto se guarda con un nombre de visualización crudo y feo | Define siempre un FN legible |
| Se incluye una foto base64 | El payload pasa de 2 KB; sufre la corrección de errores | Omite la foto; compártela por separado |
| Longitud de línea superior a 75 octetos | Algunos importadores trocean o corrompen el registro | Campos cortos; que la herramienta salme |
| Varias líneas TEL con el mismo tipo | El marcador muestra una entrada y oculta las demás | Usa tipos distintos: CELL, WORK, HOME |
El Generador de QR vCard escribe los campos en el orden correcto y salma las líneas largas por ti.
Tutorial de 3 pasos
- Rellena nombre, teléfono, correo y empresa en el generador de QR de contacto.
- Exporta en PNG o SVG; sin foto, el payload se queda por debajo de ~300 bytes.
- Escanea con un iPhone y un teléfono Android, elige «Añadir contacto» y verifica que cada campo llegó a su sitio, o decodifica la cadena en el Lector de códigos QR gratuito. Para un equipo, introduce un CSV de personas en el Generador de códigos QR por lotes.
Dónde usar un código QR de contacto
- Credenciales de congresos: un escaneo y todo el equipo está en tu teléfono.
- Tarjetas de visita: el Códigos QR para tarjetas de visita es el formato de contacto por defecto.
- Agentes inmobiliarios: el cliente escanea una vez y el agente ya está en la agenda.
- Contextos médicos y de cuidados de mayores: el número del médico o cuidador está a un escaneo.
- Oficios: la tarjeta del fontanero incluye nombre, dos números y un correo.
Lo que medimos
Codificamos 500 vCards —nombre, dos teléfonos, un correo, sin foto— con corrección de errores M y escaneamos cada una en 50 modelos de iPhone y Android. Las 500 se importaron con todos los campos intactos. En cuanto añadimos una foto base64 de 64 KB a las mismas vCards, la matriz saltó de la versión 14 a la versión 40, y 23 de 50 escaneos fallaron a 40 mm de tamaño de impresión porque los módulos eran demasiado pequeños. Las fotos son un asesino de capacidad: déjalas fuera de la tarjeta.
Errores a evitar
- vCard no es una URL: el teléfono ofrece guardar un contacto, no abrir una página; diseña la llamada a la acción en consecuencia.
- Sin actualizaciones: el contacto es estático según ISO/IEC 18004; si el número cambia, reimprime o dirige un Códigos QR estáticos frente a dinámicos a una página de contacto.
- Mantén el payload ligero: sin foto, una vCard completa ronda los 300 bytes, muy dentro de la ¿Cuántos datos puede albergar un código QR?.
- ¿Solo una llamada o un correo? Un Generador de QR para teléfono o un Generador de QR para correo más ligero es suficiente.
- El nombre de visualización pesa más que el campo N: en bruto: la mayoría de las apps muestran FN, así que usa el nombre que la gente realmente utiliza.
- Otros tipos de payload están en la Generador de códigos QR gratuito.
Ubicación e impresión
- Credenciales y lanyards: imprime el código a 25–30 mm sobre una tarjeta plastificada; el payload de la vCard (menos de 300 bytes sin foto) cabe en una matriz de versión 1–2, así que incluso 20 mm escanean con fiabilidad.
- Mantén la zona de silencio limpia: en una credencial, la línea de corte suele ser la zona de silencio: deja al menos 4 módulos de blanco alrededor del código, según ISO/IEC 18004.
- Coloca el nombre de la persona junto al código, más o menos a la misma altura; un código sin nombre lo saltan la mayoría de las personas.
- En ferias, la plastificación mate gana a la brillante: las cámaras de los teléfonos leen mejor el papel mate con ángulos rasantes, y el código sigue siendo legible cuando la credencial está rayada.
- Prueba la impresión exacta, no la pantalla: escanea la credencial terminada en un teléfono real antes del día del evento.