Dokumentation
Dokumentation
Zurück zum PortalDokumentation — Cleverbikes Portal
Handbuch für LieferantenErste SchritteBikes anlegenBikes bearbeitenCSV-ImportÄnderungsanträgeFehlerreportsBike-Status verstehenEigene Daten verwaltenZwei-Faktor aktivierenSitzungen verwaltenLieferanten-API nutzenFAQ für Lieferanten
Lieferant

CSV-Import

Mehrere Bikes gleichzeitig einspielen — Template, Spalten, Datumsformat, Fehler-Handling.

Für größere Batches kannst du Bikes per CSV importieren. Das Portal unterstützt CSV und XLSX.

Template herunterladen

  1. Gehe zu Bikes → CSV-Import.
  2. Klicke auf Template herunterladen.
  3. Speichere die Datei lokal.

Das Template enthält alle für deinen Lieferanten konfigurierten Spalten in der richtigen Reihenfolge.

Spalten-Mapping

Die CB-Admins haben pro Lieferant ein Column-Mapping angelegt: jede Spalten-Überschrift im CSV ist auf ein Portal-Feld gemappt.

Pflicht-Spalten:

  • name (Modellname)
  • frame_number (Rahmennummer, weltweit eindeutig)

Alle anderen Spalten sind optional, können aber Pflicht sein, je nach deiner Konfiguration.

Datumsformat

Pflicht: DD.MM.YYYY (deutsches Format). Beispiel: 15.03.2024.

Andere Formate werden abgelehnt (siehe Fehler unten).

Import starten

  1. Klicke auf Datei auswählen und wähle deine CSV/XLSX.
  2. Das Portal zeigt eine Vorschau der ersten 10 Zeilen.
  3. Prüfe die Spalten-Zuordnung.
  4. Klicke Import starten.

Der Import läuft im Hintergrund. Du kannst andere Aufgaben weitermachen.

Ergebnis prüfen

Nach dem Import siehst du eine Zusammenfassung:

  • OK-Zeilen: erfolgreich angelegt.
  • Fehler-Zeilen: mit Fehler-Code und Zeile.

Typische Fehler:

CodeBedeutung
frame_number_duplicateRahmennummer existiert schon im System.
invalid_date_formatDatum ist nicht DD.MM.YYYY.
missing_required_fieldPflichtspalte leer.
invalid_ageAlter außerhalb 0–47 Monate.
unknown_categoryKategorie nicht im Dropdown vorhanden.

Re-Import nach Korrektur

Nicht die ganze Datei neu hochladen. Stattdessen:

  1. Exportiere die Fehler-Zeilen (Button in der Ergebnis-Ansicht).
  2. Korrigiere sie in Excel.
  3. Lade nur die korrigierte Datei erneut hoch.

OK-Zeilen aus dem ersten Durchlauf bleiben unberührt.

Weiterlesen

  • Bikes anlegen — einzeln statt Batch
  • Fehler verstehen — Fehler-Listen

Bikes bearbeiten

Liste filtern, sortieren, einzeln oder als Batch bearbeiten — was direkt geht und was einen Antrag braucht.

Änderungsanträge

Geschützte Felder ändern — wie du einen Antrag stellst und was danach passiert.

On this page

Template herunterladenSpalten-MappingDatumsformatImport startenErgebnis prüfenRe-Import nach KorrekturWeiterlesen