> ## 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.

# Integrationsübersicht

> Verbinde Mathership mit Kassensystemen und externen Verkaufsdatenquellen

# 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

<CardGroup cols={3}>
  <Card title="Kassensysteme verbinden" icon="plug">
    Verbinde unterstützte Kassensysteme wie Lightspeed K-Series und Sides POS.
  </Card>

  <Card title="Verkäufe dem Bestand zuordnen" icon="arrows-turn-to-dots">
    Verknüpfe POS-Artikel oder Produkte mit Mathership-Zutaten und Rezepten.
  </Card>

  <Card title="Bestandsbewegungen erstellen" icon="list-check">
    Wandle zugeordnete POS-Verkäufe in Bestandsabbuchungen im Ledger um.
  </Card>
</CardGroup>

## Verfügbare Integrationen

<CardGroup cols={3}>
  <Card title="Lightspeed K-Series" icon="bolt" href="/en/restaurants/integrations/lightspeed">
    Verbinde Lightspeed, synchronisiere Standorte und Artikel und übertrage POS-Verkäufe in den Bestand.
  </Card>

  <Card title="Sides POS" icon="cash-register" href="/en/restaurants/integrations/sides-pos">
    Verbinde Sides, synchronisiere Filialen und Produkte und verarbeite tägliche Verkaufsberichte.
  </Card>

  <Card title="CSV-Upload" icon="file-csv" href="/en/restaurants/integrations/pos-csv-upload">
    Lade POS-Verkaufsdaten manuell aus einer konfigurierten CSV-Datei hoch.
  </Card>

  <Card title="POS-Zuordnung" icon="arrows-turn-to-dots" href="/en/restaurants/integrations/pos-mapping">
    Ordne POS-Artikel Zutaten oder Rezepten zu, damit Verkäufe den Bestand aktualisieren können.
  </Card>

  <Card title="Lagereinheiten" icon="warehouse" href="/en/restaurants/inventory/storage-units">
    Verwalte die Lagereinheiten, die für POS-Verkaufsübertragungen und Bestandsbewegungen verwendet werden.
  </Card>

  <Card title="Ledger" icon="list-check" href="/en/restaurants/inventory/ledger">
    Prüfe Bestandsbewegungen, die durch Bestellungen, Transfers, Schwund, Zählungen und POS-Integrationen erstellt wurden.
  </Card>
</CardGroup>

## Integrationen aufrufen

So verwaltest du Integrationen:

<Steps>
  <Step title="Manage öffnen">
    Gehe im Mathership-Dashboard zu **Manage**.
  </Step>

  <Step title="Integrationen öffnen">
    Wähle **Integrations** aus.
  </Step>

  <Step title="Eine Integration auswählen">
    Wähle die Integration aus, die du konfigurieren möchtest, zum Beispiel **Lightspeed K-Series**, **Sides POS** oder **CSV Upload**.
  </Step>

  <Step title="System verbinden oder aktualisieren">
    Verbinde das externe System, aktualisiere Zugangsdaten oder konfiguriere die CSV-Importeinstellungen.
  </Step>

  <Step title="Externe Daten synchronisieren">
    Synchronisiere je nach Integration Standorte, Filialen, Produkte oder Artikel.
  </Step>

  <Step title="Zuordnungen einrichten">
    Verknüpfe POS-Artikel oder Produkte mit Mathership-Zutaten oder Rezepten.
  </Step>

  <Step title="Aktivieren, wenn alles bereit ist">
    Aktiviere die Integration, den Standort oder die Filiale erst, wenn Lagereinheiten und Zuordnungen eingerichtet sind.
  </Step>
</Steps>

## So funktionieren Integrationen

Die meisten POS-Integrationen folgen derselben Grundstruktur.

<Steps>
  <Step title="System verbinden">
    Lightspeed verwendet OAuth. Sides verwendet Zugangsdaten mit Benutzername und Passwort. CSV Upload verwendet einen konfigurierten CSV-Import.
  </Step>

  <Step title="Externe Daten synchronisieren">
    Synchronisiere Standorte, Filialen, POS-Artikel, Produkte oder andere Daten, die für die Zuordnung benötigt werden.
  </Step>

  <Step title="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.
  </Step>

  <Step title="POS-Artikel zuordnen">
    POS-Artikel und Produkte können Zutaten oder Rezepten zugeordnet werden. Rezeptzuordnungen werden in Zutatenbewegungen aufgelöst.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/en/restaurants/integrations/lightspeed) 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](/en/restaurants/integrations/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](/en/restaurants/integrations/pos-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-Artikel  | Zugeordnet zu | Ergebnis                              |
| ------------ | ------------- | ------------------------------------- |
| Cheeseburger | Rezept        | Bucht alle Rezeptzutaten ab           |
| Espresso     | Zutat         | Bucht Kaffee direkt ab                |
| Flasche Cola | Zutat         | Bucht eine Flasche aus dem Bestand ab |

Siehe [POS Mapping](/en/restaurants/integrations/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 System | Externer Standort | Mathership-Lagereinheit |
| --------------- | ----------------- | ----------------------- |
| Lightspeed      | Hauptrestaurant   | Hauptlager              |
| Lightspeed      | Bar               | Barlager                |
| Sides           | Downtown Store    | Küchenlager             |

Ohne verknüpfte Lagereinheit können Aktivierung und Transfers fehlschlagen.

<Warning>
  Prüfe die verknüpfte Lagereinheit immer, bevor du einen Standort oder eine Filiale aktivierst. Eine falsche Lagereinheit kann Bestandsbewegungen am falschen Ort erzeugen.
</Warning>

## 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.

<Note>
  Manuelle Transfers sind für Tests hilfreich, weil du die daraus entstehenden Ledger-Bewegungen prüfen kannst, bevor du automatische Transfers aktivierst.
</Note>

## Automatischer Transfer

Einige Integrationen unterstützen automatische Verkaufsübertragungen.

Je nach Einrichtung der Integration können automatische Transfers folgende Zustände haben:

| Status      | Bedeutung                                                                                  |
| ----------- | ------------------------------------------------------------------------------------------ |
| Aktiv       | Verkäufe werden automatisch verarbeitet                                                    |
| Pausiert    | Die automatische Verarbeitung ist gestoppt, Einrichtung und Historie bleiben aber erhalten |
| Fortgesetzt | Die 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

<Steps>
  <Step title="POS-Integration verbinden">
    Verbinde Lightspeed, Sides oder konfiguriere CSV Upload.
  </Step>

  <Step title="Standorte oder Filialen synchronisieren">
    Importiere externe Standorte oder Filialen.
  </Step>

  <Step title="Lagereinheiten verknüpfen">
    Weise jeden Standort bzw. jede Filiale der richtigen Mathership-Lagereinheit zu.
  </Step>

  <Step title="POS-Produkte oder Artikel synchronisieren">
    Importiere die Produkte oder Artikel, die zugeordnet werden sollen.
  </Step>

  <Step title="POS-Zuordnungen erstellen">
    Ordne wichtige POS-Produkte oder Artikel Zutaten oder Rezepten zu.
  </Step>

  <Step title="Standort oder Filiale aktivieren">
    Aktiviere erst, wenn Lagereinheiten und wichtige Zuordnungen bereit sind.
  </Step>

  <Step title="Migrationsstatus prüfen">
    Prüfe, ob die historische Migration gestartet wurde und korrekt abgeschlossen wurde.
  </Step>

  <Step title="Ledger prüfen">
    Prüfe die erstellten Bestandsbewegungen.
  </Step>

  <Step title="Bei Bedarf manuelle Transfers ausführen">
    Nutze manuelle Transfers, um bestimmte Daten zu testen oder erneut zu verarbeiten.
  </Step>
</Steps>

## Best Practices

<CardGroup cols={2}>
  <Card title="Zuerst Lagereinheiten einrichten" icon="warehouse">
    Erstelle und prüfe Lagereinheiten, bevor du POS-Standorte oder Filialen aktivierst.
  </Card>

  <Card title="Vor der Zuordnung synchronisieren" icon="rotate">
    Synchronisiere Produkte oder Artikel, bevor du Zuordnungen erstellst.
  </Card>

  <Card title="Mit wichtigen Artikeln beginnen" icon="ranking-star">
    Beginne zuerst mit POS-Artikeln und Produkten mit hohem Verkaufsvolumen.
  </Card>

  <Card title="Sorgfältig zuordnen" icon="arrows-turn-to-dots">
    Prüfe Zutat, Rezept und Mengenfaktor, bevor du Zuordnungen speicherst.
  </Card>

  <Card title="Nicht zugeordnete Artikel prüfen" icon="magnifying-glass">
    Nutze nicht zugeordnete Artikel nach dem ersten Transfer als Arbeitsliste.
  </Card>

  <Card title="Ledger prüfen" icon="list-check">
    Prüfe Ledger-Bewegungen nach der Aktivierung und nach größeren Änderungen an Zuordnungen.
  </Card>

  <Card title="Nur bei Bedarf erneut ausführen" icon="clock-rotate-left">
    Führe Migrationen nur erneut aus, nachdem Zuordnungen oder Einrichtungsprobleme korrigiert wurden.
  </Card>

  <Card title="Namen klar halten" icon="tag">
    Halte Produkt- und Rezeptnamen klar, damit Zuordnungen leichter gepflegt werden können.
  </Card>
</CardGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Bestandszahlen wirken falsch">
    Prüfe:

    * POS-Zuordnungen
    * Mengenfaktoren
    * Rezeptzutaten
    * Zuordnung der Lagereinheit
    * Ledger-Einträge für das betroffene Datum
  </Accordion>
</AccordionGroup>

## Verwandte Seiten

<CardGroup cols={3}>
  <Card title="Lightspeed K-Series" icon="bolt" href="/en/restaurants/integrations/lightspeed">
    Verbinde Lightspeed und übertrage POS-Verkäufe in den Bestand.
  </Card>

  <Card title="Sides POS" icon="cash-register" href="/en/restaurants/integrations/sides-pos">
    Verbinde Sides und verarbeite tägliche Verkaufsberichte.
  </Card>

  <Card title="CSV-Upload" icon="file-csv" href="/en/restaurants/integrations/pos-csv-upload">
    Lade POS-Verkaufsdaten manuell aus CSV-Dateien hoch.
  </Card>

  <Card title="POS-Zuordnung" icon="arrows-turn-to-dots" href="/en/restaurants/integrations/pos-mapping">
    Ordne POS-Produkte Zutaten oder Rezepten zu.
  </Card>

  <Card title="Lagereinheiten" icon="warehouse" href="/en/restaurants/inventory/storage-units">
    Richte die Lagereinheiten ein, die für Bestandstransfers verwendet werden.
  </Card>

  <Card title="Ledger" icon="list-check" href="/en/restaurants/inventory/ledger">
    Prüfe Bestandsbewegungen, die durch Integrationen erstellt wurden.
  </Card>
</CardGroup>