Datenimport und Export für Erzeuger und Flächen

Unter Einstellungen → Import und Export bereitest du Erzeuger und Anbauflächen als CSV auf. Für beide Datentypen stehen eine leere Vorlage, eine befüllte Beispieldatei und der Export vorhandener Daten bereit.

Mit Vorlage oder Export starten

1. Wähle Erzeuger oder Anbauflächen.
2. Lade Vorlage herunterladen für eine leere Datei oder Beispieldatei herunterladen für ausgefüllte Musterzeilen. Spalten und Formate erklärt dieselben Felder direkt in der App.
3. Mit Vorhandene Daten exportieren erhältst du die Daten der ausgewählten Organisation in denselben Spalten. Der Flächenexport enthält die aktuelle Geometrie als GeoJSON. Erzeuger-IDs aus dem Export kannst du direkt in die Flächendatei übernehmen.
4. Ersetze die fiktiven Beispieldaten durch deine Angaben. Die Beispiele beziehen sich auf Burkina Faso und Togo; Namen, IDs und Koordinaten sind keine verifizierten Felddaten.
5. Importiere zuerst Erzeuger und anschließend deren Flächen. Eine producer_external_id muss bereits existieren.

Der Export lädt alle Seiten vollständig, bevor die CSV angeboten wird. Bei einem Fehler wird keine unvollständige Datei heruntergeladen. Eine leere Organisation ergibt eine Datei nur mit Spaltenüberschriften. Der Export umfasst Erzeugerstammdaten und die aktuellen Flächenversionen, einschließlich vorhandener inaktiver Stammdatensätze. Er ist keine vollständige Sicherung von Historie, Status, Dokumenten oder Prüfungen.

Bestehende Daten werden übersprungen

Der Import legt neue Datensätze an. Er aktualisiert keine bestehenden Einträge. Erzeuger werden an der externen ID oder der Kombination aus Name und Land erkannt, Flächen an ihrer externen ID. Wenn du eine exportierte Fläche erneut importierst, behalte ihre ID bei, damit keine zusätzliche Fläche entsteht.

Erzeuger: Spalten

Spalte	Pflicht	Format und Bedeutung
name	Ja	Name des Erzeugers.
country_code	Ja	Ländercode mit zwei Buchstaben: z. B. BF oder TG.
external_id	Nein	Eindeutige externe ID. Ohne Angabe erzeugt Via eine ID.
producer_type	Nein	individual, cooperative, estate oder company. Standard: individual.
region	Nein	Region oder Verwaltungsgebiet als Text.
locality	Nein	Ort oder Dorf als Text.
address	Nein	Adresse als Text.
postal_code	Nein	Postleitzahl als Text, damit führende Nullen erhalten bleiben.
phone	Nein	Telefonnummer als Text, z. B. mit +226 oder +228.
email	Nein	E-Mail-Adresse mit @.
cooperative	Nein	Exakter Name einer vorhandenen, aktiven Kooperative. Vorher anlegen oder leer lassen.

Beispiel mit den nötigen Angaben und einer eigenen ID:

external_id,name,country_code
PR-BF-EXAMPLE,Beispielbetrieb Burkina Faso,BF

Anbauflächen: Spalten

Spalte	Pflicht	Format und Bedeutung
producer_external_id	Ja	Externe ID eines vorhandenen Erzeugers, exakt wie im Erzeugerexport.
name	Ja	Name der Anbaufläche.
crop	Ja	Kulturcode, z. B. maize oder cocoa. Die App zeigt die verfügbaren Codes der Organisation. Übersetzte Namen wie „Mais“ sind keine Codes.
external_id	Nein	Eindeutige Flächen-ID. Ohne Angabe wird eine erzeugt.
area_ha	Bei Punkt	Fläche größer als 0 und höchstens 4 ha. Bei einem Polygon berechnet Via die Fläche aus der Grenze.
latitude	Ohne geometry	WGS84-Breitengrad zwischen −90 und 90. Zusammen mit longitude angeben.
longitude	Ohne geometry	WGS84-Längengrad zwischen −180 und 180. Westliche Längen sind negativ.
geometry	Alternative zu Koordinatenspalten	GeoJSON-Geometrie vom Typ Point oder Polygon, kein Feature oder FeatureCollection. Hat Vorrang vor latitude und longitude.
valid_from	Nein	Datum als JJJJ-MM-TT. Ohne Angabe: Importtag.

Punkt oder Flächengrenze

Für einen Punkt bis 4 ha genügen Breiten- und Längengrad mit der Flächenangabe. Beispiel für eine fiktive 3-ha-Fläche:

producer_external_id,external_id,name,crop,area_ha,latitude,longitude
PR-BF-EXAMPLE,PL-BF-EXAMPLE,Beispielfläche,maize,3,10.78,-4.42

Für mehr als 4 ha brauchst du eine Polygongrenze. In GeoJSON steht immer zuerst der Längengrad, dann der Breitengrad. Der Ring muss geschlossen sein: Der letzte Koordinatenpunkt entspricht dem ersten. Die Beispieldatei enthält bereits ein korrekt in CSV eingebettetes Polygon. Wenn du sie bearbeitest, lasse das Tabellenprogramm die Anführungszeichen beim CSV-Speichern setzen.

Datei prüfen und importieren

1. Lade die Datei über CSV-Datei auswählen hoch.
2. Wähle Prüfen. Der Probelauf schreibt keine Datensätze.
3. Korrigiere gemeldete Fehler und lade die Datei erneut hoch. „Übersprungen“ bedeutet beispielsweise: ID schon vorhanden, Erzeuger unbekannt oder Kooperative nicht gefunden.
4. Wähle erst bei passender Vorschau Datensätze importieren. Fehlerhafte und übersprungene Zeilen werden nicht angelegt.

Pro Datei sind höchstens 1.000 Datenzeilen möglich. Größere Exporte musst du vor dem Import aufteilen und die Kopfzeile in jeder Teildatei beibehalten. CSV und TSV mit Komma, Semikolon oder Tabulator werden unterstützt; ein Trennzeichen gilt jeweils für die gesamte Datei. UTF-8 erhält Akzente und Sonderzeichen. Ein Dezimalpunkt ist empfohlen; bei Dezimalkomma muss das Feld korrekt in Anführungszeichen stehen oder ein anderes Trennzeichen verwendet werden.

Öffne IDs, Telefonnummern und Postleitzahlen im Tabellenprogramm als Text. Der Export schützt formelähnliche Textwerte mit einem führenden Apostroph; Via erkennt diese Textmarkierung beim erneuten Import und entfernt sie wieder. Anführungszeichen, Trennzeichen und mehrzeilige Adressen bleiben erhalten.

Berechtigungen und Kontrolle

Für Prüfung und Import brauchst du Schreibrechte für Erzeuger beziehungsweise Flächen. Der Erzeugerexport benötigt Leserechte für Erzeuger. Der Flächenexport benötigt Leserechte für Flächen und zusätzlich Anbauflächen exportieren. Der Export bleibt auf die ausgewählte Organisation beschränkt.

Prüfe nach dem Flächenimport die Zuordnung zum Erzeuger, Koordinaten und Grenze auf der Karte. Starte anschließend bei Bedarf das Waldscreening und die Feldprüfung. Importierte Geometrie allein ist kein Prüfergebnis.