CodeBox Hub
GRATIS

Código QR para contactos: campos de vCard y errores de formato

Codifica un contacto con el formato vCard 3.0: tabla de campos, errores habituales de FN/TEL/N y un tutorial de 3 pasos.

# 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

CampoSintaxis v3.0ObligatorioEjemploNotas
VersiónVERSION:3.0SíVERSION:3.0Primera línea después de BEGIN
NombreN:Family;Given;;;SíN:Chen;Wei;;;Apellido primero, luego nombre
Nombre de visualizaciónFN:Wei ChenNoFN:Wei ChenLo que muestra la app de contactos
TeléfonoTEL;TYPE=CELL:+86…NoTEL;TYPE=CELL:+861****1234Una línea por número
Correo electrónicoEMAIL:hi@x.comNoEMAIL:hi@codeboxhub.comPermitidas varias líneas
OrganizaciónORG:CompanyNoORG:CodeBoxParámetro de tipo opcional
CargoTITLE:EngineerNoTITLE:Staff EngineerCargo, no la empresa
DirecciónADR;TYPE=WORK:…NoADR;TYPE=WORK:;;1 Main St;City;ST;100000;CNOrden fijo de campos
FotoPHOTO;ENCODING=BASE64:…Nobloque base64Infla la matriz enormemente
URLURL;TYPE=WORK:https://…NoURL:https://codeboxhub.comPágina principal de la empresa
NotaNOTE:…NoNOTE:Call before 18:00Texto libre; el importador salma las líneas

Errores habituales de vCard

ErrorQué pasaSolución
v4.0 en un Android antiguoEl importado falla o se pierden camposQuédate en VERSION:3.0
Orden del campo N: invertidoEl nombre propio cae en la casilla de apellidoN: es Family;Given;; no lo inviertas
FN ausenteEl contacto se guarda con un nombre de visualización crudo y feoDefine siempre un FN legible
Se incluye una foto base64El payload pasa de 2 KB; sufre la corrección de erroresOmite la foto; compártela por separado
Longitud de línea superior a 75 octetosAlgunos importadores trocean o corrompen el registroCampos cortos; que la herramienta salme
Varias líneas TEL con el mismo tipoEl marcador muestra una entrada y oculta las demásUsa 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

  1. Rellena nombre, teléfono, correo y empresa en el generador de QR de contacto.
  2. Exporta en PNG o SVG; sin foto, el payload se queda por debajo de ~300 bytes.
  3. 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

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.

FAQ

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

Abre el aviso «Añadir contacto» con una vCard completa —nombre, números, correo, empresa— lista para guardar.

¿Debo usar vCard 3.0 o 4.0?

3.0 (RFC 2426). Se importa sin problemas en todos los teléfonos importantes; v4.0 falla en algunos marcadores de Android antiguos.

¿Puede un código QR de contacto incluir una foto?

Técnicamente sí, mediante un campo PHOTO base64, pero infla la matriz tanto que las impresiones pequeñas fallan; omítelo.

¿Cómo añado dos números de teléfono a una vCard?

Escribe dos líneas TEL con tipos distintos, por ejemplo `TEL;TYPE=CELL` y `TEL;TYPE=WORK`.

¿Los códigos QR de contacto funcionan en Android?

Sí. Android trata la vCard como una importación de contacto y muestra el flujo estándar de añadir contacto.

¿Cuál es la diferencia entre los campos N: y FN:?

N: es el nombre/apellido estructurado que se usa para ordenar; FN: es el nombre de visualización que muestra la app de contactos.

¿Un código QR de contacto es lo mismo que un código QR de tarjeta de visita?

Por lo general, sí: el payload por defecto de una tarjeta de visita es una vCard; la diferencia es solo lo que imprimes alrededor.

Sigue leyendo

Contáctanos