Seus dados no Truleaf Campos: formatos e migração

Exporte todos os seus dados a qualquer momento, de graça, em formatos abertos.

Versão do registro 1.0.0 · em vigor desde 31 de out. de 2026

Quem pode exportar

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

As exportações são gratuitas em todos os planos, inclusive no plano gratuito, e depois que um plano termina.

Para baixar seus próprios dados pessoais, acesse as configurações da sua conta.

Como exportar

Exportação completa: abra seu espaço de trabalho, vá em Exportações e escolha Exportar tudo. Enviamos um e-mail quando os arquivos estiverem prontos. Eles ficam disponíveis por 30 dias e você pode gerá-los de novo a qualquer momento.
Registros, campos e séries de dados: use Exportar na tela que os mostra, ou abra Exportações e escolha Nova exportação.

A exportação completa

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

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

Os mesmos dados geram os mesmos arquivos, então você 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 registro, histórico de conversas). Guarde-a em local seguro.

Guia

Arquivos de Guia
Pasta	Arquivo	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 arquivo com suas linhas, tamanho, soma de verificação e esquema	JSON (dados)	esquema
Raiz	`schemas/<name>.schema.json`	O JSON Schema de cada arquivo da exportação	JSON Schema (esquema)
Raiz	`schemas/siex-mapping.json`	Correspondência de colunas com o layout Anexo V do SIEX	JSON (dados)	esquema

Espaço de trabalhoorg/

Arquivos de Espaço de trabalho
Pasta	Arquivo	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 suas funções	CSV (planilha)	esquema
org/	`invitations.csv`	Convites abertos e anteriores	CSV (planilha)	esquema
org/	`advisor_links.csv`	Vínculos com consultores e seus clientes	CSV (planilha)	esquema
org/	`consents.csv`	Consentimentos dados no espaço de trabalho	CSV (planilha)	esquema
org/	`settings.json`	Configurações do espaço de trabalho	JSON (dados)	esquema

Propriedades e camposgeo/

Arquivos de Propriedades e campos
Pasta	Arquivo	Conteúdo	Formato	Esquema
geo/	`farms.geojson`	Contornos e detalhes das propriedades	GeoJSON (SIG)	esquema
geo/	`parcels.geojson`	Contornos de cada campo 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`	Vínculos entre campos e recintos SIGPAC	CSV (planilha)	esquema
geo/	`zones.geojson`	Cada zona de manejo, a partir de dados de satélite	GeoJSON (SIG)	esquema

Registrosrecords/

Arquivos de Registros
Pasta	Arquivo	Conteúdo	Formato	Esquema
records/	`seasons.csv`	Ciclos de cultivo por campo	CSV (planilha)	esquema
records/	`seasons.ndjson`	Ciclos de cultivo por campo	NDJSON (linhas JSON)	esquema
records/	`irrigation_systems.csv`	Cada sistema de irrigação	CSV (planilha)	esquema
records/	`irrigation_systems.ndjson`	Cada sistema de irrigação	NDJSON (linhas JSON)	esquema
records/	`tags.csv`	Etiquetas e os campos que elas marcam	CSV (planilha)	esquema
records/	`tags.ndjson`	Etiquetas e os campos que elas marcam	NDJSON (linhas JSON)	esquema
records/	`treatments.csv`	Aplicações	CSV (planilha)	esquema
records/	`treatments.ndjson`	Aplicações	NDJSON (linhas JSON)	esquema
records/	`treatment_products.csv`	Produtos usados em cada aplicação	CSV (planilha)	esquema
records/	`treatment_products.ndjson`	Produtos usados em cada aplicação	NDJSON (linhas JSON)	esquema
records/	`irrigation_events.csv`	Registros de irrigação	CSV (planilha)	esquema
records/	`irrigation_events.ndjson`	Registros de irrigação	NDJSON (linhas JSON)	esquema
records/	`observations.csv`	Cada observação com notas e fotos	CSV (planilha)	esquema
records/	`observations.ndjson`	Cada observação com notas e fotos	NDJSON (linhas JSON)	esquema
records/	`tasks.csv`	Tarefas	CSV (planilha)	esquema
records/	`tasks.ndjson`	Tarefas	NDJSON (linhas JSON)	esquema
records/	`operators.csv`	Aplicadores	CSV (planilha)	esquema
records/	`operators.ndjson`	Aplicadores	NDJSON (linhas JSON)	esquema
records/	`equipment.csv`	Equipamento de aplicação	CSV (planilha)	esquema
records/	`equipment.ndjson`	Equipamento de aplicação	NDJSON (linhas JSON)	esquema
records/	`cuaderno_es.xlsx`	Caderno de campo no layout de colunas do Anexo V (propriedades na Espanha)	Planilha Excel (XLSX)

Satélitesatellite/

Arquivos de Satélite
Pasta	Arquivo	Conteúdo	Formato	Esquema
satellite/	`observations.csv`	Imagens de satélite usadas, com a cobertura de nuvens	CSV (planilha)	esquema
satellite/	`index_stats.csv`	Estatísticas de índice por campo e imagem	CSV (planilha)	esquema
satellite/	`series_daily.csv`	Séries diárias de índice por campo	CSV (planilha)	esquema
satellite/	`phenology.csv`	Estádios fenológicos estimados por ciclo de cultivo	CSV (planilha)
satellite/	`parcel_state.csv`	Situação atual de cada campo	CSV (planilha)	esquema

Clima e águaweather/

Arquivos de Clima e água
Pasta	Arquivo	Conteúdo	Formato	Esquema
weather/	`parcel_water_daily.csv`	Balanço hídrico diário por campo (ET₀, ETc, chuva)	CSV (planilha)	esquema
weather/	`parcel_weather_link.csv`	Fonte meteorológica de cada campo	CSV (planilha)	esquema
weather/	`spray_profiles.json`	Ajustes da janela de pulverização	JSON (dados)	esquema
weather/	`daily.csv`	Valores meteorológicos diários usados, com a fonte	CSV (planilha)	esquema

Sensoressensors/

Arquivos de Sensores
Pasta	Arquivo	Conteúdo	Formato
sensors/	`connections.csv`	Conexões de sensores, sem credenciais	CSV (planilha)
sensors/	`devices.csv`	Dispositivos	CSV (planilha)
sensors/	`sensors.csv`	Sensores de cada dispositivo	CSV (planilha)
sensors/	`readings_<yyyy-mm>_<nnnn>.csv.gz`	Leituras brutas por mês	CSV compactado (gzip)
sensors/	`readings_hourly_<yyyy>.csv.gz`	Leituras horárias por ano	CSV compactado (gzip)
sensors/	`readings_daily.csv`	Leituras diárias	CSV (planilha)

Alertasalerts/

Arquivos de Alertas
Pasta	Arquivo	Conteúdo	Formato	Esquema
alerts/	`rules.json`	Regras de alerta	JSON (dados)	esquema
alerts/	`alerts.csv`	Alertas	CSV (planilha)	esquema
alerts/	`alert_transitions.csv`	Mudanças de status dos alertas	CSV (planilha)	esquema
alerts/	`alert_feedback.csv`	Avaliações dos alertas	CSV (planilha)	esquema

Visitasvisits/

Arquivos de Visitas
Pasta	Arquivo	Conteúdo	Formato	Esquema
visits/	`visits.csv`	Visitas de consultores	CSV (planilha)
visits/	`visit_reports.ndjson`	Relatórios de visita	NDJSON (linhas JSON)

Assistente Kwáu AIkwau/

Arquivos de Assistente Kwáu AI
Pasta	Arquivo	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/

Arquivos de Atividade
Pasta	Arquivo	Conteúdo	Formato	Esquema
audit/	`activity.csv`	Registro de atividade	CSV (planilha)	esquema

Fotos e arquivosmedia/

Arquivos de Fotos e arquivos
Pasta	Arquivo	Conteúdo	Formato	Esquema
media/	`index.csv`	Lista de fotos e arquivos	CSV (planilha)	esquema
media/	`<media_id>.<ext>`	Fotos e arquivos como foram enviados	Arquivo original

Exportações de uma seleção

Exportações que você pode fazer de uma seleção
Exportação	Formatos	Convenções	Notas
Caderno (layout Anexo V)	Excel (XLSX), CSV (planilha)	Excel em espanhol: UTF-8 com BOM, ponto e vírgula, vírgula decimal	Registros no layout de colunas do Anexo V (SIEX v3.11) para sua ferramenta CUE ou seu consultor. O Truleaf Campos não envia dados ao SIEX.
Todos os registros	CSV (planilha), 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 (planilha)
Zona de manejo	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 (planilha)
Séries climáticas	CSV (planilha)		A evapotranspiração de referência é marcada como modelada quando não vem de uma estação meteorológica.
Leituras de sensores	CSV (planilha)

Formatos e padrões

Formatos abertos usados nas exportações
Formato	Padrão
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 (planilha)	CSV, RFC 4180 (UTF-8)
NDJSON (linhas JSON)	NDJSON (newline-delimited JSON, one RFC 8259 value per line)
Planilha 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.
Horários em UTC (ISO 8601); as colunas local_date dão a data da propriedade.
Os identificadores são UUIDs; os de usuário são strings 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ê	Motivo	Incluído no lugar
Imagens de satélite brutas	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 brutos	Termos dos fornecedores de meteorologia.	Os valores diários usados, com a fonte.
Lógica de alertas e modelos	Segredos de negócio (Regulamento de 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 vínculos com consultores (org/advisor_links.csv).
Credenciais de integrações	Mantidas em segredo por segurança.	Dados de conexão sem segredos.
Catálogos de terceiros	Licenciados por terceiros (EPPO, MAPA, SIEX, SIGPAC).	Os códigos e rótulos usados nos seus registros.
Envios de cada notificação	Logs do sistema sobre pessoas específicas.	Os alertas e suas mudanças de status.
Histórico de status do campo	Não é armazenado.	A situação 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 as recebe em uma exportação de dados pessoais.
Autores das conversas do Kwáu AI	As conversas são privadas para o autor.	Um pseudônimo por autor (authorRef).

Troca de fornecedor e saída

Aviso: comece agora ou em uma data até 2 meses à frente.
Transição: 30 dias de serviço completo enquanto você migra. Você pode prorrogá-la uma vez.
Recuperação: pelo menos 30 dias após a transição, somente leitura, para baixar seus dados.
Exclusão: excluímos todos os dados do espaço de trabalho e enviamos uma confirmação por e-mail a cada proprietário.

Sem cobranças por troca de fornecedor ou transferência de dados.

Somente proprietários de um espaço de trabalho podem iniciar a troca ou a saída, e podem cancelá-la até o 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 em um documento OpenAPI. Crie uma exportação, verifique o status e peça um link de download válido por 15 minutos.

Use o token de acesso de uma sessão conectada (válido por 15 minutos, renovado pelo app web). 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. Esses limites protegem o serviço; as exportações são gratuitas.

Registro em JSON

Versões e alterações

Versões do registro
Versão	Data	Alterações
1.0.0	31 de out. de 2026	Primeira versão do registro.

Mudanças que só acrescentam são versões menores. Remover uma coluna exige uma versão maior e 12 meses de sobreposição.

Contato

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