CSV o API: cuándo conviene cada integración para una flota
Un archivo sirve bien para lotes y conciliaciones; una API, para consultas operativas y automatización continua. La decisión depende de la cadencia, el volumen y la trazabilidad requerida.
Por Marco Ferreiro ·
Elegir entre un CSV y una API no es elegir entre una tecnología vieja y una nueva. Es decidir cómo se moverán los datos, con qué frecuencia y qué debe ocurrir cuando algo sale mal. Un archivo puede resolver muy bien una carga semanal de vehículos. Una API puede ser indispensable si cada alta necesita una respuesta inmediata dentro de otro sistema.
La comparación útil empieza por el proceso, no por el formato preferido del proveedor.
Cuándo un CSV es suficiente
El CSV encaja bien cuando el trabajo sucede por lotes: incorporar una flota inicial, enviar novedades diarias, conciliar resultados o preparar una revisión humana. También ayuda cuando el receptor necesita conservar una entrada completa y volver a procesarla ante un cambio de reglas.
Su aparente sencillez exige un contrato. El RFC 4180 documenta una forma común de representar registros, encabezados y campos entre comillas, incluso cuando contienen comas o saltos de línea. Aun así, reconoce diferencias entre implementaciones. Por eso no alcanza con pedir “un CSV”. Hay que acordar:
- codificación de caracteres y separador;
- nombres, orden y obligatoriedad de columnas;
- representación de valores vacíos y fechas;
- identificador estable de cada vehículo o fila;
- versión del esquema, cantidad de registros y control de integridad;
- canal de entrega, cifrado, retención y respuesta ante rechazos.
Un archivo sin estas reglas suele trasladar el problema al operador: columnas que cambian de nombre, ceros perdidos, filas duplicadas o campos multilínea leídos como registros distintos.
Cuándo una API aporta más valor
Una API conviene cuando la empresa necesita integrar cada operación en tiempo cercano al evento: dar de alta un vehículo, pedir una consulta, recuperar su estado o activar una acción con el resultado. Evita esperar al siguiente lote y permite que el sistema consumidor trate respuestas y errores en forma programática.
OpenAPI define una descripción estándar e independiente del lenguaje para APIs HTTP. Esa descripción puede documentar operaciones, parámetros, cuerpos, respuestas y esquemas. No garantiza por sí sola que el servicio sea confiable, pero reduce ambigüedades y permite validar el contrato con herramientas.
Además del esquema, una integración operativa debe acordar autenticación, límites de uso, paginación, versionado, estados parciales, reintentos e idempotencia. También necesita distinguir “sin resultados” de “la fuente no respondió”. Si esa diferencia queda escondida en un mensaje libre, la automatización puede tomar una decisión incorrecta.
La cadencia define buena parte de la respuesta
Hay cuatro preguntas que suelen ordenar la elección:
- ¿Cuándo se necesita el resultado? Si puede llegar en una conciliación nocturna, el archivo puede alcanzar. Si bloquea una tarea que ocurre ahora, la API gana peso.
- ¿Cómo llega el volumen? Miles de altas juntas favorecen un lote; consultas distribuidas durante el día favorecen una interfaz transaccional.
- ¿Qué se reprocesa? Un archivo versionado facilita repetir un conjunto completo. Una API necesita claves estables para repetir una petición sin duplicar efectos.
- ¿Quién atiende las excepciones? El diseño debe decir cómo se corrigen filas inválidas o respuestas fallidas y quién conserva la trazabilidad.
El portal oficial de Series de Tiempo muestra que ambos modelos pueden convivir: permite extraer datos en CSV e integrar respuestas JSON en aplicaciones. No son canales incompatibles; sirven a usos diferentes.
Un esquema híbrido suele ser práctico
Una flota puede comenzar con un CSV para la carga inicial y usar una API para cambios posteriores. También puede consultar por API durante el mes y recibir un archivo de conciliación al cierre. El archivo funciona como fotografía controlada; la API, como canal de operación.
Para que el híbrido no cree dos verdades, ambos caminos deben compartir identificadores y definiciones. La misma patente normalizada, el mismo estado de cobertura y la misma semántica para fechas y ausencias. Cada registro debería indicar su procedencia y momento de observación, de modo que una conciliación pueda explicar una diferencia sin sobrescribir silenciosamente datos más nuevos.
Probá el flujo antes de escalarlo
Un piloto representativo revela más que una comparación abstracta. Incluí filas correctas, duplicadas, incompletas y con caracteres especiales; en la API, probá respuestas parciales, demoras y reintentos. Medí tiempo total, intervenciones manuales, errores recuperables y capacidad de reconstruir qué ocurrió.
La privacidad también vale para ambos canales. La Ley 25.326 exige que los datos personales tratados sean adecuados, pertinentes, no excesivos y mantenidos con la calidad necesaria. Un CSV no debería transportar columnas “por las dudas”, y una API no debería exponer campos que el consumidor no necesita. Definí acceso, retención y eliminación antes de pasar a producción.
Regla de decisión
Usá CSV cuando el proceso sea deliberadamente masivo, periódico y tolerante a demoras. Usá API cuando necesites interacción continua, estados consultables y automatización por operación. Si el negocio requiere las dos cosas, diseñá un esquema híbrido con una sola semántica y trazabilidad compartida.
La mejor integración no es la que tiene más tecnología. Es la que permite saber qué se envió, qué respondió, qué falta y cómo corregirlo sin improvisar.
Metodología
- Alcance
- Comparación operativa entre intercambio tabular por archivos y consultas HTTP para procesos empresariales vinculados con vehículos e infracciones.
- Unidad de análisis
- Un flujo de integración, evaluado por volumen, frecuencia, latencia aceptable, trazabilidad, reproceso y necesidad de automatización.
- Cobertura
- Estándares técnicos y pautas oficiales consultados el 13 de agosto de 2026; la elección concreta también depende del contrato y la capacidad operativa de cada empresa.
Limitaciones
- No fija límites de volumen ni tiempos de respuesta universales para todos los proveedores.
- No reemplaza una evaluación de seguridad, privacidad y continuidad sobre los sistemas concretos que intercambiarán datos.
Fuentes
- RFC 4180: Common Format and MIME Type for CSV Files — RFC Editor (consultada el )
- OpenAPI Specification v3.2.0 — OpenAPI Initiative (consultada el )
- Resolución 19/2018 — Pautas Técnicas de Interoperabilidad de Sistemas — Argentina.gob.ar (consultada el )
- API de Series de Tiempo de la Administración Pública Nacional — Dirección de Datos Abiertos (consultada el )
- Ley 25.326 de Protección de los Datos Personales — Argentina.gob.ar (consultada el )
Preguntas frecuentes
¿Una API siempre es mejor que importar un CSV?
No. Si el proceso es periódico, por lotes y tolera demora, un CSV bien definido puede ser más simple de operar y reprocesar. La API aporta más valor cuando la respuesta debe entrar al flujo en forma continua.
¿Se pueden usar CSV y API en la misma integración?
Sí. Un diseño híbrido puede usar archivos para una carga inicial, conciliaciones o exportaciones masivas, y una API para altas, cambios y consultas operativas posteriores.
¿Qué debe documentarse antes de intercambiar datos de una flota?
Como mínimo, campos, identificadores, formatos de fecha, significado de vacíos, versión, cobertura, errores, seguridad, retención y responsable de cada corrección.
Notas relacionadas
Timeout no significa “sin multas”: cómo informar resultados parciales en una integración
Cuando una fuente no responde, el resultado es parcial o indeterminado, nunca cero. Un contrato explícito permite reintentar, alertar y decidir sin producir falsos negativos.
Cómo definimos una consulta completa antes de publicar estadísticas de multas.ar
Antes de convertir consultas operativas en porcentajes o rankings, exigimos cobertura identificable, respuestas comparables y controles que separen un resultado válido de un fallo técnico.
Polling de consultas sin saturar la API: Retry-After, ETag y espera con jitter
Consultar el estado cada segundo no hace que una búsqueda termine antes. Un contrato con Retry-After, ETag y una espera aleatoria reduce solicitudes repetidas, bytes y picos de clientes sincronizados.