Daten importieren & exportieren
Stammdaten per CSV/JSON importieren (Kontakte, Produkte, Produktkategorien, Fahrzeuge, Fehlercodes) und Buchhalter-, Archiv-, DEP7- und Vollexporte herunterladen.
→ Imports öffnen · Exporte öffnen
Unter Administration → Daten & Geräte importierst du Stammdaten aus CSV- oder JSON-Dateien und lädst Exporte für Buchhaltung, Archiv und Behörden herunter. Beide Bereiche liegen als getrennte Seiten in der Admin-Navigation: Importe und Exporte.
Daten importieren
Auf der Seite Importe wählst du oben eines von fünf Importzielen (die Kacheln sind in der Oberfläche englisch beschriftet):
- Contacts – Kunden- und Kontaktdatensätze anlegen oder aktualisieren.
- Products – Katalogprodukte inklusive Bestand, Kategorien und Lieferanten.
- Product categories – verschachtelte Kategoriepfade anlegen.
- Vehicles – Kundenfahrzeuge, Räder und Flottendaten.
- Fault codes – Herstellerfehlercodes samt Ersatzteilen (siehe Moduleinstellungen).
Jeder Import akzeptiert CSV oder JSON (.json / .csv). Bei CSV wählst du das CSV-Trennzeichen: Auto, Semikolon (;), Komma (,) oder Tab. Excel-Dateien (.xlsx/.xls) werden nicht direkt gelesen – speichere sie vorher als CSV. Über die aufklappbaren Formatblöcke siehst du jeweils ein Beispiel und lädst es per JSON herunterladen / CSV herunterladen als Vorlage herunter.
So läuft ein Import ab
Importziel wählen
Klicke oben auf die passende Kachel. SimpliServ erkennt anhand der Spalten, wenn eine Datei zum falschen Ziel passt, und weist dich darauf hin.
Datei auswählen
Lade unter Datei (JSON oder CSV) deine Datei hoch und stelle bei CSV bei Bedarf das passende Trennzeichen ein. Die Datei wird sofort eingelesen und geprüft.
Vorschau prüfen
SimpliServ zeigt an, wie viele Datensätze bereit zum Import sind, sowie ignorierte Duplikate und ungültige Zeilen. In der Tabellenvorschau stehen fehlerhafte Zeilen zuerst; problematische Zellen sind rot markiert, automatisch gesetzte Standardwerte kursiv.
Probelauf (optional, empfohlen)
Mit Probelauf simulierst du den Import, ohne Daten zu schreiben. Das Ergebnis zeigt z. B. „Würde anlegen", „Würde aktualisieren" und „Würde überspringen".
Import starten
Klicke auf Import starten. Ein Fortschrittsbalken läuft mit; danach erscheinen die Ergebnisse (angelegt / aktualisiert / fehlgeschlagen) und eine Liste der Fehler mit der jeweiligen Zeile und Begründung.
Nutze immer zuerst den Probelauf, besonders bei großen Dateien. Er deckt Duplikate, fehlende Pflichtfelder und nicht zuordenbare Zeilen auf, bevor etwas gespeichert wird.
Kontakte importieren
Es gibt zwei Modi, umschaltbar über den Schalter Bestehende Kontakte aktualisieren:
- Anlegen (Standard): legt neue Kontakte an. Mindestens Vor-/Nachname oder Firma ist erforderlich. Doppelte E-Mail-Adressen innerhalb der Datei werden übersprungen.
- Patch (Schalter aktiv): ordnet Zeilen über
id(bevorzugt) oderemailbestehenden Kontakten zu und aktualisiert nur die gefüllten Felder. Nicht zuordenbare Zeilen werden übersprungen. Nur in diesem Modus lassen sichcreated_atundupdated_atüberschreiben.
Unterstützte Felder (Auswahl, mit Spalten-Aliassen): first_name/last_name (oder name), email, phone, company, website, uid/vat_id, tax_number, salutation, academic_title, bank_name, iban, bic, image_url, notes, birthday, newsletter_accepted, automatic_emails, customer_type, customer_group.
- Adressen: entweder flach über
shipping_*undbilling_*(z. B.shipping_address1,billing_zip) oder strukturiert alsaddresses-Array (JSON) bzw. nummerierte Spaltenaddress_1_type,address_1_address1… (Typen:billing,shipping,private,work,other). Das Land wird über ISO-Code oder Ländername aufgelöst. - Eigene Felder: als JSON-Objekt
custom_fieldsoder als CSV-Spaltencustom_fields_<slug>(z. B.custom_fields_kundenkategorie).
Mehr zur Pflege siehe Kontakte, Kundentypen & -gruppen und Eigene Felder.
Produkte importieren
Pflichtfeld ist name. Fehlende Kategorien und Lieferanten werden beim Import automatisch angelegt.
- Preise:
pricefür Netto oderprice_grossfür Brutto, gesteuert überprice_input_mode(net/gross). Beträge werden auch in lokaler Schreibweise erkannt (20,45ebenso wie1.234,56). - Standardwerte: ohne Angabe wird der Steuersatz auf 20 % und die Einheit auf Stück gesetzt.
- Bestand & Lager:
quantityfür die Menge;storage_nameakzeptiert verschachtelte Pfade – das erste Segment ist das Lager, weitere Segmente bilden die Lagerort-Hierarchie (Trenner>oder/, z. B.Hauptlager > Regal A > Fach 3). Ohne Angabe landet der Bestand im Standardlager „Import". - Weitere Felder:
article_number,ean,description,purchase_price,weight,is_serialized,manufacturer,device_model,supplier_name,categories,custom_fields_<slug>.
Zwei Optionen stehen zur Verfügung:
- Kategorien automatisch aufteilen (/ und >) – zerlegt Kategorieangaben in Pfad-Ebenen. Mehrere Kategorien werden per Semikolon getrennt.
- Bestehende Produkte aktualisieren – Treffer werden über EAN, dann Artikelnummer gesucht; wird ein Produkt gefunden, wird es aktualisiert statt übersprungen.
Fahrzeuge importieren
Fahrzeuge legst du gesammelt an; mit Bestehende Fahrzeuge aktualisieren werden Treffer per ID, FIN, Seriennummer, Kennzeichen und zuletzt Marke/Modell/Kunde aktualisiert statt dupliziert. Für Auswahlwerte verwendest du die technischen Werte aus dem Beispiel (z. B. bike, ebike, car, km). Mehr unter Fahrzeuge.
Vertiefend zu Produkten: Produkt anlegen, Produkt-Varianten, Kategorien und Lager & Bestand.
Produktkategorien importieren
Lege Kategoriebäume in einem Schritt an. Pro Zeile gibst du entweder
full_pathmit dem vollständigen Pfad (Trenner>), z. B.Eltern > Kategorie > Unterkategorie, oderparent_path+name– der übergeordnete Pfad plus der neue Kategoriename.
Optional ist eine description. SimpliServ sortiert die Zeilen nach Tiefe, legt fehlende Ebenen in der richtigen Reihenfolge an und überspringt bereits vorhandene Pfade. Fehlt eine übergeordnete Kategorie, die nicht selbst Teil der Datei ist, wird die Zeile mit einem Hinweis als fehlgeschlagen markiert.
Exporte herunterladen
Die Seite Exporte erfordert die Berechtigung Administration → Exporte → Lesen und bündelt mehrere Exporte:
Buchhalter-Export
Die Karte Buchhalter-Export liefert alle Unterlagen für die Buchhaltung eines Zeitraums. Wähle Von und Bis, optional eine Kasse (für das Kassenbuch Pflicht) und für Sammel-PDFs Dokumente pro Seite. Dann klickst du auf den gewünschten Export:
| Export | Inhalt |
|---|---|
| Buchhaltungsjournal | Beleg- und Zahlungsjournal (CSV) als ZIP – der Standardexport pro Monat oder Quartal, inklusive Erklärungs-PDF |
| Nur Belegjournal (CSV) / Belegjournal ohne Kassa (CSV) | nur das Belegjournal als einzelne Datei |
| Rechnungen (PDF) | ZIP mit allen Ausgangsrechnungen, eine Datei je Rechnung |
| Belege (PDF) | ZIP mit allen Kassenbelegen, eine Datei je Bon |
| Rechnungen & Belege (PDF) | beides als Sammel-PDF zum Durchblättern |
| Kassenbuch (PDF) / Kassenbuch (CSV) | Bargeldbewegungen einer Kasse mit Anfangs- und Endbestand |
| Umsatzbericht (PDF) | verdichtete Umsatzübersicht, gesamt oder je Kasse |
| Differenzbesteuerung (CSV) | Einzelnachweis für die Differenzbesteuerung (nur wenn aktiviert) |
| Erklärung f. Buchhaltung (PDF) | Erklärblatt zum Weiterschicken an die Buchhaltung |
Ist das Buchhaltungsmodul aktiv, verweist zusätzlich die Karte Buchhaltung auf Buchhaltungs-Export öffnen und Kassenbuch öffnen; dann gilt das Kassenbuch aus dem Hauptbuch. Siehe Buchhaltungs-Export.
Die Karte Dokumentenarchiv-Export exportiert unveränderliche Archivpakete nach Zeitraum.
- Dokumenttyp: Rechnungen, Angebote, Kostenvoranschläge, Lieferscheine oder Belege.
- Von / Bis: Start- und Enddatum (Start muss vor oder gleich Ende liegen).
- Mit ZIP herunterladen erhältst du das Archivpaket als ZIP.
Details zu Aufbau und Aufbewahrung stehen unter GoBD-Archivierung.
Aufbewahrung und Vollexport
Im Bereich Aufbewahrung und Vollexport zeigt SimpliServ die gesetzlichen Aufbewahrungsfristen für dein Land (Aufbewahrung bis, Letzter Vollexport). Mit Vollexport starten (Berechtigung Administration → Exporte → Vollexport) entsteht ein ZIP mit allen Belegen, Buchungen, Stammdaten und der Verfahrensdokumentation; den Download-Link bekommst du zusätzlich per E-Mail. Die Tabelle listet alle Vollexporte mit Status, Größe und Dateien. Solange Aufbewahrungspflichten laufen, kann das Konto ohne aktuellen Vollexport nicht gelöscht werden.
Archiv- und DEP7-Exporte sind revisionssichere Belegausgaben für Buchhaltung und Behörden – kein Backup deiner Stammdaten. Für eine vollständige Sicherung nutze den Vollexport.
Berechtigungen
- Importe sind über Administration → Einstellungen → Ansehen erreichbar.
- Exporte erfordern Administration → Exporte → Lesen, der Vollexport zusätzlich Administration → Exporte → Vollexport.
Wer welche Admin-Bereiche sieht, steuerst du unter Benutzer & Rollen.
Verwandte Themen
- Kontakt anlegen — was du nach dem Kontakt-Import von Hand pflegst und ergänzt.
- Produkt anlegen — Einzelanlage als Ergänzung zum Produkt-Massenimport.
- Eigene Felder — definiert die
custom_fields_<slug>-Spalten, die der Import befüllt. - GoBD-Archivierung — Aufbau und Aufbewahrung der Archivpakete, die du hier exportierst.
- DEP-Export (RKSV) — Hintergrund und Pflichten zum DEP7-Kassenexport.
How is this guide?