Skip to main content

​
SIDES POS

Verwende die SIDES-POS-Integration, um dein SIDES-Restaurantmanagementsystem mit Mathership zu verbinden. Die Integration synchronisiert SIDES-Filialen und Produkte, ermöglicht die Zuordnung von Produkten zu Zutaten oder Rezepten und erstellt Bestands-Ledger-Einträge aus SIDES-Verkaufsdaten.

SIDES verbinden

Verbinde SIDES mit Zugangsdaten aus Benutzername und Passwort und teste die Verbindung jederzeit.

Produkte zuordnen

Ordne SIDES-Produkte Mathership-Zutaten oder Rezepten zu.

Bestand aktualisieren

Übertrage SIDES-Verkäufe als Bestandsausgangsbewegungen in den Ledger.

​
Was die Integration kann

Die Integration kann:
  • SIDES mit Zugangsdaten aus Benutzername und Passwort verbinden
  • Die SIDES-Verbindung jederzeit testen
  • Zugangsdaten aktualisieren, ohne Einrichtungsdaten zu verlieren
  • SIDES-Filialen synchronisieren
  • SIDES-Produkte synchronisieren
  • SIDES-Filialen mit Mathership-Lagereinheiten verknüpfen
  • SIDES-Produkte Zutaten oder Rezepten zuordnen
  • Eine historische 90-Tage-Migration ausführen
  • Automatische tägliche Transfers ausführen
  • Manuelle Eintages-Transfers ausführen
  • Bestands-Ledger-Einträge aus SIDES-Verkäufen erstellen
  • Transferprotokolle für Prüfung und Fehlerbehebung speichern

​
Was die Integration macht

Wenn ein SIDES-Transfer ausgeführt wird, führt Mathership Folgendes aus:
  1. SIDES-Verkaufsdaten für eine Filiale und ein Datum abrufen
  2. Die Rohdaten der SIDES-Bestellungen und Belegpositionen speichern
  3. Die verkauften Produktnamen und Mengen lesen
  4. Passende POS-Zuordnungen in Mathership finden
  5. Zugeordnete Zutaten direkt abbuchen
  6. Zugeordnete Rezepte in Rezeptzutaten aufschlüsseln
  7. Bestandsmengen berechnen
  8. Bestands-Ledger-Einträge erstellen
  9. Ein Transferprotokoll mit Statistiken, Fehlern, übersprungenen Zeilen und nicht zugeordneten Artikeln speichern

​
Was die Integration nicht macht

Die SIDES-Integration macht Folgendes nicht:
  • Zutaten automatisch erstellen
  • Rezepte automatisch erstellen
  • Produktzuordnungen automatisch erraten
  • Bestand für nicht zugeordnete Produkte abbuchen
  • Lagerbestände optimieren
  • SIDES-Verkaufsdaten ändern
  • Bestand zurück an SIDES übertragen
  • Bestellungen erstellen
  • Lieferrouten berechnen
SIDES-Verkäufe wirken sich erst auf den Bestand aus, nachdem die zugehörigen SIDES-Produkte Zutaten oder Rezepten zugeordnet wurden.

​
Empfohlene Einrichtungsreihenfolge

Verwende diese Reihenfolge für eine saubere SIDES-Einrichtung:
1

Lagereinheiten erstellen

Richte die Mathership-Lagereinheiten ein, aus denen Bestandsabbuchungen erfolgen sollen.
2

Zutaten erstellen

Stelle sicher, dass die Zutaten existieren, die für Produkt- und Rezeptabbuchungen verwendet werden.
3

Rezepte erstellen

Erstelle Rezepte für SIDES-Produkte, die mehrere Zutaten abbuchen sollen.
4

SIDES verbinden

Gib die SIDES-Zugangsdaten ein und teste die Verbindung.
5

Filialen synchronisieren

Importiere SIDES-Filialen in Mathership.
6

Filialen mit Lagereinheiten verknüpfen

Weise jede SIDES-Filiale der richtigen Mathership-Lagereinheit zu.
7

Produkte synchronisieren

Importiere SIDES-Produkte.
8

Wichtige Produkte zuerst zuordnen

Beginne mit Produkten mit hohem Verkaufsvolumen und Produkten, die den Bestand stark beeinflussen.
9

Filiale aktivieren

Aktiviere die Filiale, sobald Lagereinheiten und Zuordnungen bereit sind.
10

Migrationsstatus prüfen

Prüfe die 90-Tage-Migration nach der Aktivierung.
11

Manuellen Transfer ausführen

Teste ein Datum manuell, bevor du dich auf den automatischen Transfer verlässt.
12

Ledger prüfen

Prüfe erstellte Ledger-Einträge und korrigiere Zuordnungen bei Bedarf.
Die wichtigste Einrichtungsregel lautet: Filialen benötigen Lagereinheiten, und SIDES-Produkte benötigen Zuordnungen. Ohne beides können Verkäufe nicht zuverlässig Bestandsbewegungen erstellen.

​
Bevor du beginnst

Bereite vor dem Verbinden von SIDES diese Mathership-Bestandsobjekte vor.

​
Lagereinheiten

Jede SIDES-Filiale muss mit einer Mathership-Lagereinheit verknüpft werden. Die Lagereinheit legt fest, wo der Bestand abgebucht werden soll.

​
Zutaten und Rezepte

Zutaten sind die Bestandsobjekte, die abgebucht werden. Verwende Rezepte, wenn ein verkauftes SIDES-Produkt aus mehreren Zutaten besteht. Wenn das SIDES-Produkt verkauft wird, bucht Mathership die Zutaten innerhalb des Rezepts ab.

​
SIDES verbinden

Verwende das Verbindungsformular, um Mathership mit SIDES zu verbinden.

​
Felder im Verbindungsformular

​
Verbindung testen

Teste nach dem Verbinden, ob Mathership die SIDES-API erreichen kann:
1

Integration öffnen

Öffne die Integration aus dem Bereich Connected.
2

Auf Test connection klicken

Mathership ruft die SIDES-API auf.
3

Ergebnis prüfen

Mathership gibt eine Erfolgs- oder Fehlermeldung zurück.
Verwende Test connection, wenn du vermutest, dass Zugangsdaten geändert wurden oder die Verbindung nicht mehr funktioniert.

​
Zugangsdaten bearbeiten

Du kannst Zugangsdaten jederzeit aktualisieren, ohne Filialen, Produkte, Zuordnungen oder Transferhistorie zu verlieren.
1

Integration öffnen

Öffne die bestehende SIDES-Integration.
2

Edit credentials aufklappen

Öffne den Bereich zur Bearbeitung der Zugangsdaten.
3

Felder aktualisieren

Aktualisiere den Integrationsnamen, Benutzernamen oder das Passwort.
4

Änderungen speichern

Klicke auf Save changes.
Lasse das Feld für Benutzername oder Passwort leer, um den aktuellen Wert beizubehalten.

​
Filialen und Produkte verwalten

Verwende im Integrationspanel die zwei Navigationsbuttons:
  • Manage stores — öffnet die Filialliste für diese Integration
  • Manage products — öffnet die Produktliste für diese Integration

​
Filialen synchronisieren

Synchronisiere Filialen, um die für dein Konto verfügbaren SIDES-Filialen zu importieren.

​
Spalten der Filialliste

​
Filter der Filialliste

Filtere die Liste über die Toolbar-Chips:

​
Lagereinheit verknüpfen

Jede SIDES-Filiale muss mit einer Mathership-Lagereinheit verknüpft werden, bevor sie aktiviert werden oder Ausgänge verarbeiten kann. Dasselbe verkaufte Produkt kann je nach Filiale Bestand aus unterschiedlichen Lagereinheiten abbuchen.
Ohne verknüpfte Lagereinheit kann eine SIDES-Filiale keine zuverlässigen Bestandsbewegungen erstellen.

​
Produkte synchronisieren

Synchronisiere Produkte, um SIDES-Produkte in Mathership zu importieren.

​
Spalten der Produktliste

​
Filter der Produktliste

​
SIDES-Produkttypen

​
SIDES-Produkte zuordnen

Klicke auf eine beliebige Produktzeile, um das Zuordnungs-Sheet zu öffnen. Jedes SIDES-Produkt muss zugeordnet werden, bevor es Bestandsbewegungen erstellen kann. Du kannst ein Produkt zuordnen zu:
  • Einer Zutat — die Zutat wird pro Verkauf direkt abgebucht
  • Einem Rezept — das Rezept wird in seine Zutaten aufgeschlüsselt und alle Zeilen werden abgebucht

​
Warum Zuordnung erforderlich ist

Ohne Zuordnung kann Mathership den Verkauf speichern, aber keine korrekte Bestandsabbuchung erstellen. Wenn ein Rezept verkauft wird, löst Mathership alle Rezeptzeilen einschließlich verschachtelter Unterrezepte auf und bucht jede Zutat ab.

​
Zuordnungsfelder

​
Zuordnungsbeispiele

​
Filiale aktivieren

Eine SIDES-Filiale muss aktiviert werden, bevor Migration und reguläre Transferverarbeitung ausgeführt werden können. Stelle vor der Aktivierung sicher:
  • Die Filiale hat eine Lagereinheit
  • Wichtige SIDES-Produkte sind zugeordnet
  • Rezepte und Zutaten sind korrekt eingerichtet
  • Du verstehst, welche Lagereinheit die Abbuchungen erhält

​
Detailseite der Filiale

Wenn du eine Filiale öffnest, siehst du eine Live-Übersicht über Status, Zustand, Aktivität und Konfiguration.

​
Filialmetadaten

Die Kopfzeile der Detailseite zeigt den Filialnamen, das Aktiviert-Badge, das Auto-issue-Badge und gegebenenfalls eines der folgenden Status-Badges:

​
Zustandsindikatoren

Wenn einer der folgenden Punkte erkannt wird, erscheint oben auf der Seite ein Warnbanner:
  • Keine Lagereinheit verknüpft
  • Filiale ist als coming soon markiert
  • Filiale ist vorübergehend geschlossen
  • Eine Migration läuft aktuell

​
Statistiken

​
Konfiguration

​
90-Tage-Migration

Wenn eine Filiale aktiviert wird, erstellt Mathership eine historische 90-Tage-Migration, die vergangene SIDES-Verkäufe verarbeitet und Bestandsbewegungen erstellt, sofern Zuordnungen existieren.

​
Datumsbereich der Migration

Der Standard-Migrationsbereich umfasst die letzten 90 abgeschlossenen Tage und endet gestern.

​
Migrationsstatus

​
Fortschrittsfelder der Migration

​
Migrationsaktionen

​
Automatischer Transfer

Schalte Auto issue im Bereich Konfiguration um, um die automatische tägliche Verarbeitung zu pausieren oder fortzusetzen. Pausiere den automatischen Transfer, wenn:
  • Zuordnungen unvollständig sind oder korrigiert werden
  • Eine Lagereinheiten-Verknüpfung falsch ist
  • Du unerwartete Bestandsbewegungen untersuchst
  • Du automatische Abbuchungen vorübergehend verhindern möchtest
Das Pausieren des automatischen Transfers löscht weder die Integration noch Filialen, Zuordnungen oder Transferhistorie.

​
Manueller Transfer

Verwende den manuellen Transfer, wenn du einen bestimmten Tag verarbeiten möchtest. Der manuelle Transfer ist nützlich für:
  • Das Testen der Integration vor dem Aktivieren des automatischen Transfers
  • Das erneute Verarbeiten eines Tages nach Änderungen an Zuordnungen
  • Das Korrigieren des Bestands nach einem fehlgeschlagenen Transfer
  • Das Prüfen eines bestimmten SIDES-Verkaufsdatums

​
Was während des Transfers passiert

Wenn ein SIDES-Transfer ausgeführt wird, führt Mathership Folgendes aus:
  1. Prüfen, ob die Filiale eine Lagereinheit hat
  2. Transferprotokoll erstellen
  3. SIDES-Verkaufsdaten für das ausgewählte Datum abrufen
  4. SIDES-Bestellungen und Belegpositionen speichern
  5. Verkaufte Produktnamen und Mengen lesen
  6. Zeilen überspringen, die bereits für die aktuelle Lagereinheit gebucht wurden
  7. Verkaufte Produktnamen mit POS-Zuordnungen abgleichen
  8. Zugeordnete Zutaten direkt abbuchen
  9. Zugeordnete Rezepte in Zutaten aufschlüsseln
  10. Gewichtete Durchschnittskosten berechnen
  11. Bestands-Ledger-Einträge erstellen
  12. Ledger-Einträge mit SIDES-Belegpositionen verknüpfen
  13. Letzte Ausführungszeit der Integration aktualisieren
  14. Transferstatistiken und Fehler speichern

​
Verarbeitung von Verkaufszeilen

Es werden nur positive Belegpositionen mit Produktnamen verarbeitet. Eine Belegposition wird übersprungen, wenn:
  • Die Menge fehlt, null oder negativ ist
  • Der Produktname fehlt
  • Die Zeile bereits gebucht wurde
  • Das Produkt nicht zugeordnet ist
  • Die zugeordnete Zutat oder das zugeordnete Rezept nicht aufgelöst werden kann

​
POS-Zuordnungsabgleich

Der Transfer gleicht SIDES-Belegpositionen über den Produktnamen mit POS-Zuordnungen ab. Der SIDES-Produktname muss exakt mit dem zugeordneten POS-Produktnamen übereinstimmen.
Wenn sich Produktnamen in SIDES ändern, müssen Zuordnungen möglicherweise geprüft oder neu erstellt werden.

​
Transferergebnis

Der Bereich des letzten erfolgreichen Ausgangs auf der Filialdetailseite zeigt:

​
Transferstatistiken

Detaillierte Transferstatistiken, die im Protokoll gespeichert sind, können Folgendes enthalten:

​
Nicht zugeordnete Produkte

Wenn ein verkauftes SIDES-Produkt keine Zuordnung hat, zeichnet Mathership den Produktnamen als nicht zugeordnet auf und erstellt keine Bestandsabbuchung.

​
Verarbeitungslogik

​
Zutat-Zuordnung

Wenn die Zuordnung auf eine Zutat verweist, bucht Mathership diese Zutat direkt ab.

​
Rezeptzuordnung

Wenn die Zuordnung auf ein Rezept verweist, löst Mathership das Rezept auf und bucht alle Rezeptzutaten ab. Rezepte können Unterrezepte enthalten. Wenn ein zugeordnetes Rezept ein Unterrezept enthält, löst Mathership es als Teil des Transfers auf. Rezeptzeilen können einen Verlustprozentsatz enthalten. Wenn der Verlustprozentsatz ungültig ist, zeichnet der Transfer eine invalid_trim_pct-Exception auf. Wenn Rezepte sich gegenseitig in einem Zyklus referenzieren, stoppt Mathership die Auflösung und zeichnet eine recipe_cycle-Exception auf.

​
Gewichtete Durchschnittskosten

Mathership berechnet die Stückkosten aus Wareneingangs-Ledger-Einträgen mit: Gesamtwert der Wareneingänge / Gesamtmenge der Wareneingänge Wenn keine Wareneingangsmenge verfügbar ist, betragen die Stückkosten 0.

​
Bestands-Ledger-Einträge

Jeder Bestands-Ledger-Eintrag ist verknüpft mit:
  • Unternehmen und Zutat
  • Lagereinheit
  • Abgebuchter Menge
  • Stückkosten und Gesamtwert
  • Datum
  • SIDES-Filiale
  • Transferprotokoll
  • SIDES-Belegposition
Siehe Ledger für eine detaillierte Bestandshistorie.

​
Transferprotokolle

Jeder Ausgangsversuch erstellt ein Transferprotokoll. Öffne Protokolle über den Button See all logs auf der Filialdetailseite. Die Filialdetailseite zeigt außerdem die letzten 10 fehlgeschlagenen Transfers direkt an, einschließlich Report date, Attempt number, Start time und Error message.

​
Test-Checkliste

Bevor du dich auf automatische Transfers verlässt, teste einen Tag manuell und prüfe:
  • Die richtige SIDES-Filiale wurde verwendet
  • Die Filiale hat die richtige Lagereinheit
  • Das richtige Datum wurde verarbeitet
  • Verkaufte Produkte wurden gefunden
  • Wichtige Produkte sind zugeordnet
  • Rezeptzutaten wurden korrekt abgebucht
  • Mengen sind korrekt
  • Ledger-Einträge erscheinen in der richtigen Lagereinheit
  • Nicht zugeordnete Produktnamen sind erwartet
  • Der Status des Transferprotokolls ist erfolgreich
  • Es treten keine unerwarteten Exceptions auf

​
Best Practices

Zuerst Bestand einrichten

Richte Lagereinheiten, Zutaten und Rezepte ein, bevor du SIDES verbindest.

Zugangsdaten testen

Teste die Verbindung nach dem Einrichten oder Ändern von Zugangsdaten.

Produkte mit hohem Volumen zuerst zuordnen

Beginne mit den Produkten, die am häufigsten verkauft werden, um schnell den größten Bestandseffekt zu erzielen.

Zuerst manuell testen

Teste immer einen Tag manuell, bevor du den automatischen Transfer aktivierst.

Nicht zugeordnete Produkte prüfen

Nutze nicht zugeordnete Produktnamen aus dem Transferprotokoll als Arbeitsliste für fehlende Zuordnungen.

Produktnamen stabil halten

Die Zuordnung hängt von exakten SIDES-Produktnamen ab.

Filialstatus prüfen

Filialen, die als coming soon oder vorübergehend geschlossen markiert sind, haben möglicherweise keine Verkaufsdaten.

Ledger-Ergebnisse prüfen

Prüfe nach Transfers den Bestands-Ledger, um Mengen, Lagereinheiten und Zutaten zu bestätigen.

​
Häufige Probleme

Prüfe, ob Benutzername und Passwort korrekt sind.Aktualisiere die Zugangsdaten über Edit credentials und teste erneut.
Synchronisiere Filialen erneut.Wenn Filialen weiterhin fehlen, prüfe, ob dein SIDES-Konto Zugriff auf diese Filialen hat.
Synchronisiere Produkte erneut.Die Produktliste kann aus dem Cache bereitgestellt werden — führe Sync products aus, um einen frischen Abruf von SIDES zu erzwingen.
Prüfe, ob eine Lagereinheit verknüpft und gespeichert ist und ob mindestens ein Produkt zugeordnet ist.
Prüfe, ob die Filiale aktiviert ist, eine Lagereinheit verknüpft hat und keine andere Migration bereits aussteht oder läuft.
Prüfe, ob Produkte zugeordnet sind, Produktnamen in SIDES mit den in Zuordnungen verwendeten Namen übereinstimmen, die Filiale eine Lagereinheit hat und SIDES für das ausgewählte Datum Verkäufe hatte.
Öffne das Transferprotokoll und prüfe nicht zugeordnete Produktnamen.Erstelle oder korrigiere Zuordnungen und führe dann den manuellen Ausgang erneut aus.
  1. Auto issue pausieren
  2. Verknüpfung der Lagereinheit korrigieren und speichern
  3. Bestehende Ledger-Einträge für die betroffenen Daten prüfen
  4. Nach der Korrektur einen manuellen Ausgang ausführen
Prüfe das Datum, die SIDES-Filiale und ob es am ausgewählten Tag Verkaufsaktivität gab.Filialen, die als coming soon oder vorübergehend geschlossen markiert sind, haben an bestimmten Daten möglicherweise keine Daten.
Prüfe, ob der Name der SIDES-Belegposition exakt mit dem zugeordneten Produktnamen übereinstimmt, ob die zugeordnete Zutat oder das Rezept noch existiert, ob das Rezept Zutatenzeilen enthält und ob die verkaufte Menge größer als null ist.

​
Verwandte Seiten

POS-Zuordnung

Ordne POS-Produkte Zutaten oder Rezepten zu.

Lagereinheiten

Verwalte die Lagerorte, die für Bestandsabbuchungen verwendet werden.

Bestands-Ledger

Prüfe Bestandsbewegungen, die durch Sides-Transfers erstellt wurden.

Integrationsübersicht

Zurück zur Integrationsübersicht.
Zuletzt geändert am 9. Juni 2026