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. La eficacia se guarda como buena: no la preguntes (si fue otra, se corrige con editar_tratamiento). Si un producto lleva productoAlmacenId y cantidadUsada, descuenta esa cantidad del almacén (sin stock suficiente no guarda). En una explotación con partes de trabajo crea también la línea del parte (salvo sinParte). No guarda si el linting da alguna alerta de nivel error o warning. 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 y dilo. Después de crearla, Crisopa analiza el texto con IA para proponer tareas en la app (quedan como sugerencias que el usuario acepta o descarta). 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" de la campaña de la parcela: nº de tratamientos y el último, UF N-P-K aplicadas (por ha) frente al plan de abonado, volumen regado (m³) frente a la concesión, nº de visitas y la última, 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 (un id de "ids" de listar_registros: cada fila agrupa los registros de una unidad; para editar la unidad entera repite la llamada con cada id). 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. Si el abonado lleva parte de trabajo, su línea se ajusta sola a la parcela, la superficie y el día nuevos (las horas estimadas se reescalan; el equipo no cambia). Requiere scope de escritura.

editar_fertilizacion

Edita los datos agronómicos de una parcela o de un grupo (una unidad de listar_parcelas: pásale todos sus "parcelaIds"). Solo modifica los campos que envíes; null borra un campo opcional. Los campos se aplican a todas las parcelas recibidas, salvo "superficie", que solo se admite con una parcela suelta, y "nombre", que en un grupo renombra el grupo. Si cambias el cultivo, pasa el nombre en "cultivo" y el código oficial se resuelve solo; si el nombre es ambiguo, la tool devuelve candidatos y tienes que repetir con "codigoCultivo". Si cambias el marco y no das la densidad, se recalcula. No toca la referencia SIGPAC ni la campaña: eso se hace desde la web. Edita solo la campaña de las parcelas recibidas, no las de otras campañas. Requiere scope de escritura.

editar_parcela

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 (un id de "ids" de listar_registros: cada fila agrupa los registros de una unidad, y para editar la unidad entera repites la llamada con cada id de "ids"). Solo modifica los campos que envíes; los omitidos se dejan igual. Excepción: un cambio de aplicador o maquinaria se aplica a todo su grupo (las demás parcelas de la misma aplicación), porque el equipo es uno por aplicación. 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

Genera un informe en PDF para el titular de la finca a partir de un texto que redactas tú, y lo guarda en la Documentación de la explotación. Antes, lee las visitas del periodo con listar_visitas (desde/hasta) y, si hace falta, los registros con listar_registros; redacta una síntesis clara (estado de los cultivos, problemas, decisiones y próximos pasos) usando SOLO datos de esas fuentes, sin inventar cifras, dosis ni productos. El PDF lleva la marca de la organización y un anexo que sale de la base de datos, no de tu texto: los tratamientos y fertilizaciones del periodo y la lista de visitas citadas. No los copies en "contenido". Devuelve el nombre del documento, una URL para abrirlo ya (caduca en 10 minutos) y el enlace a la Documentación. Requiere scope de escritura.

generar_informe_pdf

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. "equipo" son los miembros de la organización que entran en esa explotación: los únicos a los que se puede asignar una tarea.

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. Por defecto solo trae las parcelas con el cultivo vigente; las que ya terminaron su cultivo en la campaña (tienen "fechaFinCultivo", y una sucesora con otro cultivo) solo salen con "incluirTerminadas": true.

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. También devuelve los trabajadores activos (personal propio que cobra horas): se pasan como trabajadorIds al registrar un abonado de fondo o cobertera con máquina propia en crear_registros. Una máquina con `empresa` es de una empresa de servicios: con ella no van trabajadores.

listar_recursos_aplicacion

Lista los registros de una explotación según "tipo": "tratamientos" (fitosanitarios, Anexo III RD 1311/2012), "ordenes_tratamiento" (prescripciones para el aplicador: PENDIENTE o EJECUTADA, con sus parcelas y caldo), "fertilizaciones" (abonado ejecutado con UF N-P-K), "riegos" (volúmenes), "planes_abonado" (plan de abonado, RD 1051/2022: UF N-P-K objetivo por ha), "ecorregimenes" (ecorrégimen PAC de cada parcela, RD 1048/2022: práctica, fechas, superficie y sus datos específicos) o "cosechas_comercializadas" (ventas de cosecha: producto, kg, cliente, albarán, lote y parcelas de origen). Filtra opcionalmente por parcela (o varias, p. ej. todos los "parcelaIds" de una unidad de listar_parcelas) o campaña. Cada registro nombra su unidad en "parcela"/"parcelas" ("nombre", "cultivo", "parcelaIds"): un grupo es UNA unidad, preséntalo por su nombre y no enumeres sus parcelas. "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 y por persona asignada. Cada tarea nombra sus unidades en "parcelas" ("nombre", "cultivo", "parcelaIds"): un grupo es UNA unidad. "asignado" es quien tiene que hacerla, o null.

listar_tareas

Lista las visitas del diario de campo de una explotación: fecha, título, unidades de trabajo (parcelas sueltas o grupos, con sus "parcelaIds") 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. Con "desde"/"hasta" devuelve las visitas de ese periodo, sea cual sea su campaña (es lo que necesita generar_informe_pdf).

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. Es reversible: se puede volver a marcar como pendiente.

marcar_tarea

Registra como tratamientos lo que se ha gastado del almacén en una campaña: uno o varios productos, cada uno en uno o varios destinos (parcelas del mismo cultivo, plaga, máquina y fechas). Va en dos llamadas. (1) Calcular, con "productos": el servidor calcula la dosis (la más alta que permite la ficha), cuántas aplicaciones hacen falta hasta las que queden en la campaña, el caldo que cuadra con esa dosis y la concentración, comprueba que en cada fecha había stock según las entradas del almacén y lintea cada aplicación. Los productos con la misma sustancia activa comparten el cupo de aplicaciones de la ficha: lo gasta primero el que va antes en la lista. Sin cantidad, reparte todo el stock que cabe y avisa de lo que sobra (avisoSobrante). Calcular no crea tratamientos ni toca el stock, pero guarda un borrador del plan durante 30 min. Devuelve por producto lo aplicado, lo que sobra, las entradas del almacén y las aplicaciones, un "informe" en markdown (un apartado por producto: cada aplicación en una viñeta y lo que permite la ficha) y, si nada bloquea y vienen aplicadorId y la maquinariaId de cada destino, un "planId". Enseña al usuario ese informe tal cual, sin resumirlo en una tabla, para que compruebe que lo aplicado es correcto; antes, en una o dos frases, lo que decidiste tú (aplicador, máquinas, por qué esas fechas). Trae "bloqueo" en el producto si algo impide crearlo: cualquier alerta de nivel error o warning, un uso ambiguo (con usosCandidatos: elige el más típico para el cultivo y repite con su codigoAgente), fechas imposibles o sin stock. (2) Confirmar, solo con "planId" y tras el visto bueno del usuario: crea exactamente ese plan (los tratamientos) y descuenta el stock del almacén, sin recalcularlo, todo o nada. Si ya se creó, devuelve lo creado sin duplicar. Si caducó (30 min) o alguien registró algo en esas parcelas o gastó stock entre medias, no crea nada: vuelve a calcular. Confirmar requiere scope de escritura.

repartir_almacen

Termina el cultivo de una parcela o grupo dentro de la campaña y deja entrar otro cultivo en el mismo terreno (herbáceos: doble cosecha, segundo cultivo). Úsala cuando en la misma parcela, dentro de la campaña, sale un cultivo y entra otro; NO para corregir el cultivo mal puesto (eso es editar_parcela) ni para cambiar de campaña. La parcela vieja queda como histórico (con "fechaFinCultivo") conservando todos sus registros, y nace una sucesora en la MISMA campaña con el mismo nombre y SIGPAC y el cultivo nuevo; la tool devuelve su id en "nuevasParcelaIds". Desde ese momento los tratamientos, riegos, abonados, órdenes y planes del cultivo nuevo se registran en la sucesora, no en la terminada. Pasa todos los "parcelaIds" de la unidad (de listar_parcelas); un grupo se termina entero. "fechaFin" es el último día del cultivo que termina y debe caer dentro de la campaña. Indica el cultivo nuevo por nombre en "cultivo"; si es ambiguo la tool devuelve candidatos y repites con "codigoCultivo". No se puede terminar una parcela ya terminada: usa la sucesora. Requiere scope de escritura.

terminar_cultivo

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