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

# Konnektivität und Druck von Star-Druckern beheben

> Diagnostizieren und beheben Sie häufige storekit-Druckprobleme mit dem interaktiven Troubleshooter. Referenz für die LED-Statuscodes von Star-Druckern bei Konnektivitätsproblemen.

export const PrintingTroubleshooter = () => {
  const [step, setStep] = useState(0);
  const [answers, setAnswers] = useState({});
  const flow = [{
    question: "What's the printer's Power LED showing?",
    options: [{
      label: 'Steady blue (on)',
      value: 'power_on',
      next: 1
    }, {
      label: 'Off',
      value: 'power_off',
      solution: 'power_off'
    }]
  }, {
    question: "What's the Network LED showing?",
    options: [{
      label: 'Steady green (connected)',
      value: 'network_on',
      next: 2
    }, {
      label: 'Flashing green',
      value: 'network_flashing',
      solution: 'network_flashing'
    }, {
      label: 'Off',
      value: 'network_off',
      solution: 'network_off'
    }]
  }, {
    question: "What's the Error LED showing?",
    options: [{
      label: 'Off (no error)',
      value: 'no_error',
      next: 3
    }, {
      label: 'Steady red',
      value: 'error_steady',
      solution: 'cover_open'
    }, {
      label: 'Flashing red',
      value: 'error_flashing',
      solution: 'out_of_paper'
    }]
  }, {
    question: "What's happening with your orders?",
    options: [{
      label: "Orders aren't printing at all",
      value: 'not_printing',
      next: 4
    }, {
      label: 'Some items are missing from prints',
      value: 'missing_items',
      solution: 'split_printing'
    }, {
      label: 'Print quality is poor (faded/light)',
      value: 'quality',
      solution: 'print_quality'
    }, {
      label: 'Orders are printing late/delayed',
      value: 'delayed',
      solution: 'buffer_setting'
    }]
  }, {
    question: 'Are you using auto-print?',
    options: [{
      label: 'Yes, auto-print is enabled',
      value: 'auto_print',
      next: 5
    }, {
      label: 'No, I manually print orders',
      value: 'manual',
      solution: 'power_cycle'
    }]
  }, {
    question: 'Have you accepted the orders in your dashboard?',
    options: [{
      label: 'Yes, orders are accepted',
      value: 'accepted',
      solution: 'power_cycle'
    }, {
      label: 'No / Not sure',
      value: 'not_accepted',
      solution: 'accept_orders'
    }]
  }];
  const solutions = {
    power_off: {
      title: 'Printer Has No Power',
      icon: '🔌',
      steps: ['Check the power cable is connected to both the printer and wall outlet', 'Disconnect and reconnect the power cable firmly', 'Try a different power outlet', 'Press the power button - wait for steady blue light'],
      severity: 'error'
    },
    network_flashing: {
      title: 'Printer Trying to Connect',
      icon: '📶',
      steps: ['Power off the printer', 'Check ethernet cable is firmly connected to router', 'Verify your internet connection is working', 'Power on printer and wait 60 seconds', 'If still flashing, try moving printer closer to router (WiFi) or use ethernet cable'],
      severity: 'warning'
    },
    network_off: {
      title: 'No Network Connection',
      icon: '❌',
      steps: ['Power off the printer', 'Check ethernet cable at both ends (printer and router)', 'Try a different ethernet port on your router', 'Verify your router is online and working', 'Power on printer and wait 60 seconds'],
      note: 'No network = no orders will print. This is critical to fix.',
      severity: 'error'
    },
    cover_open: {
      title: 'Printer Cover Open',
      icon: '📂',
      steps: ['Check the paper cover is fully closed', 'Open and close the cover firmly until it clicks', 'If error persists, check paper is loaded correctly'],
      severity: 'warning'
    },
    out_of_paper: {
      title: 'Out of Paper',
      icon: '📜',
      steps: ['Open the printer cover', 'Insert a new paper roll with thermal side facing out', 'Close the cover until it clicks', 'The error should clear automatically'],
      severity: 'warning'
    },
    split_printing: {
      title: 'Check Split Printing Settings',
      icon: '⚙️',
      steps: ['Go to Menu in your dashboard', 'Select the category with missing items', 'Click the Printing tab', 'Ensure the correct printer is ticked for this category', 'Repeat for any other categories not printing', 'Save changes'],
      note: 'Each category can be assigned to specific printers. Unassigned categories won\'t print to that printer.',
      severity: 'info'
    },
    print_quality: {
      title: 'Improve Print Quality',
      icon: '✨',
      steps: ['Check paper is loaded correctly (thermal side facing out - test by scratching with fingernail)', 'Clean the print head with isopropyl alcohol and a lint-free cloth', 'Replace paper roll if old or stored in humid conditions', 'Try the "Large" text size setting in Settings > Direct Printing'],
      severity: 'info'
    },
    buffer_setting: {
      title: 'Check Print Timing Settings',
      icon: '⏱️',
      steps: ['Go to Settings > Direct Printing', 'Check the buffer/delay setting for pre-orders', 'For ASAP orders, ensure "Print immediately" is enabled', 'Review your pre-order lead time settings', 'If using auto-print, orders only print after acceptance'],
      severity: 'info'
    },
    accept_orders: {
      title: 'Accept Orders First',
      icon: '✅',
      steps: ['With auto-print enabled, orders only print after being accepted', 'Go to your Orders page in the dashboard', 'Look for pending orders waiting to be accepted', 'Accept the order - it should print automatically', 'If it still doesn\'t print, try a power cycle'],
      note: 'Auto-print waits for you to accept orders before printing. This prevents printing orders you might reject.',
      severity: 'info'
    },
    power_cycle: {
      title: 'Power Cycle the Printer',
      icon: '🔄',
      steps: ['Turn the printer off using the power button', 'Unplug the power cord from the wall outlet', 'Wait 30 seconds', 'Plug the power cord back in', 'Turn the printer on', 'Wait for steady blue (power) and green (network) lights', 'Try printing a test order from Settings > Direct Printing'],
      note: 'This resolves most "everything looks fine but won\'t print" issues.',
      severity: 'info'
    }
  };
  const reset = () => {
    setStep(0);
    setAnswers({});
  };
  const handleAnswer = option => {
    const newAnswers = {
      ...answers,
      [step]: option.value
    };
    setAnswers(newAnswers);
    if (option.solution) {
      setStep(-1);
      setAnswers({
        ...newAnswers,
        solution: option.solution
      });
    } else if (option.next !== undefined) {
      setStep(option.next);
    }
  };
  const currentSolution = answers.solution ? solutions[answers.solution] : null;
  return <div className="not-prose">
      {}
      {step >= 0 && !currentSolution && <div className="space-y-4">
          {step > 0 && <button onClick={reset} className="text-sm text-blue-600 dark:text-blue-400 hover:underline flex items-center gap-1">
              ← Start over
            </button>}
          
          <div className="p-4 rounded-xl border border-zinc-200 dark:border-zinc-700 bg-zinc-50 dark:bg-zinc-800/50">
            <h3 className="text-lg font-semibold text-zinc-900 dark:text-white mb-4">
              {flow[step].question}
            </h3>
            <div className="space-y-2">
              {flow[step].options.map((option, idx) => <button key={idx} onClick={() => handleAnswer(option)} className="w-full p-3 rounded-lg border border-zinc-200 dark:border-zinc-600 hover:border-blue-500 dark:hover:border-blue-500 hover:bg-blue-50 dark:hover:bg-blue-900/20 transition-all text-left text-zinc-900 dark:text-white">
                  {option.label}
                </button>)}
            </div>
          </div>
        </div>}

      {}
      {currentSolution && <div className="space-y-4">
          <button onClick={reset} className="text-sm text-blue-600 dark:text-blue-400 hover:underline flex items-center gap-1">
            ← Start over
          </button>

          <div className={`p-4 rounded-xl border-2 ${currentSolution.severity === 'error' ? 'border-red-300 dark:border-red-800 bg-red-50 dark:bg-red-900/20' : currentSolution.severity === 'warning' ? 'border-yellow-300 dark:border-yellow-800 bg-yellow-50 dark:bg-yellow-900/20' : 'border-blue-300 dark:border-blue-800 bg-blue-50 dark:bg-blue-900/20'}`}>
            <div className="flex items-start gap-3">
              <span className="text-3xl">{currentSolution.icon}</span>
              <div className="flex-1">
                <h3 className="text-lg font-semibold text-zinc-900 dark:text-white">
                  {currentSolution.title}
                </h3>
                
                <ol className="mt-4 space-y-2">
                  {currentSolution.steps.map((s, idx) => <li key={idx} className="flex gap-3">
                      <span className="flex-shrink-0 w-6 h-6 rounded-full bg-zinc-200 dark:bg-zinc-700 flex items-center justify-center text-sm font-medium text-zinc-700 dark:text-zinc-300">
                        {idx + 1}
                      </span>
                      <span className="text-zinc-700 dark:text-zinc-300">{s}</span>
                    </li>)}
                </ol>

                {currentSolution.note && <div className="mt-4 p-3 rounded-lg bg-white/50 dark:bg-black/20 text-sm text-zinc-600 dark:text-zinc-400">
                    💡 {currentSolution.note}
                  </div>}
              </div>
            </div>
          </div>

          <div className="p-4 rounded-xl border border-zinc-200 dark:border-zinc-700 bg-white dark:bg-zinc-800">
            <h4 className="font-medium text-zinc-900 dark:text-white mb-2">Still not working?</h4>
            <p className="text-sm text-zinc-600 dark:text-zinc-400">
              If these steps didn't help, contact support with your store name, printer model, and a photo of the LED lights.
            </p>
          </div>
        </div>}
    </div>;
};

## Diagnose-Tool

Beantworten Sie einige Fragen, um Ihr Problem zu diagnostizieren:

<PrintingTroubleshooter />

***

## LED-Anzeigen

Star-Drucker verfügen über LED-Anzeigen, die den Druckerstatus anzeigen:

| LED          | Status          | Bedeutung                                  |
| ------------ | --------------- | ------------------------------------------ |
| **Power**    | Blau, dauerhaft | Drucker ist eingeschaltet und funktioniert |
| **Power**    | Aus             | Kein Strom — Verbindungen prüfen           |
| **Netzwerk** | Grün, dauerhaft | Mit Netzwerk verbunden                     |
| **Netzwerk** | Grün, blinkend  | Versucht Netzwerkverbindung herzustellen   |
| **Netzwerk** | Aus             | Keine Netzwerkverbindung                   |
| **Fehler**   | Rot, dauerhaft  | Druckerabdeckung ist offen                 |
| **Fehler**   | Rot, blinkend   | Kein Papier                                |

<Note>
  Die Bluetooth-LED wird mit storekit nicht verwendet — Drucker verbinden sich ausschließlich per WLAN oder Ethernet.
</Note>

## Schneller Neustart

Wenn Ihr Drucker Power- und Netzwerk-LED dauerhaft leuchten, aber nicht druckt, versuchen Sie einen Neustart:

1. Schalten Sie den Drucker aus
2. Ziehen Sie das Netzkabel aus der Steckdose
3. Warten Sie 30 Sekunden
4. Stecken Sie das Kabel wieder ein und schalten Sie den Drucker ein

Wenn wartende Bestellungen zu drucken beginnen, ist der Drucker wieder online.

## Verbindungsprobleme

### Power-LED ist aus

* Prüfen Sie, ob das Netzkabel mit Drucker und Steckdose verbunden ist
* Trennen Sie das Netzkabel und stecken Sie es wieder ein
* Testen Sie eine andere Steckdose
* Drücken Sie den Ein-/Aus-Schalter — er sollte dauerhaft blau leuchten

### Netzwerk-LED ist aus oder blinkt

1. Schalten Sie den Drucker aus
2. Prüfen Sie die Ethernet-Verbindung zu Ihrem Router (oder die WLAN-Signalstärke)
3. Trennen Sie das Netzwerkkabel und stecken Sie es wieder ein
4. Schalten Sie den Drucker ein
5. Blinkt es weiter, prüfen Sie, ob Ihre Internetverbindung funktioniert

<Warning>
  Keine Netzwerkverbindung = keine gedruckten Bestellungen. Stellen Sie stets sicher, dass Ihr Router online und der Drucker korrekt verbunden ist.
</Warning>

### BT-Router

BT (British Telecom) hat eine Netzwerkrichtlinie eingeführt, die die Verbindung zwischen BT-Routern und dem storekit-Cloud-Druckdienst blockieren kann. Davon sind viele BT-Hub- und BT-Smart-Hub-Modelle betroffen.

**Symptome:**

* Der Drucker erscheint im Dashboard als **online**, doch Bestellungen werden zeitweise nicht gedruckt
* Ein Neustart des Druckers behebt es vorübergehend, das Problem tritt aber erneut auf — oft binnen Stunden
* Testdrucke funktionieren möglicherweise einwandfrei, danach schlagen echte Bestellungen kurz darauf fehl

**Workarounds (in priorisierter Reihenfolge):**

<Steps>
  <Step title="Option 1: Separaten Mobilrouter verwenden (empfohlen)">
    Verbinden Sie den Drucker mit einem **5G-Mobilrouter** statt mit dem BT-Router. Damit umgehen Sie die Netzwerkfilterung von BT vollständig — die zuverlässigste Lösung. Sie benötigen einen 5G-Router und eine SIM-Karte mit Datentarif — der Drucker verbraucht sehr wenig Daten, daher genügt ein kleines Datenpaket.
  </Step>

  <Step title="Option 2: Ethernet statt WLAN verwenden">
    Verbinden Sie den Drucker per **Ethernet-Kabel** mit dem BT-Router statt per WLAN. Kabelgebundene Verbindungen sind stabiler und werden weniger von BTs Netzwerk-Management beeinflusst.
  </Step>

  <Step title="Option 3: MAC-Adresse des Druckers auf Whitelist setzen">
    Melden Sie sich in der Admin-Oberfläche des BT-Hubs an (in der Regel unter `192.168.1.254`) und setzen Sie die MAC-Adresse des Druckers auf die Whitelist. So verhindern Sie, dass der Router die Druckerverbindung depriorisiert oder blockiert. Die MAC-Adresse finden Sie auf dem Netzwerkstatus-Ausdruck (halten Sie die **FEED**-Taste beim Einschalten gedrückt).
  </Step>
</Steps>

**Weitere Tipps für BT-Router:**

* **Smart Setup / Complete Wi-Fi deaktivieren** — diese Funktion kann die Druckerverbindung stören, indem sie Geräte automatisch zwischen Bändern oder Access Points verschiebt. Deaktivieren Sie sie im BT-Router-Admin unter **Advanced Settings** → **Wireless**
* **Drucker neu starten** (aus, 30 Sekunden vom Strom trennen, wieder einstecken), um das Drucken vorübergehend wiederherzustellen, während Sie einen der obigen Fixes anwenden
* Löst nichts davon das Problem, erwägen Sie, den BT-Router im Netzwerk des Druckers durch einen Nicht-BT-Router zu ersetzen

Allgemeine Schritte zur Einrichtung des Druckers finden Sie im [Leitfaden zur Druckereinrichtung](/docs/de/guides/printing/printer-setup).

## Bestellungen werden nicht gedruckt

### Drucker zeigt online, aber Bestellungen werden nicht gedruckt

* Bei **Auto-Druck** werden Bestellungen erst nach Annahme gedruckt
* Prüfen Sie, ob die **Puffer**-Einstellung Vorbestellungen verzögert
* Vergewissern Sie sich, dass der Drucker den relevanten Kategorien zugewiesen ist (bei Split-Printing)
* Senden Sie einen Testdruck aus dem Dashboard

### Einige Artikel werden nicht gedruckt

* Bei Split-Printing: Prüfen Sie, ob die Kategorie einem Online-Drucker zugewiesen ist
* Sorgen Sie für ausreichend Papier
* Geben Sie eine Testbestellung zur Prüfung der Weiterleitung auf

### Kundennotizen fehlen auf Bons

Die Bestellung wird gedruckt, aber die Notiz des Gastes (Allergie, Zubereitungswunsch, Lieferhinweis) fehlt auf dem Küchen- oder Bar-Bon:

1. Prüfen Sie, ob Bestellnotizen aktiviert sind — gehen Sie zu **Läden** → \[Ihr Laden] → **Einstellungen** → **Operations** → **Bestellnotizen** und stellen Sie sie auf **Optional** oder **Pflicht**. **Ausgeblendet** entfernt das Notizfeld vollständig aus dem Checkout.
2. Wenn Sie Bestell-Batching nutzen, aktivieren Sie **Bestellnotizen einschließen** — unter **Order batching** → **Merged ticket contents** auf derselben Seite. Ist Batching aktiv und dieser Schalter aus, werden Notizen aus dem zusammengeführten Bon entfernt, obwohl sie in der Dashboard-Bestellung weiterhin sichtbar sind. Siehe [Kundennotizen bei zusammengeführten Bons](/docs/de/guides/orders/advanced/order-batching#customer-notes-on-batched-tickets).
3. Für Zonal (Aztec) setzen Sie eine **Order Note Product ID** — Zonal akzeptiert Notizen nur als Zeilenposition, ohne diese erreicht die Notiz weder das POS noch seine Bons. Siehe [Zonal-Bestellnotizen](/docs/de/guides/integrations/pos/zonal#order-notes).
4. Beachten Sie, dass die Einstellung **Admin-Kommentare drucken** in den Druckereinstellungen die im Dashboard hinzugefügten Admin-Kommentare steuert, nicht die Kundennotizen.

Eine allgemeine Bestellnotiz ist keinem Artikel zugeordnet, daher druckt sie auf jedem Stations-Bon, der für diese Bestellung erzeugt wird — ein Drucker, der keinen der Artikel der Bestellung erhält, druckt keinen Bon.

### Verzögerter Druck

Wenn Bestellungen gedruckt werden, aber später als erwartet ankommen, arbeiten Sie diese Checkliste durch:

1. Prüfen Sie, ob Bestell-Batching aktiviert ist — gehen Sie zu **Läden** → \[Ihr Laden] → **Einstellungen** → **Operations** → **Order batching** und prüfen Sie den Wert **Batch timeout** (1–5 Minuten). Deaktivieren Sie **Enable order batching**, um jede Bestellung direkt in die Küche zu senden. Weitere Details siehe [Leitfaden zu Bestell-Batching](/docs/de/guides/orders/advanced/order-batching).
2. **Prüfen Sie den Vorbestellungspuffer** in den Druckereinstellungen — ein Puffer ungleich null verzögert Vorbestellungen.
3. **Prüfen Sie Auto-Annahme** — ist sie deaktiviert, warten Bestellungen auf manuelle Annahme, bevor sie gedruckt werden.
4. **Prüfen Sie Ihren Internetanbieter** — langsame oder unzuverlässige Verbindungen können die Zustellung der Bestellung an den Drucker verzögern (siehe [BT-Router](#bt-router) oben).

## Sporadisches Drucken (funktioniert eine Weile, dann nicht mehr)

Wenn Ihr Drucker eine Weile funktioniert und dann zufällig aufhört zu drucken — und nach einem Neustart wieder läuft —, handelt es sich meist um ein **Problem der Netzwerkstabilität**, nicht um Hardware. Ihr Router unterbricht möglicherweise regelmäßig die Verbindung des Druckers.

### Problem diagnostizieren

1. **DHCP-Lease-Zeit des Routers prüfen** — kurze Lease-Zeiten können dazu führen, dass der Drucker seine IP-Adresse verliert. Stellen Sie die Lease-Zeit in der Router-Verwaltung auf **24 Stunden** oder länger
2. **Statische IP dem Drucker zuweisen** — verhindert, dass der Router die Adresse des Druckers neu vergibt:
   * Ermitteln Sie die aktuelle IP-Adresse des Druckers auf dem Netzwerkstatus-Ausdruck (halten Sie **FEED** beim Einschalten gedrückt)
   * Öffnen Sie die Router-Verwaltung und reservieren Sie diese IP für die MAC-Adresse des Druckers
3. **MAC-Adresse des Druckers whitelisten** in den Router-Einstellungen, damit der Router den Drucker nicht depriorisiert oder trennt
4. **WLAN-Störungen prüfen** — stellen Sie den Drucker näher am Router auf oder wechseln Sie auf Ethernet

<Tip>
  Verwenden Sie die kostenlose App **Star Quick Setup Utility** ([iOS](https://apps.apple.com/app/star-quick-setup-utility/id1549088652) / [Android](https://play.google.com/store/apps/details?id=com.starmicronics.starquicksetup)), um den Netzwerkverbindungsstatus Ihres Druckers zu prüfen und aktuelle IP-Adresse, Signalstärke und Verbindungstyp anzuzeigen.
</Tip>

<Note>
  Wenn Sie einen BT-Router nutzen, siehe den Abschnitt [BT-Router](#bt-router) — BT hat eine Netzwerkrichtlinie, die häufig zu sporadischen Druckfehlern führt.
</Note>

## Mehrere Netzwerke / Wechsel des Routers

Wenn Ihr Drucker in einem Router funktioniert, aber nicht mehr, sobald Sie einen anderen Router oder ein anderes Netzwerk verwenden, liegt die Ursache fast immer in einer **Netzwerk-Konfigurationsdiskrepanz** zwischen den beiden Routern. Selbst wenn beide Netzwerke Internetzugang haben, können Unterschiede bei lokalem Datenverkehr die Druckerkommunikation stören.

### Warum das passiert

| Ursache                                     | Erklärung                                                                                                                                                                         |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Unterschiedliche Subnetze**               | Wenn der Drucker in `192.168.1.x` ist, Ihr Gerät aber in `192.168.0.x`, können sie einander nicht erreichen — selbst wenn beide mit demselben physischen Router verbunden sind    |
| **AP-Isolation (Client-Isolation)**         | Viele Router aktivieren AP-Isolation standardmäßig, wodurch Geräte im selben WLAN nicht miteinander kommunizieren können. Das blockiert die Verbindung zwischen Gerät und Drucker |
| **Firewall-Regeln blockieren Druckerports** | Manche Router blockieren standardmäßig Datenverkehr auf Port **9100** (RAW-Druck) oder Port **515** (LPR/LPD) und verhindern, dass Druckaufträge den Drucker erreichen            |

### Schritt-für-Schritt-Fix

<Steps>
  <Step title="Prüfen, ob Drucker und Gerät im selben Subnetz sind">
    Prüfen Sie die IP-Adresse des Druckers, indem Sie die **FEED**-Taste beim Einschalten gedrückt halten, um ein Netzwerkstatusblatt zu drucken. Prüfen Sie dann die IP-Adresse Ihres Geräts in dessen WLAN-/Netzwerkeinstellungen. Beide sollten die ersten drei Oktette teilen (z. B. `192.168.1.x`). Unterscheiden sie sich, verbinden Sie beide mit demselben Router oder VLAN.
  </Step>

  <Step title="AP-Isolation / Client-Isolation deaktivieren">
    Melden Sie sich in der Router-Verwaltung an und suchen Sie nach **AP Isolation**, **Client Isolation** oder **Wireless Isolation** (meist unter **Wireless** → **Advanced Settings**). Schalten Sie es aus, damit Geräte im selben Netzwerk miteinander kommunizieren können. Speichern und Router neu starten.
  </Step>

  <Step title="Prüfen, ob die Router-Firewall den Drucker blockiert">
    Prüfen Sie in der Router-Verwaltung Firewall- oder Zugriffskontrolleinstellungen auf Regeln, die die IP-Adresse des Druckers oder die Ports **9100** und **515** blockieren. Fügen Sie bei Bedarf eine Ausnahme für die Drucker-IP hinzu. Manche Router führen dies unter **Port Filtering** oder **Access Control**.
  </Step>

  <Step title="Statische IP für den Drucker im neuen Netzwerk vergeben">
    Nach einem Router-Wechsel erhält der Drucker möglicherweise eine neue IP-Adresse via DHCP. Reservieren Sie die IP des Druckers in den DHCP-Einstellungen des neuen Routers, damit sie sich nicht ändert. Detaillierte Schritte siehe [Sporadisches Drucken](#sporadisches-drucken-funktioniert-eine-weile-dann-nicht-mehr).
  </Step>
</Steps>

### Star-Micronics-Cloud-Drucker

Star-Micronics-Cloud-Drucker (mit dem Cloud-Druckdienst von storekit) benötigen eine ausgehende Internetverbindung, um Bestellungen zu empfangen — sie verlassen sich nicht allein auf lokalen Netzwerkdruck. Beim Wechsel des Netzwerks muss der Drucker die Cloud-Server von Star erreichen können.

<Warning>
  Wenn die Netzwerk-LED des Druckers dauerhaft grün leuchtet, aber im neuen Netzwerk keine Bestellungen gedruckt werden, blockiert der Router möglicherweise ausgehenden Verkehr zu den Servern von Star.
</Warning>

Prüfen Sie, dass der Drucker vom neuen Netzwerk aus **`*.starmicronics.com`** auf **Port 443** (HTTPS) erreichen kann:

1. Prüfen Sie, dass der Router keine restriktive ausgehende Firewall oder Inhaltsfilterung nutzt, die unbekannte Domains blockiert
2. Wenn Ihr Router einen Whitelist-/Allowlist-Modus hat, ergänzen Sie `*.starmicronics.com` auf Port 443
3. Stellen Sie sicher, dass die DNS-Auflösung funktioniert — der Drucker muss Star-Hostnamen auflösen. Versuchen Sie in den WAN-Einstellungen des Routers einen öffentlichen DNS (z. B. `8.8.8.8`), falls das Standard-DNS unzuverlässig ist

<Tip>
  Verwenden Sie die App **Star Quick Setup Utility** ([iOS](https://apps.apple.com/app/star-quick-setup-utility/id1549088652) / [Android](https://play.google.com/store/apps/details?id=com.starmicronics.starquicksetup)), um den Verbindungsstatus des Druckers nach einem Netzwerkwechsel zu prüfen. Wenn die App den Drucker sieht, aber keine Bestellungen ankommen, liegt es wahrscheinlich an einer ausgehenden Firewall-Regel.
</Tip>

### BT-Router-Nutzer

Wenn der neue Router ein BT Hub oder BT Smart Hub ist, sind Sie möglicherweise ebenfalls von BTs Netzwerkrichtlinie betroffen, die Cloud-Druck-Verbindungen blockiert. Siehe den Abschnitt [BT-Router](#bt-router) oben für konkrete Workarounds, einschließlich Nutzung eines separaten Mobilrouters, Wechsel auf Ethernet und Whitelisting der MAC-Adresse des Druckers.

## Split-Printing-Probleme

### Artikel drucken auf allen Druckern

Die Kategorie wurde keinem bestimmten Drucker zugewiesen. Gehen Sie zu **Menü** → wählen Sie die Kategorie → Tab **Printing** und aktivieren Sie nur den bzw. die gewünschten Drucker.

### Artikel drucken auf falschem Drucker

* Prüfen Sie die Druckeinstellungen der Kategorie
* Deaktivieren Sie Drucker, die diese Kategorie nicht erhalten sollen

## Probleme mit der Druckqualität

### Verblasster oder heller Druck

* Prüfen Sie, ob das Papier korrekt eingelegt ist (Thermoseite nach außen)
* Reinigen Sie den Druckkopf mit Isopropylalkohol
* Ersetzen Sie die Papierrolle, wenn sie alt oder feucht gelagert wurde

### Text zu klein

Versuchen Sie in den Druckereinstellungen die Textgröße **Groß**.

## Werksreset

<Warning>
  Führen Sie einen Werksreset nur als letzten Ausweg durch. Der Drucker muss anschließend neu eingerichtet werden.
</Warning>

Wenn nichts anderes funktioniert:

**Schritt 1: Drucker aus storekit löschen**

1. Öffnen Sie Ihr [storekit-Dashboard](https://dashboard.storekit.com)
2. Navigieren Sie zu **Einstellungen** → **Direct Printing**
3. Klicken Sie neben dem Drucker auf das Papierkorb-Symbol, um ihn zu löschen

**Schritt 2: Drucker zurücksetzen**

1. Schalten Sie den Drucker aus
2. Führen Sie einen Stift in die **RESET**-Öffnung auf der Rückseite ein
3. Drücken Sie bei gedrückter RESET-Taste kurz die **POWER**-Taste
4. Halten Sie RESET weiter gedrückt, bis die grüne Netzwerk-LED blinkt
5. Lassen Sie die RESET-Taste los
6. Drücken Sie die **FEED**-Taste, um die LAN-Schnittstelle auszuwählen
7. Halten Sie FEED gedrückt, um zu bestätigen
8. Der Drucker wird auf Werkseinstellungen zurückgesetzt

**Schritt 3: Erneut einrichten**

[Richten Sie den Drucker erneut ein](/docs/de/guides/printing/printer-setup) von Beginn an.

## E-Mail-Benachrichtigungen

storekit versendet automatisch E-Mail-Benachrichtigungen, wenn Ihre Drucker offline gehen oder wieder online kommen, damit Sie über den Druckerstatus informiert bleiben.

### Offline-Benachrichtigungen

Wenn ein Drucker sich 5 Minuten lang nicht meldet, erhalten Sie eine E-Mail mit:

* **Druckerdetails** — Name, Modell und MAC-Adresse
* **Offline-Zeitpunkt** — Wann der Drucker offline ging
* **Schnellaktionen** — Direkter Link zum Druckerstatus im Dashboard

### Online-Benachrichtigungen

Wenn ein Drucker nach mindestens 5 Minuten Offline-Zeit wieder verbunden ist, erhalten Sie eine Bestätigungs-E-Mail mit:

* **Druckerdetails** — Name und Modell
* **Online-Zeitpunkt** — Wann der Drucker wieder verbunden war
* **Statusbestätigung** — Bestätigung, dass der Drucker Bestellungen empfangen kann

### So erhalten Sie Benachrichtigungen

Stellen Sie sicher, dass die E-Mail-Adresse Ihres Standorts korrekt konfiguriert ist:

1. Gehen Sie in Ihrem Dashboard zu **Ladeneinstellungen**
2. Navigieren Sie zu **Store Details**
3. Prüfen Sie, dass Ihre E-Mail-Adresse korrekt ist
4. Fügen Sie bei Bedarf mehrere E-Mail-Adressen hinzu (die erste Adresse erhält die Benachrichtigungen)

<Tip>
  Druckerstatus-Benachrichtigungen helfen, Konnektivitätsprobleme zu erkennen, bevor sie die Bestellerfüllung beeinträchtigen. Wenn Sie eine Offline-Benachrichtigung erhalten, prüfen Sie sofort Stromversorgung und Netzwerkverbindung des Druckers.
</Tip>

## Vorbestellungsdruck

Vorbestellungs-Bons unterscheiden sich von Live-Bestell-Bons — sie werden zu einem **geplanten Zeitpunkt** anhand Ihrer Puffereinstellung gedruckt, nicht sofort bei Bestellaufgabe. Eine um 10 Uhr aufgegebene Vorbestellung für 14 Uhr Abholung mit einem 30-Minuten-Puffer druckt beispielsweise um 13:30 Uhr.

Siehe [Vorbestellungspuffer](/docs/de/guides/printing/printer-setup#pre-order-buffer), um dieses Timing zu konfigurieren.

### Vorbestellungen werden nicht gedruckt

<Steps>
  <Step title="Puffereinstellung prüfen">
    Gehen Sie zu **Dashboard** → **Ladeneinstellungen** → **Drucker** → wählen Sie Ihren Drucker → prüfen Sie den Wert **Puffer**. Ein Puffer ungleich null verzögert den Druck bis näher an die Erfüllungszeit. Auf `0` setzen, wenn Vorbestellungen sofort gedruckt werden sollen.
  </Step>

  <Step title="Bestätigen, dass der Drucker zum geplanten Druckzeitpunkt online ist">
    Vorbestellungen werden gedruckt, wenn das Pufferfenster erreicht wird — ist der Drucker in diesem Moment offline, wird der Bon nicht gedruckt. Prüfen Sie Ihre [Druckerstatus-Benachrichtigungen](#e-mail-benachrichtigungen) auf Offline-Warnungen rund um den erwarteten Druckzeitpunkt.
  </Step>
</Steps>

### Vorbestellungs-Bon zeigt falsches Datum/Uhrzeit

* **Zeitzoneneinstellungen prüfen** — gehen Sie zu **Dashboard** → **Ladeneinstellungen** → **Store Details** und prüfen Sie, dass die Zeitzone dem physischen Standort Ihres Ladens entspricht. Eine falsche Zeitzone verschiebt alle gedruckten Zeiten.

## Probleme beim Testdruck

### Testdruck funktioniert, echte Bestellungen jedoch nicht

<Steps>
  <Step title="Kategorienzuweisung prüfen">
    Bei Split-Printing gehen Sie zu **Menü** → wählen Sie die Kategorie → Tab **Printing** und prüfen Sie, ob die Kategorie dem richtigen Drucker zugewiesen ist. Ein Testdruck umgeht die Kategorienzuweisung — er kann daher erfolgreich sein, auch wenn keine Kategorien mit dem Drucker verknüpft sind.
  </Step>

  <Step title="Auto-Druck vs. manueller Druck prüfen">
    Ist der Drucker auf **Manuell** eingestellt, werden Bestellungen erst gedruckt, wenn Sie im Dashboard auf die Druckschaltfläche klicken. Wechseln Sie auf **Auto**, damit Bestellungen bei Annahme automatisch gedruckt werden.
  </Step>
</Steps>

### Testdruck schlägt fehl

<Steps>
  <Step title="Drucker neu starten">
    Schalten Sie den Drucker aus, ziehen Sie das Netzkabel, warten Sie 30 Sekunden und schalten Sie den Drucker wieder ein. Siehe [Schneller Neustart](#schneller-neustart).
  </Step>

  <Step title="Verbindung prüfen">
    Prüfen Sie, dass USB- oder Ethernet-Kabel fest verbunden sind. Bei Netzwerkdruckern: Die Netzwerk-LED sollte dauerhaft grün leuchten. Siehe [Verbindungsprobleme](#verbindungsprobleme).
  </Step>

  <Step title="Drucker im Dashboard prüfen">
    Gehen Sie zu **Dashboard** → **Ladeneinstellungen** → **Drucker** und prüfen Sie, dass der Drucker erscheint und als **Online** angezeigt wird. Fehlt er, [fügen Sie ihn erneut hinzu](/docs/de/guides/printing/printer-setup#schritt-3-drucker-in-storekit-hinzufugen).
  </Step>
</Steps>

## Weiterhin Probleme?

1. Senden Sie einen Testdruck aus dem Dashboard, um die Konnektivität zu bestätigen
2. Notieren Sie Fehleranzeigen oder Meldungen
3. Prüfen Sie Druckerstatus-E-Mail-Benachrichtigungen
4. [Wenden Sie sich an den storekit-Support](/docs/de/getting-started/contact-support) mit Ihrem Ladennamen und einer Beschreibung des Problems


## Related topics

- [Einen Star-Micronics-Cloud-Drucker einrichten](/docs/de/guides/printing/printer-setup.md)
- [Menükategorien erstellen und planen](/docs/de/guides/menu/categories.md)
- [Webhook-Events](/docs/de/developers/webhooks/webhook-events.md)
- [6. Cloud-Bondrucker anschließen](/docs/de/getting-started/launch/connect-printing.md)
- [QR-Codes für Ihren storekit-Store herunterladen und drucken](/docs/de/guides/store-settings/qr-codes.md)