Convertidor online gratuito de XML a VCARD

Un teléfono, cliente de correo electrónico o aplicación de agenda puede requerir contactos en formato vCard (.vcf) en lugar de una exportación XML específica de una aplicación. Convertir el archivo facilita importar, compartir, editar y transferir contactos entre dispositivos y programas compatibles.

Qué es XML

XML es un formato de texto basado en etiquetas para almacenar e intercambiar datos jerárquicos. Los archivos XML de contactos pueden ser generados por sistemas CRM, clientes de correo electrónico, agendas, servicios web, copias de seguridad de dispositivos y bases de datos personalizadas.

XML no tiene un esquema universal para contactos. Un archivo puede usar <contact>, <firstName> y <phone>; otro puede usar <person>, <given> y <telephoneNumber>. Antes de la conversión, identifica el elemento de contacto que se repite y los campos que contienen nombres, direcciones de correo electrónico, números de teléfono, organizaciones, direcciones postales, notas e identificadores. Los espacios de nombres y los elementos anidados también pueden afectar a la detección de campos.

Qué es el formato vCard

vCard es un formato de texto plano estandarizado para registros de contactos, normalmente guardado con la extensión .vcf. Un archivo puede contener uno o varios contactos y puede ser importado por teléfonos, clientes de correo electrónico, agendas, sistemas CRM y gestores de contactos de escritorio.

Cada registro comienza con BEGIN:VCARD y termina con END:VCARD. Entre las propiedades comunes se incluyen FN para el nombre mostrado, N para los componentes estructurados del nombre, TEL, EMAIL, ORG, ADR, NOTE y UID. vCard 3.0 suele ser la opción más segura por compatibilidad; vCard 4.0 admite funciones más recientes, pero puede no importarse correctamente en teléfonos y aplicaciones antiguos.

Cómo convertir XML a vCard

Para una exportación de contactos convencional, utiliza el conversor de 101convert.com: carga el archivo XML, elige VCARD como formato de salida, inicia la conversión y descarga el archivo .vcf resultante. No es necesario instalar ningún software. Revisa el resultado antes de importarlo cuando el XML proceda de una aplicación propietaria.

Si la detección automática de campos falla, utiliza un editor XML, un programa de transformación de datos o un script personalizado:

1. Abre el XML y localiza el elemento que se repite una vez por cada contacto.
2. Asigna los campos de origen a las propiedades de vCard: el nombre mostrado a FN, los nombres y apellidos a N, los números de teléfono a TEL, las direcciones de correo electrónico a EMAIL, la empresa a ORG y los componentes de la dirección postal a ADR.
3. Elige vCard 3.0, a menos que la aplicación receptora admita explícitamente vCard 4.0.
4. Genera un bloque completo de vCard por cada contacto y guarda todos los bloques como un archivo UTF-8, por ejemplo contacts.vcf.
5. Importa el archivo mediante el menú de contactos de la aplicación de destino, normalmente Contacts → Import o File → Import.

Un registro vCard 3.0 mínimo es:

BEGIN:VCARD
VERSION:3.0
N:Doe;Jane;;;
FN:Jane Doe
TEL;TYPE=CELL:+1-202-555-0147
EMAIL:jane.doe@example.com
ORG:Example Ltd
END:VCARD

Para conversiones repetibles, la biblioteca estándar de Python puede analizar una estructura XML sencilla y generar vCards. Cambia los nombres y las rutas de los elementos para que coincidan con el origen:

import xml.etree.ElementTree as ET

def esc(value):
    return (value or "").replace("\\", "\\\\").replace(";", "\\;") \
        .replace(",", "\\,").replace("\r", "").replace("\n", "\\n")

root = ET.parse("contacts.xml").getroot()
blocks = []
for contact in root.findall(".//contact"):
    first = contact.findtext("firstName", "")
    last = contact.findtext("lastName", "")
    full = (first + " " + last).strip()
    name = ";".join((esc(last), esc(first), "", "", ""))
    lines = [
        "BEGIN:VCARD", "VERSION:3.0", f"N:{name}",
        f"FN:{esc(full)}"
    ]
    phone = contact.findtext("phone", "")
    email = contact.findtext("email", "")
    if phone:
        lines.append(f"TEL:{esc(phone)}")
    if email:
        lines.append(f"EMAIL:{esc(email)}")
    lines.append("END:VCARD")
    blocks.append("\r\n".join(lines))

with open("contacts.vcf", "w", encoding="utf-8", newline="") as output:
    output.write("\r\n".join(blocks) + "\r\n")

Ejecútalo con python convert_contacts.py. Un script de producción debe gestionar los espacios de nombres XML, los valores ausentes, varios elementos de teléfono y correo electrónico, el plegado de líneas de vCard para líneas largas y el escape específico de cada propiedad. También debe asignar parámetros TYPE adecuados únicamente cuando el XML identifique un número como móvil, laboral, particular o fax.

Limitaciones de calidad y compatibilidad

La calidad de la conversión depende del esquema XML, no de su extensión de archivo. Un conversor no puede inferir de forma fiable el significado de un número sin etiqueta, y los campos propietarios pueden no tener un equivalente en vCard. Las fotos, los grupos, los campos personalizados, los permisos, los registros vinculados, varias direcciones y los datos de relaciones pueden descartarse o transformarse.

Conserva el XML original como copia de seguridad. Prueba una muestra pequeña antes de convertir una agenda grande y, después de la importación, comprueba los nombres, la codificación de caracteres, las etiquetas de los teléfonos, los registros duplicados, el texto no latino y los saltos de línea. Volver a importar el mismo archivo .vcf puede crear duplicados, y algunas aplicaciones solo admiten un subconjunto de las propiedades de vCard 3.0 o 4.0.