> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Centegra

> Verbinden Sie das Centegra-POS mit storekit für Order Injection. Verknüpfen Sie Produkte per PLU, um Online-Bestellungen an Ihre bestehenden Kassen zu senden, wobei Tische per POS-ID zugeordnet werden.

Centegra ist ein Enterprise-POS-System, das häufig im Gastgewerbe eingesetzt wird. Die storekit-Integration ermöglicht die automatische Order Injection. Die Menüverwaltung erfolgt über manuelle Produktverknüpfung – Sie erstellen Ihr Menü in storekit und verknüpfen Produkte mit ihren Centegra-IDs.

## Was Sie erhalten

* **Order Injection** – Online-Bestellungen werden direkt an Centegra gesendet
* **Tischzuordnung** – Leiten Sie Dine-in-Bestellungen an einen Centegra-Standort und -Tisch per POS-ID
* **Manuelle Produktverknüpfung** – Vollständige Kontrolle über die Präsentation Ihres Online-Menüs

## Erste Schritte

### Was Sie benötigen

Wenden Sie sich an Ihren Centegra Account Manager, um Folgendes zu erhalten:

* **Secure Key** – Ihr API-Schlüssel auf Unternehmensebene
* **Site ID** – Identifiziert Ihren spezifischen Standort

Sie müssen außerdem nach dem Verbinden venue-spezifische Einstellungen im storekit-Dashboard konfigurieren.

### Centegra verbinden

1. Gehen Sie in Ihrem storekit-Dashboard zu **Einstellungen > Integrationen**
2. Wählen Sie **Centegra**
3. Geben Sie Ihren **Secure Key** ein
4. Klicken Sie auf **Verbinden**

### Site auswählen

Nach dem Verbinden auf Kontoebene:

1. Gehen Sie zu **Stores** → Ihrem Store → **Einstellungen** → **Integrationen** → **Centegra**
2. Wählen Sie Ihre Centegra-**Site** aus den verfügbaren Optionen
3. Die Site ID wird für die Bestellweiterleitung gespeichert

### Venue-Einstellungen konfigurieren

Jedes Venue benötigt spezifische Centegra-Einstellungen:

| Einstellung         | Beschreibung                                             |
| ------------------- | -------------------------------------------------------- |
| **Location**        | Bereich/Standort innerhalb Ihrer Site für Bestellungen   |
| **Till**            | Welche Kasse Online-Bestellungen empfängt                |
| **Till Secure Key** | Authentifizierungsschlüssel für die ausgewählte Kasse    |
| **Clerk**           | Die Clerk-ID für Online-Bestellungen                     |
| **Media**           | Zahlungsmedientyp für Online-Zahlungen                   |
| **Source**          | Quellenkennung für Online-Bestellungen                   |
| **Price Level**     | Welches Preisniveau für Bestellpositionen verwendet wird |

<Warning>
  Alle Einstellungen müssen mit gültigen Werten in Ihrem Centegra-System übereinstimmen. Eine fehlerhafte Konfiguration führt zum Scheitern von Bestellungen.
</Warning>

## Produkte verknüpfen

Centegra verwendet **manuelle Produktverknüpfung** – Produkte werden nicht automatisch aus Ihrem POS synchronisiert.

### Funktionsweise

1. Erstellen Sie Ihr Menü in storekit mit Kategorien, Produkten und Modifikatoren
2. Geben Sie für jedes Produkt seine **Centegra Product ID** im POS-ID-Feld ein
3. Geben Sie für jeden Modifikator seine **Centegra Product ID** ein
4. Bei Bestellungen sendet storekit die Product IDs an Centegra

### Product IDs finden

Ihre Centegra Product IDs finden Sie in:

* Centegra-Backoffice unter Produkte
* Produkt-Exportberichten
* Durch Kontakt mit Ihrem Centegra-Supportteam

### Modifikatoren verknüpfen

Modifikatoren benötigen ebenfalls Product IDs von Centegra:

1. Gehen Sie in storekit zu Ihren Modifikatorgruppen
2. Geben Sie für jede Modifikator-Option ihre Centegra Product ID ein
3. Modifikatoren werden als untergeordnete Artikel gesendet, die mit ihrem Elternprodukt verknüpft sind

## Funktionsweise von Bestellungen

### Bestellablauf

1. Kunde gibt eine Bestellung in Ihrem storekit-Store auf
2. Bestellung wird mit Centegra validiert (`TransactionValidate`)
3. Bei Gültigkeit wird die Bestellung übermittelt (`Transaction`)
4. Bestellung erscheint in Centegra auf der konfigurierten Kasse
5. Kunde erhält Bestätigung mit Transaktions-ID

<Info>
  Wenn eine Bestellung nicht mit Centegra synchronisiert werden kann, erhalten Sie eine E-Mail-Benachrichtigung mit Fehlerdetails und einem direkten Link zur Bestellung in Ihrem Dashboard.
</Info>

### Bestellarten

| Online-Bestellung | Centegra-Transaktionstyp |
| ----------------- | ------------------------ |
| Abholung          | Type 2                   |
| Lieferung         | Type 3                   |

### Was Centegra empfängt

Jede Bestellung enthält:

* Externe Transaktions-ID (zeitstempelbasiert)
* Location-, Till- und Clerk-IDs
* Alle Artikel mit Product IDs, Mengen und Preisen
* Modifikatoren als untergeordnete Artikel, die mit den Eltern verknüpft sind
* Berechnete Rabatte, verteilt auf die Artikel
* Zahlungsdetails mit Media ID
* Kundenname, E-Mail, Telefon
* Bestellreferenznummer
* Zubereitungsstartzeit (für Planung)
* Bestellnotizen

### Rabatte

Wenn ein Rabatt angewendet wird:

* Der Rabattbetrag wird proportional auf alle Artikel verteilt
* Jeder Artikel zeigt seinen Einzelpreis, Brutto-Gesamtbetrag und Rabattbetrag
* Centegra erhält die vollständige Rabattaufschlüsselung

### Trinkgelder

Trinkgelder werden als negative Zahlungsposition behandelt, sodass die Bestellsumme korrekt bleibt und das Trinkgeld separat erfasst wird.

## Tische und Dine-In-Weiterleitung

Die Centegra-Einstellungsseite hat keinen Grundriss oder Tischsynchronisationsbutton. Erstellen Sie Ihre Bereiche und Tische in storekit (siehe [Dine-in-Tische](/docs/de/guides/fulfillment/dine-in-tables)) und geben Sie jedem Tisch die passende Centegra-POS-ID, damit Dine-in-Bestellungen an den richtigen Tisch innerhalb der konfigurierten **Location** geleitet werden.

## Fehlerbehebung

### Verbindungsprobleme

**„Secure Key nicht gefunden"**

* Prüfen Sie, ob Ihr Secure Key auf Kontoebene korrekt eingegeben wurde
* Wenden Sie sich an den Centegra-Support, um Ihren API-Zugriff zu bestätigen

**„Site nicht gefunden"**

* Prüfen Sie, ob die Site ID mit Ihrem Standort in Centegra übereinstimmt
* Stellen Sie sicher, dass Ihr Secure Key Zugriff auf diese Site hat

### Bestellprobleme

**Bestellungen scheitern bei der Validierung**

* Prüfen Sie, dass alle Venue-Einstellungen konfiguriert sind (Location, Till, Clerk usw.)
* Überprüfen Sie, ob der Till Secure Key korrekt ist
* Stellen Sie sicher, dass alle Produkte gültige Centegra Product IDs haben

**„Produkt hat keine posId"**

* Dem fehlgeschlagenen Artikel fehlt seine Centegra Product ID
* Bearbeiten Sie das Produkt in storekit und fügen Sie die POS-ID hinzu

**„Modifikator hat keine posId"**

* Einer Modifikator-Option fehlt ihre Product ID
* Bearbeiten Sie den Modifikator und fügen Sie die Centegra Product ID hinzu

### Falsche Artikel oder Preise

* Prüfen Sie, ob Product IDs zwischen storekit und Centegra übereinstimmen
* Überprüfen Sie, dass die Price-Level-Einstellung für Ihr Online-Menü korrekt ist
* Stellen Sie sicher, dass Steuersätze für Produkte konfiguriert sind

### Dine-In-Bestellungen erreichen nicht den richtigen Tisch

* Bestätigen Sie, dass Ihr Venue eine gültige Site ID (posId) hat
* Prüfen Sie, ob die in den storekit-Centegra-Einstellungen gewählte **Location** in Centegra existiert
* Vergewissern Sie sich, dass jeder storekit-Tisch die POS-ID des passenden Centegra-Tisches trägt

## Go-Live-Checkliste

Vor dem Start:

* [ ] Secure Key auf Kontoebene eingegeben
* [ ] Venue-Einstellungen konfiguriert (Location, Till, Clerk, Media, Source, Price Level)
* [ ] Alle Produkte haben Centegra Product IDs
* [ ] Alle Modifikatoren haben Centegra Product IDs
* [ ] Test-Abholbestellung aufgeben
* [ ] Bestellung erscheint auf der richtigen Kasse in Centegra
* [ ] Artikel, Modifikatoren und Preise sind korrekt
* [ ] Test-Lieferbestellung mit vollständiger Adresse
* [ ] Tische in storekit mit ihren Centegra-POS-IDs erstellen (bei Dine-in)

## Unterstützte Funktionen

<AccordionGroup>
  <Accordion title="Menü-Synchronisation">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Automatische Menü-Synchronisation |      ✗      |
    | Manuelle Produktverknüpfung       |      ✓      |
    | Produktbilder                     |      ✗      |
    | Allergene                         |      ✗      |
    | Nährwertangaben                   |      ✗      |
    | Verschachtelte Modifikatoren      |      ✗      |
    | Unterkategorien                   |      ✗      |
    | Bestandsstatus                    |      ✗      |

    Centegra verwendet manuelle Produktverknüpfung. Erstellen Sie Ihr Menü in storekit und geben Sie für jeden Artikel die Centegra Product ID ein.
  </Accordion>

  <Accordion title="Bestellungen">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Order Injection                   |      ✓      |
    | Vorbestellungen                   |      ✓      |
    | Order Buffering                   |      ✗      |
    | Warenkorb-Validierung             |      ✗      |
    | Auto-Snooze ausverkaufter Artikel |      ✗      |
    | Rabatte                           |      ✓      |
    | Trinkgelder                       |      ✓      |
    | Servicegebühr                     |      ✗      |
    | Benutzerdefinierte Bestellnotizen |      ✓      |
    | Lieferdetails                     |      ✓      |
  </Accordion>

  <Accordion title="Pay at Table">
    | Funktion                            | Unterstützt |
    | ----------------------------------- | :---------: |
    | Live-Rechnungssynchronisation       |      ✗      |
    | Zahlungen auf Rechnung anwenden     |      ✗      |
    | Split Payments                      |      ✗      |
    | Zahlungen am POS-Terminal verfolgen |      ✗      |
    | Zu bestehender Rechnung hinzufügen  |      ✗      |
  </Accordion>

  <Accordion title="Venue-Einrichtung">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Grundriss-Synchronisation         |      ✗      |
    | Echtzeit-Bestandsaktualisierungen |      ✗      |
    | Multi-Standort-Unterstützung      |      ✓      |
  </Accordion>
</AccordionGroup>

## Verwandt

* [POS-Integration – Übersicht](/docs/de/guides/integrations/pos/overview)
* [PLU-Mapping-Leitfaden](/docs/de/guides/integrations/pos/advanced/plu-mapping)
* [POS-Fehlerbehebung](/docs/de/guides/integrations/pos/advanced/troubleshooting)


## Related topics

- [POS-Menüsynchronisation](/docs/de/guides/menu/pos-menu-sync.md)
- [Menüprodukte, Modifier und Tags anlegen und konfigurieren](/docs/de/guides/menu/products.md)
- [POS-Integration – Übersicht](/docs/de/guides/integrations/pos/overview.md)
- [PLU-Mapping-Leitfaden](/docs/de/guides/integrations/pos/advanced/plu-mapping.md)
- [POS-verbundener Store](/docs/de/getting-started/store-types/pos-connected-store.md)