borrar_fertilizacion
ChatGPTElimina un registro de fertilización (un id de "ids" de listar_registros; para borrar la unidad entera repite con cada id) de forma permanente y revierte el movimiento de almacén asociado (restaura el stock descontado) y quita su parte del parte de trabajo del abonado, que desaparece si se queda sin nada. Esta acción no se puede deshacer: confirma con el usuario antes de invocarla. Requiere scope de escritura.
borrar_tarea
ChatGPTElimina una tarea de forma permanente (se borran también sus vínculos con parcelas). Requiere scope de escritura y confirmación previa (ver instrucciones).
borrar_tratamiento
ChatGPTElimina un tratamiento fitosanitario (un id de "ids" de listar_registros) de forma permanente y revierte el movimiento de almacén asociado (restaura el stock descontado). Borra solo ese registro; para borrar una unidad entera (varias parcelas), repite con cada id de "ids". Esta acción no se puede deshacer: confirma con el usuario antes de invocarla. Requiere scope de escritura.
borrar_visita
ChatGPTElimina una visita del diario de campo de forma permanente (se borran también sus vínculos con parcelas y sus fotos). Requiere scope de escritura y confirmación previa (ver instrucciones).
buscar_producto_registro
ChatGPTBusca un producto fitosanitario en el registro del MAPA por nombre comercial (p. ej. "Roundup") o nº de registro. Devuelve el idProducto que necesitan consultar_usos_autorizados y crear_tratamiento.
buscar_productos_autorizados
ChatGPTQué productos del MAPA están AUTORIZADOS contra un agente (plaga/enfermedad) en un cultivo. Ej: "araña roja" en "naranjo". Pasa el cultivo por texto o, mejor, una parcelaId (deriva su cultivo y prioriza lo que ya hay en almacén). Dosis y plazos ORIENTATIVOS: confírmalos con leer_ficha_registro (idProducto) antes de recomendar en firme.
consultar_usos_autorizados
ChatGPTDado uno o varios productos (idProducto) y una parcela, devuelve los usos autorizados del MAPA para el cultivo de esa parcela: por cada agente, su codigoAgente y los valores de referencia (dosis mín/máx, volumen de caldo, nº de aplicaciones, plazo de seguridad). De aquí salen el agente a tratar (su codigoAgente) y la dosis/caldo a aplicar. Las reglas de elección (dosis normal-alta, caldo por tipo) están en las instructions.
crear_orden_tratamiento
ChatGPTCrea una orden de tratamiento (prescripción PENDIENTE) que el asesor entrega al aplicador: el tratamiento queda planificado pero NO registrado todavía (no descuenta almacén ni pasa el linting normativo; eso ocurre al ejecutarla como tratamiento). Úsala cuando el usuario quiera "prescribir", "ordenar" o "planificar" un tratamiento para que otra persona lo aplique, no para registrar uno ya hecho (para eso usa crear_tratamiento). Acepta una o varias parcelas (mismo cultivo y explotación) y uno o varios productos (el caldo). La orden es el papel que aplica el tractorista, así que en el depósito cabe más que el registro de fitosanitarios: los productos del MAPA van en "productos" (comercial, materia activa, registro y plazo se derivan de su ficha) y todo lo demás —abonos foliares, correctores, mojantes, con o sin fila de almacén— va en "otrosProductos" por su nombre. aplicador y maquinaria son OPCIONALES en la orden. Devuelve el número de orden correlativo asignado. Avisa de la orden nueva con una notificación en la app móvil de Crisopa del propio usuario, si la tiene instalada. Requiere scope de escritura.
crear_plan_abonado
ChatGPTCrea o actualiza el plan de abonado de una campaña para una o varias parcelas (RD 1051/2022): UF N-P-K objetivo por hectárea (ufNitrogeno, ufFosforo, ufPotasio) por parcela. Hay un único plan por parcela y campaña: si la parcela ya tiene uno en esa campaña, se reemplaza entero y si no envías observaciones quedan vacías; fechaElaboracion toma la fecha indicada o la de hoy. Devuelve cuántos planes se crearon/actualizaron y sus ids. Requiere scope de escritura.
crear_registros
ChatGPTRegistra en lote riegos, fertilizaciones y eco-regímenes, mezclados en una sola llamada (p. ej. el riego de cada mes de la campaña, o varios abonados). Todo o nada: si un registro falla no se guarda ninguno y el error dice cuál. Riego: un registro por periodo con los m³/ha de todo el periodo (para repartir una campaña por meses, un registro por mes); va a la campaña de su verano (el año de fechaInicio) aunque pases ids de parcelas de otra campaña. Fertilización: las UF se calculan solas; sin productoAlmacenId se crea un producto al vuelo y se descuenta stock (puede quedar negativo: se avisa). En una explotación con partes de trabajo, el abonado de fondo o cobertera (AF, AC o sin tipo; no la fertirrigación F) nace con su parte y exige maquinariaId (y trabajadorIds si la máquina es propia; lo da listar_recursos_aplicacion), salvo sinParte: true; si falta, se rechaza el lote entero. Eco-régimen: se asigna a parcelas que aún no lo tienen. Los tratamientos NO van aquí (crear_tratamiento, repartir_almacen). Requiere scope de escritura.
crear_tareas_en_lote
ChatGPTCrea 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_tratamiento
ChatGPTRegistra 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_visita
ChatGPTRegistra 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.
detalle_parcela
ChatGPTFicha 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.
editar_fertilizacion
ChatGPTEdita 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_parcela
ChatGPTEdita 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_tarea
ChatGPTEdita 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_tratamiento
ChatGPTEdita 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_visita
ChatGPTEdita 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.
generar_informe_pdf
ChatGPTGenera 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.
leer_ficha_registro
ChatGPTDescarga 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.
listar_almacen
ChatGPTLista 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_explotaciones
ChatGPTLista 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_parcelas
ChatGPTLista 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_recursos_aplicacion
ChatGPTDevuelve 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_registros
ChatGPTLista 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_tareas
ChatGPTLista 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_visitas
ChatGPTLista 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).
marcar_tarea
ChatGPTMarca 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.
repartir_almacen
ChatGPTRegistra 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.
terminar_cultivo
ChatGPTTermina 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.
validar_tratamiento
ChatGPTEjecuta 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.