Tus datos en Truleaf Fields: formatos y cambio
Exporta todos tus datos cuando quieras, gratis y en formatos abiertos.
Versión del registro 1.0.0 · en vigor desde el 31 oct 2026
Quién puede exportar
Los propietarios y administradores de un espacio de trabajo pueden exportarlo todo. Los editores pueden exportar registros, parcelas y series de datos.
Las exportaciones son gratuitas en todos los planes, también en el gratuito y cuando termina un plan.
Para descargar tus propios datos personales, ve a los ajustes de tu cuenta.
Cómo exportar
- Exportación completa: abre tu espacio de trabajo, ve a Exportaciones y elige Exportar todo. Te avisamos por correo cuando los archivos estén listos. Siguen disponibles 30 días y puedes generarlos de nuevo cuando quieras.
- Registros, parcelas y series de datos: usa Exportar en la pantalla que los muestra, o abre Exportaciones y elige Nueva exportación.
La exportación completa
Un archivo zip, o varias partes de hasta 200 MB con las fotos en sus propias partes. El manifiesto lista cada archivo con sus filas, tamaño, suma de control y esquema.
El README está en el idioma que elijas y en inglés.
Los mismos datos dan los mismos archivos, así que puedes comparar las sumas de control entre exportaciones.
La exportación completa contiene datos personales (nombres, correos, números fiscales y de registro, historial de conversación). Guárdala de forma segura.
Guía
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| Raíz | README.md | Qué contiene la exportación, en tu idioma y en inglés | Markdown (texto) | |
| Raíz | manifest.json | Cada archivo con sus filas, tamaño, suma de control y esquema | JSON (datos) | esquema |
| Raíz | schemas/<name>.schema.json | El JSON Schema de cada archivo de la exportación | JSON Schema | |
| Raíz | schemas/siex-mapping.json | Correspondencia de columnas con el formato del Anexo V del SIEX | JSON (datos) | esquema |
Espacio de trabajoorg/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| org/ | org.json | Nombre, tipo, plan y fincas del espacio de trabajo | JSON (datos) | esquema |
| org/ | members.csv | Miembros y sus roles | CSV (hoja de cálculo) | esquema |
| org/ | invitations.csv | Cada invitación, abierta o pasada | CSV (hoja de cálculo) | esquema |
| org/ | advisor_links.csv | Vínculos con asesores y sus clientes | CSV (hoja de cálculo) | esquema |
| org/ | consents.csv | Consentimientos dados en el espacio de trabajo | CSV (hoja de cálculo) | esquema |
| org/ | settings.json | Ajustes del espacio de trabajo | JSON (datos) | esquema |
Fincas y parcelasgeo/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| geo/ | farms.geojson | Contornos y datos de las fincas | GeoJSON (SIG) | esquema |
| geo/ | parcels.geojson | Contornos de parcelas con cultivo, superficie y etiquetas | GeoJSON (SIG) | esquema |
| geo/ | parcel_exclusions.geojson | Zonas excluidas de cada parcela | GeoJSON (SIG) | esquema |
| geo/ | parcel_sigpac_links.csv | Vínculos entre parcelas y recintos SIGPAC | CSV (hoja de cálculo) | esquema |
| geo/ | zones.geojson | Cada zona de manejo, a partir de datos de satélite | GeoJSON (SIG) | esquema |
Registrosrecords/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| records/ | seasons.csv | Ciclos de cultivo por parcela | CSV (hoja de cálculo) | esquema |
| records/ | seasons.ndjson | Ciclos de cultivo por parcela | NDJSON (líneas JSON) | esquema |
| records/ | irrigation_systems.csv | Cada sistema de riego | CSV (hoja de cálculo) | esquema |
| records/ | irrigation_systems.ndjson | Cada sistema de riego | NDJSON (líneas JSON) | esquema |
| records/ | tags.csv | Etiquetas y las parcelas que marcan | CSV (hoja de cálculo) | esquema |
| records/ | tags.ndjson | Etiquetas y las parcelas que marcan | NDJSON (líneas JSON) | esquema |
| records/ | treatments.csv | Tratamientos | CSV (hoja de cálculo) | esquema |
| records/ | treatments.ndjson | Tratamientos | NDJSON (líneas JSON) | esquema |
| records/ | treatment_products.csv | Productos usados en cada tratamiento | CSV (hoja de cálculo) | esquema |
| records/ | treatment_products.ndjson | Productos usados en cada tratamiento | NDJSON (líneas JSON) | esquema |
| records/ | irrigation_events.csv | Registros de riego | CSV (hoja de cálculo) | esquema |
| records/ | irrigation_events.ndjson | Registros de riego | NDJSON (líneas JSON) | esquema |
| records/ | observations.csv | Cada observación con notas y fotos | CSV (hoja de cálculo) | esquema |
| records/ | observations.ndjson | Cada observación con notas y fotos | NDJSON (líneas JSON) | esquema |
| records/ | tasks.csv | Tareas | CSV (hoja de cálculo) | esquema |
| records/ | tasks.ndjson | Tareas | NDJSON (líneas JSON) | esquema |
| records/ | operators.csv | Aplicadores | CSV (hoja de cálculo) | esquema |
| records/ | operators.ndjson | Aplicadores | NDJSON (líneas JSON) | esquema |
| records/ | equipment.csv | Equipo de aplicación | CSV (hoja de cálculo) | esquema |
| records/ | equipment.ndjson | Equipo de aplicación | NDJSON (líneas JSON) | esquema |
| records/ | cuaderno_es.xlsx | Cuaderno de campo en el formato de columnas del Anexo V (fincas en España) | Libro de Excel (XLSX) |
Satélitesatellite/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| satellite/ | observations.csv | Imágenes de satélite usadas, con su nubosidad | CSV (hoja de cálculo) | esquema |
| satellite/ | index_stats.csv | Estadísticas de índices por parcela e imagen | CSV (hoja de cálculo) | esquema |
| satellite/ | series_daily.csv | Series diarias de índices por parcela | CSV (hoja de cálculo) | esquema |
| satellite/ | phenology.csv | Estados fenológicos estimados por ciclo de cultivo | CSV (hoja de cálculo) | |
| satellite/ | parcel_state.csv | Estado actual de cada parcela | CSV (hoja de cálculo) | esquema |
Meteorología y aguaweather/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| weather/ | parcel_water_daily.csv | Balance hídrico diario por parcela (ET₀, ETc, lluvia) | CSV (hoja de cálculo) | esquema |
| weather/ | parcel_weather_link.csv | Fuente meteorológica de cada parcela | CSV (hoja de cálculo) | esquema |
| weather/ | spray_profiles.json | Ajustes de la ventana de tratamiento | JSON (datos) | esquema |
| weather/ | daily.csv | Valores meteorológicos diarios usados, con su fuente | CSV (hoja de cálculo) | esquema |
Sensoressensors/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| sensors/ | connections.csv | Conexiones de sensores, sin credenciales | CSV (hoja de cálculo) | |
| sensors/ | devices.csv | Dispositivos | CSV (hoja de cálculo) | |
| sensors/ | sensors.csv | Sensores de cada dispositivo | CSV (hoja de cálculo) | |
| sensors/ | readings_<yyyy-mm>_<nnnn>.csv.gz | Lecturas en bruto por mes | CSV comprimido (gzip) | |
| sensors/ | readings_hourly_<yyyy>.csv.gz | Lecturas horarias por año | CSV comprimido (gzip) | |
| sensors/ | readings_daily.csv | Lecturas diarias | CSV (hoja de cálculo) |
Alertasalerts/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| alerts/ | rules.json | Reglas de alerta | JSON (datos) | esquema |
| alerts/ | alerts.csv | Alertas | CSV (hoja de cálculo) | esquema |
| alerts/ | alert_transitions.csv | Cambios de estado de las alertas | CSV (hoja de cálculo) | esquema |
| alerts/ | alert_feedback.csv | Valoraciones de las alertas | CSV (hoja de cálculo) | esquema |
Visitasvisits/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| visits/ | visits.csv | Visitas de asesores | CSV (hoja de cálculo) | |
| visits/ | visit_reports.ndjson | Informes de visita | NDJSON (líneas JSON) |
Asistente Kwáu AIkwau/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| kwau/ | conversations.ndjson | Cada conversación con Kwáu AI del espacio de trabajo, con autores seudonimizados | NDJSON (líneas JSON) | esquema |
Actividadaudit/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| audit/ | activity.csv | Registro de actividad | CSV (hoja de cálculo) | esquema |
Fotos y archivosmedia/
| Carpeta | Archivo | Contenido | Formato | Esquema |
|---|---|---|---|---|
| media/ | index.csv | Lista de fotos y archivos | CSV (hoja de cálculo) | esquema |
| media/ | <media_id>.<ext> | Fotos y archivos tal como se subieron | Archivo original |
Exportaciones de una selección
| Exportación | Formatos | Convenciones | Notas |
|---|---|---|---|
| Cuaderno (formato Anexo V) | Excel (XLSX), CSV (hoja de cálculo) |
|
|
| Todos los registros | CSV (hoja de cálculo), Excel (XLSX) |
| |
| Contornos de parcelas | GeoJSON (SIG), Shapefile (zip), KML para Google Earth, CSV (hoja de cálculo) | ||
| Zona de manejo | GeoJSON (SIG), Shapefile (zip) |
| |
| Series de índices de satélite | CSV (hoja de cálculo) | ||
| Series meteorológicas | CSV (hoja de cálculo) |
| |
| Lecturas de sensores | CSV (hoja de cálculo) |
Formatos y estándares
| Formato | Estándar |
|---|---|
| GeoJSON (SIG) | GeoJSON, RFC 7946 (EPSG:4326) |
| Shapefile (zip) | ESRI Shapefile (ESRI Shapefile Technical Description, July 1998), zip with .prj WGS 84 and .cpg UTF-8 |
| KML para Google Earth | OGC KML 2.2 (OGC 07-147r2) |
| CSV (hoja de cálculo) | CSV, RFC 4180 (UTF-8) |
| NDJSON (líneas JSON) | NDJSON (newline-delimited JSON, one RFC 8259 value per line) |
| Libro de Excel (XLSX) | Office Open XML SpreadsheetML, ECMA-376 |
| JSON Schema | JSON Schema 2020-12 |
| Paquete zip | ZIP (PKWARE .ZIP File Format Specification, APPNOTE) |
- Unidades del SI; las superficies, en hectáreas.
- Horas en UTC (ISO 8601); las columnas local_date dan la fecha de la finca.
- Los identificadores son UUID; los de usuario, cadenas de 24 caracteres.
- Correspondencia de columnas con el Anexo V del SIEX v3.11
Previstos: GeoPackage, fiboa GeoParquet, Shapefile de prescripción e ISOXML v1.5.
No incluido
| Qué | Por qué | Se incluye en su lugar |
|---|---|---|
| Imágenes de satélite en bruto | Se pueden reproducir a partir de los datos públicos de Copernicus. | Estadísticas de índices, identificadores de imagen y versión de procesado. |
| Capas de mapa renderizadas | Rampas de color de proveedores; se pueden reproducir a partir de las estadísticas. | Estadísticas y series de índices. |
| Datos meteorológicos en bruto | Condiciones de los proveedores meteorológicos. | Los valores diarios usados, con su fuente. |
| Lógica de alertas y modelos | Secretos empresariales (Reglamento de Datos, art. 2.38). | Las respuestas de Kwáu AI con sus citas, y cada alerta. |
| Datos de otro espacio de trabajo | Pertenece a otro espacio de trabajo. | La lista de vínculos con asesores (org/advisor_links.csv). |
| Credenciales de integraciones | Se mantienen en secreto por seguridad. | Datos de conexión sin secretos. |
| Catálogos de terceros | Con licencia de terceros (EPPO, MAPA, SIEX, SIGPAC). | Los códigos y etiquetas usados en tus registros. |
| Envíos de cada notificación | Registros del sistema sobre personas concretas. | Las alertas y sus cambios de estado. |
| Historial de estado de parcelas | No se guarda. | El estado actual de cada parcela (satellite/parcel_state.csv). |
| Conversación Kwáu de cartera | Mezclan datos de más de un espacio de trabajo cliente. | Su autor las recibe en una exportación de datos personales. |
| Autor de conversación Kwáu AI | Cada conversación es privada para su autor. | Un seudónimo por autor (authorRef). |
Cambio de proveedor y baja
- Aviso: empieza ahora o en una fecha dentro de 2 meses como máximo.
- Transición: 30 días de servicio completo mientras te cambias. Puedes ampliarla una vez.
- Recuperación: al menos 30 días tras la transición, en modo lectura, para descargar tus datos.
- Borrado: borramos todos los datos del espacio de trabajo y enviamos una confirmación por correo a cada propietario.
Sin cargos por cambio de proveedor ni por transferencia de datos.
Solo los propietarios de un espacio de trabajo pueden iniciar el cambio o la baja, y pueden cancelarlo hasta que acabe la transición.
El acceso de los asesores al espacio de trabajo termina cuando acaba la transición.
API de exportación
La API de exportación se describe en un documento OpenAPI. Crea una exportación, consulta su estado y pide un enlace de descarga válido 15 minutos.
Usa el token de acceso de una sesión iniciada (válido 15 minutos, la aplicación web lo renueva). Las claves de API del espacio de trabajo para scripts están previstas para la v1.1.
Hasta 10 exportaciones por hora y 2 exportaciones completas al día por espacio de trabajo. Estos límites protegen el servicio; las exportaciones son gratuitas.
Versiones y cambios
| Versión | Fecha | Cambios |
|---|---|---|
| 1.0.0 | 31 oct 2026 |
|
Los cambios que solo añaden son versiones menores. Quitar una columna exige una versión mayor y 12 meses de convivencia.
Contacto
Dudas sobre exportaciones o cambio de proveedor: hello@truleaf.org.