Ваші дані в Truleaf Fields: формати й перехід

Експортуйте всі свої дані будь-коли, безкоштовно, у відкритих форматах.

Версія реєстру 1.0.0 · чинна з 31 жовт. 2026 р.

Хто може експортувати

Власники й адміністратори робочого простору можуть експортувати все. Редактори можуть експортувати записи, поля й ряди даних.

Експорт безкоштовний на кожному тарифі, зокрема безкоштовному, і після завершення тарифу.

Щоб завантажити власні персональні дані, відкрийте налаштування свого облікового запису.

Як експортувати

Повний експорт: відкрийте робочий простір, перейдіть до розділу Експорт і виберіть Експортувати все. Ми повідомимо листом, коли файли будуть готові. Файли доступні 30 днів, і ви можете створити їх знову будь-коли.
Записи, поля й ряди даних: натисніть Експортувати на екрані, де вони показані, або відкрийте Експорти й виберіть Новий експорт.

Повний експорт

Один zip-файл або кілька частин до 200 МБ, фото — в окремих частинах. Маніфест містить кожен файл із кількістю рядків, розміром, контрольною сумою та схемою.

README — вибраною мовою та англійською.

Однакові дані дають однакові файли, тож контрольні суми різних експортів можна порівнювати.

Повний експорт містить персональні дані: імена, email, податкові та реєстраційні номери; кожна розмова входить з історією. Зберігайте його надійно.

Довідка

Файли розділу «Довідка»
Папка	Файл	Вміст	Формат	Схема
Коренева папка	`README.md`	Що містить експорт, вашою мовою та англійською	Markdown (текст)
Коренева папка	`manifest.json`	Кожен файл із рядками, розміром, контрольною сумою та схемою	JSON (дані)	схема
Коренева папка	`schemas/<name>.schema.json`	JSON Schema кожного файлу експорту	JSON Schema (схема)
Коренева папка	`schemas/siex-mapping.json`	Відповідність стовпців макету Anexo V системи SIEX	JSON (дані)	схема

Робочий простірorg/

Файли розділу «Робочий простір»
Папка	Файл	Вміст	Формат	Схема
org/	`org.json`	Назва, тип, тариф і ферми робочого простору	JSON (дані)	схема
org/	`members.csv`	Учасники та їхні ролі	CSV (таблиця)	схема
org/	`invitations.csv`	Відкриті та минулі запрошення	CSV (таблиця)	схема
org/	`advisor_links.csv`	Зв’язки з консультантами та їхніми клієнтами	CSV (таблиця)	схема
org/	`consents.csv`	Згоди, надані в робочому просторі	CSV (таблиця)	схема
org/	`settings.json`	Налаштування робочого простору	JSON (дані)	схема

Ферми й поляgeo/

Файли розділу «Ферми й поля»
Папка	Файл	Вміст	Формат	Схема
geo/	`farms.geojson`	Контури й дані ферм	GeoJSON (ГІС)	схема
geo/	`parcels.geojson`	Контури полів із культурою, площею та мітками	GeoJSON (ГІС)	схема
geo/	`parcel_exclusions.geojson`	Ділянки, виключені з полів	GeoJSON (ГІС)	схема
geo/	`parcel_sigpac_links.csv`	Зв’язки між полями й ділянками SIGPAC	CSV (таблиця)	схема
geo/	`zones.geojson`	Кожна зона управління за супутниковими даними	GeoJSON (ГІС)	схема

Записиrecords/

Файли розділу «Записи»
Папка	Файл	Вміст	Формат	Схема
records/	`seasons.csv`	Цикли вирощування за полями	CSV (таблиця)	схема
records/	`seasons.ndjson`	Цикли вирощування за полями	NDJSON (рядки JSON)	схема
records/	`irrigation_systems.csv`	Кожна система зрошення	CSV (таблиця)	схема
records/	`irrigation_systems.ndjson`	Кожна система зрошення	NDJSON (рядки JSON)	схема
records/	`tags.csv`	Мітка й поля, які вона позначає	CSV (таблиця)	схема
records/	`tags.ndjson`	Мітка й поля, які вона позначає	NDJSON (рядки JSON)	схема
records/	`treatments.csv`	Обробки	CSV (таблиця)	схема
records/	`treatments.ndjson`	Обробки	NDJSON (рядки JSON)	схема
records/	`treatment_products.csv`	Засоби, використані в кожній обробці	CSV (таблиця)	схема
records/	`treatment_products.ndjson`	Засоби, використані в кожній обробці	NDJSON (рядки JSON)	схема
records/	`irrigation_events.csv`	Записи про полив	CSV (таблиця)	схема
records/	`irrigation_events.ndjson`	Записи про полив	NDJSON (рядки JSON)	схема
records/	`observations.csv`	Спостереження з нотатками й фото	CSV (таблиця)	схема
records/	`observations.ndjson`	Спостереження з нотатками й фото	NDJSON (рядки JSON)	схема
records/	`tasks.csv`	Завдання	CSV (таблиця)	схема
records/	`tasks.ndjson`	Завдання	NDJSON (рядки JSON)	схема
records/	`operators.csv`	Кожен виконавець обробки	CSV (таблиця)	схема
records/	`operators.ndjson`	Кожен виконавець обробки	NDJSON (рядки JSON)	схема
records/	`equipment.csv`	Техніка для внесення	CSV (таблиця)	схема
records/	`equipment.ndjson`	Техніка для внесення	NDJSON (рядки JSON)	схема
records/	`cuaderno_es.xlsx`	Польовий журнал у макеті стовпців Anexo V (ферми в Іспанії)	Книга Excel (XLSX)

Супутникsatellite/

Файли розділу «Супутник»
Папка	Файл	Вміст	Формат	Схема
satellite/	`observations.csv`	Використані супутникові знімки з хмарністю	CSV (таблиця)	схема
satellite/	`index_stats.csv`	Статистика індексу для кожного поля та знімка	CSV (таблиця)	схема
satellite/	`series_daily.csv`	Щоденні ряди індексу для кожного поля	CSV (таблиця)	схема
satellite/	`phenology.csv`	Цикл вирощування й оцінені фази росту в ньому	CSV (таблиця)
satellite/	`parcel_state.csv`	Поточний стан кожного поля	CSV (таблиця)	схема

Погода й водаweather/

Файли розділу «Погода й вода»
Папка	Файл	Вміст	Формат	Схема
weather/	`parcel_water_daily.csv`	Щоденний водний баланс поля (ET₀, ETc, опади)	CSV (таблиця)	схема
weather/	`parcel_weather_link.csv`	Джерело погоди для кожного поля	CSV (таблиця)	схема
weather/	`spray_profiles.json`	Вікно для обприскування: налаштування	JSON (дані)	схема
weather/	`daily.csv`	Використані щоденні погодні значення з джерелом	CSV (таблиця)	схема

Датчикиsensors/

Файли розділу «Датчики»
Папка	Файл	Вміст	Формат
sensors/	`connections.csv`	Підключення датчиків, без облікових даних	CSV (таблиця)
sensors/	`devices.csv`	Пристрої	CSV (таблиця)
sensors/	`sensors.csv`	Пристрій і його датчики	CSV (таблиця)
sensors/	`readings_<yyyy-mm>_<nnnn>.csv.gz`	Сирі показання за місяцями	CSV, стиснений (gzip)
sensors/	`readings_hourly_<yyyy>.csv.gz`	Погодинні показання за роками	CSV, стиснений (gzip)
sensors/	`readings_daily.csv`	Щоденні показання	CSV (таблиця)

Попередженняalerts/

Файли розділу «Попередження»
Папка	Файл	Вміст	Формат	Схема
alerts/	`rules.json`	Правила попереджень	JSON (дані)	схема
alerts/	`alerts.csv`	Попередження	CSV (таблиця)	схема
alerts/	`alert_transitions.csv`	Зміни статусу попереджень	CSV (таблиця)	схема
alerts/	`alert_feedback.csv`	Відгуки на попередження	CSV (таблиця)	схема

Візитиvisits/

Файли розділу «Візити»
Папка	Файл	Вміст	Формат	Схема
visits/	`visits.csv`	Візити консультантів	CSV (таблиця)
visits/	`visit_reports.ndjson`	Звіти про візити	NDJSON (рядки JSON)

Асистент Kwáu AIkwau/

Файли розділу «Асистент Kwáu AI»
Папка	Файл	Вміст	Формат	Схема
kwau/	`conversations.ndjson`	Кожна розмова з Kwáu AI в робочому просторі, автори під псевдонімами	NDJSON (рядки JSON)	схема

Активністьaudit/

Файли розділу «Активність»
Папка	Файл	Вміст	Формат	Схема
audit/	`activity.csv`	Журнал активності	CSV (таблиця)	схема

Фото й файлиmedia/

Файли розділу «Фото й файли»
Папка	Файл	Вміст	Формат	Схема
media/	`index.csv`	Список фото й файлів	CSV (таблиця)	схема
media/	`<media_id>.<ext>`	Фото й файли в тому вигляді, як їх завантажили	Оригінальний файл

Експорт вибраних даних

Які експорти можна зробити з вибраних даних
Експорт	Формати	Угоди	Нотатки
Cuaderno (формат Anexo V)	Таблиця Excel (XLSX), CSV (таблиця)	Іспанський Excel: UTF-8 з BOM, крапка з комою, десяткова кома	Записи в макеті стовпців Anexo V (SIEX v3.11) для вашого інструмента CUE або консультанта. Truleaf Fields не надсилає дані в SIEX.
Усі записи	CSV (таблиця), Таблиця Excel (XLSX)	Стандарт: UTF-8, кома, десяткова крапка Іспанський Excel: UTF-8 з BOM, крапка з комою, десяткова кома
Контури полів	GeoJSON (ГІС), Shapefile (zip-архів), KML для Google Earth, CSV (таблиця)
Зона управління	GeoJSON (ГІС), Shapefile (zip-архів)		Зони описують закономірності вегетації в супутникових даних. Це не карта внесення.
Ряди супутникових індексів	CSV (таблиця)
Ряди погоди	CSV (таблиця)		Еталонна евапотранспірація позначається як змодельована, якщо вона не з метеостанції.
Показання датчиків	CSV (таблиця)

Формати й стандарти

Відкриті формати в експортах
Формат	Стандарт
GeoJSON (ГІС)	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 для Google Earth	OGC KML 2.2 (OGC 07-147r2)
CSV (таблиця)	CSV, RFC 4180 (UTF-8)
NDJSON (рядки JSON)	NDJSON (newline-delimited JSON, one RFC 8259 value per line)
Книга Excel (XLSX)	Office Open XML SpreadsheetML, ECMA-376
JSON Schema (схема)	JSON Schema 2020-12
Zip-архів	ZIP (PKWARE .ZIP File Format Specification, APPNOTE)

Одиниці SI; площі в гектарах.
Час у UTC (ISO 8601); стовпці local_date містять дату ферми.
Ідентифікатори — UUID; ідентифікатори користувачів — рядки з 24 символів.
Відповідність стовпців Anexo V SIEX v3.11

Заплановано: GeoPackage, fiboa GeoParquet, Shapefile для карт внесення та ISOXML v1.5.

Не входить

Що не входить до повного експорту
Що	Чому	Натомість входить
Сирі супутникові знімки	Їх можна відтворити з відкритих даних Copernicus.	Статистика індексу, ідентифікатори знімків і версія обробки.
Згенеровані шари карти	Колірні шкали постачальників; їх можна відтворити зі статистики.	Статистика й ряди індексу.
Сирі погодні дані	Умови постачальників погодних даних.	Використані щоденні значення з джерелом.
Логіка попереджень і моделей	Таємниці бізнесу (Акт про дані, ст. 2, п. 38).	Відповіді Kwáu AI з цитатами і кожне попередження.
Дані інших робочих просторів	Вони належать іншому робочому простору.	Список зв’язків із консультантами (org/advisor_links.csv).
Облікові дані інтеграцій	Приховані з міркувань безпеки.	Дані підключення без секретів.
Каталоги третіх сторін	Ліцензовані третіми сторонами (EPPO, MAPA, SIEX, SIGPAC).	Коди й назви, використані у ваших записах.
Доставка кожного сповіщення	Системні журнали про конкретних людей.	Попередження та зміни їхнього статусу.
Історія стану поля	Не зберігається.	Поточний стан кожного поля (satellite/parcel_state.csv).
Розмова Kwáu в портфелі	Вони поєднують дані кількох робочих просторів клієнтів.	Їхній автор отримує їх в експорті персональних даних.
Автор розмови з Kwáu AI	Кожна розмова приватна для свого автора.	Один псевдонім на автора (authorRef).

Перехід і вихід із сервісу

Повідомлення: почніть зараз або з дати не пізніше ніж за 2 місяці.
Перехідний період: 30 днів повного сервісу, поки ви переходите. Його можна продовжити 1 раз.
Отримання даних: щонайменше 30 днів після перехідного періоду, лише перегляд, щоб завантажити дані.
Видалення: ми видаляємо всі дані робочого простору й надсилаємо кожному власнику підтвердження листом.

Без плати за перехід чи перенесення даних.

Лише власники робочого простору можуть почати перехід або вихід і скасувати його до кінця перехідного періоду.

Доступ консультантів до робочого простору закінчується разом із перехідним періодом.

API експорту

API експорту описано в документі OpenAPI. Створіть експорт, перевірте статус і запросіть посилання для завантаження, чинне 15 хвилин.

Використовуйте токен доступу сеансу, у який ви ввійшли (чинний 15 хвилин, вебзастосунок його оновлює). Ключі API робочого простору для скриптів заплановано у v1.1.

До 10 експортів на годину й 2 повних експортів на день для робочого простору. Ці ліміти захищають сервіс; експорт безкоштовний.

Реєстр у JSON

Версії та зміни

Версії реєстру
Версія	Дата	Зміни
1.0.0	31 жовт. 2026 р.	Перша версія реєстру.

Додавання — це мінорні версії. Вилучення стовпця потребує мажорної версії та 12 місяців перекриття.

Контакти

Питання про експорт чи перехід: hello@truleaf.org.