Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://help.mathership.com/llms.txt

Use this file to discover all available pages before exploring further.

Lightspeed K-Series

Nutzen Sie die Lightspeed K-Series Integration, um Ihr Lightspeed POS mit Bestellfix zu verbinden. Die Integration kann:
  • Lightspeed über OAuth verbinden
  • Lightspeed-Standorte synchronisieren
  • Lightspeed-Artikel synchronisieren
  • Standorte mit Lagereinheiten verknüpfen
  • Lightspeed-Artikel mit Zutaten oder Rezepten verknüpfen
  • Eine historische 90-Tage-Migration durchführen
  • Automatische tägliche Übertragungen durchführen
  • Manuelle Übertragungen für einzelne Tage durchführen
  • Warenbestandsbuchungen aus POS-Verkäufen erstellen

Übersicht

Die Einrichtung der Lightspeed-Integration folgt diesem Ablauf:
  1. Lightspeed verbinden
  2. Standorte synchronisieren
  3. Jeden Standort mit einer Lagereinheit verknüpfen
  4. Artikel synchronisieren
  5. Lightspeed-Artikel mit Zutaten oder Rezepten verknüpfen
  6. Standort aktivieren
  7. 90-Tage-Migration prüfen
  8. Automatische oder manuelle Übertragungen nutzen

Screenshot

Screenshot hier einfügen.

Lightspeed verbinden

So verbinden Sie Lightspeed:
  1. Öffnen Sie VerwaltenIntegrationen
  2. Wählen Sie Lightspeed K-Series
  3. Starten Sie den Lightspeed-Verbindungsprozess
  4. Autorisieren Sie Bestellfix in Lightspeed
  5. Kehren Sie zu Bestellfix zurück
  6. Speichern Sie die Integration
Bestellfix erhält vom Frontend einen OAuth-Autorisierungscode und tauscht diesen gegen Lightspeed-Tokens aus. Die Tokens werden sicher gespeichert und für zukünftige Synchronisierungen und Übertragungen verwendet.

Erforderliche Verbindungsdaten

Beim Erstellen der Integration benötigt Bestellfix:
FeldBedeutung
company_idDas Unternehmen, dem die Integration gehört
nameInterner Name der Integration
codeOAuth-Autorisierungscode von Lightspeed

Mögliche Verbindungsfehler

FehlerBedeutung
lightspeed_integration_existsEs existiert bereits eine Lightspeed-Integration
lightspeed_oauth_exchange_failedDer Autorisierungscode konnte nicht ausgetauscht werden
lightspeed_not_configuredLightspeed OAuth ist nicht korrekt konfiguriert
unauthorized_company_accessDas Unternehmen gehört nicht zum aktuellen Benutzer

Lightspeed erneut autorisieren

Nutzen Sie die erneute Autorisierung, wenn die Lightspeed-Verbindung eine neue Autorisierung benötigt. Die bestehende Einrichtung bleibt dabei erhalten. Die erneute Autorisierung behält bei:
  • Standorte
  • Verknüpfungen mit Lagereinheiten
  • Artikel-Zuordnungen
  • Übertragungsverlauf
  • Migrationsverlauf
So autorisieren Sie erneut:
  1. Öffnen Sie die bestehende Lightspeed-Integration
  2. Starten Sie den Lightspeed-Autorisierungsprozess erneut
  3. Übermitteln Sie den neuen Autorisierungscode
  4. Bestellfix ersetzt die gespeicherten Tokens

Screenshot

Screenshot hier einfügen.

Standorte synchronisieren

Nach dem Verbinden von Lightspeed synchronisieren Sie die Standorte. Standorte stehen für Lightspeed-Betriebsstandorte oder Verkaufsstandorte. So synchronisieren Sie Standorte:
  1. Öffnen Sie die Lightspeed-Integration
  2. Klicken Sie auf Standorte synchronisieren
  3. Warten Sie, bis die Standorte geladen wurden
  4. Prüfen Sie die Standortliste
Die Standort-Synchronisierung ruft Standorte aus Lightspeed ab und speichert sie in Bestellfix.

Standortliste

Die Standortliste zeigt zwischengespeicherte Lightspeed-Standorte. Jeder Standort kann mit einer Bestellfix-Lagereinheit verknüpft werden. Typische Felder sind:
FeldBedeutung
StandortnameName aus Lightspeed
LagereinheitVerknüpfte Bestellfix-Lagereinheit
AktiviertOb Übertragungen aktiv sind
Automatische Übertragung pausiertOb die automatische Übertragung pausiert ist

Screenshot

Screenshot hier einfügen.

Lagereinheit verknüpfen

Jeder Lightspeed-Standort muss mit einer Bestellfix-Lagereinheit verknüpft werden, bevor er aktiviert werden kann. Die Lagereinheit legt fest, wo der Warenbestand abgezogen wird. So verknüpfen Sie eine Lagereinheit:
  1. Öffnen Sie den Lightspeed-Standort
  2. Wählen Sie eine Lagereinheit aus
  3. Speichern Sie die Verknüpfung
Ein Standort kann ohne Lagereinheit nicht aktiviert werden.

Lagereinheit entfernen

Sie können die Verknüpfung mit der Lagereinheit wieder entfernen. Tun Sie dies nur, wenn der Standort keinen Warenbestand mehr aus dieser Lagereinheit abziehen soll.

Häufige Fehler bei Lagereinheiten

FehlerBedeutung
storage_unit_requiredVor der Aktivierung oder Übertragung muss eine Lagereinheit verknüpft sein
storage_unit_company_mismatchDie ausgewählte Lagereinheit gehört zu einem anderen Unternehmen

Artikel synchronisieren

Nach dem Synchronisieren der Standorte synchronisieren Sie die Lightspeed-Artikel. Artikel sind die Produkte oder Verkaufsartikel aus Lightspeed. So synchronisieren Sie Artikel:
  1. Öffnen Sie die Lightspeed-Integration
  2. Klicken Sie auf Artikel synchronisieren
  3. Warten Sie, bis die Artikel geladen wurden
  4. Prüfen Sie die Artikelliste
Bestellfix speichert die synchronisierten Artikel und zeigt an, ob jeder Artikel zugeordnet ist.

Artikelliste

Die Artikelliste ist nach Namen sortiert und kann Zuordnungsinformationen anzeigen. Typische Artikelzustände:
ZustandBedeutung
Nicht zugeordnetDer Artikel hat noch keine Warenbestandszuordnung
Einer Zutat zugeordnetDer Artikel zieht direkt eine Zutat ab
Einem Rezept zugeordnetDer Artikel zieht Rezeptzutaten ab
AbzugszuordnungDer Artikel kann je nach Einrichtung eine Rücknahme oder einen Abzug auslösen

Screenshot

Screenshot hier einfügen.

Lightspeed-Artikel zuordnen

Jeder Lightspeed-Artikel muss zugeordnet werden, bevor er Warenbestandsbewegungen erzeugen kann. Sie können einen Artikel zuordnen zu:
  • Einer Zutat
  • Einem Rezept

Einer Zutat zuordnen

Nutzen Sie die Zutaten-Zuordnung, wenn der Lightspeed-Artikel direkt eine einzelne Zutat abziehen soll. Beispiel:
Lightspeed-ArtikelZugeordnet zuMenge
Cola 0,33 lCola-Flasche1
EspressoKaffeebohnen0.009

Einem Rezept zuordnen

Nutzen Sie die Rezept-Zuordnung, wenn der Lightspeed-Artikel aus mehreren Zutaten besteht. Beispiel:
Lightspeed-ArtikelZugeordnet zu
Classic BurgerRezept Classic Burger
Pizza MargheritaRezept Pizza Margherita
Wenn der Artikel verkauft wird, löst Bestellfix das Rezept in einzelne Zutaten auf und zieht die Rezeptzutaten ab.

Zuordnungsfelder

FeldBedeutung
mapped_object_typeingredient oder recipe
mapped_object_idID der Zutat oder des Rezepts
quantityMultiplikator für das zugeordnete Objekt
is_subtractionOb die Zuordnung als Abzug oder Rücknahme behandelt wird

Zuordnung aktualisieren

So ändern Sie eine Zuordnung:
  1. Öffnen Sie den Lightspeed-Artikel
  2. Wählen Sie eine neue Zutat oder ein neues Rezept
  3. Passen Sie bei Bedarf die Menge an
  4. Speichern Sie die Zuordnung
Bestellfix ersetzt die bestehende Zuordnung für diesen Artikel.

Zuordnung löschen

So löschen Sie eine Zuordnung:
  1. Öffnen Sie den Lightspeed-Artikel
  2. Entfernen Sie die Zuordnung
  3. Speichern Sie
Nach dem Löschen erzeugt der Artikel keine Warenbestandsabzüge mehr.

Zuordnungsfehler

FehlerBedeutung
recipe_not_foundDas ausgewählte Rezept existiert für dieses Unternehmen nicht
ingredient_not_foundDie ausgewählte Zutat existiert für dieses Unternehmen nicht
unauthorized_company_accessDer Artikel oder die Integration gehört nicht zum aktuellen Benutzer

Standort aktivieren

Ein Lightspeed-Standort muss aktiviert werden, bevor Migration und Übertragungen laufen können. Prüfen Sie vor der Aktivierung:
  • Der Standort hat eine Lagereinheit
  • Wichtige Lightspeed-Artikel sind zugeordnet
  • Rezepte und Zutaten sind korrekt eingerichtet
So aktivieren Sie einen Standort:
  1. Öffnen Sie den Lightspeed-Standort
  2. Prüfen Sie die verknüpfte Lagereinheit
  3. Klicken Sie auf Aktivieren
  4. Bestellfix startet eine 90-Tage-Migration
Die Aktivierung setzt den Standort auf aktiv und startet die historische Migration, sofern noch keine Migration läuft.

Screenshot

Screenshot hier einfügen.

90-Tage-Migration

Wenn ein Standort aktiviert wird, erstellt Bestellfix eine historische 90-Tage-Migration. Die Migration verarbeitet vergangene Lightspeed-Verkäufe und erstellt Warenbestandsbewegungen, wenn passende Zuordnungen vorhanden sind. Die Migration ist hilfreich, weil sie den Warenverbrauch aus aktuellen POS-Verkäufen nachträglich auffüllen kann.

Migrationsstatus

Sie können den Migrationsstatus am Standort abrufen. Typische Migrationszustände sind:
ZustandBedeutung
AusstehendDie Migration wurde erstellt, aber noch nicht gestartet
LäuftDie Migration wird gerade verarbeitet
AbgeschlossenDie Migration wurde abgeschlossen
AbgebrochenDie Migration wurde abgebrochen
FehlgeschlagenDie Migration wurde wegen eines Fehlers gestoppt

Migration erneut ausführen

Nutzen Sie Migration erneut ausführen, wenn Sie nach der Aktivierung Zuordnungen hinzugefügt oder korrigiert haben. Eine erneute Ausführung verarbeitet den historischen Zeitraum noch einmal. Bestellfix verhindert, dass eine weitere Migration gestartet wird, solange bereits eine Migration ausstehend ist oder läuft.

Migration abbrechen

Nutzen Sie Migration abbrechen, wenn eine Migration gestoppt werden soll. Der Abbruch gilt für ausstehende oder laufende Migrationsaufträge des Standorts.

Migrationsfehler

FehlerBedeutung
location_not_activatedDer Standort muss zuerst aktiviert werden
storage_unit_requiredDer Standort hat keine verknüpfte Lagereinheit
migration_already_in_progressEine Migration ist bereits ausstehend oder läuft

Automatische Übertragung

Lightspeed-Standorte können automatische Übertragungen nutzen. Die automatische Übertragung ist für die regelmäßige tägliche Verarbeitung gedacht. Sie können die automatische Übertragung für jeden Standort pausieren oder fortsetzen.

Automatische Übertragung pausieren

So pausieren Sie die automatische Übertragung:
  1. Öffnen Sie den Lightspeed-Standort
  2. Klicken Sie auf Automatische Übertragung umschalten
  3. Prüfen Sie, dass die automatische Übertragung pausiert ist
Wenn sie pausiert ist, bleibt der Standort verbunden, aber die nächtliche Übertragung sollte nicht laufen.

Automatische Übertragung fortsetzen

Klicken Sie erneut auf Automatische Übertragung umschalten, um die automatische Übertragung fortzusetzen. Der Wert wechselt zwischen pausiert und aktiv.

Screenshot

Screenshot hier einfügen.

Manuelle Übertragung

Nutzen Sie die manuelle Übertragung, wenn Sie einen bestimmten Tag verarbeiten möchten. Die manuelle Übertragung ist hilfreich für:
  • Das Testen der Integration
  • Die erneute Verarbeitung eines Tages
  • Korrekturen des Warenbestands nach Zuordnungsänderungen
  • Die Prüfung eines bestimmten Lightspeed-Verkaufstags

Manuelle Übertragung ausführen

So führen Sie eine manuelle Übertragung aus:
  1. Öffnen Sie den Lightspeed-Standort
  2. Öffnen Sie Manuelle Übertragung
  3. Geben Sie das Datum ein
  4. Starten Sie die Übertragung
  5. Prüfen Sie das Ergebnis
Das Datum sollte dieses Format verwenden:
DD-MM-YYYY
Beispiel:
20-10-2025
Das Backend akzeptiert auch dieses Format:
YYYY-MM-DD
Beispiel:
2025-10-20

Aktualisierungsverhalten bei manueller Übertragung

Die manuelle Übertragung kann force_refresh verwenden. Standardmäßig wird force_refresh als aktiviert behandelt. Das bedeutet: Bestellfix ruft frische Lightspeed-Daten ab und erstellt die relevanten Warenbestandsbuchungen für diesen Standort und dieses Datum neu.

Was während der Übertragung passiert

Wenn eine Lightspeed-Übertragung läuft, führt Bestellfix folgende Schritte aus:
  1. Lightspeed-Verkaufsdaten für Standort und Datum abrufen
  2. Verkaufte Artikel auslesen
  3. Verkaufte Artikel mit POS-Zuordnungen abgleichen
  4. Rezept-Zuordnungen in Zutaten auflösen
  5. Zutatenmengen berechnen
  6. Warenbestandsbuchungen erstellen
  7. Übertragungszusammenfassung zurückgeben

Übertragungsergebnis

Eine manuelle Übertragung gibt eine Zusammenfassung zurück. Die Antwort kann enthalten:
FeldBedeutung
dateVerarbeitetes Berichtsdatum
successOb die Übertragung erfolgreich war
no_dataOb Lightspeed keine Verkaufsdaten zurückgegeben hat
log_idReferenz zum Übertragungsprotokoll
ledger_idsIDs der erstellten Warenbestandsbuchungen
statsVerarbeitungsstatistiken
errorFehlermeldung, falls die Verarbeitung fehlgeschlagen ist

Ergebnis ohne Daten

Wenn Lightspeed für das ausgewählte Datum keine Daten hat, kann die Übertragung no_data zurückgeben. Das bedeutet meistens:
  • Für diesen Standort und dieses Datum wurden keine Verkäufe gefunden
  • Das falsche Datum wurde eingegeben
  • Der falsche Standort wurde ausgewählt
  • Lightspeed hat keine Berichtsdaten zurückgegeben

Übertragungsfehler

FehlerBedeutung
date_requiredEs wurde kein Datum angegeben
invalid_date_formatDas Datumsformat ist ungültig
storage_unit_requiredDer Standort hat keine verknüpfte Lagereinheit
lightspeed_auth_failedDie Lightspeed-Authentifizierung ist fehlgeschlagen
lightspeed_api_errorDie Lightspeed API hat einen Fehler zurückgegeben

Warenbestandsbuchungen

Lightspeed-Übertragungen erstellen Warenbestandsbuchungen. Diese Buchungen reduzieren den Warenbestand auf Basis verkaufter POS-Artikel. Die Buchungen sind verbunden mit:
  • Unternehmen
  • Zutat
  • Lagereinheit
  • Transaktionstyp
  • Menge
  • Einstandskosten
  • Wert
  • Datum
  • Übertragungsprotokoll oder Quelldaten
Siehe Warenbestandsbuchungen für die detaillierte Warenbestandshistorie.

Verarbeitungslogik

Die Übertragung nutzt dieselbe Warenbestandslogik wie andere POS-Integrationen. Verkaufte Lightspeed-Artikel werden über POS-Zuordnungen verarbeitet. Wenn die Zuordnung auf eine Zutat zeigt, zieht Bestellfix diese Zutat direkt ab. Wenn die Zuordnung auf ein Rezept zeigt, löst Bestellfix das Rezept auf und zieht alle Rezeptzutaten ab.

Beispiel

Lightspeed-VerkaufZuordnungErgebnis im Warenbestand
1 × EspressoKaffeebohnenKaffeebohnen abziehen
2 × Cola 0,33 lCola-Flasche2 Flaschen abziehen
1 × BurgerBurger-RezeptAlle Burger-Zutaten abziehen

Empfohlene Einrichtungsreihenfolge

Nutzen Sie diese Reihenfolge für eine saubere Lightspeed-Einrichtung:
  1. Lagereinheiten erstellen
  2. Zutaten erstellen
  3. Rezepte erstellen
  4. Lightspeed verbinden
  5. Standorte synchronisieren
  6. Standorte mit Lagereinheiten verknüpfen
  7. Artikel synchronisieren
  8. Wichtige Artikel zuerst zuordnen
  9. Standort aktivieren
  10. Migrationsstatus prüfen
  11. Manuelle Übertragung für ein Testdatum ausführen
  12. Warenbestandsbuchungen prüfen
  13. Automatische Übertragung aktivieren

Test-Checkliste

Bevor Sie sich auf automatische Übertragungen verlassen, testen Sie einen Tag manuell. Prüfen Sie:
  • Der richtige Lightspeed-Standort wurde verwendet
  • Der Standort hat die richtige Lagereinheit
  • Das richtige Datum wurde verarbeitet
  • Verkaufte Artikel wurden gefunden
  • Wichtige Artikel sind zugeordnet
  • Rezeptzutaten wurden korrekt abgezogen
  • Mengen sind korrekt
  • Buchungen erscheinen in der richtigen Lagereinheit

Screenshot

Screenshot hier einfügen.

Häufige Probleme

Lightspeed-Verbindung existiert bereits

Bestellfix gibt zurück:
lightspeed_integration_exists
Nutzen Sie die bestehende Integration oder autorisieren Sie diese erneut, statt eine zweite Integration zu erstellen.

Autorisierung fehlgeschlagen

Bestellfix gibt zurück:
lightspeed_oauth_exchange_failed
Starten Sie den Lightspeed-Autorisierungsprozess erneut und übermitteln Sie einen neuen Autorisierungscode.

Standorte fehlen

Versuchen Sie:
  1. Standorte erneut synchronisieren
  2. Lightspeed-Autorisierung prüfen
  3. Integration bei Bedarf erneut autorisieren

Artikel fehlen

Versuchen Sie:
  1. Artikel erneut synchronisieren
  2. Prüfen, ob die Standorte zuerst synchronisiert wurden
  3. Berechtigungen des Lightspeed-Kontos prüfen

Standort kann nicht aktiviert werden

Meistens bedeutet das, dass keine Lagereinheit verknüpft ist. Lösung:
  1. Standort öffnen
  2. Lagereinheit verknüpfen
  3. Speichern
  4. Erneut aktivieren

Übertragung erstellt keine Warenbestandsbuchungen

Prüfen Sie:
  1. Das ausgewählte Datum
  2. Ob Lightspeed für dieses Datum Verkäufe hat
  3. Ob Artikel zugeordnet sind
  4. Ob Rezepte Zutaten enthalten
  5. Ob Lagereinheiten konfiguriert sind

Einige Artikel werden übersprungen

Artikel können übersprungen werden, wenn sie nicht zugeordnet sind oder nicht in Zutaten aufgelöst werden können. Korrigieren Sie die Artikel-Zuordnungen und führen Sie die manuelle Übertragung oder Migration erneut aus.

Verwandte Seiten

Integrationen Übersicht

Zurück zur Übersicht der Integrationen.

POS-Zuordnung

POS-Artikel Zutaten oder Rezepten zuordnen.

Lagereinheiten

Lagereinheiten verwalten, die für Lightspeed-Abzüge verwendet werden.

Warenbestandsbuchungen

Warenbestandsbewegungen prüfen, die durch Lightspeed-Übertragungen erstellt wurden.