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
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
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
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
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.
Ohne verknüpfte Lagereinheit können Aktivierung und Transfers fehlschlagen.
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
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
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:
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
Integration kann nicht verbunden werden
Integration kann nicht verbunden werden
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
Standort oder Filiale kann nicht aktiviert werden
Standort oder Filiale kann nicht aktiviert werden
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
Produkte oder Artikel fehlen
Produkte oder Artikel fehlen
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.
Verkäufe beeinflussen den Bestand nicht
Verkäufe beeinflussen den Bestand nicht
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
Bestandszahlen wirken falsch
Bestandszahlen wirken falsch
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.