Dados no Truleaf Campos: formatos e mudança

Exporte todos os seus dados a qualquer momento, sem custos, em formatos abertos.

Versão do registo 1.0.0 · em vigor desde 31/10/2026

Quem pode exportar

Proprietários e administradores de um espaço de trabalho podem exportar tudo. Editores podem exportar registos, campos e séries de dados.

As exportações são gratuitas em todos os planos, incluindo o plano gratuito, e depois de um plano terminar.

Para transferir os seus próprios dados pessoais, abra as definições da sua conta.

Como exportar

Exportação completa: abra o seu espaço de trabalho, vá a Exportações e escolha Exportar tudo. Enviamos um e-mail quando os ficheiros estiverem prontos. Ficam disponíveis durante 30 dias e pode gerá-los de novo a qualquer momento.
Registos, campos e séries de dados: use Exportar no ecrã que os mostra, ou abra Exportações e escolha Nova exportação.

A exportação completa

Um ficheiro zip, ou várias partes de até 200 MB com as fotografias em partes próprias. O manifesto lista cada ficheiro com as suas linhas, tamanho, soma de verificação e esquema.

O README fica no idioma que escolher e em inglês.

Os mesmos dados geram os mesmos ficheiros, por isso pode comparar as somas de verificação entre exportações.

A exportação completa contém dados pessoais (nomes, e-mails, números fiscais e de registo, histórico de cada conversa). Guarde-a em local seguro.

Guia

Ficheiros de Guia
Pasta	Ficheiro	Conteúdo	Formato	Esquema
Raiz	`README.md`	O que a exportação contém, no seu idioma e em inglês	Markdown (texto)
Raiz	`manifest.json`	Cada ficheiro com as suas linhas, tamanho, soma de verificação e esquema	JSON (dados)	esquema
Raiz	`schemas/<name>.schema.json`	O JSON Schema de cada ficheiro da exportação	JSON Schema (esquema)
Raiz	`schemas/siex-mapping.json`	Correspondência de colunas com o formato Anexo V do SIEX	JSON (dados)	esquema

Espaço de trabalhoorg/

Ficheiros de Espaço de trabalho
Pasta	Ficheiro	Conteúdo	Formato	Esquema
org/	`org.json`	Nome, tipo, plano e propriedades do espaço de trabalho	JSON (dados)	esquema
org/	`members.csv`	Membros e as suas funções	CSV (folha de cálculo)	esquema
org/	`invitations.csv`	Convites abertos e anteriores	CSV (folha de cálculo)	esquema
org/	`advisor_links.csv`	Ligações com consultores e os seus clientes	CSV (folha de cálculo)	esquema
org/	`consents.csv`	Consentimentos dados no espaço de trabalho	CSV (folha de cálculo)	esquema
org/	`settings.json`	Definições do espaço de trabalho	JSON (dados)	esquema

Propriedades e camposgeo/

Ficheiros de Propriedades e campos
Pasta	Ficheiro	Conteúdo	Formato	Esquema
geo/	`farms.geojson`	Contornos e dados das propriedades	GeoJSON (SIG)	esquema
geo/	`parcels.geojson`	Contornos dos campos com cultura, área e etiquetas	GeoJSON (SIG)	esquema
geo/	`parcel_exclusions.geojson`	Áreas excluídas de cada campo	GeoJSON (SIG)	esquema
geo/	`parcel_sigpac_links.csv`	Ligações entre campos e recintos SIGPAC	CSV (folha de cálculo)	esquema
geo/	`zones.geojson`	Cada zona de gestão, a partir de dados de satélite	GeoJSON (SIG)	esquema

Registosrecords/

Ficheiros de Registos
Pasta	Ficheiro	Conteúdo	Formato	Esquema
records/	`seasons.csv`	Ciclos culturais por campo	CSV (folha de cálculo)	esquema
records/	`seasons.ndjson`	Ciclos culturais por campo	NDJSON (linhas JSON)	esquema
records/	`irrigation_systems.csv`	Cada sistema de rega	CSV (folha de cálculo)	esquema
records/	`irrigation_systems.ndjson`	Cada sistema de rega	NDJSON (linhas JSON)	esquema
records/	`tags.csv`	Etiquetas e os campos que marcam	CSV (folha de cálculo)	esquema
records/	`tags.ndjson`	Etiquetas e os campos que marcam	NDJSON (linhas JSON)	esquema
records/	`treatments.csv`	Tratamentos	CSV (folha de cálculo)	esquema
records/	`treatments.ndjson`	Tratamentos	NDJSON (linhas JSON)	esquema
records/	`treatment_products.csv`	Produtos usados em cada tratamento	CSV (folha de cálculo)	esquema
records/	`treatment_products.ndjson`	Produtos usados em cada tratamento	NDJSON (linhas JSON)	esquema
records/	`irrigation_events.csv`	Registos de rega	CSV (folha de cálculo)	esquema
records/	`irrigation_events.ndjson`	Registos de rega	NDJSON (linhas JSON)	esquema
records/	`observations.csv`	Cada observação com notas e fotografias	CSV (folha de cálculo)	esquema
records/	`observations.ndjson`	Cada observação com notas e fotografias	NDJSON (linhas JSON)	esquema
records/	`tasks.csv`	Tarefas	CSV (folha de cálculo)	esquema
records/	`tasks.ndjson`	Tarefas	NDJSON (linhas JSON)	esquema
records/	`operators.csv`	Aplicadores	CSV (folha de cálculo)	esquema
records/	`operators.ndjson`	Aplicadores	NDJSON (linhas JSON)	esquema
records/	`equipment.csv`	Equipamento de aplicação	CSV (folha de cálculo)	esquema
records/	`equipment.ndjson`	Equipamento de aplicação	NDJSON (linhas JSON)	esquema
records/	`cuaderno_es.xlsx`	Caderno de campo no formato de colunas do Anexo V (propriedades em Espanha)	Livro do Excel (XLSX)

Satélitesatellite/

Ficheiros de Satélite
Pasta	Ficheiro	Conteúdo	Formato	Esquema
satellite/	`observations.csv`	Imagens de satélite usadas, com a nebulosidade	CSV (folha de cálculo)	esquema
satellite/	`index_stats.csv`	Estatísticas de índice por campo e imagem	CSV (folha de cálculo)	esquema
satellite/	`series_daily.csv`	Séries diárias de índice por campo	CSV (folha de cálculo)	esquema
satellite/	`phenology.csv`	Estados de crescimento estimados por ciclo cultural	CSV (folha de cálculo)
satellite/	`parcel_state.csv`	Estado atual de cada campo	CSV (folha de cálculo)	esquema

Meteorologia e águaweather/

Ficheiros de Meteorologia e água
Pasta	Ficheiro	Conteúdo	Formato	Esquema
weather/	`parcel_water_daily.csv`	Balanço hídrico diário por campo (ET₀, ETc, chuva)	CSV (folha de cálculo)	esquema
weather/	`parcel_weather_link.csv`	Fonte meteorológica de cada campo	CSV (folha de cálculo)	esquema
weather/	`spray_profiles.json`	Definições da janela de tratamento	JSON (dados)	esquema
weather/	`daily.csv`	Valores meteorológicos diários usados, com a fonte	CSV (folha de cálculo)	esquema

Sensoressensors/

Ficheiros de Sensores
Pasta	Ficheiro	Conteúdo	Formato
sensors/	`connections.csv`	Ligações de sensores, sem credenciais	CSV (folha de cálculo)
sensors/	`devices.csv`	Dispositivos	CSV (folha de cálculo)
sensors/	`sensors.csv`	Sensores de cada dispositivo	CSV (folha de cálculo)
sensors/	`readings_<yyyy-mm>_<nnnn>.csv.gz`	Leituras em bruto por mês	CSV comprimido (gzip)
sensors/	`readings_hourly_<yyyy>.csv.gz`	Leituras horárias por ano	CSV comprimido (gzip)
sensors/	`readings_daily.csv`	Leituras diárias	CSV (folha de cálculo)

Alertasalerts/

Ficheiros de Alertas
Pasta	Ficheiro	Conteúdo	Formato	Esquema
alerts/	`rules.json`	Regras de alerta	JSON (dados)	esquema
alerts/	`alerts.csv`	Alertas	CSV (folha de cálculo)	esquema
alerts/	`alert_transitions.csv`	Mudanças de estado dos alertas	CSV (folha de cálculo)	esquema
alerts/	`alert_feedback.csv`	Avaliações dos alertas	CSV (folha de cálculo)	esquema

Visitasvisits/

Ficheiros de Visitas
Pasta	Ficheiro	Conteúdo	Formato	Esquema
visits/	`visits.csv`	Visitas de consultores	CSV (folha de cálculo)
visits/	`visit_reports.ndjson`	Relatórios de visita	NDJSON (linhas JSON)

Assistente Kwáu AIkwau/

Ficheiros de Assistente Kwáu AI
Pasta	Ficheiro	Conteúdo	Formato	Esquema
kwau/	`conversations.ndjson`	Conversas do espaço de trabalho com o Kwáu AI, autores pseudonimizados	NDJSON (linhas JSON)	esquema

Atividadeaudit/

Ficheiros de Atividade
Pasta	Ficheiro	Conteúdo	Formato	Esquema
audit/	`activity.csv`	Registo de atividade	CSV (folha de cálculo)	esquema

Fotografias e ficheirosmedia/

Ficheiros de Fotografias e ficheiros
Pasta	Ficheiro	Conteúdo	Formato	Esquema
media/	`index.csv`	Lista de fotografias e ficheiros	CSV (folha de cálculo)	esquema
media/	`<media_id>.<ext>`	Fotografias e ficheiros tal como foram carregados	Ficheiro original

Exportações de uma seleção

Exportações que pode fazer de uma seleção
Exportação	Formatos	Convenções	Observações
Caderno (formato Anexo V)	Excel (XLSX), CSV (folha de cálculo)	Excel em espanhol: UTF-8 com BOM, ponto e vírgula, vírgula decimal	Registos no formato de colunas do Anexo V (SIEX v3.11) para a sua ferramenta CUE ou o seu consultor. O Truleaf Campos não envia dados para o SIEX.
Todos os registos	CSV (folha de cálculo), Excel (XLSX)	Padrão: UTF-8, vírgula, ponto decimal Excel em espanhol: UTF-8 com BOM, ponto e vírgula, vírgula decimal
Contornos dos campos	GeoJSON (SIG), Shapefile (zip), KML para Google Earth, CSV (folha de cálculo)
Zona de gestão	GeoJSON (SIG), Shapefile (zip)		As zonas descrevem padrões de vigor nos dados de satélite. Não são uma prescrição de aplicação.
Séries de índices de satélite	CSV (folha de cálculo)
Séries meteorológicas	CSV (folha de cálculo)		A evapotranspiração de referência é marcada como modelada quando não vem de uma estação meteorológica.
Leituras de sensores	CSV (folha de cálculo)

Formatos e normas

Formatos abertos usados nas exportações
Formato	Norma
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 (folha de cálculo)	CSV, RFC 4180 (UTF-8)
NDJSON (linhas JSON)	NDJSON (newline-delimited JSON, one RFC 8259 value per line)
Livro do Excel (XLSX)	Office Open XML SpreadsheetML, ECMA-376
JSON Schema (esquema)	JSON Schema 2020-12
Pacote zip	ZIP (PKWARE .ZIP File Format Specification, APPNOTE)

Unidades do SI; áreas em hectares.
Horas em UTC (ISO 8601); as colunas local_date dão a data da propriedade.
Os identificadores são UUID; os de utilizador são cadeias de 24 caracteres.
Correspondência de colunas com o Anexo V do SIEX v3.11

Previstos: GeoPackage, fiboa GeoParquet, Shapefile de prescrição e ISOXML v1.5.

Não incluído

O que a exportação completa não inclui
O quê	Porquê	Incluído em vez disso
Imagens de satélite em bruto	Podem ser reproduzidas a partir dos dados públicos do Copernicus.	Estatísticas de índice, identificadores de imagem e a versão do processamento.
Camadas de mapa renderizadas	Escalas de cores dos fornecedores; podem ser reproduzidas a partir das estatísticas.	Estatísticas e séries de índice.
Dados meteorológicos em bruto	Termos dos fornecedores de meteorologia.	Os valores diários usados, com a fonte.
Lógica de alertas e modelos	Segredos de negócio (Regulamento dos Dados, art. 2.º, ponto 38).	As respostas do Kwáu AI com as citações, e cada alerta.
Dados fora do espaço de trabalho	Pertencem a outro espaço de trabalho.	A lista de ligações com consultores (org/advisor_links.csv).
Credenciais de integrações	Mantidas em segredo por segurança.	Dados de ligação sem segredos.
Catálogos de terceiros	Licenciados por terceiros (EPPO, MAPA, SIEX, SIGPAC).	Os códigos e rótulos usados nos seus registos.
Envios de cada notificação	Registos do sistema sobre pessoas concretas.	Os alertas e as suas mudanças de estado.
Histórico de estado dos campos	Não é guardado.	O estado atual de cada campo (satellite/parcel_state.csv).
Conversas Kwáu da carteira	Misturam dados de mais de um espaço de trabalho de cliente.	O autor recebe-as numa exportação de dados pessoais.
Autores das conversas do Kwáu AI	As conversas são privadas do respetivo autor.	Um pseudónimo por autor (authorRef).

Mudança de fornecedor e saída

Aviso: comece agora ou numa data até 2 meses depois.
Transição: 30 dias de serviço completo enquanto muda. Pode prolongá-la uma vez.
Recuperação: pelo menos 30 dias após a transição, só de consulta, para transferir os seus dados.
Eliminação: eliminamos todos os dados do espaço de trabalho e enviamos uma confirmação por e-mail a cada proprietário.

Sem custos de mudança de fornecedor ou de transferência de dados.

Só os proprietários de um espaço de trabalho podem iniciar a mudança ou a saída, e podem cancelá-la até ao fim da transição.

O acesso dos consultores ao espaço de trabalho termina quando a transição acaba.

API de exportação

A API de exportação é descrita num documento OpenAPI. Crie uma exportação, verifique o estado e peça uma ligação de transferência válida durante 15 minutos.

Use o token de acesso de uma sessão iniciada (válido durante 15 minutos, renovado pela aplicação web). As chaves de API do espaço de trabalho para scripts estão previstas para a v1.1.

Até 10 exportações por hora e 2 exportações completas por dia por espaço de trabalho. Estes limites protegem o serviço; as exportações são gratuitas.

Registo em JSON

Versões e alterações

Versões do registo
Versão	Data	Alterações
1.0.0	31/10/2026	Primeira versão do registo.

As alterações aditivas são versões menores. Remover uma coluna exige uma versão maior e 12 meses de sobreposição.

Contacto

Dúvidas sobre exportações ou mudança de fornecedor: hello@truleaf.org.