# Guía del agente de ganadería **WhatsApp y panel web — qué puede hacer y cómo pedirlo** Este documento explica, en lenguaje sencillo, las funciones reales del asistente por WhatsApp y el alcance del panel web (administrador, y según el caso capataz/consultor). Está pensado para usuarios nuevos: administradores, capataces y consultores. Hable con el bot como le hablaría a un compañero de trabajo. Use nombres de fincas, animales y productos; no necesita códigos técnicos ni UUID. --- ## 1. Roles: quién puede hacer qué Cada persona tiene un rol en la empresa. Eso define qué puede consultar y qué puede registrar. - **Administrador:** ve todas las fincas. Crea fincas, asigna personal, gestiona el catálogo de productos, **insumos (concentrado y suplemento)** y vacunas, y puede hacer todas las operaciones. En el **panel web** gestiona **ingresos y egresos** (montos de ventas y compras, movimientos manuales y resumen del período) y puede anular movimientos financieros. - **Capataz:** solo ve las fincas asignadas. Puede registrar animales, movimientos, producción, transformaciones, stock de productos, **entradas/consumos/mermas de insumos**, observaciones de salud, vacunas y pérdidas en esas fincas. No crea productos, insumos, fincas ni vacunas del catálogo. En el panel web puede cargar montos al vender o registrar una entrada de insumos (en fincas asignadas); **no** anula movimientos financieros. - **Consultor:** solo consulta (inventario, stock, producción, historial, eventos de salud, vacunas y, en el panel, movimientos financieros). No registra ni modifica nada. **Ejemplos** - Usted: «¿Cuál es mi rol?» - Bot: «Sos administrador / capataz / consultor.» --- ## 2. Fincas y personal El administrador organiza las fincas de la empresa y asigna capataces o consultores a cada una. **Ejemplos prácticos** - Admin: «Creá la finca La Esperanza en Calle 1» - Admin: «Creá la finca El Roble» - Admin: «Listá mis fincas» - Admin: «Asigná al capataz Juan a La Esperanza» - Admin: «Asigná a la consultora María a La Esperanza y El Roble» - Capataz: «Listá mis fincas» → solo ve las asignadas - Capataz: «Creá la finca Nueva» → el bot lo rechaza --- ## 3. Animales (inventario) Puede registrar bovinos (vacas y toros) por finca, con nombre, código interno, fecha de nacimiento e ingreso. El inventario actual son solo los animales activos (no vendidos, no muertos, no perdidos, no eliminados por error). **Ejemplos prácticos** - Capataz: «Registrá la vaca Luna, código V-001, nacida el 10 de marzo de 2022, ingreso el 15 de enero de 2024 en La Esperanza» - Capataz: «Registrá el toro Trueno, código T-001, en La Esperanza» - Cualquiera con acceso: «Listá los animales de La Esperanza» - Consultor: «¿Cuántos animales hay en La Esperanza?» - Capataz: «Cambiá el nombre de V-001 a Luna Clara» - Admin: «Eliminá el animal de prueba …» (solo admin; corrige un error) **Importante:** eliminar un animal (por error de carga) no es lo mismo que venderlo, darlo de baja por muerte o reportarlo perdido. Esas últimas son movimientos de negocio. --- ## 4. Movimientos de animales Traslado entre fincas, venta, muerte y **pérdida/extravío**. Un animal vendido, muerto o perdido deja de aparecer en el inventario activo, pero queda en el historial. **Ejemplos prácticos** - Admin: «Trasladá Luna (V-001) de La Esperanza a El Roble hoy» - Admin: «Vendé Trueno T-001» → baja del inventario; sin monto, igual que siempre - Capataz: «Vendí la vaca Luna en 2 millones» → baja del inventario; el resumen de aprobación muestra **Monto: 2000000** (ver sección 12) - Admin: «Dá de baja por muerte a Estrella» - Capataz: «Reportá que la vaca Luna (V-001) se perdió ayer en La Esperanza» - Admin: «Listá animales perdidos» - Consultor: «Listá animales muertos» - Consultor: «Listá animales vendidos» - Admin: «Anulá el traslado de Luna» → vuelve a la finca original - Admin: «Anulá el reporte de pérdida de Luna» → vuelve al inventario activo en la finca **Nota:** no se puede «reactivar» un movimiento anulado; se registra uno nuevo. **Perdido vs muerte:** si el animal se extravió, use «se perdió» / «extraviada». Si murió, use «murió» / «muerte». El bot distingue ambos casos. --- ## 5. Catálogo de productos La empresa tiene un catálogo compartido (leche, queso, carne, etc.). Solo el administrador crea o descontinua productos. Capataz y consultor pueden verlos y usarlos en operaciones. **Ejemplos prácticos** - Admin: «Creá el producto Leche, código LECHE, unidad litro» - Admin: «Creá el producto Queso, código QUESO, unidad kilogramo» - Capataz: «Listá productos» - Capataz: «Creá el producto Yogur» → denegado; pedir al administrador - Admin: «Descontinuá Yogur» **Importante:** los **insumos** (concentrado, suplemento) son distintos de los **productos** (leche, queso). No mezcle ambos en la misma frase. El **dinero** (ingresos/egresos) tampoco vive en el catálogo: va en **movimientos financieros** (sección 12). --- ## 5.1 Insumos (concentrado y suplemento) El administrador define el catálogo de insumos de la empresa: nombre, código interno, unidad de medida y **stock mínimo opcional** (umbral para alertas en el panel web). Capataz y consultor pueden **consultar** el catálogo y el saldo; el capataz registra entradas, consumos y mermas en sus fincas asignadas. Por WhatsApp la entrada es un evento de **cantidad** (llegó material). El **monto de la compra** es opcional: el bot **nunca** lo pregunta; si usted lo menciona espontáneamente, lo captura en la misma operación y aparece en el resumen de aprobación. También puede cargarse en el **panel web** al registrar la misma entrada, o después como movimiento financiero. Consumos y mermas **no** llevan monto: son movimientos internos de stock, no compras. El chat **no** pide proveedores ni órdenes de compra. Las cantidades van siempre en la **unidad del catálogo** (`kilogramo`, `litro` o `unidad`). Si habla en bultos u otra unidad, el bot le pedirá la cantidad en la unidad correcta una sola vez. ### Catálogo (administrador) - Crear concentrado o suplemento con nombre, código, unidad y mínimo opcional. - Listar insumos activos; descontinuar o desactivar si ya no se usa. - Capataz y consultor **no** pueden crear ni modificar el catálogo. ### Movimientos por finca (administrador y capataz) - **Entrada:** llegada de material (aumenta el stock). - **Consumo:** uso normal en la finca (baja el stock). - **Merma:** pérdida por humedad, vencimiento, accidente, etc. (baja el stock). - **Anulación:** corrige un movimiento cargado por error; el saldo se recalcula y el movimiento queda inactivo (no se reactiva). El consultor **no** registra movimientos; solo consulta saldos e historial en fincas asignadas. **Confirmación:** crear insumos en el catálogo y registrar entradas, consumos o mermas puede pedirle que confirme antes de guardar. Responda sí o no cuando el bot lo pida. **Ejemplos prácticos** - Admin: «Creá el suplemento Mineral Bovino, código MIN-B, unidad kilogramo, mínimo 20» - Admin: «Creá el concentrado Concentrado 18%, código CONC18, unidad kilogramo, mínimo 50» - Capataz: «Creá un concentrado nuevo» → denegado; pedir al administrador - Capataz: «Llegaron 200 kilos de Concentrado 18% a La Esperanza» → entrada sin monto - Admin: «Llegaron 200 kilos de concentrado, salieron en 300 mil» → entrada con monto en el resumen de aprobación - Capataz: «Hoy gastamos 30 kilos de Concentrado 18% en La Esperanza» - Capataz: «Se humedecieron y perdimos 10 kilos de Concentrado 18%» - Capataz: «¿Cuánto Concentrado 18% queda en La Esperanza?» - Consultor: «¿Cuánto Concentrado 18% hay en La Esperanza?» → solo lectura - Consultor: «Registrá consumo de concentrado» → denegado (solo lectura) - Admin: «Anulá la última merma de concentrado en La Esperanza» → el stock sube; la alerta de stock mínimo **no** se cierra sola - Capataz: «Gastá 500 kilos de Concentrado 18%» → rechazado si no hay stock suficiente **Alertas de stock mínimo:** si el administrador configuró un mínimo y un consumo o merma deja el saldo en o por debajo de ese umbral, el **administrador** ve una alerta **Stock mínimo de insumo** en el backoffice (panel «Alertas abiertas»), con la finca y los saldos. El capataz **no** recibe avisos por WhatsApp, **no** gestiona alertas y solo ve la confirmación del movimiento. Si después el stock vuelve a subir (por ejemplo anulando una merma), la alerta **sigue abierta** hasta que el administrador la reconozca, resuelva o descarte en el panel. --- ## 6. Catálogo de vacunas (administrador) Además del nombre libre al registrar una vacuna, el administrador puede definir vacunas estándar de la empresa con intervalo recomendado entre dosis. **Ejemplos prácticos** - Admin: «Creá la vacuna Aftosa, código AFT, cada 180 días» - Capataz: «Vacuná a Luna con Aftosa hoy» → el bot puede calcular la próxima fecha si usa el catálogo - Capataz: «Creá vacuna nueva» → denegado --- ## 7. Observaciones de salud y vacunación El capataz registra en campo lo que ve en los animales. Esas anotaciones alimentan alertas automáticas para el administrador (ver sección 13). El consultor solo puede consultar el historial. ### Observaciones de salud Categorías que entiende el bot: apetito bajo, herida, cojera, fiebre u otro. Puede agregar notas («pata delantera», «desde ayer», etc.). **Ejemplos prácticos** - Capataz: «La vaca 125 está comiendo poco desde ayer en La Esperanza» - Capataz: «Luna tiene una herida en la pata» - Consultor: «¿Qué problemas de salud tuvo Luna este mes?» - Consultor: «Registrá que 125 está enferma» → denegado - Capataz: «Anulá el reporte de apetito de la 125 de ayer» → corrige un error de carga ### Vacunación Registre qué vacuna se aplicó, cuándo y, si lo sabe, cuándo toca la próxima dosis. **Ejemplos prácticos** - Capataz: «Vacuné a Luna con aftosa el lunes, próxima en 6 meses» - Admin: «¿Qué vacunas tiene Luna?» - Capataz: «Anulá la vacuna de Luna del lunes» **Confirmación:** registrar salud, vacunas o pérdidas puede pedirle que confirme antes de guardar (igual que ventas o producción). Responda sí o no cuando el bot lo pida. **Importante para capataces:** al registrar salud o vacuna el bot **solo confirma el registro**. No le avisa de alertas ni le pide gestionarlas; eso es trabajo del administrador en el panel web. --- ## 8. Producción animal → producto Registre lo que produce un animal (por ejemplo litros de leche). Eso aumenta el stock del producto en la finca. Las consultas por periodo incluyen producción de animales que después se vendieron o murieron. **Ejemplos prácticos** - Capataz: «Luna produjo 15 litros de leche el 15 de abril en La Esperanza» - Capataz: «¿Cuánto stock de leche hay en La Esperanza?» - Consultor: «¿Cuánta leche produjo Luna en abril?» - Capataz: «Anulá esa producción de 15 litros» → baja el stock --- ## 9. Transformaciones (producto → producto) Convierta un producto en otro en la misma finca (por ejemplo leche en queso). Hace falta stock suficiente del producto de origen. **Ejemplos prácticos** - Capataz: «Transformá 2 litros de leche en 1 kilo de queso el 16 de abril en La Esperanza» - Capataz: «Stock de leche y queso en La Esperanza» - Capataz: «Transformá 1000 litros de leche en queso» → rechazado si no hay stock - Admin: «Anulá esa transformación» → restaura los stocks --- ## 10. Operaciones de stock de productos Además de la producción, puede cargar stock inicial, registrar venta, merma o traslado entre fincas. Por WhatsApp son eventos de **inventario** (cantidad): el bot **nunca** pide precios, pagos ni clientes. El **monto de una venta** de producto es opcional: si usted lo menciona espontáneamente, el bot lo captura en la misma operación y aparece en el resumen de aprobación. También puede cargarse en el **panel web** al registrar la venta, o después desde movimientos financieros. Merma, traslado y stock inicial **no** generan ingreso ni egreso. **Ejemplos prácticos** - Admin: «Cargá stock inicial de 100 litros de leche en El Roble» - Capataz: «Registrá merma de 5 litros de leche en La Esperanza» - Capataz: «Vendé 10 litros de leche de La Esperanza» → baja el stock; sin monto - Capataz: «Vendí 20 litros de leche en 80 mil» → baja el stock; el resumen de aprobación muestra **Monto: 80000** (sección 12) - Admin: «Trasladá 20 litros de leche de El Roble a La Esperanza» - Capataz sin acceso a El Roble: traslado desde esa finca → denegado --- ## 11. Consultas e historial Cualquier rol con acceso a la finca puede preguntar el estado actual y el pasado. El consultor solo consulta; no le ofrecerá registrar cambios. **Ejemplos prácticos** - «¿Qué animales hay hoy en La Esperanza?» → solo activos - «¿Cuáles se murieron este año?» - «¿Cuáles vendimos?» - «¿Cuáles están perdidos?» - «Producción de leche de la semana del 14 al 20 de abril» - «Stock de queso y leche por finca que me toca» - «¿Cuánto Concentrado 18% queda en La Esperanza?» → insumos, no productos - «¿Qué vacunas tiene Luna?» - «Problemas de salud de la 125 este mes» - «¿Cuánto ingresó este mes?» → por WhatsApp no; usar **Movimientos financieros** en el panel (sección 12) --- ## 12. Ingresos y egresos (panel web) El dinero de la empresa se registra en **movimientos financieros**, separados del inventario. Una venta de animales, una venta de producto o una entrada de insumos pueden llevar un **monto opcional** en el mismo acto — por WhatsApp (si usted lo menciona) o en el panel web; si no se carga ahí, se puede registrar después como movimiento manual. ### Qué se puede registrar | Tipo | Categoría típica | Origen | | --- | --- | --- | | **Ingreso** | Venta de animal | Al vender animales por WhatsApp (monto opcional si lo menciona) o en el panel | | **Ingreso** | Venta de producto | Al vender stock de producto por WhatsApp (monto opcional si lo menciona) o en el panel | | **Egreso** | Compra de insumo | Al registrar una **entrada** por WhatsApp (monto opcional si lo menciona) o en el panel | | **Ingreso** | Otro ingreso | Alta manual (arriendo, servicio, etc.; pide descripción) | | **Egreso** | Otro egreso | Alta manual (mano de obra, etc.; pide descripción) | Consumos y mermas de insumos, mermas/traslados de producto, muertes y pérdidas de animales **no** generan movimiento financiero. ### Dónde se ve y quién actúa - Menú **Financiero → Movimientos financieros** en el backoffice. - Resumen del período: total ingresos, total egresos, neto y desglose por categoría (filtro por finca y fechas). - **Administrador y capataz** pueden crear (el capataz solo en fincas asignadas). Movimientos sin finca (gasto/ingreso de toda la empresa) son solo del administrador. - **Solo el administrador** anula un movimiento financiero. - **Consultor** solo consulta. ### Relación con WhatsApp Por el chat, ventas y entradas siguen siendo de **cantidad**. El bot **nunca** pide el monto ni lista ingresos/egresos. Si el trabajador lo menciona espontáneamente («vendí en 2 millones», «salieron en 300 mil»), el bot lo captura en la misma operación y aparece en el resumen de aprobación; si no lo menciona, el flujo es igual que antes. Los movimientos manuales (otro ingreso/egreso) y el resumen del período siguen siendo del panel. **Nota:** anular una venta o una entrada de insumos en inventario **no** anula sola el movimiento financiero vinculado, y al revés. Si hay que corregir el dinero, se anula el movimiento financiero (admin) y se crea uno nuevo si hace falta. --- ## 13. Alertas automáticas (solo administrador — panel web) Cuando el capataz registra salud, vacunas o pérdidas, el sistema puede generar **alertas operativas** para el administrador **sin usar WhatsApp**. El bot **no** lista alertas, **no** las cierra y **no** notifica al admin por chat. El administrador las ve en el **dashboard del backoffice** (panel «Alertas abiertas»), con filtro por finca. ### Tipos de alerta (resumen) | Señal | Qué significa | Gravedad típica | | --- | --- | --- | | Repetición de salud en un animal | Dos o más observaciones del mismo animal en pocos días | Advertencia | | Pico de síntoma en una finca | Varios animales distintos con el mismo síntoma en la misma finca en la ventana configurada | Crítica | | Vacuna vencida | Pasó la fecha de próxima dosis sin registro de refuerzo | Advertencia | | Animal perdido reciente | Pérdida registrada en los últimos días | Informativa | | Stock mínimo de insumo | Saldo de concentrado/suplemento en finca en o bajo el mínimo configurado | Advertencia | ### Qué puede hacer el administrador - **Reconocer:** «ya lo vi, lo estoy mirando» - **Resolver:** «quedó atendido» - **Descartar:** «no era accionable / ruido» La inteligencia artificial **no** cierra alertas sola. Si la misma situación sigue empeorando (por ejemplo más animales con el mismo síntoma), el sistema **actualiza** la alerta existente en lugar de spamear duplicados. --- ## 14. Más herramientas del panel web (administrador) Además de alertas y movimientos financieros, el backoffice incluye: - **Gráficos de salud:** tendencia de observaciones por día, por tipo de síntoma y por finca (para contextualizar las alertas). - **Historial de eventos:** listado de observaciones de salud y vacunaciones registradas en campo (solo lectura; el alta sigue siendo por WhatsApp). - **Informe semanal con IA:** resumen automatizado de solo lectura los lunes. Es análisis complementario; **no** reemplaza las alertas operativas del panel principal ni las modifica. - **Registro de ventas y entradas con monto:** pantallas para vender animales, vender productos y registrar entrada de insumos, con campo opcional de monto (alimenta la sección 12). Capataz y consultor **no** acceden a alertas ni informes semanales en el panel. Sí pueden ver (y el capataz crear, según rol) movimientos financieros según la sección 12. --- ## 15. Ideas clave para no confundirse - Inventario actual no es lo mismo que historial. Vendidos, muertos y perdidos no cuentan como animales presentes, pero sí en reportes históricos. - **Perdido ≠ muerte.** Use las palabras que correspondan; el bot elige la operación correcta. - Anular un registro corrige un error: el movimiento o evento queda inactivo y no se reactiva. Para corregir, se crea uno nuevo. - Eliminar es para cargas erróneas; no use eso para venta, muerte o pérdida. - El stock actual de **productos** se consulta preguntando por stock de leche, queso, etc.; el de **insumos** preguntando por concentrado o suplemento en la finca. - **Cantidad ≠ dinero.** Vender un animal o litros de leche por WhatsApp mueve inventario; el monto es opcional — el bot nunca lo pregunta, pero si usted lo menciona queda vinculado al movimiento financiero en la misma operación (o puede cargarse después en el panel). - Anular una merma o consumo de insumo sube el saldo, pero **no** cierra sola la alerta de stock mínimo en el backoffice. - Anular una venta o entrada de insumos **no** anula sola el ingreso/egreso vinculado, y al revés. - Registrar salud en WhatsApp **no** le muestra alertas al capataz; lo mismo aplica a consumos de insumo que generen alerta de stock mínimo (solo ve confirmación del movimiento). - Si una acción necesita confirmación, el bot explica qué va a hacer y espera su aprobación. --- ## 16. Qué no hace el agente (por ahora) - Registrar, listar o anular **ingresos/egresos manuales** por WhatsApp (otro ingreso/egreso; ver sección 12). - **Pedir** montos, facturas, pagos, clientes o proveedores en el chat (si usted menciona un monto espontáneamente en una venta o entrada, sí se guarda). - Contabilidad de partida doble, cuentas por cobrar/pagar o facturación electrónica. - Costeo o rentabilidad por animal o lote (el ledger de ingresos/egresos es la base; el detalle por animal viene después). - Gestión de otras especies distintas de bovinos. - Crear productos, **insumos**, fincas o vacunas del catálogo si usted es capataz o consultor. - Órdenes de compra o proyección de «días de cobertura» de insumos. - Medicamentos o vacunas en inventario de insumos (solo catálogo de vacunas para registrar aplicaciones). - Listar, reconocer, resolver o descartar **alertas operativas** por WhatsApp (solo backoffice, solo administrador). - Diagnóstico veterinario, recetas o inventario de medicamentos. - Adjuntar fotos de heridas o animales en el chat. **Consejo final:** escriba en español natural, con nombres reales de fincas y animales. Si falta un dato (fecha, cantidad, finca), el bot se lo pedirá. --- *Documento orientativo para usuarios del canal WhatsApp y del panel web de administración. Actualizado con movimientos financieros (ingresos/egresos en el panel y captura opcional de monto por WhatsApp), insumos (concentrado/suplemento), alertas de stock mínimo y capacidades de salud, vacunas y pérdidas.*