Animales

Aquí llevas el registro de cada animal de tu finca. Sirve para saber cuántos tienes, de qué tipo y raza, cómo están de salud, dónde están y cuánto te costaron. Es la base de otros módulos: las vacunas de Salud Animal se registran sobre un animal, y el Panel Central y Finanzas usan sus datos para calcular cifras.

Animales aparece en el menú lateral, en el grupo Inventario. Si tu operación es de tipo Agrícola, este módulo no se muestra (más abajo explicamos cómo cambiarlo).

Qué ves en la pantalla Animales

Al entrar ves el título Animales y la frase “Registro y seguimiento del ganado de tu finca.” Arriba a la derecha están los botones de acción y debajo todo lo que usas a diario.

Captura pendiente

Lista de animales

Pantalla Animales completa en escritorio: título, botones Importar CSV y Nuevo animal, tarjetas de resumen, caja de búsqueda, chips de estado de salud con contadores y tabla con al menos 5 animales de distintos tipos y estados.

Botones de la cabecera

En el celular, Nuevo animal es un botón flotante en la esquina de la pantalla y cada animal se muestra como una tarjeta con sus botones Editar y Eliminar (según tu rol).

Tarjetas de resumen

Encima de la tabla hay tarjetas que se actualizan solas con lo que registras:

• Total de animales.
• Animales por tipo (Bovino, Porcino, etc.).
• Animales por estado de salud.
• Refuerzos próximos 30 días: cuántas vacunas tienen su próxima dosis cerca. Para decidir qué hacer con una vacuna, usa siempre las cifras de Salud Animal, que son las de referencia.

En escritorio puedes colapsar las tarjetas. En el celular ves tres fichas: Total, Con alertas y Refuerzos.

La tabla

En escritorio la tabla tiene estas columnas: ID, Nombre, Tipo, Raza, Nacimiento, Peso, Precio adq., Salud, Ubicación, Sede, Notas y Acciones. El Administrador además ve una casilla de selección al inicio de cada fila.

La tabla se pagina de 10, 25, 50 o 100 filas por página (por defecto 25). La columna Sede muestra la sede donde quedó cada animal.

Cuando todavía no hay animales verás “Sin animales registrados” y el texto “Agrega tu primer animal para comenzar.” con el botón Nuevo animal.

Qué datos guardas de cada animal

Datos del animalLo que debes completar en cada ficha

ID (código)Obligatorio

Es la identificación única del animal dentro de tu finca, como la marca o el número de arete. Ejemplos: BOV-001 para la primera vaca, POR-014 para el cerdo número 14. No se repite, tiene máximo 50 caracteres y TerraCore lo propone según el tipo: no lo escribes a mano en el formulario.

NombreObligatorio

El nombre con el que tu equipo reconoce al animal, para encontrarlo rápido en la lista. Ejemplos: Lola, Manchas, Lote 3 de engorde. Máximo 255 caracteres.

TipoObligatorio

La especie del animal: Bovino, Porcino, Ovino, Caprino, Equino, Avícola u Otro. Define el prefijo del código y la lista de razas. Lo eliges al crear (por ejemplo Bovino) y después no se puede cambiar; si te equivocas, registra el animal de nuevo con el tipo correcto.

RazaObligatorio

Se elige de una lista que depende del tipo (ver tabla más abajo). Ejemplos: Holstein para un bovino lechero, Duroc para un porcino, Paso Fino Colombiano para un equino.

Peso (kg)Obligatorio

El peso actual, en kilogramos y con hasta dos decimales. Ejemplos: 445 kg, 120,5 kg. El máximo es 99.999,99 kg y no admite negativos. Solo guarda el último peso: al pesar de nuevo, edita el animal.

Fecha de nacimientoObligatorio

Sirve para calcular la edad que ves en la ficha. Ejemplo: 21 de marzo de 2024. No puede ser una fecha futura. Si no la sabes con certeza, pon la fecha aproximada.

SaludObligatorio

El estado sanitario del animal: Saludable, En tratamiento, Enfermo, Cuarentena o Fallecido. Un animal nuevo arranca en Saludable. Lo cambias tú al editar; por ejemplo, pasa una vaca con mastitis a En tratamiento.

UbicaciónObligatorio

Dónde está el animal ahora, en texto libre. Ejemplos: Establo norte, Potrero 3, Corral 2. Máximo 255 caracteres. Al escribir, TerraCore te sugiere ubicaciones que ya usaste para que no escribas el mismo lugar de dos formas.

Precio de adquisición (COP)Obligatorio

Lo que pagaste por el animal, en pesos colombianos. Ejemplos: $ 2.500.000 por un novillo, $ 800.000 por un cerdo. No admite negativos. Esta cifra alimenta el Valor del hato de Finanzas.

Campos opcionalesOpcional

Notas.

El botón de guardar queda apagado hasta que completes los nueve campos obligatorios. Así te aseguras de que cada animal tenga la información mínima para que el Panel Central y Finanzas calculen bien. Notas admite hasta 500 caracteres.

Tipos de animal y razas disponibles

Al elegir el tipo, el campo Raza muestra solo las razas de ese tipo. Si cambias el tipo antes de guardar, la raza elegida se borra y eliges otra.

Cómo se arma el código

TerraCore propone el código con tres letras del tipo, un guion y un número de tres cifras, por ejemplo BOV-004. El número es el siguiente libre que ve en tu lista. Si cambias el chip de Tipo en un animal nuevo, el código cambia al prefijo de ese tipo.

Si el código que propone ya está en uso, la app te avisa con este mensaje: “Ya existe un animal con este código en esta finca.”

Paso a paso

Registrar un animalToma 1 minuto

1. Abre Animales

   En el menú lateral, dentro de Inventario, toca Animales.

2. Toca Nuevo animal

   Se abre el formulario “Nuevo animal”.
3. Elige el tipo

   Toca el chip del tipo (por ejemplo Bovino). El campo ID se completa solo con el código sugerido.

4. Completa los datos

   Escribe el Nombre, elige la Raza, indica el Peso (kg), la Fecha de nacimiento, el estado de Salud, la Ubicación y el Precio de adquisición (COP). Si quieres, agrega una nota.

5. Guarda

   Toca Guardar animal. Verás el aviso “(nombre) agregado” y el animal aparece en la tabla.

Captura pendiente

Formulario Nuevo animal

Ventana Nuevo animal con el campo ID de solo lectura (BOV-001), chips de Tipo, Raza, Peso, Fecha de nacimiento, Salud, Ubicación, Precio de adquisición y Notas con contador de caracteres. Pie con el texto 'Se guarda aunque no tengas conexión.'

En la parte de abajo del formulario verás el texto “Se guarda aunque no tengas conexión.” Es cierto: si no tienes internet, el animal queda guardado en tu dispositivo y se envía cuando vuelva la conexión.

Editar un animalCambia peso, estado, ubicación u otros datos

1. Ubica el animal

   Búscalo en la tabla o toca su tarjeta en el celular.
2. Toca Editar

   Se abre el formulario con el título “Editar” y el nombre del animal. El ID y el Tipo se muestran pero no se pueden cambiar.

3. Cambia lo que necesites

   Cambia los datos que necesites y revisa que todo quede correcto.

4. Guarda

   Toca Guardar cambios. El botón se activa solo cuando algo cambió. Verás “(nombre) actualizado”.

Ficha o detalle del animal

Al tocar el nombre de un animal se abre un panel lateral con su ficha.

Captura pendiente

Detalle del animal

Panel lateral de un animal con iniciales, estado de salud, Peso, Edad (por ejemplo 1 año y 2 meses), Ubicación, Nacimiento, Precio adq., sección Historial sanitario con una vacuna, Nota y botones Eliminar y Editar.

La ficha muestra:

• Las iniciales del animal y su estado de salud.
• Peso, Ubicación, Nacimiento y Precio adq.
• Edad, que TerraCore calcula sola: “recién nacido” si tiene menos de un mes, “N meses”, “N años” o “N años y M meses”.
• Historial sanitario: las vacunas del animal cuya próxima dosis está cerca (30 días o menos) o ya pasó. Las vacunas completas se consultan en Salud Animal.
• Nota, o “Sin notas” si no hay ninguna.
• Los botones Editar y Eliminar.

Nota rápida

En la tabla, la columna Notas te deja escribir sin abrir el formulario completo. Toca “Agregar nota…” (o la nota que ya existe), escribe hasta 500 caracteres en la ventana Notas y guarda. Verás “Nota guardada”. Funciona también sin conexión.

Cambiar el estado de salud

El estado de salud lo cambias tú, editando el animal. No cambia solo. Si cambias un animal a Enfermo, TerraCore avisa al resto del equipo (ver la sección de alertas más abajo).

Buscar y filtrar

• Búsqueda: escribe en la caja “Buscar nombre, ID o raza…”. También encuentra por ubicación.
• Chips de estado de salud: Todos, Saludable, En tratamiento, Enfermo, Cuarentena y Fallecido. Cada chip muestra cuántos animales tiene. Puedes combinar varios.
• Filtros por columna (en escritorio): texto, selección múltiple, rangos de peso o precio y rangos de fechas, según la columna. También puedes ordenar tocando el encabezado de una columna.
• Celular: chips de Tipo y orden por nombre, peso y fecha.
• Limpiar filtros: quita todo y vuelve a la lista completa.

Si los filtros no encuentran nada, verás “Sin resultados” con un resumen de los filtros activos y el botón Limpiar filtros.

Eliminar animales

Eliminar un animalSolo el Administrador

1. Toca Eliminar

   Usa el icono de papelera de la fila, el botón Eliminar de la tarjeta o el de la ficha.

2. Confirma

   Aparece la ventana “Eliminar animal” con el texto “Esta acción no se puede deshacer.” y la pregunta “¿Seguro que quieres eliminar (nombre) ((código)) del registro?”. Toca Eliminar para confirmar o Cancelar para volver.

Verás el aviso “(nombre) eliminado”. El animal desaparece de la lista, de las tarjetas y del Panel Central.

Borrado masivo

El Administrador puede eliminar varios animales a la vez:

Eliminar varios animales

1. Selecciona

   Marca las casillas de los animales que quieres quitar.
2. Toca el botón de eliminar

   Aparece la ventana “Eliminar N animales” con la pregunta “¿Seguro que quieres eliminar N animales del registro?”.

3. Confirma

   Si aceptas, se eliminan todos o ninguno. Verás “N animales eliminados”.

Importar animales desde un archivo CSV

Si ya tienes tu ganado en una hoja de cálculo, el Administrador puede cargarlo de una vez con Importar CSV. Todo el procedimiento, con sus pantallas y errores, está en Importar datos desde CSV. Lo esencial para Animales:

• El archivo debe ser CSV separado por comas y guardado en UTF-8. En Excel con configuración regional de Colombia, el CSV suele salir separado por punto y coma: cámbialo antes de cargarlo.
• Descarga la plantilla “plantilla_animales.csv” desde la ventana “Importar animales desde CSV”.
• Columnas obligatorias: ID, Nombre, Tipo, Raza, Nacimiento, Peso, Salud, Ubicacion (sin tilde) y Precio_adq. Opcionales: Notas y Sede (si va vacía, se usa tu sede).
• El Tipo se escribe tal cual aparece en la app: Bovino, Porcino, Ovino, Caprino, Equino, Avícola u Otro. Salud también: Saludable, En tratamiento, Enfermo, Cuarentena o Fallecido.
• El ID debe tener el formato del código (por ejemplo BOV-001), con el prefijo que corresponde al tipo, y no puede repetirse ni estar ya en uso.
• La fecha de Nacimiento va como año-mes-día (2024-03-21) y no puede ser futura.
• En Peso usa punto para los decimales (445.5). En Precio_adq escribe solo números, sin puntos de miles, comas ni signo de pesos (2500000).
• Antes de importar ves una vista previa: las filas con problemas se marcan en rojo con el motivo y solo se envían las filas correctas.
• Si el servidor encuentra un error en alguna fila, no se importa ningún animal y puedes descargar un archivo con los errores para corregirlos.

Al terminar verás “N filas importadas” con las opciones Importar más y Cerrar. El equipo recibe una sola notificación de resumen, no una por animal.

Captura pendiente

Importar animales desde CSV

Ventana Importar animales desde CSV con el archivo cargado, el resumen 'Archivo: nombre.csv · N filas listas · M con errores', casilla Solo errores y el botón Importar N filas.

Alertas y cifras que generan los animales

Lo que registras aquí alimenta otras partes de TerraCore:

• Animal enfermo: cuando editas un animal y cambias su estado a Enfermo, el Administrador y los Operarios reciben la notificación “Animal enfermo” (nombre y código del animal). No se genera si registras el animal ya como Enfermo desde el principio. Aparece además el aviso normal “Animal actualizado”.
• Registro de actividad: cada alta, edición o eliminación genera una notificación para el equipo (“Animal registrado”, “Animal actualizado”, “Animal eliminado”). Mira Notificaciones y actividad.
• Panel Central: la tarjeta Animales activos cuenta los animales que no están en estado Fallecido y muestra cuántos se agregaron este mes. La gráfica de distribución por tipo sale de aquí.
• Finanzas: el Valor del hato suma el precio de adquisición de los animales que tienes registrados y entra en el Patrimonio estimado. Si quitas un animal del registro, deja de sumar. Más detalle en Finanzas.
• Salud Animal: cada vacuna pertenece a un animal. Ver Salud Animal.

Quién puede hacer qué

Si un Operario intenta eliminar, la app lo rechaza y muestra un aviso de permiso. Los roles se explican en Roles y permisos.

Sin conexión

Animales funciona sin internet:

• Puedes ver, buscar, filtrar y ordenar tus animales con lo que ya está guardado en el dispositivo.
• Crear, editar, escribir notas, eliminar e importar se guardan en el dispositivo y se envían solos al volver la conexión (se revisa cada minuto con la app abierta).
• Los cambios pendientes se marcan con un punto amarillo con el texto “Pendiente de sincronizar”. En la cabecera ves Sincronizando, Sincronizado, N pendiente(s) o Sin conexión.
• Al importar sin conexión verás “N animales guardados en este dispositivo. Se sincronizarán al volver la conexión.” y el servidor vuelve a revisar las filas al sincronizar.

Hay tres matices:

• Si, mientras estabas sin conexión, otra persona registró un animal con el mismo código, tu cambio se rechaza al sincronizar y se deshace en tu dispositivo. Lo verás en Cambios rechazados (el botón con un triángulo rojo en la cabecera), con el texto “Ya existe un animal con este código en esta finca.” Puedes tocar Descartar o Descartar todos y volver a registrarlo.
• Si otra persona editó el mismo animal antes de que tu cambio llegara, prevalece lo que ya estaba guardado.
• Las tarjetas de Refuerzos, el Historial sanitario de la ficha, los contadores de los chips y las listas de razas y ubicaciones necesitan haberse cargado antes con internet. Sin conexión pueden verse vacíos.

La primera vez que abres TerraCore en un dispositivo necesitas internet. Más en Trabajar sin conexión.

Avisos que puedes ver

Tipo de operación

En Suscripción el Administrador elige el tipo de operación de la finca: Ganadera, Agrícola o Mixta. Ganadera y Mixta muestran Animales y Salud Animal. Agrícola los oculta (y Ganadera oculta Cultivos). Cambiarlo no borra datos: al volver a mostrarlos, todo sigue ahí.

Lo que Animales no hace

Para evitar confusiones, estas cosas no existen hoy en el módulo:

• No guarda sexo, categoría, estado reproductivo, padre ni madre.
• No lleva historial de pesos: hay un solo peso, el actual, que tú actualizas al editar.
• No registra ventas ni la baja de un animal (fecha o motivo). Para dejar de contarlo como activo, cámbialo a Fallecido o elimínalo.
• No avisa por edad ni por peso. Las únicas alertas ligadas a animales son el aviso de animal enfermo y las de vacunas.
• No tiene botón para recuperar animales eliminados.
• La exportación solo aplica al plan Profesional (ver Qué no incluye Semilla).

Consejos

• Elige un esquema simple para la Ubicación (por ejemplo “Potrero 1”, “Establo norte”) y úsalo siempre igual: así los filtros te sirven más.
• Actualiza el Peso cada vez que pesas al animal. Como no hay historial, solo queda el último valor.
• Antes de cargar muchos animales por CSV, importa un archivo de prueba con dos o tres filas para confirmar el formato.

Siguientes pasos

• Salud Animal: registra vacunas y revisa las alertas de próximas dosis.
• Importar datos desde CSV: carga tu ganado desde una hoja de cálculo.
• Panel Central: mira el resumen de tu finca.