Responsabilidades de la explotación y el productor agropecuario

Farm describe la unidad de producción. Person, Organization e InformalGroup describen a las personas o entidades responsables de ella. La identidad de una explotación es independiente de la identidad de su productor y de la de cualquier registro.

AgriculturalHolderRole significa responsabilidad de productor agropecuario: las decisiones clave sobre el uso de los recursos y el control de gestión de una finca, de forma individual o conjunta, incluida su responsabilidad técnica y económica. No significa propiedad, empleo ni gestión diaria por sí solos. Un productor también puede ser responsable de la gestión diaria, pero serlo no establece la responsabilidad de productor agropecuario. Las variantes tipadas (PersonAgriculturalHolderRole, OrganizationAgriculturalHolderRole y GroupAgriculturalHolderRole) nombran a una Person, Organization o Group mediante holder_person, holder_organization o holder_group, y a la finca mediante holder_farm, sin admitir un planificador de software como sujeto responsable. Una Farm no enumera sus roles de productor; se encuentran mediante holder_farm.

Los registros de ejemplo sintéticos describen una explotación, un productor cooperativo anterior, dos productores individuales conjuntos actuales y un colectivo informal anterior. Ninguna de las dos personas necesita un identificador nacional. El colectivo tiene un nombre sin una lista completa de miembros. El ejemplo indica la superficie total de la explotación, los tipos de tenencia de la tierra y el ganado que se mantiene, pero no parcelas. El vocabulario de Farm no exige la propiedad de la tierra, una superficie de tierra positiva ni una lista de parcelas; una finca sin tierras tiene un farm_area de cero. La sucesión fechada es un ejemplo explícito de continuidad afirmada de la unidad, no una regla universal para ventas, fusiones o divisiones.

Estas distinciones siguen el WCA 2020 de la FAO, volumen 1, Roma 2017, párrafos 6.2, 6.7–6.14 y 6.17–6.21. Los nombres de clase, los slots de fecha y la persistencia son decisiones de diseño de PublicSchema. El borrador maestro de enero de 2026 del WCA 2030 de la FAO, párrafos 4.21–4.24, también distingue a los responsables de la gestión diaria no remunerados. No se afirma ninguna conformidad con el censo.

Campos de resumen y registro

farm_area es la superficie total que explota la finca, cualquiera que sea el título, como un QuantityValue con su unidad (por ejemplo, UCUM har para hectáreas). No es la suma de las superficies de las parcelas compartidas con otras fincas. land_tenure enumera todos los tipos de arreglo bajo los cuales la finca explota tierras, según los tipos de tenencia de la tierra del ítem 0204 del WCA 2030; describe cómo la finca usa la tierra, no quién tiene derechos sobre ella, y es sensible porque algunos valores revelan una tenencia precaria. livestock_type enumera los tipos de ganado que se mantienen en la finca, sea o no propietaria de ellos la finca, agrupados según las clases de ganado del WCA 2030. Estos campos de resumen no prevalecen sobre los registros detallados de parcelas, tenencia o animales.

Un FarmerRegistration reconoce a una persona, organización o grupo como agricultor para un fin administrativo determinado. registered_farms nombra opcionalmente las fincas que cubre. El registro no establece la responsabilidad de productor agropecuario, derechos sobre la tierra ni la elegibilidad para un programa.

Vocabulario y el perfil de ejemplo local

Todos los campos del vocabulario son opcionales, de modo que las descripciones parciales sigan siendo útiles. El JSON Schema generado valida los campos disponibles, pero las referencias de cadena no demuestran la identidad del destino, y una referencia a un rol abstracto no valida por sí misma el extremo de un rol concreto. El SHACL generado comprueba las relaciones tipadas del grafo con la jerarquía de clases proporcionada.

Ejecute el perfil de demostración, que tiene un nombre propio independiente, desde la raíz del repositorio:

uv run --locked python examples/farm-operators/validate_profile.py

El perfil exige que los roles de productor concretos identifiquen una Farm mediante holder_farm y exactamente su propio extremo de productor tipado. Resuelve localmente las cadenas y los objetos incrustados, rechaza los destinos ausentes o de tipo incorrecto, rechaza el AgriculturalHolderRole abstracto, comprueba el orden de las fechas de vigencia y rechaza los campos que el vocabulario ya no define en Farm y WorkRelationship. Las fechas desconocidas permanecen ausentes y no demuestran si una responsabilidad está vigente. Este perfil solo admite los tipos concretos enumerados; extenderlo a otros subtipos de grupo o de persona requiere un cambio explícito.

El perfil es un ejemplo reproducible, no un servicio de registro operativo. No establece propiedad, registro, derecho a prestaciones ni permisos de divulgación. La elegibilidad de un grupo sigue siendo una decisión del programa. Las subvenciones a cooperativas no pueden insertarse en campos de beneficiario cuyo rango es Party sin un contrato independiente.

Migración desde fincas basadas en Group

Farm ya no hereda los campos de pertenencia de personas a grupos. Conserve los valores de origen heredados antes de decidir qué sujeto describen. GroupType/farm, de nivel normativo, sigue siendo el clasificador de los registros de grupo externos que representan unidades de producción, incluidos los modelos planos agrícolas o de protección social. No se ha redefinido como clasificador de listas de miembros. GroupRole/operator sigue describiendo su función original de pertenencia vinculada a la gestión diaria; no lo asigne automáticamente a un rol de productor. GroupMembership en sí sigue siendo de Person a Group.

ADR-021 registra las alternativas consideradas.

Trabajo en una explotación

Use HoldingWorkAssignment para vincular una Person con una Farm en la que trabaja o se prevé que trabaje. Describe a una persona trabajadora o responsable de la gestión diaria de la explotación. Una asignación directa no necesita ninguna aserción de empleador, contrato de trabajo ni segunda relación. Puede describir a una persona responsable de la gestión diaria no remunerada, una contribución familiar o un trabajo remunerado sin convertir a esa persona en productor.

Use WorkRelationship cuando la relación económica tiene identidad propia: el trabajo de una persona para una unidad económica. Esa unidad puede ser la producción del hogar o una empresa, y no tiene por qué ser una organización constituida legalmente. work_economic_unit contiene el URI de su sujeto. El perfil de ejemplo resuelve localmente ese URI como una Organization, Household, InformalGroup o Farm; afirmar este extremo significa que el sujeto es la unidad económica pertinente, no que toda instancia de esos tipos sea automáticamente una. Cuando la parte vinculada como empleador difiere de la unidad económica, como una agencia que actúa como empleador formal (employer of record), legal_employer la nombra; el perfil de ejemplo no resuelve ese vínculo.

Una asignación en una explotación puede vincularse a la relación de trabajo mediante assignment_work_relationship. Por ejemplo, una persona empleada por una agencia tiene una relación con la agencia de empleo temporal y dos asignaciones en explotaciones distintas. De igual modo, una persona contratista independiente puede tener una relación con su propia empresa y asignaciones para varios clientes. Una explotación cliente no se convierte por ello en el empleador ni en un empleo separado. La asignación y la relación vinculada deben identificar a la misma Person. Ninguna de las dos implica un rol de productor.

El ejemplo de trabajo sintético incluye responsables de la gestión diaria remunerados y no remunerados, un productor que también gestiona, producción familiar para uso propio, un trabajador familiar auxiliar en la producción para el mercado, una persona trabajadora de agencia y una persona contratista. Conserva identidades distintas de persona, explotación, relación económica y asignación.

Campo opcional	Qué describe
work_functions	Una o más funciones, como la gestión diaria o la cosecha. Solo en las asignaciones de trabajo en la explotación.
work_form	Empleo, producción para uso propio u otra forma de trabajo identificada.
work_status	Situación en una clasificación indicada, como la situación en el empleo o una situación más amplia en el trabajo.
work_remuneration	Salario, honorarios, ausencia de remuneración regular u otra modalidad de pago indicada.
work_seasonality	Patrón estacional, con independencia de la función, la situación, la duración del contrato y el tiempo de trabajo.

work_form toma un valor FormOfWork; los otros cuatro usan registros CodedValue que nombran su esquema. Los cinco son opcionales y describen el trabajo en la relación o la asignación que los contiene, no la situación global de la persona respecto a la fuerza de trabajo. Las clasificaciones ausentes siguen siendo desconocidas; las clasificaciones de una relación vinculada no se copian automáticamente en las asignaciones. Cuando ambos estén presentes, prefiera poner las clasificaciones de la relación económica en el WorkRelationship; las funciones en una finca corresponden a la asignación. Los desacuerdos de clasificación requieren una revisión de las fuentes; este ejemplo no los dirime. Los campos de empleo existentes de Person y los códigos de vocabulario no cambian.

Los esquemas de ejemplo bajo https://example.org/farm-work/v1/ son códigos locales sintéticos. Sus etiquetas ilustran dimensiones independientes; no son códigos oficiales de la ILO ni una declaración de conformidad con la ICSE. Una clasificación proporcionada necesita el URI de su esquema y su código original. Los valores desconocidos o locales pueden conservarse sin adivinar un equivalente estándar. Para un perfil vinculado a un estándar, identifique el esquema y la edición exactos y valide su aplicabilidad por separado.

El manual de la ICSE-18 de la ILO, agosto de 2023, págs. impresas 4–5 y 21, aporta la distinción entre persona y unidad económica y explica por qué las contribuciones familiares no remuneradas a la producción para el mercado pueden ser empleo, mientras que el trabajo para uso propio es una forma distinta. El empleo no siempre significa la condición de asalariado. Estas distinciones motivan el modelo; la ILO no prescribe la clase de asignación ni la serialización en cinco campos. El borrador maestro de enero de 2026 del WCA 2030 de la FAO, §§4.21–4.24 y 7.9.16–7.9.18, fundamenta las distinciones entre responsable de la gestión y productor, y entre asalariado y contratista.

La edición final, WCA 2030 de la FAO, 2026, se publicó el 4 de mayo de 2026 según la página de la ronda de la FAO. Los tipos de tenencia de la tierra (ítem 0204, párrafos 7.2.38 a 7.2.47) y las clases de ganado (anexo 8) que usa el vocabulario siguen la edición final; los números de párrafo citados arriba para el trabajo y la gestión proceden del borrador de enero.

Límites y migración del perfil de trabajo

El perfil ejecutable valida ambos archivos de ejemplo. Para WorkRelationship exige una Person y una unidad económica resuelta localmente; para HoldingWorkAssignment exige una Person y una Farm. Un vínculo de relación opcional debe resolverse como un WorkRelationship de esa misma persona. Los campos de clasificación siguen siendo opcionales. Las fechas proporcionadas deben ser válidas y estar ordenadas. Una asignación vinculada debe ajustarse a los límites conocidos de la relación; las fechas ausentes no se convierten en intervalos infinitos.

En estos ejemplos de trabajo, start_date es el primer día calendario efectivo y end_date es el último. El perfil rechaza una fecha de fin anterior a la fecha de inicio cuando se proporcionan ambas fechas. La asignación de Amina como responsable de la gestión termina el 30 de junio de 2025 y la asignación que la sustituye comienza el 1 de julio de 2025, sin ningún día efectivo superpuesto. La responsabilidad de productor agropecuario no cambia. Esto aplica la convención de fechas de las relaciones. La conversión de las fechas de origen sigue la guía de migración de fechas de relaciones, que exige confirmar primero el límite y la precisión de las fechas de la fuente.

Una pertenencia heredada de Person a Farm con un rol de responsable de la gestión diaria o de trabajador puede convertirse en un HoldingWorkAssignment una vez confirmados su significado laboral y la identidad de su destino. Conserve el código de rol original y su esquema en work_functions cuando corresponda; no infiera a partir de ese rol la remuneración, la forma, la situación, la estacionalidad ni la responsabilidad de productor agropecuario. Un código GroupRole/operator describe la gestión diaria y no es automáticamente un productor. Una pertenencia que describe la propiedad necesita una aserción de propiedad, no una asignación de trabajo. GroupMembership sigue siendo de Person a Group y no puede tener como destino una Farm.

La alternativa más simple de mayor peso es un único FarmWorkerRole. Sirve para una lista de trabajadores, pero confunde la relación económica de la agencia o del contratista con cada lugar de trabajo. Exigir un WorkRelationship más una asignación para cada participante introduce registros innecesarios cuando solo se conoce la participación. El vínculo opcional admite ambos casos. Aquí no se afirman horas, derechos derivados de la legislación laboral ni recuentos censales automáticos.