Formato de intercambio de datos · Guía documental con recurso original

CSV o JSON: qué formato elegir para intercambiar contactos sin perder campos

Contenido actualizado:

Alcance: Guía documental. Los recursos y ensayos propuestos son originales; no presentan resultados de una prueba realizada por CallsIQ.

Respuesta breve

CSV encaja con tablas de columnas estables; JSON permite objetos y listas con estructura explícita. Elige lo que admita el destino y define tipos, valores ausentes, codificación e identificadores. Guarda teléfonos como texto y comprueba una lectura de ida y vuelta con datos ficticios antes de importar contactos reales.

Comprobación clave: Lee de nuevo la muestra transformada y compara identificadores, teléfonos, caracteres, campos ausentes y listas con el original.

Fuentes y límites de esta guía

La extensión de un archivo no garantiza que otra aplicación entienda sus datos. CSV y JSON pueden representar un contacto, pero requieren acuerdos diferentes sobre columnas, tipos y estructura. Elige según el contrato del destino, no porque un formato parezca más moderno.

Qué cambia entre CSV y JSON

CSV organiza filas y campos. El RFC 4180 documenta un formato común con comas y reglas de comillas; existen variantes que debes confirmar. JSON permite objetos, listas y valores tipados. La referencia de JSON de MDN explica su sintaxis.

CSV no incorpora por sí solo una declaración de tipos por columna. JSON distingue números, texto, booleanos y null, pero tampoco define qué significa una clave para tu negocio. Ambos necesitan especificación.

La misma muestra ficticia en ambos formatos

contact_id,name,phone
demo-01,Demo,+34900000000
{"contact_id":"demo-01","name":"Demo","phone":"+34900000000"}

Los identificadores y valores son ficticios; el teléfono no debe utilizarse para llamar. En JSON el teléfono es una cadena. En CSV exige al lector tratar esa columna como texto. Una hoja de cálculo que transforma el signo inicial o los ceros puede alterar el dato antes de que llegue a la integración.

Matriz original para elegir

CSV o JSON para intercambiar contactos: tabla 1
NecesidadCSVJSON
Tabla estable para revisiónLectura sencilla por filasPosible, con otro visor
Varios teléfonos por contactoRequiere convención o tabla relacionadaPuede usar una lista
Valor ausente y texto vacíoNecesita regla acordadaPuede distinguir null y cadena vacía
Destino existenteSolo si admite ese contratoSolo si admite ese contrato

Que JSON pueda incluir una lista no significa que la API receptora la acepte. Confirma nombres, obligatoriedad y comportamiento de los campos adicionales. Una transformación que aplana una lista puede perder relaciones aunque no produzca error.

Contrato mínimo antes de transformar

Documenta codificación, delimitador cuando corresponda, nombres de campos, tipos, identificador estable y formato de fechas. Decide qué significa un campo ausente frente a uno vacío: dejar sin cambios y borrar un valor son acciones diferentes que dependen del destino.

Incluye muestras con acentos, comas dentro del nombre, teléfono vacío y varios valores relacionados. Utiliza lectores y generadores de formato, no sustituciones manuales de caracteres. No ejecutes como instrucciones el contenido procedente de un campo.

Cómo comprobarlo en Make

Make documenta estructuras de datos para analizar y serializar formatos. Una estructura generada desde una muestra necesita revisión: un registro sin teléfono no demuestra que todos carezcan de ese campo, y una sola etiqueta no describe una lista completa.

Prepara un escenario de ensayo sin envíos a producción. Lee la muestra, transforma, genera la salida y vuelve a leerla. Compara valores y número de contactos, incluyendo casos límite. Si un dato desaparece, corrige el contrato o el mapeo antes de activar el destino.

Make puede encajar para esa transformación entre aplicaciones; no es necesario para decidir el formato. CallsIQ no ha ejecutado este escenario en una cuenta. Los ejemplos y la matriz son recursos reproducibles de lectura, no resultados de una importación real.

Fuentes y límites de esta guía

Revisión documental: . Tipo de contenido: Guía documental con recurso original.

Las fuentes describen condiciones y funciones declaradas por sus responsables. Los protocolos propuestos y los ejemplos ficticios no acreditan pruebas de producto realizadas por CallsIQ.

Cómo comunicar una corrección

Consulta las condiciones actuales

Valora estas opciones si resuelven el problema descrito. Confirma funciones, límites y contratación en tu país.

MakeEnlace de afiliación

Los enlaces comerciales identificados pueden generar una comisión o recompensa por referido para CallsIQ. Nuestra política comercial.

Cómo se ha preparado esta guía

Fuentes oficiales, cálculos explicados y ejemplos identificados. Consulta la metodología y el uso de IA en la redacción.