Zum Hauptinhalt springen

Integrationen

Verbinde Mathership mit externen Systemen, um manuelle Arbeit zu reduzieren und Bestandsdaten aktuell zu halten. Integrationen werden hauptsächlich genutzt, um:
  • Kassensysteme anzubinden
  • Standorte, Filialen, Produkte oder Artikel zu synchronisieren
  • POS-Verkäufe Zutaten oder Rezepten zuzuordnen
  • Verkäufe in Bestandsbewegungen zu übertragen
  • POS-Verkaufsdaten per CSV zu importieren, wenn keine direkte Integration verfügbar ist

Kassensysteme verbinden

Verbinde unterstützte Kassensysteme wie Lightspeed K-Series und Sides POS.

Verkäufe dem Bestand zuordnen

Verknüpfe POS-Artikel oder Produkte mit Mathership-Zutaten und Rezepten.

Bestandsbewegungen erstellen

Wandle zugeordnete POS-Verkäufe in Bestandsabbuchungen im Ledger um.

Verfügbare Integrationen

Lightspeed K-Series

Verbinde Lightspeed, synchronisiere Standorte und Artikel und übertrage POS-Verkäufe in den Bestand.

Sides POS

Verbinde Sides, synchronisiere Filialen und Produkte und verarbeite tägliche Verkaufsberichte.

CSV-Upload

Lade POS-Verkaufsdaten manuell aus einer konfigurierten CSV-Datei hoch.

POS-Zuordnung

Ordne POS-Artikel Zutaten oder Rezepten zu, damit Verkäufe den Bestand aktualisieren können.

Lagereinheiten

Verwalte die Lagereinheiten, die für POS-Verkaufsübertragungen und Bestandsbewegungen verwendet werden.

Ledger

Prüfe Bestandsbewegungen, die durch Bestellungen, Transfers, Schwund, Zählungen und POS-Integrationen erstellt wurden.

Integrationen aufrufen

So verwaltest du Integrationen:
1

Manage öffnen

Gehe im Mathership-Dashboard zu Manage.
2

Integrationen öffnen

Wähle Integrations aus.
3

Eine Integration auswählen

Wähle die Integration aus, die du konfigurieren möchtest, zum Beispiel Lightspeed K-Series, Sides POS oder CSV Upload.
4

System verbinden oder aktualisieren

Verbinde das externe System, aktualisiere Zugangsdaten oder konfiguriere die CSV-Importeinstellungen.
5

Externe Daten synchronisieren

Synchronisiere je nach Integration Standorte, Filialen, Produkte oder Artikel.
6

Zuordnungen einrichten

Verknüpfe POS-Artikel oder Produkte mit Mathership-Zutaten oder Rezepten.
7

Aktivieren, wenn alles bereit ist

Aktiviere die Integration, den Standort oder die Filiale erst, wenn Lagereinheiten und Zuordnungen eingerichtet sind.

So funktionieren Integrationen

Die meisten POS-Integrationen folgen derselben Grundstruktur.
1

System verbinden

Lightspeed verwendet OAuth. Sides verwendet Zugangsdaten mit Benutzername und Passwort. CSV Upload verwendet einen konfigurierten CSV-Import.
2

Externe Daten synchronisieren

Synchronisiere Standorte, Filialen, POS-Artikel, Produkte oder andere Daten, die für die Zuordnung benötigt werden.
3

Lagereinheiten verknüpfen

Jeder aktive POS-Standort bzw. jede aktive Filiale benötigt eine Mathership-Lagereinheit. Diese legt fest, wo der Bestand abgebucht werden soll.
4

POS-Artikel zuordnen

POS-Artikel und Produkte können Zutaten oder Rezepten zugeordnet werden. Rezeptzuordnungen werden in Zutatenbewegungen aufgelöst.
5

Verkäufe übertragen

Verkaufsdaten erzeugen Bestandsausgangsbewegungen. Historische Migrationen können vergangene Verkäufe verarbeiten, und manuelle Transfers können für bestimmte Daten ausgelöst werden.

Direkte POS-Integrationen

Lightspeed K-Series

Lightspeed verwendet eine OAuth-Verbindung. Nach dem Verbinden von Lightspeed kannst du:
  • Lightspeed-Standorte synchronisieren
  • Jeden Standort mit einer Mathership-Lagereinheit verknüpfen
  • Standorte aktivieren
  • Eine historische Migration starten
  • Lightspeed-Artikel synchronisieren
  • Artikel Zutaten oder Rezepten zuordnen
  • Manuelle Transfers für bestimmte Daten ausführen
  • Automatische Transfers pausieren oder fortsetzen
Siehe Lightspeed K-Series für Details zur Einrichtung.

Sides POS

Sides verwendet Zugangsdaten mit Benutzername und Passwort. Nach dem Verbinden von Sides kannst du:
  • Die Verbindung testen
  • Filialen synchronisieren
  • Jede Filiale mit einer Mathership-Lagereinheit verknüpfen
  • Filialen aktivieren
  • Eine historische Migration starten
  • Produkte synchronisieren
  • Produkte Zutaten oder Rezepten zuordnen
  • Manuelle Transfers für bestimmte Daten ausführen
  • Automatische Transfers pausieren oder fortsetzen
Siehe Sides POS für Details zur Einrichtung.

CSV-Upload

CSV Upload wird verwendet, wenn Verkaufsdaten manuell importiert werden, statt über eine Live-POS-Verbindung. Verwende CSV Upload, um:
  • POS-Verkaufsdaten aus einer Datei hochzuladen
  • Verkäufe aus Systemen ohne direkte Integration zu verarbeiten
  • Konfigurierte CSV-Regeln anzuwenden
  • Bestandsabbuchungen auf Basis zugeordneter POS-Codes zu erstellen
CSV Upload erfordert korrekte POS-Zuordnungen, bevor Verkäufe verarbeitet werden können. Siehe CSV Upload für Details zur Einrichtung.

POS-Zuordnung

Die POS-Zuordnung legt fest, wie Verkäufe den Bestand beeinflussen. Ein POS-Artikel kann zugeordnet werden zu:
  • Zutat — die Zutat wird direkt abgebucht
  • Rezept — das Rezept wird in seine Zutaten aufgeschlüsselt
  • Mengenfaktor — legt fest, wie viel Bestand pro Verkauf betroffen ist
POS-ArtikelZugeordnet zuErgebnis
CheeseburgerRezeptBucht alle Rezeptzutaten ab
EspressoZutatBucht Kaffee direkt ab
Flasche ColaZutatBucht eine Flasche aus dem Bestand ab
Siehe POS Mapping für Details.

Zuordnung von Lagereinheiten

Bevor ein POS-Standort oder eine Filiale aktiviert werden kann, muss er bzw. sie mit einer Lagereinheit verknüpft werden. Dadurch weiß Mathership, wo der Bestand abgebucht werden soll.
Externes SystemExterner StandortMathership-Lagereinheit
LightspeedHauptrestaurantHauptlager
LightspeedBarBarlager
SidesDowntown StoreKüchenlager
Ohne verknüpfte Lagereinheit können Aktivierung und Transfers fehlschlagen.
Prüfe die verknüpfte Lagereinheit immer, bevor du einen Standort oder eine Filiale aktivierst. Eine falsche Lagereinheit kann Bestandsbewegungen am falschen Ort erzeugen.

Historische Migration

Einige Integrationen können historische Verkaufsdaten verarbeiten. Das ist nützlich, wenn:
  • Du einen neuen POS-Standort oder eine neue Filiale aktivierst
  • Du die jüngere Verkaufshistorie importieren möchtest
  • Du Zuordnungen hinzugefügt hast, nachdem die Integration erstellt wurde
  • Du eine Migration nach der Korrektur von Zuordnungen erneut ausführen musst
Bei Lightspeed und Sides kann die Aktivierung eine historische Migration für die letzten 90 abgeschlossenen Tage starten.

Manueller Transfer

Mit manuellen Transfers kannst du Verkäufe für ein bestimmtes Datum verarbeiten. Nutze dies, wenn:
  • Du einen Tag manuell übertragen möchtest
  • Ein vorheriger Transfer fehlgeschlagen ist
  • Du Zuordnungen aktualisiert hast und Verkäufe erneut verarbeiten möchtest
  • Du einen bestimmten Geschäftstag prüfen musst
  • Du eine Integration testen möchtest, bevor du dich auf automatische Verarbeitung verlässt
Der Transfer erstellt Bestands-Ledger-Einträge auf Basis zugeordneter POS-Verkäufe.
Manuelle Transfers sind für Tests hilfreich, weil du die daraus entstehenden Ledger-Bewegungen prüfen kannst, bevor du automatische Transfers aktivierst.

Automatischer Transfer

Einige Integrationen unterstützen automatische Verkaufsübertragungen. Je nach Einrichtung der Integration können automatische Transfers folgende Zustände haben:
StatusBedeutung
AktivVerkäufe werden automatisch verarbeitet
PausiertDie automatische Verarbeitung ist gestoppt, Einrichtung und Historie bleiben aber erhalten
FortgesetztDie automatische Verarbeitung kann später wieder aktiviert werden
Nutze die Pausierung, wenn du automatische Bestandsabbuchungen vorübergehend stoppen möchtest, ohne die Integration zu löschen.

Typischer Einrichtungsablauf

1

POS-Integration verbinden

Verbinde Lightspeed, Sides oder konfiguriere CSV Upload.
2

Standorte oder Filialen synchronisieren

Importiere externe Standorte oder Filialen.
3

Lagereinheiten verknüpfen

Weise jeden Standort bzw. jede Filiale der richtigen Mathership-Lagereinheit zu.
4

POS-Produkte oder Artikel synchronisieren

Importiere die Produkte oder Artikel, die zugeordnet werden sollen.
5

POS-Zuordnungen erstellen

Ordne wichtige POS-Produkte oder Artikel Zutaten oder Rezepten zu.
6

Standort oder Filiale aktivieren

Aktiviere erst, wenn Lagereinheiten und wichtige Zuordnungen bereit sind.
7

Migrationsstatus prüfen

Prüfe, ob die historische Migration gestartet wurde und korrekt abgeschlossen wurde.
8

Ledger prüfen

Prüfe die erstellten Bestandsbewegungen.
9

Bei Bedarf manuelle Transfers ausführen

Nutze manuelle Transfers, um bestimmte Daten zu testen oder erneut zu verarbeiten.

Best Practices

Zuerst Lagereinheiten einrichten

Erstelle und prüfe Lagereinheiten, bevor du POS-Standorte oder Filialen aktivierst.

Vor der Zuordnung synchronisieren

Synchronisiere Produkte oder Artikel, bevor du Zuordnungen erstellst.

Mit wichtigen Artikeln beginnen

Beginne zuerst mit POS-Artikeln und Produkten mit hohem Verkaufsvolumen.

Sorgfältig zuordnen

Prüfe Zutat, Rezept und Mengenfaktor, bevor du Zuordnungen speicherst.

Nicht zugeordnete Artikel prüfen

Nutze nicht zugeordnete Artikel nach dem ersten Transfer als Arbeitsliste.

Ledger prüfen

Prüfe Ledger-Bewegungen nach der Aktivierung und nach größeren Änderungen an Zuordnungen.

Nur bei Bedarf erneut ausführen

Führe Migrationen nur erneut aus, nachdem Zuordnungen oder Einrichtungsprobleme korrigiert wurden.

Namen klar halten

Halte Produkt- und Rezeptnamen klar, damit Zuordnungen leichter gepflegt werden können.

Fehlerbehebung

Prüfe, ob:
  • Deine Zugangsdaten korrekt sind
  • Das externe System verfügbar ist
  • Die Integration für das richtige Unternehmen konfiguriert ist
  • Du die Berechtigung hast, das Unternehmen zu verwalten
Prüfe, ob:
  • Der Standort oder die Filiale synchronisiert wurde
  • Eine Lagereinheit verknüpft ist
  • Die Lagereinheit zum selben Unternehmen gehört
  • Nicht bereits eine Migration läuft
Versuche, Produkte oder Artikel erneut zu synchronisieren.Bei Sides können Produkte aus dem Cache geladen werden, sofern du sie nicht manuell synchronisierst.Bei Lightspeed kannst du die Artikelsynchronisierung verwenden, um zwischengespeicherte Artikel zu aktualisieren.
Prüfe, ob:
  • POS-Artikel zugeordnet sind
  • Die zugeordnete Zutat oder das zugeordnete Rezept zum selben Unternehmen gehört
  • Der Standort oder die Filiale aktiviert ist
  • Eine Lagereinheit verknüpft ist
  • Der Transfer erfolgreich abgeschlossen wurde
Prüfe:
  • POS-Zuordnungen
  • Mengenfaktoren
  • Rezeptzutaten
  • Zuordnung der Lagereinheit
  • Ledger-Einträge für das betroffene Datum

Verwandte Seiten

Lightspeed K-Series

Verbinde Lightspeed und übertrage POS-Verkäufe in den Bestand.

Sides POS

Verbinde Sides und verarbeite tägliche Verkaufsberichte.

CSV-Upload

Lade POS-Verkaufsdaten manuell aus CSV-Dateien hoch.

POS-Zuordnung

Ordne POS-Produkte Zutaten oder Rezepten zu.

Lagereinheiten

Richte die Lagereinheiten ein, die für Bestandstransfers verwendet werden.

Ledger

Prüfe Bestandsbewegungen, die durch Integrationen erstellt wurden.
Zuletzt geändert am 9. Juni 2026