Entidades

Esta sección documenta las entidades principales de la API CXTierra, basadas en los estándares FIWARE para agricultura inteligente. Cada entidad representa un componente clave del ecosistema agrícola y sigue el modelo de datos NGSI-LD.

Arquitectura de la API

El siguiente diagrama muestra las entidades disponibles en la API CXTierra y las operaciones HTTP que puedes realizar con cada una:

Leyenda

Símbolo	Significado
GET	Consultar información de la entidad
Morado	Personas y titulares
Azul	Explotaciones
Amarillo	Parcelas/Fincas
Verde claro	Cultivos y actividades
Verde agua	Catálogos de referencia
Naranja	Servicios de trabajos asíncronos

Entidades Disponibles

Todas las siguientes entidades están completamente operativas en la API:

Entidades Principales

Person: Información de titulares de explotación
AgriFarm: Datos de explotaciones agrícolas
AgriParcel: Información de fincas/parcelas
AgriCrop: Datos de cultivos

Registros de Actividad

AgriFertilize: Registros de aplicación de fertilizantes
AgriPhytosanitarys: Registros de productos fitosanitarios aplicados

Catálogos

Type Phytosanitary: Catálogo oficial de productos fitosanitarios
Type Crop: Catálogo de tipos de cultivos
Type Crop Variety: Catálogo de variedades de cultivos

Servicios Asíncronos

Job Status: Consultar el estado de trabajos asíncronos en proceso
Job Result: Obtener el resultado de trabajos asíncronos completados

Tabla de Contenidos

Relaciones entre Entidades
AgriFarm (Explotación)
AgriParcel (Finca)
AgriCrop (Cultivo)
AgriFertilize (Fertilización)
AgriPhytosanitarys (Fitosanitarios)
Servicios de Trabajos Asíncronos
- Job Status
- Job Result
Person (Titular)
Type Phytosanitary
Type Crop
Type Crop Variety

Información General de la API

Autenticación Requerida

Todos los endpoints requieren las siguientes cabeceras:

Ocp-Apim-Subscription-Key: Tu clave de suscripción
Ocp-Apim-Subscription-Sid: Tu ID de suscripción

Paginación Recomendada

Se recomienda usar paginación para evitar timeouts en respuestas grandes:

page: Número de página (empezando en 0)
page_size: Elementos por página (mínimo 1, recomendado 10-50)

Relaciones

Esta tabla muestra cómo se relacionan las entidades FIWARE con los conceptos de Plataforma Tierra:

Estado	Entidad FIWARE	Concepto PT	Descripción	Cardinalidad
✅	AgriFarm	Explotación	Unidad técnico-económica del sector primario, equivalente a una empresa agrícola o ganadera.	1 explotación → 0..n fincas
✅	AgriParcel	Finca	Porción delimitada de terreno dentro de una explotación.	1 finca → 0..n cultivos
✅	AgriCrop	Cultivo	Zona trabajada dedicada a la actividad agrícola en una finca.	1 cultivo → 0..n fertilizaciones + 0..n fitosanitarios
✅	AgriFertilizes	Fertilización	Registro de aplicación de fertilizantes en un cultivo.	n fertilizaciones → 1 cultivo
✅	AgriPhytosanitarys	Fitosanitarios	Registro de productos fitosanitarios aplicados en el cultivo.	n aplicaciones fitosanitarias → 1 cultivo
✅	Person	Titular	Personas asociadas a una explotación (propietarios, administradores, operadores, etc.).	n titulares → 1 explotación

Jerarquía de Datos

text

Titular (Person)
└── Explotación (AgriFarm)
    └── Finca (AgriParcel)
        Cultivo (AgriCrop)
          ├── Fertilizaciones (AgriFertilizes)
          └── Fitosanitarios (AgriPhytosanitarys)

AgriFarm

Descripción de AgriFarm

Esta entidad contiene una descripción armonizada de una explotación genérica compuesta por edificios y parcelas. Esta entidad se asocia principalmente con la agricultura vertical y las aplicaciones IoT relacionadas.

Casos de uso comunes:

Gestión de explotaciones agrícolas
Localización geográfica de propiedades
Asociación con titulares y parcelas
Integración con sistemas SIGPAC

Ejemplo de AgriFarm

Respuesta que recibirás

json

[
  {
    "id": "urn:ngsi-ld:AgriFarm:1-1",
    "type": "AgriFarm",
    "dateCreated": "21-06-2023 10:03:54",
    "dateModified": "21-06-2023 10:03:54",
    "name": "OLIVAR Y ALMENDROS",
    "year": 2023,
    "description": "OLIVAR Y ALMENDROS",
    "relatedSource": [
      {
        "application": "urn:ngsi-ld:AgriApp:CXTierra",
        "applicationEntityId": "app:CXTierra"
      }
    ],
    "seeAlso": [
      "https://example.org/concept/farm",
      "https://datamodel.org/example/farm"
    ],
    "location": {
      "type": "Point",
      "coordinates": []
    },
    "landLocation": {
      "type": "Polygon",
      "coordinates": []
    },
    "address": {
      "addressLocality": "Urueñas",
      "addressCountry": "ES",
      "streetAddress": ""
    },
    "contactPoint": {
      "email": "",
      "telephone": ""
    },
    "ownedBy": "urn:ngsi-ld:Person:2467",
    "hasBuilding": [],
    "hasAgriParcel": [
      "urn:ngsi-ld:AgriParcel:3566",
      "urn:ngsi-ld:AgriParcel:3569",
      "urn:ngsi-ld:AgriParcel:3565",
      "urn:ngsi-ld:AgriParcel:3564",
      "urn:ngsi-ld:AgriParcel:3567",
      "urn:ngsi-ld:AgriParcel:3568"
    ],
    "regionalAttributes": [
      {
        "region": "Spain",
        "nif": "00000000A",
        "ren": "",
        "rea": "000X0000X",
        "regepa": "",
        "address": {
          "province": "Segovia",
          "community": {
            "type": "Community",
            "id": 8,
            "ine": 7,
            "name": "Castilla Y León"
          },
          "cp": "40317"
        },
        "siex": 0
      }
    ]
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`id`	string	Identificador único de la entidad en formato URN NGSI-LD
`type`	string	Tipo de entidad NGSI-LD (AgriFarm)
`dateCreated`	string	Fecha y hora de creación de la entidad
`dateModified`	string	Fecha y hora de la última modificación de la entidad
`name`	string	Nombre asignado a la explotación
`year`	integer	Año de la campaña agrícola asociada
`description`	string	Descripción detallada de la explotación
`relatedSource`	array	Array de fuentes relacionadas con la entidad
`relatedSource[].application`	string	URN de la aplicación origen
`relatedSource[].applicationEntityId`	string	ID de la entidad en la aplicación origen
`seeAlso`	array	Array de URLs con información relacionada
`location`	object	Ubicación geográfica del punto central de la explotación (GeoJSON Point)
`location.type`	string	Tipo de geometría (Point)
`location.coordinates`	array	Array de coordenadas [longitud, latitud]
`landLocation`	object	Geometría del terreno de la explotación (GeoJSON Polygon)
`landLocation.type`	string	Tipo de geometría (Polygon)
`landLocation.coordinates`	array	Array de coordenadas que definen el polígono
`address`	object	Información de dirección postal
`address.addressLocality`	string	Localidad de la explotación
`address.addressCountry`	string	Código de país (ISO 3166-1 alpha-2)
`address.streetAddress`	string	Dirección postal completa
`contactPoint`	object	Información de contacto
`contactPoint.email`	string	Email de contacto
`contactPoint.telephone`	string	Teléfono de contacto
`ownedBy`	string	URN de la persona propietaria (referencia a entidad Person)
`hasBuilding`	array	Array de URNs de edificios asociados
`hasAgriParcel`	array	Array de URNs de parcelas asociadas (referencias a entidades AgriParcel)
`regionalAttributes`	array	Array de atributos específicos regionales
`regionalAttributes[].region`	string	Nombre de la región
`regionalAttributes[].nif`	string	NIF asignado a la explotación
`regionalAttributes[].ren`	string	Número de Registro de Explotación Nacional
`regionalAttributes[].rea`	string	Número de Registro de Explotación Autonómico
`regionalAttributes[].regepa`	string	Número de Registro General de Explotaciones Agrícolas
`regionalAttributes[].address`	object	Dirección regional
`regionalAttributes[].address.province`	string	Provincia de la explotación
`regionalAttributes[].address.community`	object	Información de la comunidad autónoma
`regionalAttributes[].address.community.type`	string	Tipo de dato (Community)
`regionalAttributes[].address.community.id`	integer	Identificador de la comunidad
`regionalAttributes[].address.community.ine`	integer	Código INE de la comunidad
`regionalAttributes[].address.community.name`	string	Nombre de la comunidad autónoma
`regionalAttributes[].address.cp`	string	Código postal
`regionalAttributes[].siex`	integer	Indica si la explotación se ha importado desde el REA (0 = No, 1 = Sí)

Endpoints de AgriFarm

URLs Disponibles

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/agrifarms	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/agrifarms	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/agrifarms	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/agrifarms	Desarrollo oSIGris

Parámetros de AgriFarm

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`agrifarmId`	string	Opcional	ID de la explotación para filtrar resultados	urn:ngsi-ld:AgriFarm:383-367
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Ejemplo de petición cURL

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/agrifarms?agrifarmId=urn:ngsi-ld:AgriFarm:383-367" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Parámetros de AgriFarm

Parámetro	Tipo	Descripción	Valor por defecto
`page`	integer	Número de página (inicia en 0)	null
`page_size`	integer	Elementos por página (mínimo 1)	null

Recomendación

Se recomienda usar paginación para evitar timeouts en consultas grandes.

AgriParcel

Descripción de AgriParcel

La entidad AgriParcel proporciona una descripción armonizada de una parcela genérica. Esta entidad está diseñada para asociarse principalmente con la agricultura vertical y aplicaciones IoT relacionadas.

Características principales:

Geometría tipo POLYGON con coordenadas geográficas
Integración con datos SIGPAC
Pertenencia a una explotación (AgriFarm)
Posibilidad de contener múltiples cultivos

Ejemplo de AgriParcel

Respuesta que recibirás

json

[
  {
    "id": "urn:ngsi-ld:AgriParcel:3566",
    "type": "AgriParcel",
    "dateCreated": "21-06-2023 10:03:54",
    "dateModified": "21-06-2023 10:03:54",
    "location": {
      "type": "POLYGON",
      "coordinates": [
        [
          [-2.594234, 36.877484],
          [-2.594221, 36.877384],
          [-2.594308, 36.877346],
          [-2.59433, 36.877216],
          [-2.594331, 36.87709],
          [-2.594396, 36.877023],
          [-2.594401, 36.876883],
          [-2.594245, 36.876925],
          [-2.594124, 36.876937],
          [-2.593946, 36.876856],
          [-2.59431, 36.876798],
          [-2.595025, 36.876626],
          [-2.595269, 36.876543],
          [-2.595437, 36.876794],
          [-2.595488, 36.876797],
          [-2.5956, 36.877017],
          [-2.595767, 36.877241],
          [-2.595815, 36.877192],
          [-2.59588, 36.877238],
          [-2.595866, 36.877425],
          [-2.595841, 36.877498],
          [-2.595703, 36.877538],
          [-2.595526, 36.877619],
          [-2.595125, 36.877604],
          [-2.59498, 36.87762],
          [-2.594908, 36.877661],
          [-2.594817, 36.877748],
          [-2.59475, 36.877765],
          [-2.594553, 36.877671],
          [-2.59428, 36.877571],
          [-2.594212, 36.877512],
          [-2.594234, 36.877484]
        ]
      ]
    },
    "area": null,
    "description": "Almederos 2",
    "category": "",
    "relatedSource": [
      {
        "application": "urn:ngsi-ld:AgriApp:CXTierra",
        "applicationEntityId": "app:CXTierra"
      }
    ],
    "seeAlso": [
      "https://example.org/concept/agriparcel",
      "https://datamodel.org/example/agriparcel"
    ],
    "belongsTo": "urn:ngsi-ld:AgriFarm:383-367",
    "ownedBy": null,
    "owner": [],
    "regionalAttributes": [
      {
        "region": "Spain",
        "sigpac": [
          {
            "type": "PS",
            "id": "4554",
            "id2": "4",
            "prov": "4",
            "town": "41",
            "aggr": "0",
            "zone": "0",
            "pol": "13",
            "parc": "99",
            "enc": "3",
            "purp": "FY",
            "dim": "1.3312",
            "decdim": "1.33",
            "slop": "12.1",
            "vul": "1",
            "sie": "0",
            "con": "0",
            "geom": {
              "type": null,
              "coordinates": []
            }
          }
        ],
        "siex": 0
      }
    ]
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`id`	string	Identificador único de la parcela en formato URN NGSI-LD
`type`	string	Tipo de entidad NGSI-LD (AgriParcel)
`dateCreated`	string	Fecha y hora de creación de la entidad
`dateModified`	string	Fecha y hora de la última modificación de la entidad
`location`	object	Geometría de la parcela (GeoJSON Polygon)
`location.type`	string	Tipo de geometría (POLYGON)
`location.coordinates`	array	Array de coordenadas que definen el polígono de la parcela
`area`	number	Superficie de la parcela en hectáreas (puede ser null)
`description`	string	Nombre o descripción de la parcela
`category`	string	Categoría de la parcela
`relatedSource`	array	Array de fuentes relacionadas con la entidad
`relatedSource[].application`	string	URN de la aplicación origen
`relatedSource[].applicationEntityId`	string	ID de la entidad en la aplicación origen
`seeAlso`	array	Array de URLs con información relacionada
`belongsTo`	string	URN de la explotación a la que pertenece (referencia a AgriFarm)
`ownedBy`	string	URN del propietario (puede ser null)
`owner`	array	Array de propietarios
`regionalAttributes`	array	Array de atributos específicos regionales
`regionalAttributes[].region`	string	Nombre de la región
`regionalAttributes[].sigpac`	array	Array de referencias SIGPAC de la parcela
`regionalAttributes[].sigpac[].type`	string	Tipo de dato (PS)
`regionalAttributes[].sigpac[].id`	string	Identificador asignado al recinto SIGPAC
`regionalAttributes[].sigpac[].id2`	string	Identificador auxiliar del recinto SIGPAC
`regionalAttributes[].sigpac[].prov`	string	Código de provincia del recinto SIGPAC
`regionalAttributes[].sigpac[].town`	string	Código de municipio del recinto SIGPAC
`regionalAttributes[].sigpac[].aggr`	string	Código de agregado del recinto SIGPAC
`regionalAttributes[].sigpac[].zone`	string	Código de zona del recinto SIGPAC
`regionalAttributes[].sigpac[].pol`	string	Código de polígono del recinto SIGPAC
`regionalAttributes[].sigpac[].parc`	string	Código de parcela del recinto SIGPAC
`regionalAttributes[].sigpac[].enc`	string	Código de recinto del recinto SIGPAC
`regionalAttributes[].sigpac[].purp`	string	Código de aprovechamiento del recinto SIGPAC
`regionalAttributes[].sigpac[].dim`	string	Superficie en hectáreas del recinto SIGPAC
`regionalAttributes[].sigpac[].decdim`	string	Superficie declarada del recinto SIGPAC
`regionalAttributes[].sigpac[].slop`	string	Pendiente del recinto SIGPAC en porcentaje
`regionalAttributes[].sigpac[].vul`	string	Indica si el recinto es vulnerable (0 = No, 1 = Sí)
`regionalAttributes[].sigpac[].sie`	string	Indicador SIE del recinto SIGPAC
`regionalAttributes[].sigpac[].con`	string	Indicador de conservación del recinto SIGPAC
`regionalAttributes[].sigpac[].geom`	object	Geometría del recinto SIGPAC
`regionalAttributes[].sigpac[].geom.type`	string	Tipo de geometría (puede ser null)
`regionalAttributes[].sigpac[].geom.coordinates`	array	Array de coordenadas
`regionalAttributes[].siex`	integer	Indica si la parcela se ha importado desde el REA (0 = No, 1 = Sí)

Endpoints de AgriParcel

URLs para Parcelas

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/agriparcels	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/agriparcels	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/agriparcels	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/agriparcels	Desarrollo oSIGris

Parámetros de AgriParcel

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`agrifarmId`	string	SÍ	ID de la explotación	urn:ngsi-ld:AgriFarm:383-367
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Parámetro Obligatorio

El parámetro agrifarmId es obligatorio para consultar parcelas. Debe obtenerlo previamente del endpoint /agrifarms.

Ejemplo de petición cURL

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/agriparcels?agrifarmId=urn:ngsi-ld:AgriFarm:383-367" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

AgriCrop

Descripción de AgriCrop

La entidad AgriCrop proporciona una descripción armonizada de un cultivo genérico. Esta entidad está diseñada para asociarse principalmente con la agricultura vertical y aplicaciones IoT relacionadas.

Información incluida:

Tipo de cultivo y variedad
Sistema de cultivo (aire libre, invernadero, etc.)
Fechas de inicio y fin del cultivo
Asociación con parcelas SIGPAC
Dimensiones por parcela

Ejemplo de AgriCrop

Respuesta que recibirás

json

[
  {
    "id": "urn:ngsi-ld:AgriCrop:1442",
    "type": "AgriCrop",
    "dateCreated": "21-06-2023 09:57:16",
    "dateModified": "21-06-2023 09:57:16",
    "name": "",
    "alternateName": "Hojiblanca",
    "agroVocConcept": "",
    "seeAlso": [],
    "description": "Olivo Hojiblanca",
    "wateringFrequency": "",
    "regionalAttributes": [
      {
        "region": "Spain",
        "sagip": {
          "type": "TypeSagip",
          "id": "1",
          "name": "Sin especificar",
          "acronym": "",
          "detail": ""
        },
        "sigpac": [
          {
            "type": "CropSigpac",
            "id": "4044",
            "reacode": null,
            "inidate": "21-06-2023 09:57:16",
            "enddate": "",
            "dimension": 0.368,
            "idseason": "383",
            "idparcel": "3564",
            "idsigpac": "4552",
            "idcrop": "1442"
          }
        ],
        "subtype": {
          "type": "TCV",
          "id": 10069,
          "typecrop": {
            "type": "TypeCrop",
            "id": "101",
            "name": "Olivo",
            "subtypeid": "1",
            "style": {
              "type": "Style",
              "id": "1101",
              "name": "crop_101"
            }
          },
          "code": 138,
          "name": "Hojiblanca"
        },
        "system": {
          "type": "TypeCropSystem",
          "id": 1,
          "name": "Aire libre",
          "detail": ""
        }
      }
    ]
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`id`	string	Identificador único del cultivo en formato URN NGSI-LD
`type`	string	Tipo de entidad NGSI-LD (AgriCrop)
`dateCreated`	string	Fecha y hora de creación de la entidad
`dateModified`	string	Fecha y hora de la última modificación de la entidad
`name`	string	Nombre del cultivo
`alternateName`	string	Nombre alternativo del cultivo (nombre de la variedad)
`agroVocConcept`	string	Concepto de vocabulario agrícola asociado
`seeAlso`	array	Array de URLs con información relacionada
`description`	string	Descripción detallada del cultivo
`wateringFrequency`	string	Frecuencia de riego
`regionalAttributes`	array	Array de atributos específicos regionales
`regionalAttributes[].region`	string	Nombre de la región
`regionalAttributes[].sagip`	object	Información del Sistema Agrícola de Gestión de Información de Producciones
`regionalAttributes[].sagip.type`	string	Tipo de dato (TypeSagip)
`regionalAttributes[].sagip.id`	string	Identificador del tipo SAGIP
`regionalAttributes[].sagip.name`	string	Nombre del tipo SAGIP
`regionalAttributes[].sagip.acronym`	string	Acrónimo del tipo SAGIP
`regionalAttributes[].sagip.detail`	string	Detalles adicionales del tipo SAGIP
`regionalAttributes[].sigpac`	array	Array de referencias SIGPAC asociadas al cultivo
`regionalAttributes[].sigpac[].type`	string	Tipo de dato (CropSigpac)
`regionalAttributes[].sigpac[].id`	string	Identificador de la relación cultivo-SIGPAC
`regionalAttributes[].sigpac[].reacode`	string	Código REA (puede ser null)
`regionalAttributes[].sigpac[].inidate`	string	Fecha de inicio del cultivo en este recinto SIGPAC
`regionalAttributes[].sigpac[].enddate`	string	Fecha de fin del cultivo en este recinto SIGPAC
`regionalAttributes[].sigpac[].dimension`	number	Superficie del cultivo en este recinto SIGPAC (hectáreas)
`regionalAttributes[].sigpac[].idseason`	string	ID de la campaña agrícola
`regionalAttributes[].sigpac[].idparcel`	string	ID de la parcela
`regionalAttributes[].sigpac[].idsigpac`	string	ID del recinto SIGPAC
`regionalAttributes[].sigpac[].idcrop`	string	ID del cultivo
`regionalAttributes[].subtype`	object	Información del tipo y variedad de cultivo
`regionalAttributes[].subtype.type`	string	Tipo de dato (TCV - TypeCropVariety)
`regionalAttributes[].subtype.id`	integer	Identificador de la variedad de cultivo
`regionalAttributes[].subtype.typecrop`	object	Información del tipo de cultivo
`regionalAttributes[].subtype.typecrop.type`	string	Tipo de dato (TypeCrop)
`regionalAttributes[].subtype.typecrop.id`	string	Identificador del tipo de cultivo
`regionalAttributes[].subtype.typecrop.name`	string	Nombre del tipo de cultivo
`regionalAttributes[].subtype.typecrop.subtypeid`	string	ID del subtipo
`regionalAttributes[].subtype.typecrop.style`	object	Información de estilo visual
`regionalAttributes[].subtype.typecrop.style.type`	string	Tipo de dato (Style)
`regionalAttributes[].subtype.typecrop.style.id`	string	Identificador del estilo
`regionalAttributes[].subtype.typecrop.style.name`	string	Nombre del estilo
`regionalAttributes[].subtype.code`	integer	Código de la variedad
`regionalAttributes[].subtype.name`	string	Nombre de la variedad de cultivo
`regionalAttributes[].system`	object	Sistema de cultivo utilizado
`regionalAttributes[].system.type`	string	Tipo de dato (TypeCropSystem)
`regionalAttributes[].system.id`	integer	Identificador del sistema de cultivo
`regionalAttributes[].system.name`	string	Nombre del sistema de cultivo (ej: Aire libre, Invernadero)
`regionalAttributes[].system.detail`	string	Detalles adicionales del sistema de cultivo

Endpoints de AgriCrop

URLs para AgriCrop

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/agricrops	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/agricrops	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/agricrops	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/agricrops	Desarrollo oSIGris

Parámetros de AgriCrop

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`agrifarmId`	string	SÍ	ID de la explotación	urn:ngsi-ld:AgriFarm:383-367
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Parámetro Obligatorio

El parámetro agrifarmId es obligatorio para consultar cultivos. Debe obtenerlo previamente del endpoint /agrifarms.

Ejemplo de petición cURL

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/agricrops?agrifarmId=urn:ngsi-ld:AgriFarm:383-367" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

AgriFertilize

Descripción de AgriFertilize

La entidad AgriFertilize representa información detallada sobre la aplicación de fertilizantes en cultivos, incluyendo composición química, dosificación y métodos de aplicación.

Datos incluidos:

Información del producto fertilizante
Composición química (macronutrientes, micronutrientes, etc.)
Dosificación y unidades de medida
Fechas de aplicación
Maquinaria utilizada
Asociación con cultivos específicos

Ejemplo de AgriFertilize

Respuesta que recibirás

json

[
  {
    "id": "urn:ngsi-ld:AgriFertilize:1",
    "type": "AgriFertilize",
    "dateCreated": "2024-05-30T09:14:44",
    "dateModified": "2024-05-30T09:14:44",
    "name": "",
    "subtype": {
      "type": "TypeFertilize",
      "id": 1339,
      "code": "F0002478/2025",
      "name": "Abono Organico Npk (Ca) 1,5-1-2 (2) Mezcla De Origen Animal Y Vegetal Sirlepur",
      "mmcm": [
        {
          "type": "CM",
          "id": 10000,
          "subtype": {
            "type": "TCM",
            "id": 1,
            "subtype": {
              "type": "SCM",
              "id": 1,
              "name": "Macronutriente principal"
            },
            "code": 1,
            "name": "Nitrógeno total",
            "symbol": "% N total"
          },
          "value": 1.5
        },
        {
          "type": "CM",
          "id": 10001,
          "subtype": {
            "type": "TCM",
            "id": 6,
            "subtype": {
              "type": "SCM",
              "id": 1,
              "name": "Macronutriente principal"
            },
            "code": 6,
            "name": "Óxido de fósforo total",
            "symbol": "% P2O5 total"
          },
          "value": 1
        },
        {
          "type": "CM",
          "id": 10002,
          "subtype": {
            "type": "TCM",
            "id": 9,
            "subtype": {
              "type": "SCM",
              "id": 1,
              "name": "Macronutriente principal"
            },
            "code": 9,
            "name": "Óxido de potasio",
            "symbol": "% K2O total"
          },
          "value": 2
        }
      ],
      "macm": [
        {
          "type": "CM",
          "id": 44578,
          "subtype": {
            "type": "TCM",
            "id": 2,
            "subtype": {
              "type": "SCM",
              "id": 2,
              "name": "Otro macronutriente"
            },
            "code": 2,
            "name": "Nitrógeno orgánico",
            "symbol": "% N orgánico"
          },
          "value": 1.5
        }
      ],
      "hecm": [
        {
          "type": "CM",
          "id": 44582,
          "subtype": {
            "type": "TCM",
            "id": 16,
            "subtype": {
              "type": "SCM",
              "id": 4,
              "name": "Metal pesado"
            },
            "code": 2,
            "name": "Cobre",
            "symbol": "% Cu"
          },
          "value": 0.0001
        }
      ],
      "micm": [
        {
          "type": "CM",
          "id": 44581,
          "subtype": {
            "type": "TCM",
            "id": 22,
            "subtype": {
              "type": "SCM",
              "id": 3,
              "name": "Micronutriente"
            },
            "code": 1,
            "name": "Boro",
            "symbol": "% Bo"
          },
          "value": 1.1
        }
      ],
      "accm": [
        {
          "type": "CM",
          "id": 58492,
          "subtype": {
            "type": "TCM",
            "id": 33,
            "subtype": {
              "type": "SCM",
              "id": 5,
              "name": "Ácido"
            },
            "code": -1,
            "name": "Ácido húmico",
            "symbol": "% Hum"
          },
          "value": 1
        }
      ],
      "aacm": [
        {
          "type": "CM",
          "id": 58494,
          "subtype": {
            "type": "TCM",
            "id": 40,
            "subtype": {
              "type": "SCM",
              "id": 6,
              "name": "Aminoácido"
            },
            "code": -1,
            "name": "Glicina",
            "symbol": "% Gly"
          },
          "value": 1
        }
      ],
      "otcm": [
        {
          "type": "CM",
          "id": 58496,
          "subtype": {
            "type": "TCM",
            "id": 54,
            "subtype": {
              "type": "SCM",
              "id": 7,
              "name": "Otro"
            },
            "code": -1,
            "name": "Manitol",
            "symbol": "% manitol"
          },
          "value": 0.4
        }
      ],
      "comp": {
        "type": "Company",
        "id": 269,
        "name": "Organicos Pedrin, S.l",
        "nif": ""
      },
      "manure": "",
      "material": {
        "type": "TMF",
        "id": 15,
        "name": "Productos fertilizantes: abonos orgánicos"
      },
      "matdet": "",
      "provider": "",
      "nif": "",
      "check": 0,
      "metadata": [
        {
          "type": "Create",
          "user": {
            "type": "UserMetadata",
            "id": "1",
            "loginname": "sistema",
            "email": "",
            "name": "Sistema",
            "surname": "",
            "nif": ""
          },
          "date": "2024-02-09T15:48:46"
        }
      ],
      "reviewed": "1"
    },
    "inidate": "2025-05-30T09:14:44",
    "enddate": "",
    "dose": 10,
    "measure": {
      "type": "Measure",
      "id": "501",
      "subtype": {
        "type": "TypeMeasure",
        "id": "6",
        "name": "Fertilizante"
      },
      "code": 17,
      "name": "Kilogramo por hectárea",
      "symbol": "kg/ha",
      "prior": "1",
      "detail": ""
    },
    "soup": 1000,
    "msoup": {
      "type": "Measure",
      "id": "514",
      "subtype": {
        "type": "TypeMeasure",
        "id": "6",
        "name": "Fertilizante"
      },
      "code": 4,
      "name": "Litro",
      "symbol": "l",
      "prior": "3",
      "detail": ""
    },
    "r10": "",
    "mud": 0,
    "bill": "",
    "plan": "",
    "taf": {
      "type": "TAF",
      "id": "1",
      "name": "Abonado de fondo"
    },
    "maf": {
      "type": "MAF",
      "id": "1",
      "name": "Esparcido general"
    },
    "tmi": {
      "type": "TMI",
      "id": "1",
      "name": "Sin especificar",
      "acronym": ""
    },
    "machine": [
      {
        "type": "MachineInfoFertilize",
        "id": "1",
        "product": "Agua",
        "detail": "",
        "idmachine": "8"
      }
    ],
    "detail": "",
    "idcp": ["13", "14", "15"]
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`id`	string	Identificador único de la aplicación de fertilizante en formato URN NGSI-LD
`type`	string	Tipo de entidad NGSI-LD (AgriFertilize)
`dateCreated`	string	Fecha y hora de creación de la entidad
`dateModified`	string	Fecha y hora de la última modificación de la entidad
`name`	string	Nombre de la aplicación de fertilizante
`subtype`	object	Información detallada del tipo de fertilizante
`subtype.type`	string	Tipo de dato (TypeFertilize)
`subtype.id`	integer	Identificador del tipo de fertilizante
`subtype.code`	string	Código de registro del fertilizante
`subtype.name`	string	Nombre completo del producto fertilizante
`subtype.mmcm`	array	Array de macronutrientes principales (N, P, K)
`subtype.mmcm[].type`	string	Tipo de dato (CM - ChemicalMeasure)
`subtype.mmcm[].id`	integer	Identificador de la medida química
`subtype.mmcm[].subtype`	object	Información del tipo de componente químico
`subtype.mmcm[].subtype.type`	string	Tipo de dato (TCM - TypeChemicalMeasure)
`subtype.mmcm[].subtype.id`	integer	Identificador del tipo de componente
`subtype.mmcm[].subtype.subtype`	object	Subcategoría del componente (SCM - SubtypeChemicalMeasure)
`subtype.mmcm[].subtype.subtype.id`	integer	Identificador de la subcategoría
`subtype.mmcm[].subtype.subtype.name`	string	Nombre de la subcategoría (ej: Macronutriente principal)
`subtype.mmcm[].subtype.code`	integer	Código del componente químico
`subtype.mmcm[].subtype.name`	string	Nombre del componente (ej: Nitrógeno total, Óxido de fósforo)
`subtype.mmcm[].subtype.symbol`	string	Símbolo químico del componente (ej: % N total, % P2O5)
`subtype.mmcm[].value`	number	Valor porcentual del componente en el fertilizante
`subtype.macm`	array	Array de otros macronutrientes (mismo formato que mmcm)
`subtype.hecm`	array	Array de metales pesados (mismo formato que mmcm)
`subtype.micm`	array	Array de micronutrientes (mismo formato que mmcm)
`subtype.accm`	array	Array de ácidos (mismo formato que mmcm)
`subtype.aacm`	array	Array de aminoácidos (mismo formato que mmcm)
`subtype.otcm`	array	Array de otros componentes (mismo formato que mmcm)
`subtype.comp`	object	Información de la compañía fabricante
`subtype.comp.type`	string	Tipo de dato (Company)
`subtype.comp.id`	integer	Identificador de la compañía
`subtype.comp.name`	string	Nombre de la compañía
`subtype.comp.nif`	string	NIF de la compañía
`subtype.manure`	string	Información sobre estiércol
`subtype.material`	object	Tipo de material fertilizante
`subtype.material.type`	string	Tipo de dato (TMF - TypeMaterialFertilize)
`subtype.material.id`	integer	Identificador del tipo de material
`subtype.material.name`	string	Nombre del tipo de material
`subtype.matdet`	string	Detalles del material
`subtype.provider`	string	Proveedor del fertilizante
`subtype.nif`	string	NIF del proveedor
`subtype.check`	integer	Indicador de verificación
`subtype.metadata`	array	Array de metadatos de creación y modificación
`subtype.metadata[].type`	string	Tipo de operación (Create, Update)
`subtype.metadata[].user`	object	Información del usuario que realizó la operación
`subtype.metadata[].user.type`	string	Tipo de dato (UserMetadata)
`subtype.metadata[].user.id`	string	ID del usuario
`subtype.metadata[].user.loginname`	string	Nombre de login del usuario
`subtype.metadata[].user.email`	string	Email del usuario
`subtype.metadata[].user.name`	string	Nombre del usuario
`subtype.metadata[].user.surname`	string	Apellido del usuario
`subtype.metadata[].user.nif`	string	NIF del usuario
`subtype.metadata[].date`	string	Fecha y hora de la operación (formato ISO 8601)
`subtype.reviewed`	string	Indicador de revisión (0 = No revisado, 1 = Revisado)
`inidate`	string	Fecha de inicio de la aplicación del fertilizante (formato ISO 8601)
`enddate`	string	Fecha de fin de la aplicación del fertilizante
`dose`	number	Dosis aplicada del fertilizante
`measure`	object	Unidad de medida de la dosis
`measure.type`	string	Tipo de dato (Measure)
`measure.id`	string	Identificador de la medida
`measure.subtype`	object	Tipo de medida
`measure.subtype.type`	string	Tipo de dato (TypeMeasure)
`measure.subtype.id`	string	Identificador del tipo de medida
`measure.subtype.name`	string	Nombre del tipo de medida
`measure.code`	integer	Código de la medida
`measure.name`	string	Nombre de la unidad de medida (ej: Kilogramo por hectárea)
`measure.symbol`	string	Símbolo de la unidad (ej: kg/ha)
`measure.prior`	string	Prioridad de la medida
`measure.detail`	string	Detalles adicionales de la medida
`soup`	number	Cantidad de caldo/mezcla preparada
`msoup`	object	Unidad de medida del caldo (mismo formato que measure)
`r10`	string	Información adicional de dilución
`mud`	number	Cantidad de lodo
`bill`	string	Número de factura
`plan`	string	Plan de abonado asociado
`taf`	object	Tipo de aplicación de fertilizante
`taf.type`	string	Tipo de dato (TAF - TypeApplicationFertilize)
`taf.id`	string	Identificador del tipo de aplicación
`taf.name`	string	Nombre del tipo de aplicación (ej: Abonado de fondo)
`maf`	object	Método de aplicación del fertilizante
`maf.type`	string	Tipo de dato (MAF - MethodApplicationFertilize)
`maf.id`	string	Identificador del método
`maf.name`	string	Nombre del método (ej: Esparcido general)
`tmi`	object	Tipo de mezcla
`tmi.type`	string	Tipo de dato (TMI - TypeMix)
`tmi.id`	string	Identificador del tipo de mezcla
`tmi.name`	string	Nombre del tipo de mezcla
`tmi.acronym`	string	Acrónimo del tipo de mezcla
`machine`	array	Array de maquinaria utilizada en la aplicación
`machine[].type`	string	Tipo de dato (MachineInfoFertilize)
`machine[].id`	string	Identificador de la relación máquina-fertilización
`machine[].product`	string	Producto aplicado con la máquina
`machine[].detail`	string	Detalles adicionales sobre el uso de la máquina
`machine[].idmachine`	string	ID de la máquina utilizada
`detail`	string	Detalles adicionales de la aplicación
`idcp`	array	Array de IDs de cultivos-parcelas a los que se aplicó el fertilizante

Endpoints de AgriFertilize

URLs para Fertilizantes

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/agrifertilizes	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/agrifertilizes	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/agrifertilizes	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/agrifertilizes	Desarrollo oSIGris

Parámetros de AgriFertilize

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`agrifarmId`	string	SÍ	ID de la explotación	urn:ngsi-ld:AgriFarm:383-367
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Parámetro Obligatorio

El parámetro agrifarmId es obligatorio para consultar fertilizaciones. Debe obtenerlo previamente del endpoint /agrifarms.

Ejemplo de petición cURL

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/agrifertilizes?agrifarmId=urn:ngsi-ld:AgriFarm:383-367" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Recomendación

Se recomienda usar paginación para evitar timeouts en consultas grandes.

AgriPhytosanitarys

Descripción de AgriPhytosanitarys

La entidad AgriPhytosanitarys representa información detallada sobre la aplicación de productos fitosanitarios en cultivos, incluyendo registro del producto, dosificación y eficacia.

Datos incluidos:

Información del producto fitosanitario registrado
Sustancias activas y composición
Dosificación y medidas de aplicación
Datos de eficacia y riesgo
Maquinaria utilizada en la aplicación
Períodos de seguridad y limitaciones de entrada
Asociación con cultivos específicos

Ejemplo de AgriPhytosanitarys

Respuesta que recibirás

json

[
  {
    "id": "urn:ngsi-ld:AgriPhytosanitary:2",
    "type": "AgriPhytosanitary",
    "dateCreated": "2023-09-25T15:34:21",
    "dateModified": "2023-09-25T15:34:21",
    "name": "11179 - Microthiol special disperss",
    "subtype": {
      "type": "TypePhytosanitary",
      "id": "183",
      "idpdf": "88013",
      "code": "11179",
      "name": "Microthiol Special Disperss",
      "names": ["Colpenn", "Microthiol Special Disperss", "Sulf 80 Wg"],
      "idate": "01-01-1970",
      "rdate": "",
      "edate": "15-04-2025",
      "cdate": "",
      "ldate": "",
      "mix": 1,
      "idtf": [11, 1],
      "comp": {
        "type": "Company",
        "id": 1,
        "name": "Upl Iberia S.a.",
        "vat": "A08103343"
      },
      "subs": {
        "type": "Substance",
        "id": "1",
        "name": "Azufre 80% [Wg] P/P"
      },
      "prod": {
        "type": "TypeProduct",
        "id": 1,
        "name": "Producto fitosanitario registrado"
      },
      "ci": []
    },
    "dose": "1",
    "measure": "1",
    "efficacy": {
      "type": "TypeEfficacy",
      "id": "1",
      "name": "Buena",
      "detail": ""
    },
    "typerisk": "1",
    "infection": "1",
    "detail": "1",
    "tj": [],
    "idtpismv": [],
    "distributed": "0",
    "batch": "",
    "soup": "0",
    "dt": "0",
    "mdt": "",
    "st": "0",
    "mst": "",
    "preventive": "0",
    "pp": "0",
    "speed": "0",
    "recipe": "0",
    "surface": "60.1027",
    "entrylimit": "0",
    "seclimit": "0",
    "machine": [
      {
        "type": "MachineInfoPhytosanitary",
        "id": "1",
        "product": "Agua",
        "detail": "",
        "idmachine": "8"
      }
    ],
    "idcp": ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"],
    "measur": ""
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`id`	string	Identificador único del tratamiento fitosanitario en formato URN NGSI-LD
`type`	string	Tipo de entidad NGSI-LD (AgriPhytosanitary)
`dateCreated`	string	Fecha y hora de creación de la entidad (formato ISO 8601)
`dateModified`	string	Fecha y hora de la última modificación de la entidad (formato ISO 8601)
`name`	string	Nombre del producto fitosanitario con su código de registro
`subtype`	object	Información detallada del tipo de producto fitosanitario
`subtype.type`	string	Tipo de dato (TypePhytosanitary)
`subtype.id`	string	Identificador del tipo de fitosanitario
`subtype.idpdf`	string	ID del PDF del registro oficial
`subtype.code`	string	Código de registro oficial del producto
`subtype.name`	string	Nombre comercial del producto
`subtype.names`	array	Array de nombres comerciales alternativos
`subtype.idate`	string	Fecha de inscripción del producto
`subtype.rdate`	string	Fecha de renovación del registro
`subtype.edate`	string	Fecha de expiración del registro
`subtype.cdate`	string	Fecha de cancelación del registro
`subtype.ldate`	string	Fecha límite de utilización
`subtype.mix`	integer	Indica si el producto puede mezclarse (0 = No, 1 = Sí)
`subtype.idtf`	array	Array de IDs de tipos de formulación
`subtype.comp`	object	Información de la compañía fabricante
`subtype.comp.type`	string	Tipo de dato (Company)
`subtype.comp.id`	integer	Identificador de la compañía
`subtype.comp.name`	string	Nombre de la compañía fabricante
`subtype.comp.vat`	string	CIF/NIF de la compañía
`subtype.subs`	object	Información de la sustancia activa
`subtype.subs.type`	string	Tipo de dato (Substance)
`subtype.subs.id`	string	Identificador de la sustancia activa
`subtype.subs.name`	string	Nombre y concentración de la sustancia activa
`subtype.prod`	object	Tipo de producto
`subtype.prod.type`	string	Tipo de dato (TypeProduct)
`subtype.prod.id`	integer	Identificador del tipo de producto
`subtype.prod.name`	string	Nombre del tipo de producto (ej: Producto fitosanitario registrado)
`subtype.ci`	array	Array de condicionamientos de uso
`dose`	string	Dosis aplicada del producto
`measure`	string	Unidad de medida de la dosis
`efficacy`	object	Evaluación de la eficacia del tratamiento
`efficacy.type`	string	Tipo de dato (TypeEfficacy)
`efficacy.id`	string	Identificador del tipo de eficacia
`efficacy.name`	string	Nombre de la evaluación de eficacia (ej: Buena, Excelente)
`efficacy.detail`	string	Detalles adicionales sobre la eficacia
`typerisk`	string	Tipo de riesgo asociado al tratamiento
`infection`	string	ID de la infección o plaga tratada
`detail`	string	Detalles adicionales del tratamiento
`tj`	array	Array de justificaciones técnicas
`idtpismv`	array	Array de IDs de tipos de plagas, infecciones, etc.
`distributed`	string	Indicador de distribución (0 = No distribuido, 1 = Distribuido)
`batch`	string	Número de lote del producto
`soup`	string	Cantidad de caldo preparado
`dt`	string	Dosis total aplicada
`mdt`	string	Medida de la dosis total
`st`	string	Superficie tratada
`mst`	string	Medida de la superficie tratada
`preventive`	string	Indica si es tratamiento preventivo (0 = No, 1 = Sí)
`pp`	string	Indicador de producción propia
`speed`	string	Velocidad de aplicación
`recipe`	string	ID de la receta fitosanitaria asociada
`surface`	string	Superficie total tratada en hectáreas
`entrylimit`	string	Período de reentrada en días (limitación de entrada al área tratada)
`seclimit`	string	Plazo de seguridad en días (tiempo antes de cosecha/consumo)
`machine`	array	Array de maquinaria utilizada en la aplicación
`machine[].type`	string	Tipo de dato (MachineInfoPhytosanitary)
`machine[].id`	string	Identificador de la relación máquina-tratamiento
`machine[].product`	string	Producto aplicado con la máquina (ej: Agua)
`machine[].detail`	string	Detalles adicionales sobre el uso de la máquina
`machine[].idmachine`	string	ID de la máquina utilizada
`idcp`	array	Array de IDs de cultivos-parcelas a los que se aplicó el tratamiento
`measur`	string	Información adicional de medidas

Endpoints de AgriPhytosanitarys

URLs para Fitosanitarios

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/agriphytosanitarys	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/agriphytosanitarys	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/agriphytosanitarys	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/agriphytosanitarys	Desarrollo oSIGris

Parámetros de AgriPhytosanitarys

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`agrifarmId`	string	SÍ	ID de la explotación	urn:ngsi-ld:AgriFarm:383-367
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Parámetro Obligatorio

El parámetro agrifarmId es obligatorio para consultar fitosanitarios. Debe obtenerlo previamente del endpoint /agrifarms.

Ejemplo de petición cURL

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/agriphytosanitarys?agrifarmId=urn:ngsi-ld:AgriFarm:383-367" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Servicios de Trabajos Asíncronos

CXTierra y oSIGris procesan ciertas operaciones de forma asíncrona. Cuando se inicia un proceso asíncrono, el sistema devuelve un jobId que puedes usar para consultar el estado y resultado del trabajo.

Job Status - Estado del Trabajo

Consulta el estado actual de un trabajo asíncrono en proceso.

URLs para Job Status

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/jobstatus	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/jobstatus	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/jobstatus	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/jobstatus	Desarrollo oSIGris

Parámetros de Job Status

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`jobId`	integer	SÍ	ID del trabajo asíncrono devuelto al iniciarlo	311

Parámetro Obligatorio

El parámetro jobId es obligatorio. Si no se proporciona, recibirás el error:

json

{
  "error": "jobId is a required query parameter and should be a valid id"
}

Ejemplo de Respuesta Job Status

Respuesta que recibirás

json

{
  "type": "JobAsync",
  "id": "311",
  "inidate": "29-09-2025 10:22:40",
  "status": {
    "type": "JobStatus",
    "id": "3",
    "name": "FinalizadoCompleto"
  },
  "percentage": 100,
  "error": null
}

Descripción de datos que recibirás

Campo	Tipo	Descripción
`type`	string	Tipo de entidad (JobAsync)
`id`	string	Identificador del trabajo asíncrono
`inidate`	string	Fecha y hora de inicio del trabajo (formato: DD-MM-YYYY HH:mm:ss)
`status`	object	Información del estado actual del trabajo
`status.type`	string	Tipo de dato (JobStatus)
`status.id`	string	Identificador del estado
`status.name`	string	Nombre del estado (ej: FinalizadoCompleto, EnProceso, Error)
`percentage`	integer	Porcentaje de completitud del trabajo (0-100)
`error`	string	Mensaje de error si el trabajo falló (null si no hay errores)

Estados Posibles del Trabajo

El campo status contiene un objeto con información detallada del estado actual. Los valores posibles son:

`status.id`	`status.name`	Descripción	Acción Recomendada
`1`	`Pendiente`	El trabajo está en cola esperando procesamiento	Esperar y volver a consultar
`2`	`Iniciado`	El trabajo ha comenzado a procesarse	Esperar y volver a consultar
`3`	`FinalizadoCompleto`	El trabajo finalizó exitosamente	Consultar resultado con jobresult
`4`	`FinalizadoParcial`	El trabajo finalizó con algunos elementos sin procesar	Consultar resultado con jobresult
`5`	`FinalizadoError`	El trabajo finalizó pero con errores	Revisar el campo `error`
`6`	`Error`	El trabajo falló completamente	Revisar el campo `error`

Ejemplo de petición cURL para Job Status

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/jobstatus?jobId=311" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Job Result - Resultado del Trabajo

Obtiene el resultado final de un trabajo asíncrono que ha sido completado.

URLs para Job Result

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/jobresult	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/jobresult	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/jobresult	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/jobresult	Desarrollo oSIGris

Parámetros de Job Result

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`jobId`	integer	SÍ	ID del trabajo asíncrono completado	311

Parámetro Obligatorio

El parámetro jobId es obligatorio. Si no se proporciona, recibirás el error:

json

{
  "error": "jobId is a required query parameter and should be a valid id"
}

Ejemplo de Respuesta Job Result

Respuesta que recibirás

json

{
  "data": [
    {
      "result": "ok",
      "id": -1
    }
  ],
  "error": []
}

Descripción de datos que recibirás

Campo	Tipo	Descripción
`data`	array	Array con los resultados del trabajo completado
`data[].result`	string	Resultado de la operación (ej: "ok", "error")
`data[].id`	number	ID del recurso creado o afectado (-1 si no aplica)
`error`	array	Array de errores ocurridos durante el procesamiento (vacío si no hay errores)

Ejemplo de petición cURL para Job Result

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/jobresult?jobId=311" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Flujo Recomendado para Trabajos Asíncronos

Iniciar el proceso asíncrono → Obtener jobId
Consultar estado periódicamente → Usar /jobstatus?jobId=X
Verificar percentage y status.name:
- Si percentage < 100: Esperar y volver a consultar (polling)
- Si status.name = "FinalizadoCompleto": Ir al paso 4
- Si status.name = "Error": Revisar campo error
Obtener resultado final → Usar /jobresult?jobId=X

Recomendación de Polling

Se recomienda consultar el estado cada 2-5 segundos para procesos cortos, o cada 10-30 segundos para procesos largos.

Person

Descripción de Person

La entidad Person representa información sobre individuos asociados a explotaciones agrícolas, incluyendo titulares, propietarios, administradores y operadores.

Información incluida:

Datos personales básicos (nombre, apellidos)
Información de contacto (email, teléfono)
Dirección completa
Fechas de creación y modificación
Asociación con explotaciones agrícolas

Ejemplo de Person

Respuesta que recibirás

json

[
  {
    "id": "urn:ngsi-ld:Person:f1dbd0ec-ae57-49b7-86e7-030171015dcb",
    "type": "Person",
    "dateCreated": "2017-04-01T01:20:00Z",
    "dateModified": "2017-09-04T12:30:00Z",
    "name": "José Gonzalez",
    "address": {
      "addressLocality": "Madrid",
      "addressCountry": "ES",
      "streetAddress": "Calle Alvarez Mujica, 12"
    },
    "email": "jose.gonzalez@example.com",
    "telephone": "+34698281828"
  },
  {
    "id": "urn:ngsi-ld:Person:fce9dcbc-4479-11e8-9de1-cb228de7a15c",
    "type": "Person",
    "dateCreated": "2017-01-01T01:20:00Z",
    "dateModified": "2017-05-04T12:30:00Z",
    "name": "Juan Pérez",
    "address": {
      "addressLocality": "Valdepeñas",
      "addressCountry": "ES",
      "streetAddress": "Camino de Membrilla 17"
    },
    "email": "juan.perez@example.com",
    "telephone": "+34687271728"
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`id`	string	Identificador único de la persona en formato URN NGSI-LD
`type`	string	Tipo de entidad NGSI-LD (Person)
`dateCreated`	string	Fecha y hora de creación de la entidad (formato ISO 8601)
`dateModified`	string	Fecha y hora de la última modificación de la entidad (formato ISO 8601)
`name`	string	Nombre completo de la persona
`address`	object	Información de dirección postal
`address.addressLocality`	string	Localidad o ciudad de residencia
`address.addressCountry`	string	Código de país (ISO 3166-1 alpha-2)
`address.streetAddress`	string	Dirección postal completa (calle y número)
`email`	string	Dirección de correo electrónico de contacto
`telephone`	string	Número de teléfono de contacto (formato internacional)

Endpoints de Person

URLs para Personas

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/people	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/people	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/people	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/people	Desarrollo oSIGris

Parámetros de Person

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`agrifarmId`	string	SÍ	ID de la explotación	urn:ngsi-ld:AgriFarm:383-367
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Parámetro Obligatorio

El parámetro agrifarmId es obligatorio para consultar personas. Debe obtenerlo previamente del endpoint /agrifarms.

Ejemplo de petición cURL

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/people?agrifarmId=urn:ngsi-ld:AgriFarm:383-367" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Type Phytosanitary

Descripción de Type Phytosanitary

La entidad Type Phytosanitary representa información sobre los tipos de fitosanitarios disponibles en el catálogo oficial, incluyendo productos registrados y sus características técnicas.

Información incluida:

Código oficial del producto fitosanitario (ES-XXXXX)
Nombre comercial del producto
Información de la empresa fabricante (nombre, NIF)
Sustancias activas y concentraciones
Fechas de registro, expiración y límite de uso
Tipo de producto (registrado, autorizado, etc.)
Detalles de aplicación y restricciones
Identificadores únicos del sistema

Ejemplo de Type Phytosanitary

Respuesta que recibirás

json

[
  {
    "type": "TypePhytosanitary",
    "id": 2575,
    "subtype": {
      "type": "SubtypePhytosanitary",
      "id": 1550,
      "idpdf": "98498",
      "code": "ES-00001",
      "comp": {
        "type": "Company",
        "id": 10,
        "name": "Syngenta España, S.a.",
        "nif": "A59542928"
      },
      "subs": {
        "type": "Substance",
        "id": "684",
        "name": "Ciflufenamid 3% + Difenoconazol 6% [Dc] P/V"
      },
      "detail": "Aplicar  en  pulverización  normal foliar, desde la aparición de la 3ª hoja hasta que el grano empieza a  adquirir  el color característico de la variedad mediante tractor o manualmente, con un máximo de 2  aplicaciones  y  un volumen de caldo de 200-1000 l/Ha, sin sobrepasar los 0,65 l/Ha. de producto por aplicación, o con tractor por ULV,  con un intervalo de 10 días entre aplicaciones.",
      "ci": []
    },
    "name": "Dynali",
    "tpd": [
      {
        "type": "TPD",
        "id": 2642,
        "idate": "26-02-2013",
        "edate": "15-03-2026",
        "ldate": ""
      }
    ],
    "prod": {
      "type": "TypeProduct",
      "id": 1,
      "name": "Producto fitosanitario registrado"
    }
  },
  {
    "type": "TypePhytosanitary",
    "id": 2576,
    "subtype": {
      "type": "SubtypePhytosanitary",
      "id": 1551,
      "idpdf": "82124",
      "code": "ES-00002",
      "comp": {
        "type": "Company",
        "id": 11,
        "name": "Gowan Crop Protection Ltd.",
        "nif": "N8267006H"
      },
      "subs": {
        "type": "Substance",
        "id": "685",
        "name": "Benfluralina 60% [Wg] P/P"
      },
      "detail": "",
      "ci": []
    },
    "name": "Neoflan",
    "tpd": [
      {
        "type": "TPD",
        "id": 2643,
        "idate": "10-01-2014",
        "edate": "12-08-2023",
        "ldate": "31-12-2023"
      }
    ],
    "prod": {
      "type": "TypeProduct",
      "id": 1,
      "name": "Producto fitosanitario registrado"
    }
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`type`	string	Tipo de dato (TypePhytosanitary)
`id`	integer	Identificador único del tipo de fitosanitario
`subtype`	object	Información detallada del subtipo de fitosanitario
`subtype.type`	string	Tipo de dato (SubtypePhytosanitary)
`subtype.id`	integer	Identificador del subtipo
`subtype.idpdf`	string	ID del PDF del registro oficial del producto
`subtype.code`	string	Código de registro oficial del producto (formato ES-XXXXX)
`subtype.comp`	object	Información de la compañía fabricante
`subtype.comp.type`	string	Tipo de dato (Company)
`subtype.comp.id`	integer	Identificador de la compañía
`subtype.comp.name`	string	Nombre de la compañía fabricante
`subtype.comp.nif`	string	NIF de la compañía
`subtype.subs`	object	Información de la sustancia activa
`subtype.subs.type`	string	Tipo de dato (Substance)
`subtype.subs.id`	string	Identificador de la sustancia activa
`subtype.subs.name`	string	Nombre y concentración de la sustancia activa
`subtype.detail`	string	Detalles de aplicación, restricciones y recomendaciones de uso
`subtype.ci`	array	Array de condicionamientos de uso
`name`	string	Nombre comercial del producto fitosanitario
`tpd`	array	Array de datos de registro del producto
`tpd[].type`	string	Tipo de dato (TPD - TypePhytosanitaryDate)
`tpd[].id`	integer	Identificador del registro de fechas
`tpd[].idate`	string	Fecha de inscripción del producto (formato DD-MM-YYYY)
`tpd[].edate`	string	Fecha de expiración del registro (formato DD-MM-YYYY)
`tpd[].ldate`	string	Fecha límite de utilización del producto (formato DD-MM-YYYY)
`prod`	object	Tipo de producto fitosanitario
`prod.type`	string	Tipo de dato (TypeProduct)
`prod.id`	integer	Identificador del tipo de producto
`prod.name`	string	Nombre del tipo de producto (ej: Producto fitosanitario registrado)

Endpoints de Type Phytosanitary

URLs para Type Phytosanitary

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/typephytosanitary	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/typephytosanitary	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/typephytosanitary	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/typephytosanitary	Desarrollo oSIGris

Parámetros de Type Phytosanitary

Parámetro	Tipo	Descripción	Valor por defecto
`code`	string	Código del producto fitosanitario	null
`name`	string	Nombre del producto fitosanitario	null
`page`	integer	Número de página (inicia en 0)	null
`page_size`	integer	Elementos por página (mínimo 1)	null

Type Crop

Descripción de Type Crop

La entidad Type Crop representa información sobre los tipos de cultivos disponibles en el catálogo oficial.

Información incluida:

Código y nombre oficial del tipo de cultivo

Ejemplo de Type Crop

Respuesta que recibirás

json

[
  {
    "type": "TypeCrop",
    "id": "140",
    "name": "Abaca alias manila",
    "subtypeid": "1",
    "style": {
      "type": "Style",
      "id": "1140",
      "name": "crop_140"
    }
  },
  {
    "type": "TypeCrop",
    "id": "360",
    "name": "Abedul",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1360",
      "name": "crop_360"
    }
  },
  {
    "type": "TypeCrop",
    "id": "296",
    "name": "Abeto",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1296",
      "name": "crop_296"
    }
  },
  {
    "type": "TypeCrop",
    "id": "361",
    "name": "Abeto de douglas",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1361",
      "name": "crop_361"
    }
  },
  {
    "type": "TypeCrop",
    "id": "228",
    "name": "Acacia",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1228",
      "name": "crop_228"
    }
  },
  {
    "type": "TypeCrop",
    "id": "231",
    "name": "Acacia de tres espinas",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1231",
      "name": "crop_231"
    }
  },
  {
    "type": "TypeCrop",
    "id": "825",
    "name": "Acacia del japón",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1825",
      "name": "crop_825"
    }
  },
  {
    "type": "TypeCrop",
    "id": "362",
    "name": "Acebo",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1362",
      "name": "crop_362"
    }
  },
  {
    "type": "TypeCrop",
    "id": "363",
    "name": "Acebuche",
    "subtypeid": "3",
    "style": {
      "type": "Style",
      "id": "1363",
      "name": "crop_363"
    }
  },
  {
    "type": "TypeCrop",
    "id": "418",
    "name": "Acedera",
    "subtypeid": "4",
    "style": {
      "type": "Style",
      "id": "1418",
      "name": "crop_418"
    }
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`type`	string	Tipo de dato (TypeCrop)
`id`	string	Identificador único del tipo de cultivo
`name`	string	Nombre del tipo de cultivo
`subtypeid`	string	Identificador de la categoría o subtipo del cultivo
`style`	object	Información de estilo visual para representación gráfica
`style.type`	string	Tipo de dato (Style)
`style.id`	string	Identificador del estilo
`style.name`	string	Nombre del estilo (formato: crop_ID)

Endpoints de Type Crop

URLs para Type Crop

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/typecrop	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/typecrop	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/typecrop	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/typecrop	Desarrollo oSIGris

Parámetros de Type Crop

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`code`	string	No	Filtrar por código del tipo de cultivo	"197"
`name`	string	No	Filtrar por nombre del tipo de cultivo	"Tomate"
`crop_subtype_id`	string	No	Filtrar por ID de subtipo/categoría de cultivo	"4"
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Ejemplo de petición cURL para Type Crop

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/typecrop?name=Tomate&page=0&page_size=10" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Type Crop Variety

Descripción de Type Crop Variety

La entidad Type Crop Variety representa información sobre los tipos de variedad de cultivos disponibles en el catálogo oficial.

Información incluida:

Código y nombre oficial del tipo de variedad de cultivo

Ejemplo de Type Crop Variety

Respuesta que recibirás

json

[
  {
    "type": "TCV",
    "id": 14753,
    "typecrop": {
      "type": "TypeCrop",
      "id": "140",
      "name": "Abaca alias manila",
      "subtypeid": "1",
      "style": {
        "type": "Style",
        "id": "1140",
        "name": "crop_140"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17611,
    "typecrop": {
      "type": "TypeCrop",
      "id": "360",
      "name": "Abedul",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1360",
        "name": "crop_360"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17466,
    "typecrop": {
      "type": "TypeCrop",
      "id": "296",
      "name": "Abeto",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1296",
        "name": "crop_296"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17612,
    "typecrop": {
      "type": "TypeCrop",
      "id": "361",
      "name": "Abeto de douglas",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1361",
        "name": "crop_361"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17360,
    "typecrop": {
      "type": "TypeCrop",
      "id": "228",
      "name": "Acacia",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1228",
        "name": "crop_228"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17363,
    "typecrop": {
      "type": "TypeCrop",
      "id": "231",
      "name": "Acacia de tres espinas",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1231",
        "name": "crop_231"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 98136,
    "typecrop": {
      "type": "TypeCrop",
      "id": "825",
      "name": "Acacia del japón",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1825",
        "name": "crop_825"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17613,
    "typecrop": {
      "type": "TypeCrop",
      "id": "362",
      "name": "Acebo",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1362",
        "name": "crop_362"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17614,
    "typecrop": {
      "type": "TypeCrop",
      "id": "363",
      "name": "Acebuche",
      "subtypeid": "3",
      "style": {
        "type": "Style",
        "id": "1363",
        "name": "crop_363"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  },
  {
    "type": "TCV",
    "id": 17737,
    "typecrop": {
      "type": "TypeCrop",
      "id": "418",
      "name": "Acedera",
      "subtypeid": "4",
      "style": {
        "type": "Style",
        "id": "1418",
        "name": "crop_418"
      }
    },
    "code": 0,
    "name": "Sin variedad"
  }
]

Descripción de datos que recibirás

Campo	Tipo	Descripción
`type`	string	Tipo de dato (TCV - TypeCropVariety)
`id`	integer	Identificador único de la variedad de cultivo
`typecrop`	object	Información del tipo de cultivo asociado
`typecrop.type`	string	Tipo de dato (TypeCrop)
`typecrop.id`	string	Identificador del tipo de cultivo
`typecrop.name`	string	Nombre del tipo de cultivo
`typecrop.subtypeid`	string	Identificador de la categoría o subtipo del cultivo
`typecrop.style`	object	Información de estilo visual para representación gráfica
`typecrop.style.type`	string	Tipo de dato (Style)
`typecrop.style.id`	string	Identificador del estilo
`typecrop.style.name`	string	Nombre del estilo (formato: crop_ID)
`code`	integer	Código de la variedad (0 = sin variedad específica)
`name`	string	Nombre de la variedad de cultivo

Endpoints de Type Crop Variety

URLs para Type Crop Variety

Entorno	URL	Descripción
PT PRO	https://api.plataformatierra.es/api-cxtierra/v1/entities/typecropvariety	Producción
PT DEV	https://api.plataformatierra.es/api-cxtierra-dev/v1/entities/typecropvariety	Desarrollo
oSIGris PRO	https://api.plataformatierra.es/api-cxtierra-osigris/v1/entities/typecropvariety	Producción oSIGris
oSIGris DEV	https://api.plataformatierra.es/api-cxtierra-osigris-dev/v1/entities/typecropvariety	Desarrollo oSIGris

Parámetros de Type Crop Variety

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
`code`	integer	No	Filtrar por código de la variedad	8
`name`	string	No	Filtrar por nombre de la variedad	"Cherry"
`crop_type_id`	string	No	Filtrar por ID del tipo de cultivo asociado	"197"
`crop_type_name`	string	No	Filtrar por nombre del tipo de cultivo asociado	"Tomate"
`page`	integer	No	Número de página (inicia en 0)	0
`page_size`	integer	No	Elementos por página (mínimo 1)	10

Ejemplo de petición cURL para Type Crop Variety

bash

curl -X GET "https://api.plataformatierra.es/api-cxtierra/v1/entities/typecropvariety?crop_type_id=197&name=Cherry&page=0&page_size=10" \
  -H "Ocp-Apim-Subscription-Key: TU_Ocp-Apim-Subscription-Key" \
  -H "Ocp-Apim-Sid-Key: TU_Ocp-Apim-Sid-Key"

Información Adicional

Códigos de Respuesta HTTP

Código	Descripción
`200`	Petición exitosa
`400`	Error en los parámetros de la petición
`401`	No autorizado - verificar claves de API
`403`	Acceso denegado
`404`	Recurso no encontrado
`429`	Demasiadas peticiones - rate limit excedido
`500`	Error interno del servidor

Buenas Prácticas

Recomendaciones de Uso

Usar paginación: Siempre incluye parámetros page y page_size para evitar timeouts
Límite de página: Se recomienda page_size entre 10-50 elementos
Autenticación: Verifica que tus claves de API sean válidas y estén activas
Rate Limiting: Implementa delays entre peticiones para evitar límites de velocidad
Manejo de errores: Siempre maneja los códigos de respuesta HTTP apropiadamente

Formatos de Fecha

Todas las fechas en la API siguen el formato ISO 8601:

Formato: YYYY-MM-DDTHH:mm:ss o DD-MM-YYYY HH:mm:ss
Zona horaria: UTC por defecto
Ejemplo: 2023-06-21T10:03:54 o 21-06-2023 10:03:54

Soporte y Contacto

¿Necesitas ayuda?

Si tienes dudas sobre la implementación o encuentras algún problema, consulta la documentación oficial de Plataforma Tierra o contacta con el equipo de soporte técnico.

Entidades ​

Arquitectura de la API ​

Leyenda ​

Entidades Disponibles ​

Entidades Principales ​

Registros de Actividad ​

Catálogos ​

Servicios Asíncronos ​

Tabla de Contenidos ​

Información General de la API ​

Relaciones ​

Jerarquía de Datos ​

AgriFarm ​

Descripción de AgriFarm ​

Ejemplo de AgriFarm ​

Endpoints de AgriFarm ​

URLs Disponibles ​

Parámetros de AgriFarm ​

Ejemplo de petición cURL ​

Parámetros de AgriFarm ​

AgriParcel ​

Descripción de AgriParcel ​

Ejemplo de AgriParcel ​

Endpoints de AgriParcel ​

URLs para Parcelas ​

Parámetros de AgriParcel ​

Ejemplo de petición cURL ​

AgriCrop ​

Descripción de AgriCrop ​

Ejemplo de AgriCrop ​

Endpoints de AgriCrop ​

URLs para AgriCrop ​

Parámetros de AgriCrop ​

Ejemplo de petición cURL ​

AgriFertilize ​

Descripción de AgriFertilize ​

Ejemplo de AgriFertilize ​

Endpoints de AgriFertilize ​

URLs para Fertilizantes ​

Parámetros de AgriFertilize ​

Ejemplo de petición cURL ​

AgriPhytosanitarys ​

Descripción de AgriPhytosanitarys ​

Ejemplo de AgriPhytosanitarys ​

Endpoints de AgriPhytosanitarys ​

URLs para Fitosanitarios ​

Parámetros de AgriPhytosanitarys ​

Ejemplo de petición cURL ​

Servicios de Trabajos Asíncronos ​

Job Status - Estado del Trabajo ​

URLs para Job Status ​

Parámetros de Job Status ​

Ejemplo de Respuesta Job Status ​

Estados Posibles del Trabajo ​

Ejemplo de petición cURL para Job Status ​

Job Result - Resultado del Trabajo ​

URLs para Job Result ​

Parámetros de Job Result ​

Ejemplo de Respuesta Job Result ​

Ejemplo de petición cURL para Job Result ​

Flujo Recomendado para Trabajos Asíncronos ​

Person ​

Descripción de Person ​

Ejemplo de Person ​

Endpoints de Person ​

URLs para Personas ​

Parámetros de Person ​

Ejemplo de petición cURL ​

Type Phytosanitary ​

Descripción de Type Phytosanitary ​

Ejemplo de Type Phytosanitary ​

Endpoints de Type Phytosanitary ​

URLs para Type Phytosanitary ​

Parámetros de Type Phytosanitary ​

Type Crop ​

Descripción de Type Crop ​

Ejemplo de Type Crop ​

Endpoints de Type Crop ​

URLs para Type Crop ​

Parámetros de Type Crop ​

Entidades

Arquitectura de la API

Leyenda

Entidades Disponibles

Entidades Principales

Registros de Actividad

Catálogos

Servicios Asíncronos

Tabla de Contenidos

Información General de la API

Relaciones

Jerarquía de Datos

AgriFarm

Descripción de AgriFarm

Ejemplo de AgriFarm

Endpoints de AgriFarm

URLs Disponibles

Parámetros de AgriFarm

Ejemplo de petición cURL

Parámetros de AgriFarm

AgriParcel

Descripción de AgriParcel

Ejemplo de AgriParcel

Endpoints de AgriParcel

URLs para Parcelas

Parámetros de AgriParcel

Ejemplo de petición cURL

AgriCrop

Descripción de AgriCrop

Ejemplo de AgriCrop

Endpoints de AgriCrop

URLs para AgriCrop

Parámetros de AgriCrop

Ejemplo de petición cURL

AgriFertilize

Descripción de AgriFertilize

Ejemplo de AgriFertilize

Endpoints de AgriFertilize

URLs para Fertilizantes

Parámetros de AgriFertilize

Ejemplo de petición cURL

AgriPhytosanitarys

Descripción de AgriPhytosanitarys

Ejemplo de AgriPhytosanitarys

Endpoints de AgriPhytosanitarys

URLs para Fitosanitarios

Parámetros de AgriPhytosanitarys

Ejemplo de petición cURL

Servicios de Trabajos Asíncronos

Job Status - Estado del Trabajo

URLs para Job Status

Parámetros de Job Status

Ejemplo de Respuesta Job Status

Estados Posibles del Trabajo

Ejemplo de petición cURL para Job Status

Job Result - Resultado del Trabajo

URLs para Job Result

Parámetros de Job Result

Ejemplo de Respuesta Job Result

Ejemplo de petición cURL para Job Result

Flujo Recomendado para Trabajos Asíncronos

Person

Descripción de Person

Ejemplo de Person

Endpoints de Person

URLs para Personas

Parámetros de Person

Ejemplo de petición cURL

Type Phytosanitary

Descripción de Type Phytosanitary

Ejemplo de Type Phytosanitary

Endpoints de Type Phytosanitary

URLs para Type Phytosanitary

Parámetros de Type Phytosanitary

Type Crop

Descripción de Type Crop

Ejemplo de Type Crop

Endpoints de Type Crop

URLs para Type Crop

Parámetros de Type Crop