Zum Inhalt springen

Die Synchronisation von KORONA.studio verstehen

Die KORONA Event-Unterstützung bindet das KORONA.studio-Ökosystemmodul ein, bevor das Konto übergeben wird. In diesem Artikel erfahren Sie, welches System Eigentümer der gemeinsam genutzten Daten ist und wann synchronisierte Änderungen verfügbar werden.

Integrationseinstellungen und Verbindungsstatus im Backoffice
Im Bereich „Integrationen“ werden der Synchronisationsstatus von KORONA.studio sowie die gemeinsam genutzten Einstellungen angezeigt.

Bevor Sie beginnen

Bitte stellen Sie sicher, dass Sie wissen, zu welchem KORONA.studio-Konto die Stammdaten dieses KORONA Event-Kontos gehören. Ändern Sie die KORONA.studio-Synchronisierungsdaten oder Service-URLs nicht, es sei denn, der KORONA Event-Support fordert Sie dazu auf. Der unten beschriebene API-Schlüssel für externe KORONA POS-Aufrufe ist davon getrennt und kann über die Benutzerverwaltung ersetzt werden.

Den Synchronisationsstatus ermitteln

  1. Öffnen Sie im Backoffice Verwaltung > Integrationen.
  2. Suchen Sie nach der KORONA.studio-Integration.
  3. Über Letzte erfolgreiche Synchronisierung können Sie einsehen, wann der letzte Import abgeschlossen wurde.
  4. Sollte die Verbindung unterbrochen sein oder die Synchronisierung fehlschlagen, wenden Sie sich bitte an den KORONA Event-Support. Erstellen Sie keine doppelten Stammdaten in KORONA Event, solange die Verbindung wiederhergestellt wird.

Was wird in welche Richtung synchronisiert?

Von KORONA.studio in KORONA Event:

  • Produkte und deren Preise
  • Zahlungsmethoden, Währungen und Umsatzsteuern
  • Verkaufspunkte, Kassierer, Organisationseinheiten und Bereiche
  • Tags, Ticketdefinitionen, Kundengruppen und Wirtschaftszonen
  • Gutscheinkonfigurationen und Gutscheine, sofern das Gutscheinpaket im KORONA-Konto aktiv ist
  • Belege, die in regelmäßigen Abständen importiert werden

Von KORONA Event zu KORONA.studio:

  • Rechnungen und steuerliche Lieferscheine
  • den Vorgängen zugeordnete Kundendaten, einschließlich der Leitweg-ID eines Unternehmens, sofern vorhanden
  • In KORONA Event erstellte Tags

Bei Kundenimporten wird zudem eine KORONA.studio-Käuferreferenz als Leitweg-ID des Unternehmens in KORONA Event übernommen. Von KORONA Event erstellte E-Rechnungen verwenden den zum Zeitpunkt der Rechnungsstellung beim Kunden gespeicherten Wert; eine spätere Änderung dieses Werts führt nicht zu einer Neufassung einer bereits bestehenden Rechnung.

Nach der ersten Synchronisierung werden Importe etwa alle 15 Minuten wiederholt, während Exporte kontinuierlich ausgeführt werden. Vorübergehende Fehler werden automatisch erneut versucht und können zu Verzögerungen bei den Aktualisierungen führen. Unter „Letzte erfolgreiche Synchronisierung“ wird angezeigt, wann ein Import zuletzt erfolgreich abgeschlossen wurde.

Einen Standard-Kassierer auswählen

Wählen Sie unter Verwaltung > Integrationen > KORONA.studio-Integration den Standard-Kassierer aus und anschließend Speichern und synchronisieren. Wählen Sie einen aktiven Kassierer, der für diese Exporte geeignet ist. KORONA Event wählt keinen Standard automatisch aus.

Rechnungs- und Lieferscheinexporte für Vorgänge aus dem Online-Shop oder der API ohne Mitarbeiter benötigen diesen Standard. Wenn die Integration aktiviert ist und kein geeigneter Standard ausgewählt wurde, erscheint ein Hinweis. Bei Vorgängen mit Mitarbeiter hat ein geeigneter, dem Benutzer zugeordneter Kassierer Vorrang.

KORONA Event ordnet einem Benutzer automatisch einen Kassierer zu, wenn genau ein geeigneter Kassierer dieselbe E-Mail-Adresse hat. Groß- und Kleinschreibung spielt dabei keine Rolle. Dies gilt beim Kassiererimport und wenn ein Benutzer dem Konto beitritt, auch über eine Einladung. Bestehende Zuordnungen bleiben erhalten. Wenn mehrere geeignete Kassierer dieselbe E-Mail-Adresse haben, wählen Sie die richtige Zuordnung unter Verwaltung > Benutzer aus.

Nach der Korrektur eines fehlenden Kassierers werden fehlgeschlagene Lieferscheine innerhalb von etwa einer Stunde automatisch erneut exportiert. Legen Sie den Vorgang nicht erneut an, um einen weiteren Export auszulösen.

Preise im Online-Shop während einer Störung des Warenkorb-Dienstes

Sollte der KORONA-Warenkorb-Service vorübergehend nicht verfügbar sein, können reguläre Online-Buchungen weiterhin unter Verwendung der in KORONA Event gespeicherten Preise erfolgen. Automatische Rabatte, die den nicht verfügbaren Service erfordern, werden nicht gewährt. Den Kunden wird die lokale Warenkorb-Summe ohne Hinweis auf die Ausfallzeit angezeigt. Bestehende, durch Gutscheine festgelegte Preise und Beleglimits gelten weiterhin.

Ein externer Rabattcode muss validiert werden, bevor er verwendet werden kann. Ist eine Validierung nicht möglich, erhält der Kunde eine Fehlermeldung und kann es später erneut versuchen oder den Code entfernen, um zu den lokalen Preisen fortzufahren. Lokal konfigurierte Promotionscodes unterliegen weiterhin ihren üblichen Regeln. Die Preise bereits abgeschlossener Vorgänge werden nicht automatisch neu berechnet, wenn der Dienst wieder verfügbar ist.

Externe Systemaufrufe

Sobald diese Funktion aktiviert ist, verwaltet KORONA Event den Rückruf für die Stornierung von Kassenbelegen in jedem importierten Kassenprofil. Wenn die Verarbeitung steuerlicher Lieferscheine aktiviert ist, verwaltet KORONA Event außerdem den Rückruf für den Abschluss von Lieferscheinen. Vorhandene externe Systemaufrufe in einem Profil bleiben erhalten. KORONA Event ändert deren KORONA-Nummern nicht.

Öffnen Sie Verwaltung > Integrationen und suchen Sie Externe Systemaufrufe, um diese Rückrufe zu prüfen. Synchronisiert bedeutet, dass die Aufrufe mit den importierten Kassenprofilen verknüpft sind. Wenn ein Rückruf Reparatur erforderlich oder Nicht synchronisiert anzeigt, wählen Sie Synchronisieren und reparieren. Der nächste erfolgreiche vollständige KORONA.studio-Import repariert die verwalteten Rückrufe ebenfalls.

Der Abschnitt zeigt weiterhin die Anmeldung, ein maskiertes Passwort und die Anzeige-URLs für Vorgänge, Leistungen und Agenda. Konten mit verwalteten externen Systemaufrufen verwenden die stabile Anmeldung KORONA_EVENT; bei anderen Konten bleibt die vorhandene Plattformanmeldung bestehen. Das maskierte Passwort zeigt, welcher API-Schlüssel eingerichtet ist, kann dessen Geheimnis jedoch nicht wiederherstellen.

Um das Passwort einzurichten oder zu ersetzen, benötigen Sie die Berechtigung zur Benutzerverwaltung:

  1. Öffnen Sie Verwaltung > Nutzer und wählen Sie den dedizierten Integrationsnutzer für die KORONA POS-Verbindung aus.
  2. Wählen Sie unter API-Schlüssel die Option API-Schlüssel erstellen.
  3. Kopieren Sie den Wert aus Neuer API-Schlüssel sofort. Er wird nur einmal angezeigt. Speichern Sie ihn sicher und tragen Sie ihn in KORONA POS als Passwort ein. Verwenden Sie außerdem die unter Externe Systemaufrufe angezeigte Anmeldung und die benötigten Anzeige-URLs.
  4. Sobald der Ersatz funktioniert, wählen Sie beim alten maskierten Schlüssel API-Schlüssel widerrufen. Falls ein Schlüssel vor dem Speichern verloren geht, erstellen Sie einen neuen; der maskierte Wert kann nicht wiederhergestellt werden.

Eine POS-Stammaktion veröffentlichen

Bei Konten mit verwalteten externen Systemaufrufen können Administratoren Stammaktionen für Leistungen, Vorgänge und Agenda veröffentlichen:

  1. Öffnen Sie Verwaltung > Integrationen > Externe Systemaufrufe > POS-Anzeigeaktionen.
  2. Aktualisieren Sie das Inventar vorhandener Aufrufe. Prüfen Sie passende Aufrufe und übernehmen Sie den gewünschten Aufruf. Wählen Sie bei Bedarf Für diese Aktion verwenden. Ein passender Name allein erlaubt keine Änderungen. Mehrere absichtlich eingerichtete Aufrufe können im Inventar bestehen bleiben.
  3. Wählen Sie für die gewünschte Seite Aktion veröffentlichen. Wenn nach dem vollständigen Einlesen kein passender Aufruf vorhanden ist, wird einer erstellt. Ist das Ergebnis unklar, aktualisieren Sie das Inventar und übernehmen Sie den entstandenen Aufruf vor einem erneuten Versuch. Erstellen Sie keinen zweiten Aufruf von Hand.
  4. Notieren Sie Name und Nummer des KORONA-Aufrufs. Solange KORONA keine Nummer geliefert hat, wird stattdessen die Kennung angezeigt.
  5. Fügen Sie den externen Systemaufruf in KORONA.studio dem passenden Kassentastenlayout hinzu, verteilen Sie das Layout und öffnen Sie es an der Kasse. Prüfen Sie die Seite und die Filter, bevor Sie die Taste im Besucherbetrieb einsetzen.

Die Veröffentlichung bearbeitet kein Tastenlayout. Eine erneute Veröffentlichung verwendet den ausgewählten Aufruf weiter; Nummer, eigener Name, Zeitlimits und bestätigte Einstellungen bleiben erhalten. Ein übernommener Aufruf muss bereits die gewählte Seite oder Ansicht öffnen. Andernfalls bearbeiten Sie seine Anzeige-URL im Inventar, prüfen die Vorschau und wenden die Änderung an. Wiederholen Sie danach die Veröffentlichung.

Veröffentlichung prüfen bestätigt eine vorhandene Aktion. Veröffentlichung aufheben deaktiviert den ausgewählten KORONA-Aufruf. Andere Aufrufe und Layouttasten bleiben erhalten. Belegstornierung und der bedingte Abschluss fiskalischer Lieferscheine bleiben getrennte Rückrufaktionen an Kassenprofilen; sie sind keine Anzeigeaktionen für Tasten.

Verwenden Sie für eine Anzeigeaktion der Version 1 GET und lassen Sie die System-Rückruf-URL leer. Prüfen Sie Aufrufe mit anderen Starteinstellungen vor der Veröffentlichung im Inventar.

Die angezeigte Aktionsversion bezeichnet die bei der Erstellung gewählten Vorgaben. Die Synchronisation erhält bestätigte Einstellungen. Eine neue Softwareversion aktualisiert bestehende Aktionen nicht automatisch und stellt GET-Aufrufe nicht auf POST um.

Eine gespeicherte Ansicht als Kassenaktion veröffentlichen

  1. Öffnen Sie die passende Liste im Backoffice und speichern Sie die für die Kasse gewünschten Filter als Ansicht.
  2. Wählen Sie die Ansicht, öffnen Sie ihr Aktionsmenü und wählen Sie für ein verfügbares Ziel Als Kassenaktion „…“ veröffentlichen.
  3. Verwenden Sie den angezeigten Aufrufnamen und die Nummer für die oben beschriebene Einrichtung des Kassentastenlayouts in KORONA.studio.
Liste der gespeicherten AnsichtPOS-ZielUnterstützte Filter
VorgängeVorgängeNative Vorgangsfilter, unter anderem Status, Kunde, Produkt, Event und Tags
EventsAgendaNative Eventfilter, unter anderem Eventvorlagen, Ressourcen und Tags
Eventvorlagen, Eintritte, Produkte, GutscheineLeistungenNur Text und Tags; die Liste der Ansicht beschränkt außerdem den Angebotstyp

Für Leistungen sind beispielsweise Ort, Datum, Veröffentlichungsstatus, Preis, Produkteigenschaften und Sortierung nicht verfügbar. Eventinstanz- und Vorgangsansichten können nicht für Leistungen veröffentlicht werden. Das Menü nennt nicht unterstützte Filter. Entfernen Sie diese aus der Ansicht oder verwenden Sie das native Ziel. Leistungen zeigt weiterhin nur für den aktiven Verkaufspunkt verfügbare Artikel. Eine gespeicherte Ansicht macht unveröffentlichte oder nicht verfügbare Artikel nicht verkaufbar. An der Kasse eingegebener Suchtext ersetzt den gespeicherten Suchtext; Tags und Angebotstyp bleiben eingeschränkt. Vorgänge und Agenda behalten ihre eigenen Datums- und Sortiersteuerelemente.

Nur ausdrücklich ausgewählte Ansichten werden veröffentlicht. Änderungen am Namen oder an den Filtern erhalten Aufrufnamen, Nummer und bestätigte Einstellungen. Wird eine veröffentlichte Ansicht durch eine Änderung inkompatibel, wird ihr Aufruf mit einem Hinweis auf die gespeicherte Ansicht blockiert. Prüfen Sie die Filter oder heben Sie die Veröffentlichung auf. Das bleibt auch bei inkompatiblen Ansichten möglich.

Wählen Sie im Ansichtsmenü Kassenaktion „…“ zurückziehen, um den ausgewählten verwalteten Aufruf über den bestätigten Ablauf zu deaktivieren. Kann die Deaktivierung nicht bestätigt werden, bleiben Ansicht und Zuordnung zur Wiederherstellung erhalten. Aktualisieren Sie das Inventar, prüfen Sie den Fehler, prüfen und übernehmen Sie die ausstehende Konfiguration und versuchen Sie es erneut. Ein nach einer Zeitüberschreitung möglicherweise erstellter Aufruf muss vor der Bereinigung wiedergefunden und übernommen werden. Entfernen Sie die inaktive Taste anschließend bei Bedarf von Hand aus dem Layout.

Bevor Sie eine gespeicherte Ansicht mit einer verwalteten Kassenaktion löschen, ziehen Sie die Aktion zurück und warten Sie auf die bestätigte Deaktivierung. Das Löschen der Ansicht ändert keine KORONA-Aufrufe.

Die Veröffentlichung gespeicherter Ansichten ist nur bei Konten mit verwalteten externen Systemaufrufen verfügbar und erfordert die Berechtigung zum Bearbeiten gespeicherter Ansichten. Für Stammaktionen ist die Berechtigung zum Ändern der Integrationseinstellungen erforderlich.

Bei Konten ohne verwaltete Veröffentlichung wählen Sie eine gespeicherte Ansicht unter Events oder Vorgänge aus, öffnen Sie das Aktionsmenü und wählen Sie Verkaufspunkt-URL kopieren. Der Link einer Eventansicht öffnet Agenda mit dieser Ansicht; der Link einer Vorgangsansicht öffnet Vorgänge. Zum Kopieren sind die Berechtigung zum Lesen gespeicherter Ansichten sowie eine POS-Adresse des Kontos erforderlich. Verwenden Sie die kopierte URL für den manuell konfigurierten externen Systemaufruf in KORONA.studio, und zwar mit dem aktuellen Anmeldung unter Verwaltung > Integrationen sowie dem sicher gespeicherten API-Schlüssel. Durch das Kopieren der URL wird keine Kassenschaltfläche erstellt oder geändert.

Feed anzeigen öffnet einen Kalender-Abonnement-Feed und keine Kassenanzeige. Verwenden Sie die ICS-Adresse nicht als Agenda-Aktion. Falls weder eine Kopier- noch eine Veröffentlichungsaktion verfügbar ist, wenden Sie sich bitte an den KORONA Event-Support, um Unterstützung bei der POS-Einrichtung Ihres Kontos zu erhalten.

Die Stamm-Display-URLs unter Externe Systemaufrufe öffnen ihre Bildschirme ohne gespeicherte Ansicht.

Fehlerbehebung

ProblemWas Sie überprüfen sollten
Die Synchronisierung schlägt sofort fehlWenden Sie sich an den KORONA Event-Support; ändern Sie die KORONA.studio-Synchronisierungsdaten oder Service-URLs nicht, es sei denn, Sie werden dazu aufgefordert.
Der Abschnitt zeigt Nicht synchronisiert anWenden Sie sich bitte an den KORONA Event-Support, bevor Sie Datensätze, die Eigentum von KORONA.studio sind, lokal anlegen oder ändern.
Die Produkte oder Preise sind veraltetWenn der Eintrag unter Letzte erfolgreiche Synchronisierung zuletzt aktualisiert wurde, korrigieren Sie die Daten in KORONA.studio und warten Sie anschließend auf den nächsten Import oder wählen Sie Synchronisieren.
Ein Datensatz ist in KORONA.studio vorhanden, jedoch nicht in KORONA EventOb sich die Letzte erfolgreiche Synchronisierung nach der Änderung des Datensatzes aktualisiert hat.
Ein verwalteter Rückruf zeigt Reparatur erforderlichWählen Sie Synchronisieren und reparieren. Wenn dies erneut fehlschlägt, notieren Sie den angezeigten Fehler und wenden Sie sich an den KORONA Event-Support.

Verwandte Artikel