Crisopa

Crea varias tareas de golpe en una explotación (finca), ideal para planificar la campaña entera. Máximo 100 por llamada. Devuelve los ids creados. Requiere scope de escritura y confirmación previa (ver instrucciones).

crear_tareas_en_lote

Registra un tratamiento fitosanitario en una o varias parcelas (Anexo III RD 1311/2012) con uno o varios productos (el caldo). Si se pasan varias parcelas, crea un tratamiento por parcela en un mismo grupo. Llámala solo tras validar_tratamiento y el visto bueno del usuario (flujo en las instructions). aplicadorId y maquinariaId son obligatorios; pasa el codigoAgente para que el linting persistido sea completo. Producto comercial, materia activa, registro y plazo de seguridad se derivan del MAPA. La superficie tratada se deriva de cada parcela. Requiere scope de escritura.

crear_tratamiento

Registra una visita en el diario de campo (CRM agronómico): un único documento estilo Notion, sin categorías; la estructura emerge de los encabezados. Markdown ligero: "## Sección" → encabezado, resto → párrafos. Encabezados que ofrece la app (úsalos cuando encajen, o crea otros "## emoji Título"): "## 🌱 Estado del cultivo", "## 🌸 Fenología", "## 🐛 Plaga o enfermedad", "## 💡 Recomendación", "## 💧 Riego", "## ⚠️ Incidencia", "## 📝 Nota general". Si el usuario menciona un cultivo en general, aplícala a todas sus parcelas haciéndolo explícito, sin pedir confirmación. No pidas confirmación para registrar salvo duda. Requiere scope de escritura.

crear_visita

Ficha completa de una parcela: SIGPAC, cultivo/variedad, superficie, plantación (año, marco, densidad, patrón), riego, GIP y datos medioambientales, más el contexto de la finca (nombre y titular) y un "resumenCampana" (acumulados de tratamientos/fertilizaciones/riegos, UF N-P-K, volumen de riego, última visita y tareas pendientes). Si la parcela pertenece a un grupo SIGPAC, el resumen agrega TODOS los fragmentos del grupo (no solo el recibido). El detalle de cada registro está en listar_registros.

detalle_parcela

Edita un registro de fertilización. Solo modifica los campos que envíes; los omitidos se dejan igual. Las UF (N-P-K) se recalculan solas si cambias la dosis o las riquezas. No ajusta el almacén (el movimiento de stock original se mantiene); para cambiar el stock, bórrala y créala de nuevo. Requiere scope de escritura.

editar_fertilizacion

Edita una tarea existente. Solo modifica los campos que envíes; los que omitas se dejan igual. Si pasas "parcelas", REEMPLAZA por completo la lista de parcelas asociadas (no es aditivo). Para cambiar el estado hecha/pendiente usa marcar_tarea. Requiere scope de escritura.

editar_tarea

Edita un tratamiento fitosanitario individual (su id, de listar_registros). Solo modifica los campos que envíes; los omitidos se dejan igual. Si pasas `productos`, REEMPLAZA el caldo entero (no es aditivo); cada producto se resuelve del registro del MAPA. Tras editar, re-ejecuta el linting normativo y devuelve las alertas. NO ajusta el almacén (el movimiento de stock original se mantiene): para corregir stock, bórralo y recréalo. No cambia la parcela; para moverlo, bórralo y créalo de nuevo. Requiere scope de escritura.

editar_tratamiento

Edita una visita del diario de campo. Solo modifica los campos que envíes; los que omitas se dejan igual. Si pasas "texto", REEMPLAZA el contenido entero de la anotación (mismo Markdown ligero que crear_visita: "## Sección" → encabezado). Si pasas "parcelas", REEMPLAZA por completo la lista de parcelas (no es aditivo). Requiere scope de escritura.

editar_visita

Descarga la ficha oficial del producto en el Registro del MAPA y devuelve su texto: tabla completa de usos autorizados (cultivo, agente, dosis, nº de aplicaciones, intervalos, volumen de caldo), condicionamientos específicos (épocas, restricciones), plazos y composición. Es la FUENTE DE VERDAD para confirmar una recomendación de buscar_productos_autorizados. Pásale el idProducto que devuelve esa búsqueda.

leer_ficha_registro

Lista los productos del almacén de una explotación (fitosanitarios, fertilizantes, semillas, etc.) con su stock actual. Útil para saber qué tiene ya el agricultor antes de recomendar una compra. Por defecto solo devuelve productos con stock disponible.

listar_almacen

Lista las explotaciones (fincas) accesibles con esta clave. Devuelve el id de cada una, necesario para el resto de tools. Cada explotación incluye "inicioCampana" (el mes 1-12 en que arranca su campaña agrícola; 9 = septiembre, el más común) y "campanaActual" (el año de campaña que la app da por activa hoy en esa explotación). Usa "campanaActual" al hablar de "esta campaña" y "inicioCampana" para situar una fecha concreta en su campaña, en vez de asumir septiembre.

listar_explotaciones

Lista las unidades de trabajo de una explotación EN UNA CAMPAÑA: parcelas sueltas y grupos (varias parcelas SIGPAC que físicamente son una misma finca). Por defecto devuelve la campaña activa (la misma que ve el asesor en la web); pasa "campana" solo para consultar el histórico de una campaña anterior. La respuesta indica en "campana" cuál se ha usado. Cada unidad trae "nombre", "referenciaSigpac" (para desambiguar homónimas) y un array "parcelaIds" (un id si es suelta; varios si es grupo). Preséntala por su "nombre"; para asociar tareas/visitas/fertilizaciones o filtrar, pasa SIEMPRE todos sus "parcelaIds". La superficie de un grupo es la suma de sus parcelas.

listar_parcelas

Devuelve los aplicadores (personas con carné de manipulador, con su vigencia) y la maquinaria activa (pulverizadores, atomizadores…) de una explotación. Ambos ids son obligatorios para crear_tratamiento. Cada aplicador trae en maquinaIds las máquinas que puede usar (una empresa de servicios trae su propio equipo; un aplicador propio usa máquinas propias): elige la maquinaria entre ellas.

listar_recursos_aplicacion

Lista los registros de una explotación según "tipo": "tratamientos" (fitosanitarios, Anexo III RD 1311/2012), "fertilizaciones" (abonado ejecutado con UF N-P-K), "riegos" (volúmenes) o "planes_abonado" (plan de abonado, RD 1051/2022: UF N-P-K objetivo por ha). Filtra opcionalmente por parcela (o varias, p. ej. todas las de un grupo SIGPAC) o campaña. "limite" acota los registros devueltos (por defecto 50, máximo 200); si hay más, la respuesta marca "truncado": true. Para planificar el abonado, compara "planes_abonado" (objetivo) con "fertilizaciones" (aportado).

listar_registros

Lista las tareas planificadas de una explotación. Por defecto, las de la campaña activa; pasa "campana" para una campaña concreta o "todasLasCampanas" para el histórico. Permite filtrar por estado.

listar_tareas

Lista las visitas del diario de campo de una explotación: fecha, título, parcelas y el texto (plano) de la anotación. Por defecto, las de la campaña activa; pasa "campana" para una campaña concreta o "todasLasCampanas" para el histórico. Filtra opcionalmente por parcela (visitas que la incluyen); si pasas "parcelaId" no se acota la campaña, porque esa parcela ya es de una.

listar_visitas

Marca una tarea como hecha o pendiente. Requiere scope de escritura. Útil para cerrar tareas planificadas a medida que se ejecutan en campo. No pidas confirmación para esto.

marcar_tarea

Ejecuta el linting normativo de un tratamiento SIN crearlo (dry-run): dosis, nº de aplicaciones, autorización producto-agente-cultivo, volumen de caldo, etc. Devuelve las alertas (error/warning/info) para revisarlas antes de crear. Pasa el codigoAgente para un linting completo; se puede repetir mientras se ajustan dosis o productos. Acepta varias parcelas (mismo tratamiento en grupo); todas deben ser del mismo cultivo y explotación.

validar_tratamiento