Produkte importieren
Nach dem Lesen kannst du eine korrekt strukturierte CSV-Datei für den Produkt-Import vorbereiten, alle Pflichtfelder befüllen und Bundle-Beziehungen über Parent-SKUs auflösen.
Du kannst dein gesamtes Produktsortiment per CSV-Datei in Univents einpflegen. Das spart vor allem beim Erstaufbau viel Zeit, wenn du viele Artikel, Services und Bundles auf einmal anlegen willst.
Datei vorbereiten
Die Import-Datei ist eine Tabelle im CSV-Format. Du kannst sie in Excel, Google Sheets oder einer anderen Tabellenkalkulation erstellen und dann als .csv exportieren. Verwende Komma oder Semikolon als Trennzeichen — beides wird erkannt.
Jede Zeile entspricht einem Produkt. Bundles und ihre Komponenten kommen in derselben Datei; die Zuordnung läuft über eine gemeinsame SKU (Spalte SKU).
Pflichtfelder
Diese Felder müssen in jeder Zeile ausgefüllt sein:
| Spaltenname | Bedeutung und erlaubte Werte |
|---|---|
Name Translation | Produktname für Kunden (z.B. Bruschetta Classica) |
Internal Name | Interner Name für die Sortierung — nicht für Kunden sichtbar |
OS Type | Produkttyp: physical_product, service, digital_product, ticket |
OS Billing Model | Abrechnungsmodell: per_piece, per_guest, per_hour, per_kilometer, per_guest_and_hour |
Category | Name der Kategorie (z.B. Catering, Technik) — muss in Univents bereits angelegt sein |
Price Net | Nettopreis als Zahl (z.B. 12.50) |
Tax Rate | Steuersatz als Zahl ohne Prozentzeichen (z.B. 7, 19) |
Color | Hex-Farbcode für die Kalenderansicht (z.B. #FF5733) |
isRental? | ja für Verleih-/Mietartikel, nein sonst |
Unlimited? | ja wenn der Bestand nicht gezählt wird, nein bei endlichem Lagerbestand |
Packaging Quantity | Packungsgröße (z.B. 1 für Stückware, 2 bei 2-kg-Gebinde) |
Optionale Felder
Diese Felder kannst du ergänzen, um Produkte vollständiger zu importieren:
| Spaltenname | Bedeutung |
|---|---|
SKU | Artikelnummer — Pflicht wenn du Bundles importierst |
Description Translation | Beschreibungstext für Kunden |
Unit 1 Alternative | Alternative Bezeichnung für die Einheit (z.B. Portion, Liter) |
Cost Net | Interne Kosten für Deckungsbeitragsberechnung |
Total Stock | Aktueller Lagerbestand — nur relevant wenn Unlimited? = nein |
Storage Location | Lagerort |
Tags | Komma-getrennte Schlagwörter (z.B. besteck,edelstahl) |
hideWhenOffSale | ja / nein — außerhalb der Saison ausblenden |
hideWhenOutOfStock | ja / nein — bei Lagerbestand 0 ausblenden |
Internal Comment | Nur intern sichtbar |
Allergens (List) | Komma-getrennte Allergene (z.B. Nüsse,Laktose) |
Weight, Height, Width, Length | Maße und Gewicht für Packlisten |
Wattage, Amperage, Power Connection | Technische Daten für Geräte (z.B. für Funktionsblätter) |
Supplier | Primäre E-Mail-Adresse des Zulieferers |
Bundles über Parent-SKUs auflösen
Ein Bundle besteht aus mehreren Komponenten. Um Bundles im Import zu definieren, nutzt du zwei Mechanismen:
- Das Bundle selbst erhält einen eigenen Eintrag mit einer SKU (z.B.
BUNDLE-DINNER-01). - Jede Komponente erhält denselben Wert in der Spalte
Parent SKU.
Univents liest die Parent SKU-Spalte beim Import und verknüpft alle Zeilen mit derselben Parent-SKU automatisch als Komponenten des übergeordneten Bundles. Die Spalte Packaging Quantity gibt an, wie viele Einheiten der Komponente pro Bundle-Einheit enthalten sind.
Beispiel:
| Name Translation | SKU | Parent SKU | Packaging Quantity |
|---|---|---|---|
| Dinner-Paket | BUNDLE-DINNER-01 | (leer) | 1 |
| Suppe | COMP-SOUP | BUNDLE-DINNER-01 | 1 |
| Hauptgang | COMP-MAIN | BUNDLE-DINNER-01 | 1 |
Produktionsrelevante Felder (Küchenmonitor)
Wenn ein Produkt im Tab Küche (Küchenmonitor) erscheinen soll, füge diese Felder hinzu:
| Spaltenname | Bedeutung |
|---|---|
Production | ja / nein — zeigt das Produkt im Küchenmonitor |
Production Category | Hauptkategorie für die Produktionsansicht |
Subcategory | Unterkategorie für weitere Sortierung |
Production Lead Time | Vorlaufzeit in Stunden (Vorbereitungszeit vor Lieferung) |
Shelf Life | Mindesthaltbarkeit in Stunden |
Production Type | in_house (intern) oder external (extern) — exakt so schreiben |
Recipe | Rezeptbeschreibung (optional) |
Import starten
Navigiere im Menü zu Inventar. Oben rechts findest du den Button Import. Klicke darauf und reiche deine fertige CSV-Datei ein. Das Univents-Team überprüft die Datei und meldet sich für die finale Übernahme in dein Konto.
Häufige Fragen
Muss die Kategorie vorher in Univents angelegt werden? Ja. Kategorien werden beim Import nicht automatisch erstellt. Lege alle Kategorien vorher im Tab Kategorien im Inventar an.
Was passiert, wenn ein Pflichtfeld fehlt? Zeilen mit fehlenden Pflichtfeldern werden beim Import übersprungen. Du erhältst eine Rückmeldung, welche Zeilen nicht importiert werden konnten.
Kann ich bestehende Produkte aktualisieren? Beim Erstimport werden neue Produkte angelegt. Wenn du ein vorhandenes Produkt anhand seiner SKU aktualisieren möchtest, wende dich ans Univents-Team — ein Aktualisierungslauf über bestehende Datensätze ist auf Anfrage möglich.
Welches Dateiformat wird erwartet? Eine .csv-Datei in UTF-8-Kodierung. Komma und Semikolon als Trennzeichen werden beide erkannt. Exportiere aus Excel am besten als CSV UTF-8 (durch Trennzeichen getrennt).