Tervix
es

Apariencia

Perfil local

Sin nombre

Solo en este navegador

Gestionar perfil
Abrir menú de navegación
Datos y desarrollo

Cómo preparar datos CSV antes de convertirlos a JSON

Limpia encabezados, delimitadores, valores, codificación y campos anidados antes de transformar CSV tabular en JSON confiable.

Por el equipo editorial de Tervix11 min de lectura

Tervix · practical guide

Decide qué significa cada columna y qué tipo JSON tendrá antes de convertir. Una transformación válida sintácticamente todavía puede producir datos incorrectos.

CSV parece sencillo, pero los archivos reales contienen delimitadores ambiguos, encabezados duplicados, saltos dentro de campos, fechas inconsistentes y valores que solo parecen números. La conversión debe comenzar con un contrato de datos.

1. Identifica dialecto y codificación

RFC 4180 documenta un formato común con comas, campos entre comillas y comillas duplicadas, pero también se usan punto y coma o tabulaciones. Confirma delimitador, encabezados y codificación.

Una coma o salto dentro de un campo citado es parte del dato. No dividas manualmente; usa un analizador que comprenda las comillas. UTF-8 ofrece buena interoperabilidad con JSON.

2. Crea nombres de campo estables

Los encabezados serán claves: deben existir, ser únicos y significativos. Elimina espacios invisibles y elige una convención. No sobrescribas silenciosamente columnas duplicadas.

Conserva un mapa desde el encabezado original cuando necesites trazabilidad y documenta unidades o monedas.

3. Declara tipos en vez de adivinarlos

CSV almacena texto. Identificadores como 00123 deben seguir como cadenas; fechas como 03/04/2026 son ambiguas y enteros enormes pueden perder precisión.

Define tipo, obligatoriedad, formato de fecha y valores permitidos. JSON admite cadenas, números, booleanos, null, arrays y objetos.

Contrato mínimo

  • cliente_id: string, obligatorio
  • activo: boolean
  • fecha: string, YYYY-MM-DD
  • saldo: number

4. Trata vacíos y errores explícitamente

Una celda vacía puede significar desconocido, no aplicable, vacío intencional o cero. Decide entre omitir la propiedad, null o cadena vacía.

Valida cantidad de columnas, obligatorios, rangos y categorías. Informa fila y columna en lugar de descartar registros.

5. Diseña el JSON anidado

Columnas como direccion.ciudad pueden convertirse en objetos, pero esa convención no pertenece a CSV. Documéntala y rechaza colisiones ambiguas.

Para relaciones uno-a-muchos suele ser mejor otra tabla; si una celda contiene listas o JSON, define y valida el formato.

6. Valida y reconcilia

Vuelve a analizar el JSON, valida su esquema, compara el total de registros y prueba filas con comillas, tildes, vacíos y cifras grandes.

Conserva la fuente y la configuración para repetir y auditar la transformación.

Lista de comprobación

  • Confirmar codificación y delimitador.
  • Usar analizador con comillas.
  • Normalizar encabezados únicos.
  • Declarar tipos.
  • Definir valores ausentes.
  • Reportar filas inválidas.
  • Validar JSON y totales.

Abrir el conversor de CSV a JSON

Detecta delimitadores, configura inferencia y procesa datos compatibles localmente.

Abrir herramienta

Fuentes y revisión

Revisado el 29 de julio de 2026 con RFC 4180 y el estándar de Internet de JSON. Cada proyecto debe definir dialecto y esquema.

Aplicación responsable

Ejemplo, usos y límites de esta guía

Ejemplo aplicado

Situación
Convierte customer_id 00123, active true y joined_on 2026-08-20.
Resultado
Un esquema conserva 00123 como texto, convierte true en booleano y mantiene la fecha ISO.
Cómo interpretarlo
La inferencia podría transformar el identificador en 123; analizar el archivo no prueba que los datos sean correctos.

Casos de uso

  • Preparar datos para una API.
  • Normalizar exportaciones antes de importar.
  • Documentar una migración repetible.

Limitaciones

  • !CSV tiene varios dialectos.
  • !Las estructuras anidadas requieren mapeo.
  • !Los datos sensibles necesitan controles.