Upload-Format für Artikel

Der Artikellisten-Editor kann die von der Kasse akzeptierten Artikel aus einer hochgeladenen JSON-Datei aktualisieren. Der Upload muss ein Konfigurationsobjekt mit einem items-Array enthalten. Hochgeladene Artikel werden anhand der number zugeordnet; vorhandene Artikel mit derselben Nummer werden aktualisiert und Artikel mit neuen Nummern werden hinzugefügt.

::: note Verwendung: Admin → Artikellisten-Editor → Mittels Datei aktualisieren. :::

WARNING

Importmodus bewusst wählen: Aktualisieren ändert passende Artikelnummern und ergänzt neue; andere bestehende Artikel bleiben erhalten. Ersetzen entfernt zusätzlich im Import fehlende Artikel und deren Platzierungen auf Menüseiten. Beide Modi aktualisieren Zahlungsarten aus der Eingabe. Dies ist kein vollständiger Konfigurationsimport.

Aktualisieren oder ersetzen

1. Sichern Sie vor größeren Importen eine Konfigurationsversion.
2. Öffnen Sie Konfigurationen → Artikel bearbeiten → Über Datei aktualisieren.
3. Wählen Sie JSON-Datei und Modus Aktualisieren oder Ersetzen.
4. Lesen und bestätigen Sie beim Ersetzen die Warnung.
5. Prüfen Sie die Zusammenfassung: geliefert, neu, geändert und beim Ersetzen entfernt. Klappen Sie Details für die Artikelnummern auf.
6. Kontrollieren Sie danach die Menüseiten und Platzierungen entfernter Artikel.

Auch eine kleine Teilliste kann im Ersetzen-Modus andere Artikel entfernen. Nutzen Sie für Teiländerungen Aktualisieren. Stellen Sie bei einem unbeabsichtigten Import eine bekannte Konfigurationsversion wieder her.

Minimale Datei

Das folgende Beispiel zeigt die Dateistruktur. Ersetzen Sie die Beispielartikel und geben Sie die Zahlungsarten Ihrer Installation an. Ein leeres paymentTypes-Objekt ersetzt bestehende Zahlungsarten durch eine leere Zuordnung, auch beim Aktualisieren. Sichern Sie vor dem Import eine Konfigurationsversion.

{
  "items": [
    {
      "number": 101,
      "name": "Tomato Soup",
      "description": "Tomato soup with basil",
      "price": 6.5,
      "itemState": "ACTIVE",
      "itemType": "Food",
      "priceTogo": 6.5,
      "category": {
        "name": "Starters"
      },
      "numberOfItems": 1,
      "image": "",
      "characteristics": [
        "VEGETARIAN"
      ],
      "combinationItems": [],
      "maximumCombinationItems": 0,
      "validCustomerTypeNumbers": [],
      "customerTypeRestriction": []
    }
  ],
  "paymentTypes": {}
}

Artikelfelder

Feld	Erforderlich	Beschreibung
number	Ja	Numerische Artikelkennung von der Kasse. Wird verwendet, um zu entscheiden, ob ein Artikel aktualisiert oder hinzugefügt wird.
name	Nein	Name, der für den Artikel angezeigt wird.
description	Nein	Beschreibung, die im Menü angezeigt wird.
price	Nein	Dezimalpreis, mit Punkt als Dezimaltrennzeichen.
itemState	Nein	Verwenden Sie ACTIVE für Artikel, die verfügbar sein sollen.
itemType	Nein	Einer von Menu item, Food, Takeout, Condiments, Beverages, Unknown oder Arrangement oder Sub item.
category	Nein	Kategorieobjekt. Mindestens {"name": "Category name"} angeben.
characteristics	Nein	Array von Bezeichnungen wie VEGETARIAN, VEGAN oder Allergencodes wie ALLERGEN_GLUTEN.
combinationItems	Nein	Array von auswählbaren Kombinationsartikeln. Bei Artikeln ohne Kombinationen ein leeres Array verwenden.
validCustomerTypeNumbers	Nein	Array von Kundentypnummern, die diesen Artikel bestellen können. Bei keiner Einschränkung ein leeres Array verwenden.
printerGroup	Nein	Name der logischen Druckergruppe, z.B. KITCHEN, BAR oder TICKET.

Akzeptierte Eingabe

Der Upload akzeptiert einen JSON-Konfigurationsexport in derselben Struktur wie oben gezeigt. Das Backend versucht außerdem, unterstützte Kassenexportformate zu konvertieren, bevor die Artikel zusammengeführt werden.