Importar datos desde CSV
Carga de una vez tus animales, cultivos, insumos, lotes y vacunas desde un archivo CSV, con vista previa y revisión por fila.
Si ya llevas tu finca en Excel o en un cuaderno, no tienes que escribir todo de nuevo. La importación te deja cargar decenas o cientos de registros en un solo paso, usando un archivo CSV. Es la forma más rápida de arrancar con TerraCore el primer día.
Antes de guardar nada, la app te muestra una vista previa y te marca fila por fila qué está bien y qué hay que corregir. Así no pierdes tiempo ni ensucias tus datos.
Hoy la importación solo acepta archivos CSV. Los archivos de Excel (.xlsx) todavía no se pueden cargar directamente: primero guárdalos como CSV. Además, el plan Semilla no incluye exportar datos a CSV (ver Qué no incluye Semilla).
Necesitas tener tu sede creada para importar: sin sede, la app no te deja importar CSV en ningún módulo. Mira Tu sede es obligatoria.
Quién puede importar y dónde
Solo el rol Administrador puede importar. El botón Importar CSV no aparece para el Operario. Cada módulo tiene su propio botón, en la parte de arriba de su pantalla:
| Módulo | ¿Se puede importar? | Si hay filas con error |
|---|---|---|
| Animales | Sí | Todo o nada: si el servidor encuentra un error, no se guarda ninguna fila |
| Cultivos | Sí | Todo o nada |
| Insumos | Sí | Parcial: se guardan las filas válidas y se reportan las demás |
| Producción | Sí | Parcial |
| Salud Animal (historial de vacunación) | Sí | Todo o nada |
No se importan: movimientos de stock, sedes, usuarios ni Finanzas.
Paso a paso
- Abre el módulo
Entra al módulo donde quieres cargar datos, por ejemplo Animales.
- Toca Importar CSV
Se abre una ventana para elegir el archivo. También puedes arrastrarlo y soltarlo.
- Descarga la plantilla
Toca Descargar plantilla: te baja un archivo de ejemplo con las columnas correctas (por ejemplo
plantilla_animales.csv). Ábrelo, borra las filas de ejemplo y llena las tuyas. Con Ver especificaciones de columnas ves qué acepta cada columna. - Elige tu archivo y revisa la vista previa
La app lee tu archivo y te muestra una tabla de 25 filas por página, con una columna de errores por fila. Activa la casilla Solo errores (con el número entre paréntesis) para ver solo lo que falla.
- Toca Importar N filas
El botón muestra cuántas filas válidas va a enviar, por ejemplo Importar 2 filas. Mientras trabaja dice Importando…. Al terminar verás un aviso, como “2 animales importados”, y los registros aparecen en la lista.
Ventana Importar CSV con vista previa
Ventana de importación en Animales con los botones Descargar plantilla y Ver especificaciones de columnas, la vista previa con algunas filas válidas y una con error marcado, la casilla Solo errores y el botón Importar 2 filas.
Dos cosas importantes de la vista previa:
- El botón Importar N filas envía solo las filas válidas. Las filas con error se quedan por fuera: si las cierras sin corregir, se pierden. Corrige el archivo y vuelve a cargarlo si las necesitas.
- Si el archivo tiene una columna obligatoria que falta, verás “Falta columna” y el nombre, y no podrás importar hasta arreglarlo. Si está vacío verás “El archivo está vacío o sin datos.”
Cómo debe estar el archivo
Casi todos los problemas vienen de aquí. Revisa estos puntos antes de cargar:
| Tema | Qué hacer | Ejemplo |
|---|---|---|
| Separador | Las columnas van separadas por coma. Un archivo con punto y coma no se entiende: todas las columnas aparecen como faltantes. | BOV-001,Lola,Bovino |
| Codificación | Guarda como CSV UTF-8 para que las tildes se vean bien (Avícola, Plátano). | Avícola |
| Fechas | Formato AAAA-MM-DD (año, mes, día con guiones). | 2026-03-21 |
| Decimales | Usa punto como separador decimal y no pongas separador de miles. | 445.5 y no 445,5 ni 1.200 |
| Precios y costos | Escribe el número sin símbolo de pesos ni puntos. | 2500000 y no $ 2.500.000 |
| Mayúsculas | Los textos de lista (Tipo, Salud, Categoría) se escriben exactamente como la app los muestra. | Bovino, no bovino |
| Primera fila | Los nombres de las columnas, tal como están en la plantilla. | ID,Nombre,Tipo,… |
Si trabajas en Excel con configuración de Colombia, “Guardar como” puede crear un CSV separado por punto y coma. Elige CSV UTF-8 (delimitado por comas). Si no la ves, abre el archivo en un editor de texto y reemplaza los ; por ,.
Qué columnas acepta cada módulo
Todos los módulos tienen una columna opcional Sede: escribe el nombre exacto de una sede que ya hayas creado (no importan las mayúsculas). Si no coincide, la fila muestra el error “Columna Sede” con el nombre. Si la dejas vacía, se usa tu sede (ver Sedes).
Animales
Plantilla: plantilla_animales.csv. Es todo o nada.
El código del animal: tres letras del tipo, un guion y un número de tres dígitos. Ejemplo:
BOV-001. El prefijo debe corresponder al Tipo (BOV para Bovino, POR para Porcino, OVI para
Ovino, CAP para Caprino, EQU para Equino, AVI para Avícola, OTR para Otro). No puede repetirse
ni existir ya en tu finca, ni siquiera de un animal eliminado.
Cómo llamas al animal. Ejemplo: Lola.
Bovino, Porcino, Ovino, Caprino, Equino, Avícola u Otro, con la primera letra en mayúscula. Ejemplo: Bovino.
La raza. Ejemplo: Holstein.
Fecha de nacimiento en formato AAAA-MM-DD, que no sea futura. Ejemplo: 2024-03-21.
Peso en kg, con punto decimal. Ejemplo: 445 o 445.5.
Saludable, En tratamiento, Enfermo, Cuarentena o Fallecido. También se acepta En_tratamiento. Ejemplo: Saludable.
Dónde está el animal. Ejemplo: Establo norte.
Precio de adquisición en pesos, número entero sin puntos, comas, decimales ni símbolo. Ejemplo: 2500000.
Notas, Sede.
Cultivos
Plantilla: plantilla_cultivos.csv. Es todo o nada. Acepta los encabezados en español o en inglés, con o sin tildes.
El código del cultivo. Máximo 50 caracteres y no puede repetirse. Ejemplo: PLA-001.
Plátano, Cacao, Maíz, Café u Otro. Se aceptan también sin tilde y en minúscula. Ejemplo: Plátano.
Área sembrada, mayor que 0, con punto y hasta 2 decimales. Ejemplo: 2.50.
Fecha de siembra en formato AAAA-MM-DD, que no sea futura. Ejemplo: 2026-01-15.
Variedad, Estado (Activo, Cosechado, Perdido u Otro; si lo dejas vacío queda Activo), Notas, Sede.
Insumos
Plantilla: plantilla_insumos.csv. Es parcial: se crean las filas válidas y se reportan las que fallan.
El código del insumo con el formato INS-001. Escríbelo siempre y que no se repita.
Ejemplo: Concentrado engorde.
Alimento, Medicamento, Vacuna, Fertilizante, Pesticida, Combustible, Forraje, Semillas, Limpieza, Suplementos u Otro, exactamente así. Ejemplo: Alimento.
Cuánto tienes hoy, con punto decimal. Ejemplo: 100 o 12.5.
La cantidad por debajo de la cual quieres que te avise. Ejemplo: 20.
La unidad de medida. Ejemplo: kg.
A quién se lo compras. Ejemplo: Agroinsumos del Valle.
Fecha de la última compra en AAAA-MM-DD, que no sea futura. Ejemplo: 2026-09-15.
Precio de una unidad, sin símbolo ni separador de miles, mayor que 0. Ejemplo: 15000.
Nota, Sede.
La cantidad que escribes se registra como el inventario inicial de ese insumo.
Producción
Plantilla: plantilla_produccion.csv. Es parcial. Cada fila es un lote de producción. TerraCore genera el código del lote por ti (por ejemplo LCH-2026-05-01-001); si tu archivo trae una columna Lote, se ignora.
El día de la producción en AAAA-MM-DD, que no sea futura. Ejemplo: 2026-05-01.
Leche, Huevos, Cultivo, Carne, Queso, Miel, Lana, Frutas, Hortalizas, Café u Otro. Se aceptan con o sin tilde y en singular o plural. Ejemplo: Leche.
Cuánto produjiste, mayor que 0. Ejemplo: 180.
La unidad de lo producido. Ejemplo: L.
Horas de trabajo dedicadas. Es obligatoria aunque parezca opcional. Ejemplo: 4.5.
Insumos, Responsable, Notas, Sede.
Dos cosas que conviene saber de la importación de Producción:
- La columna Insumos (por ejemplo “Concentrado 44 kg; Sal mineralizada 2 kg”) es solo descriptiva. Importar un lote no descuenta insumos del inventario, a diferencia de registrar el lote a mano.
- El archivo no trae precio de venta ni costo, así que los lotes importados no suman ingresos ni costos en Finanzas.
- En Responsable escribe el nombre o el correo de la persona tal como aparece en Usuarios, o deja la celda vacía.
Salud Animal (historial de vacunación)
Plantilla: plantilla_historiales_sanitarios.csv. Es todo o nada: si una fila falla en el servidor, no se guarda ninguna. Sirve para cargar vacunas ya aplicadas.
El código de un animal que ya esté registrado en tu finca. Ejemplo: BOV-001. Si no existe, la
fila dice “Columna Animal” con el código y que no existe en tu finca.
El nombre de la vacuna o tratamiento. Ejemplo: Aftosa.
Cuándo se aplicó, en AAAA-MM-DD. Ejemplo: 2025-03-14.
La fecha de la próxima dosis o vencimiento, en AAAA-MM-DD. Con ella la vacuna aparece en las alertas y el calendario. Ejemplo: 2026-03-14.
Dosis, Unidad, Resultado (exitoso, reacción o pendiente; vacío queda pendiente), Costo.
Importar historiales no descuenta insumos. Escribe Dosis y Costo con punto decimal (por ejemplo 2.5). El Costo suma al gasto de salud de tus Finanzas del mes de la fecha de aplicación. Una fila repetida (mismo animal, vacuna y fecha) dentro del archivo se marca como duplicada.
Errores por fila: cómo leerlos y corregirlos
La vista previa explica cada problema en la columna de errores. Algunos ejemplos reales:
| Mensaje | Qué hacer |
|---|---|
| “Columna Tipo” con el valor y la lista esperada (Bovino, Porcino…) | Escribe el tipo exactamente como en la lista, con la primera letra en mayúscula. |
| “Columna ID” con “duplicado” | Ese código ya existe o se repite en el archivo. Usa otro. |
| “Columna ID” con “debe ser PREFIJO-NNN” | Usa el formato BOV-001 con el prefijo del tipo. |
| “Fecha debe ser YYYY-MM-DD” o similares | Escribe la fecha como 2026-03-21. |
| “Columna Siembra: no puede ser una fecha futura” | Corrige la fecha: no puede ser posterior a hoy. |
| “Columna Hectareas” con “un número mayor a 0, con punto y hasta 2 decimales” | Escribe 2.5, no 2,5. |
| “Producto” con “no reconocido” | Usa uno de los productos de la lista. |
| “Responsable” con “no coincide con ningún usuario” | Escribe el nombre o correo como está en Usuarios, o deja la celda vacía. |
| “Columna Sede” con “no coincide con ninguna sede” | Escribe el nombre exacto de tu sede, o deja la celda vacía para usar tu sede. |
En Animales, Cultivos y Salud Animal, si el servidor rechaza el archivo, aparece el resumen con los errores por fila y el botón Descargar CSV de errores, que baja un archivo con las columnas Fila, Campo y Razón. El número de fila que muestra el servidor cuenta solo las filas que se enviaron, así que si no coincide con tu archivo, busca por el código del registro.
En Insumos y Producción, si se guardaron unas filas y otras no, el aviso dice, por ejemplo, “5 importados y 2 con error”. Anota las filas con error de la pantalla, corrígelas en tu archivo y cárgalas de nuevo.
Consejos para no fallar
- Empieza con la plantilla. Descárgala siempre desde la ventana de importación y llénala; así las columnas y el orden son los correctos.
- Prueba con pocas filas. Carga 3 o 4 filas, revisa que se vean bien y luego sube el resto.
- No cargues dos veces el mismo archivo. En Animales y Cultivos los códigos repetidos se rechazan. En Insumos, repetir la importación puede crear insumos duplicados.
- Anota el ID. En Animales e Insumos escribe siempre el ID de cada fila.
- Revisa las mayúsculas en Tipo, Salud y Categoría, y evita espacios de más.
- Importa en este orden: primero Animales, después Salud Animal (necesita que los animales ya existan).
- Guarda una copia de tu archivo original: la importación no lo modifica.
Sin conexión
Puedes importar sin internet. Cada fila válida se guarda en tu dispositivo y la app te avisa, por ejemplo, “2 animales guardados en este dispositivo. Se sincronizarán al volver la conexión.” Las filas aparecen marcadas como pendientes y el servidor las revisa una por una al sincronizar (aquí no aplica el todo o nada). Si alguna se rechaza, queda en Cambios rechazados con su motivo (ver Trabajar sin conexión). En Salud Animal, un código de animal que no esté en tu dispositivo hace que se rechace el archivo.
Después de cada importación, TerraCore deja una sola nota en Actividad, “Importación CSV”, con quién la hizo y cuántos registros se crearon.
Si tu cuenta está en solo lectura (prueba terminada o cobro fallido), el botón Importar CSV abre una ventana de Plan requerido o Acceso de solo lectura en lugar de la importación.
Siguientes pasos
- Animales: revisa lo que importaste.
- Sin conexión: cómo se sincronizan los cambios.
- Qué no incluye Semilla: exportar y otras funciones de otros planes.