Insumos

Insumos es tu bodega dentro de TerraCore: alimentos, medicamentos, vacunas, fertilizantes, combustible y todo lo que usas para trabajar la finca. Sirve para saber cuánto tienes de cada cosa, cuánto vale, quién lo movió y cuándo se está acabando. Lo usas cada vez que compras algo, lo gastas o quieres revisar el estado de tu bodega.

El módulo tiene dos vistas: Inventario, que es la foto de lo que tienes hoy, y Movimientos, que es el historial de cada entrada y salida. El stock de cada insumo cambia solo por movimientos, y cada movimiento queda con su razón, su fecha y la persona que lo hizo, así que siempre puedes ver de dónde salió la cantidad que tienes hoy.

Las dos vistas de Insumos

Arriba de la pantalla ves dos pestañas. Cambias de una a otra con un toque.

Captura pendiente

Pestañas Inventario y Movimientos

Parte superior de la pantalla Insumos con las dos pestañas, Inventario (activa) y Movimientos, y debajo las cuatro tarjetas de resumen.

Una forma sencilla de pensarlo: en Inventario ves el resultado y en Movimientos ves la historia que lo explica.

Vista Inventario

Captura pendiente

Pantalla Insumos

Pantalla Insumos con las cuatro tarjetas de resumen arriba (Ítems en inventario, Stock crítico, Stock bajo, Valor del inventario), el buscador, los chips de categoría, los botones Nuevo insumo e Importar CSV, y la tabla con al menos 6 insumos en estados Crítico, Bajo y OK.

Arriba hay cuatro tarjetas de resumen:

Debajo están el buscador, los chips de categoría y la tabla de insumos, con una fila por cada insumo. Arriba a la derecha están los botones Nuevo insumo y, solo para el Administrador, Importar CSV.

Qué muestra cada columna

En cada fila encuentras estas acciones:

• Editar: corrige nombre, categoría, mínimo, proveedor, costo unitario, última compra y notas.
• Ajustar stock: registra una entrada o una salida de cantidad.
• Historial de stock: abre solo los movimientos de ese insumo.
• Eliminar: solo la ve el Administrador.

La exportación solo aplica al plan Profesional. Más información en Qué no incluye Semilla.

Qué significa Crítico, Bajo y OK

Cada insumo tiene un estado según su cantidad y su mínimo:

Ejemplo: un insumo con mínimo 20 kg está en Crítico con 19 kg, en Bajo con 20 kg hasta 30 kg, y en OK con más de 30 kg.

Un insumo con mínimo 0 nunca aparece en Crítico, porque nunca baja del mínimo. Si no quieres alertas para un insumo, déjale el mínimo en 0.

Categorías

Cada insumo pertenece a una categoría: Alimento, Medicamento, Vacuna, Fertilizante, Pesticida, Combustible, Forraje, Semillas, Limpieza, Suplementos u Otro. Los chips de categoría arriba de la tabla filtran la lista con un toque.

Qué datos guardas

Datos del insumoLo que registras en el formulario Nuevo insumo

CódigoAutomático

TerraCore sugiere el siguiente libre, con la forma INS-001, INS-002. Aparece de solo lectura: no lo escribes tú.

NombreObligatorio

El nombre con el que lo reconoces, por ejemplo “Concentrado 18%” o “Vacuna aftosa”. No puede repetirse: si ya existe uno igual (sin importar mayúsculas, tildes o espacios) la app muestra “Ya existe un insumo con ese nombre.”

CategoríaObligatorio

Una de las once categorías de la lista. Ejemplo: Forraje para el concentrado, Medicamento para la ivermectina, Combustible para el ACPM.

CantidadObligatorio

Lo que tienes hoy. Solo se escribe al crear el insumo. Después, la cantidad cambia únicamente con movimientos (ajustar stock, producción, salud animal). Ejemplos: 100 kg de concentrado, 12 L de desparasitante, 40 sacos de abono. Máximo 99.999.999,99.

UnidadObligatorio

L, kg, unidad, saco, caja, g o ml. Ejemplo: kg para el concentrado, L para el combustible. Se elige al crear y después queda de solo lectura.

Mínimo (alerta)Obligatorio

La cantidad por debajo de la cual quieres que el insumo se considere Crítico y que TerraCore te avise. No puede ser negativo. Ejemplo: si tienes 100 kg y quieres enterarte cuando queden menos de 20 kg, escribe 20.

ProveedorObligatorio

Texto libre con el nombre de a quién le compras. No está conectado a ninguna lista de proveedores: lo escribes tal cual. Ejemplo: “Agropecuaria Solla”.

Costo unitario (COP)Obligatorio

Lo que te cuesta una unidad, en pesos. No puede ser negativo. Ejemplo: $ 18.500 por saco. Con este dato se calcula el valor del inventario.

Última compraObligatorio

La fecha de tu última compra, por ejemplo 3 de octubre de 2026. No puede ser una fecha futura: la app muestra “La fecha no puede ser futura.” y no te deja guardar hasta que la corrijas. Cuando registras una entrada de stock, esta fecha pasa a ser la de hoy.

Campos opcionalesOpcional

Notas.

Si algún campo obligatorio está vacío o tiene un error, el botón Guardar queda deshabilitado hasta que lo corrijas.

Paso a paso

Crear un insumoToma 1 minuto

1. Abre Insumos

   En el menú lateral, toca Insumos.
2. Toca Nuevo insumo

   Se abre el formulario con el código ya sugerido (por ejemplo INS-001).

3. Completa los datos

   Llena nombre, categoría, cantidad, unidad, mínimo, proveedor, costo unitario y fecha de última compra. Agrega una nota si quieres.

4. Guarda

   Toca Guardar. Verás un aviso como “Concentrado 18% agregado” y el insumo aparece en la tabla.

Si creas el insumo con una cantidad mayor que 0, TerraCore registra solo un movimiento de entrada con la razón Inventario inicial. Si lo creas con cantidad 0, no se registra ningún movimiento.

Editar un insumoPara corregir nombre, mínimo, proveedor, costo o fecha

1. Abre la edición

   En la fila del insumo, toca Editar.
2. Cambia lo que necesites

   Puedes cambiar nombre, categoría, mínimo, proveedor, costo unitario, última compra y notas. Cantidad y Unidad aparecen bloqueadas.

3. Guarda

   Toca Guardar. Tu equipo recibe un aviso de actividad con lo que cambió.

Para cambiar la cantidad no se edita el insumo: se usa Ajustar stock (más abajo). Así el historial siempre explica de dónde sale cada número.

Buscar y filtrar en Inventario

La tabla de Inventario se filtra al instante, sin esperar al servidor:

• Buscador: escribe parte del nombre o del código.
• Chips de categoría: toca una categoría para ver solo esos insumos.
• Filtros por columna: cantidad, mínimo, costo unitario y fecha de última compra.
• Orden: toca el encabezado de una columna para ordenar.
• Tamaño de página: la tabla muestra 25 insumos por página por defecto.
• Limpiar filtros: quita todos los filtros de una vez.

Desde el Panel Central puedes llegar ya filtrado: la tarjeta de alertas abre Insumos solo con los Crítico, y el enlace de la lista Stock bajo abre solo los Bajo.

Vista Movimientos

Un movimiento es cualquier cambio en la cantidad de un insumo. Hay dos tipos: entrada (suma) y salida (resta). La pestaña Movimientos es el libro de esos cambios: te sirve para saber por qué un insumo tiene la cantidad que tiene, quién hizo cada cambio y cuándo.

Captura pendiente

Pestaña Movimientos

Pestaña Movimientos de Insumos con la lista de movimientos: cantidad con signo más o menos, stock antes y después, insignia de la razón, nota entre comillas, fecha y usuario. Filtros arriba y botones Invertir y Eliminar en cada fila.

Qué muestra cada columna

La pestaña lista todos los movimientos de todos tus insumos. Cada fila trae:

Fíjate en el stock antes y después: si no te cuadra una cantidad, esas dos cifras te dicen exactamente cuánto había y cuánto quedó en cada paso.

Cómo filtrar los movimientos

Arriba de la lista puedes combinar estos filtros:

• Tipo: solo entradas o solo salidas.
• Razón: solo los movimientos de un motivo, por ejemplo Producción registrada.
• Insumo: solo los de un insumo.
• Usuario: solo los que hizo una persona.
• Fecha: solo los de un día o un rango de fechas.

La lista se pagina de 25 en 25. Para ver de una vez todos los movimientos de un solo insumo, también puedes abrir su Historial de stock desde su fila en Inventario.

De dónde sale el stock y adónde va

Es decir: el stock sube cuando tú lo registras (Inventario inicial o una entrada de Ajuste manual) y baja cuando lo consume Producción o Salud Animal, o cuando registras una salida. Nadie puede crear un movimiento “a mano” desde la lista: los movimientos nacen de estas acciones.

Ajustar stock

Usa Ajustar stock cuando compras algo (entrada) o cuando gastas o pierdes algo fuera de Producción y Salud Animal (salida).

Captura pendiente

Ajustar stock

Ventana Ajustar stock con el selector Entrada o Salida, la cantidad, la nota, la línea Resultado con el stock final y el botón Confirmar entrada.

Registrar una entrada o una salidaToma menos de 1 minuto

1. Abre Ajustar stock

   En la fila del insumo, toca Ajustar stock.
2. Elige el tipo

   Selecciona Entrada si suma o Salida si resta.
3. Escribe la cantidad y una nota

   La cantidad debe ser mayor que 0. La nota es opcional pero ayuda, por ejemplo “Compra a Solla, factura 1234”.

4. Revisa el Resultado

   La ventana te muestra cómo quedará el stock antes de confirmar.

5. Confirma

   Toca Confirmar entrada o Confirmar salida. Verás un aviso como “Entrada de 50 kg en Concentrado 18%”.

Una entrada también actualiza la Última compra del insumo a la fecha de hoy.

El stock nunca queda en negativo

TerraCore no deja que un insumo baje de 0. Si intentas sacar más de lo que hay:

• En la ventana de ajuste aparece el aviso “La salida supera el stock disponible.”, el Resultado no se calcula y Confirmar salida queda deshabilitado.
• Si otra persona o dispositivo cambió el stock justo antes y tu salida ya no alcanza, la app muestra “Stock insuficiente. Disponible: 5.0.” con la cantidad real que hay.
• Un lote de producción que pide más de lo disponible se rechaza con “Stock insuficiente: Concentrado (hay 5, pides 10).” Lo explicamos en Producción.

Revertir un movimiento

Si registraste algo mal, puedes corregirlo desde la pestaña Movimientos o desde el Historial de stock del insumo. Hay dos formas de revertir un movimiento: Invertir y Eliminar. Ambas devuelven el stock a como estaba antes, pero se diferencian en el rastro que dejan.

Ejemplo: registraste por error una entrada de 50 kg de concentrado y el stock pasó de 56 a 106 kg. Con Invertir, TerraCore agrega una salida de 50 kg y el stock vuelve a 56 kg; en Movimientos verás las dos filas. Con Eliminar, el stock vuelve a 56 kg y la fila de los 50 kg deja de existir.

Si necesitas conservar la historia de lo que pasó, prefiere Invertir. Al terminar verás “Movimiento invertido correctamente” o “Movimiento eliminado”.

Quién puede revertir y hasta cuándo

El tiempo para revertir depende de tu rol:

• Pasados los 10 minutos, el Operario ya no puede revertir ese movimiento: los botones Invertir y Eliminar quedan en gris. Si necesita corregirlo, debe pedirle al Administrador que lo haga, o registrar un ajuste nuevo con Ajustar stock y dejar una nota que lo explique.
• Si pasas el cursor por un botón en gris verás el motivo: “Solo el creador puede modificar este movimiento” (el movimiento es de otra persona) o “Ventana de edición cerrada” (ya pasaron los 10 minutos).

Qué pasa con el stock al revertir

TerraCore revisa que el stock nunca quede en negativo:

• No puedes invertir una entrada si el stock ya bajó y no alcanza para devolverla. La app avisa “Stock insuficiente para invertir: disponible 5 kg, se requieren 20 kg”.
• Tampoco puedes eliminar una entrada si al quitarla el stock quedaría negativo: “No se puede eliminar: el stock resultante sería negativo”.
• Revertir una salida (por ejemplo, una salida de Ajuste manual que hiciste por error) devuelve esa cantidad al insumo.

Cuando el movimiento ya no se puede revertir, la solución es registrar primero una entrada con Ajustar stock y luego intentar de nuevo, o dejar el movimiento como está y registrar el ajuste que lo compense.

Notas

Cada insumo tiene un campo Notas para comentarios (por ejemplo, dónde lo guardas o para qué se usa). Ábrelo desde el detalle del insumo, escribe hasta 500 caracteres y guarda: verás “Nota guardada”. Cambiar una nota no modifica el stock. Tanto el Administrador como el Operario pueden hacerlo.

Importar desde CSV

Si ya llevas tu inventario en una hoja de cálculo, puedes cargarlo de una vez. Solo el Administrador ve el botón Importar CSV.

Captura pendiente

Importar insumos desde CSV

Ventana de importación con el botón Descargar plantilla, el enlace Ver especificaciones de columnas, la vista previa con filas y una columna de error, la casilla Solo errores y el botón Importar N filas.

Importar insumosSolo Administrador

1. Descarga la plantilla

   Toca Importar CSV y luego Descargar plantilla. Es un archivo de ejemplo con las columnas correctas. Ver especificaciones de columnas te muestra las reglas.

2. Llena tu archivo

   Una fila por insumo, con las columnas de la plantilla.
3. Súbelo y revisa

   TerraCore valida cada fila y te muestra una vista previa de 25 en 25. Arriba verás un resumen como “12 filas listas · 2 con error”. Marca Solo errores para ver únicamente las filas con problema.

4. Importa

   Toca Importar N filas. Solo se importan las filas válidas; las que tienen error se dejan fuera para que las corrijas y las subas después.

Al terminar verás un aviso como “12 insumos importados” o “12 importados · 2 con error”.

Columnas del archivoLa primera fila debe tener estos encabezados (sin importar tildes ni mayúsculas)

NombreObligatorio

Nombre del insumo, por ejemplo Concentrado 18%.

CategoriaObligatorio

Escrita con mayúscula inicial: Alimento, Medicamento, Vacuna, Fertilizante, Pesticida, Combustible, Forraje, Semillas, Limpieza, Suplementos u Otro.

CantidadObligatorio

Número con punto para decimales. Ejemplo: 100 o 12.5.

MinimoObligatorio

Número con punto para decimales. Ejemplo: 20.

UnidadObligatorio

Por ejemplo kg, L o saco. Usa la misma unidad que en tu inventario.

ProveedorObligatorio

Texto libre. Ejemplo: Agropecuaria Solla.

UltimaCompraObligatorio

Fecha de hoy o anterior, con la forma 2026-10-03 (año, mes y día).

CostoUnitarioObligatorio

Número con punto para decimales, en pesos y sin el signo $. Ejemplo: 18500.

Campos opcionalesOpcional

ID (la columna debe existir, la celda puede ir vacía), Nota, Sede (si la dejas vacía, se usa tu sede).

Cosas que debes cuidar al preparar el archivo:

• Separador: TerraCore solo lee archivos separados por comas. Si tu hoja de cálculo guarda con punto y coma (frecuente con Excel configurado en español de Colombia), el archivo no se reconoce y verás “Falta columna ‘ID’.” Guárdalo como CSV separado por comas.
• Decimales: escribe el punto como decimal y no uses separador de miles. Por ejemplo 15000.5, no 15.000,5.
• Excel: por ahora solo se importa CSV, no archivos de Excel (.xlsx).

Mensajes que puedes ver en la vista previa:

Cada insumo importado con cantidad queda con su cantidad inicial registrada en Movimientos. Importar muchos insumos a la vez también genera avisos de actividad para tu equipo.

Quién puede hacer qué

El Operario no ve los botones de eliminar ni Importar CSV.

Eliminar insumos

Solo el Administrador elimina. Para uno, usa Eliminar en la fila y confirma; verás “Concentrado 18% eliminado”. Para varios, marca las casillas de las filas y toca Eliminar N insumos (por ejemplo “3 insumos eliminados”). El insumo deja de aparecer en las listas, en el valor del inventario y en las alertas, y sus movimientos dejan de verse. Tu equipo recibe un aviso crítico de eliminación.

Si tu cuenta está en solo lectura (por ejemplo, con la prueba vencida o un pago pendiente), cualquier acción de escritura abre la ventana Plan requerido: “Esta acción requiere un plan activo. Compra un plan para continuar.” Puedes seguir consultando todo. Más detalle en Estado de la cuenta.

Alertas de stock

TerraCore te avisa del stock bajo de tres maneras, dentro de la app (no por correo). Si instalas la app, también puedes ver los avisos como notificaciones del dispositivo, y en camino hay avisos por WhatsApp (ver Recibir tus avisos):

• Aviso inmediato: cuando un movimiento deja un insumo por debajo de su mínimo, tú y tu equipo reciben una notificación de Stock bajo, por ejemplo “Stock bajo: Concentrado (INS-001) tiene 20 kg (mínimo: 25)”. Si el stock queda justo en el mínimo, no hay aviso.
• Aviso diario: cada mañana a las 8:00 (hora de Colombia), TerraCore revisa tus insumos y avisa de los que siguen por debajo del mínimo, una vez al día por insumo.
• En el Panel Central: la tarjeta Alertas stock crítico cuenta los insumos por debajo del mínimo y la lista Stock bajo muestra los que se acercan.

Las notificaciones las reciben los Administradores y Operarios activos. Más detalle en Notificaciones y actividad y Panel Central.

Sin conexión

Insumos funciona sin internet, siempre que ya hayas abierto TerraCore con conexión al menos una vez en ese dispositivo.

• Puedes consultar, buscar, crear, editar, eliminar, escribir notas e importar CSV. Lo que hagas queda guardado en el dispositivo y se envía al volver la señal. Arriba verás el indicador de sincronización: “Sin conexión · 3” mientras hay cambios pendientes y “Sincronizado” cuando todo llegó.
• Al importar sin conexión verás “3 insumos guardados en este dispositivo. Se sincronizarán al volver la conexión.”
• Un ajuste de stock sin conexión cambia la cantidad al instante en tu dispositivo. Si dos dispositivos hacen ajustes distintos sin conexión, al sincronizar se suman las diferencias: ninguno pisa al otro. Si una salida ya no alcanza porque otro dispositivo sacó antes, se rechaza y la ves en Cambios rechazados, en el encabezado.
• Si registras un lote de Producción sin conexión, el stock de los insumos usados sí se descuenta en tu dispositivo. El valor real y definitivo se refleja aquí cuando vuelve el internet y se sincroniza, para que no se descuente dos veces. No lo ajustes a mano.
• Si necesitas dejar una nota junto con un ajuste de stock, hazlo con conexión.
• El Historial de stock de un insumo se abre sin conexión solo si ya lo habías abierto antes con internet. Si no, verás “Sin conexión y todavía no hay datos guardados de esta pantalla. Ábrela una vez con internet.” Los ajustes hechos sin conexión aparecen en el historial después de sincronizar.
• Invertir o eliminar un movimiento sin conexión también se guarda y se aplica al volver la señal (“Reversión guardada. Se aplicará al volver la conexión.”).

Más información en Funcionamiento sin conexión.

Cómo se conecta con otros módulos

• Producción: cada lote que registras con insumos descuenta su stock automáticamente. Importar lotes por CSV no descuenta nada. Ver Producción.
• Salud Animal: una vacuna registrada con un insumo puede descontarlo. Ver Salud Animal.
• Finanzas: el Valor del inventario y el patrimonio salen de tus insumos (cantidad por costo unitario). Un insumo sin costo unitario aporta 0. Ver Finanzas.
• Panel Central y notificaciones: las alertas de stock se muestran en ambos.

Lo que no hace

• No suma stock por una compra: la forma de reponer es registrar una Entrada con Ajustar stock.
• No convierte unidades: si compras en kg y consumes en g, son insumos distintos o debes registrar siempre en la misma unidad.
• No conecta el proveedor con una lista de proveedores: es solo un texto.
• No exporta datos. La exportación solo aplica al plan Profesional (Qué no incluye Semilla).

Herramientas

Las herramientas y su mantenimiento son parte del plan Profesional y no aparecen en tu menú. Más información en Qué no incluye Semilla.

Consejos

• Define un mínimo realista para cada insumo que no te puede faltar. Con mínimo 0 no tendrás alertas.
• Registra cada compra como Entrada con una nota (proveedor o número de factura). Después sabrás de dónde salió el stock.
• Registra siempre la misma unidad para el mismo insumo.
• Revisa el filtro Crítico cada semana, antes de hacer tu lista de compras.

Siguientes pasos