poe Doku

Einrichtung

Erklärung / Mehrwert

Die Anbindung IC2 Integra verbindet POSMAN über Webservices direkt mit Global Blue. Der Kassierer aktiviert Tax Free am Bon, beim Bon-Abschluss öffnet sich die Oberfläche von Global Blue als Overlay in der Kassenoberfläche und POSMAN druckt das zurückgelieferte Tax-Free-Formular aus.

Bisher war dafür auf jedem Kassenarbeitsplatz ein eigenes Global-Blue-Programm installiert, das die Daten über Dateiaustausch erhalten hat. Mit der Webservice-Anbindung entfällt diese lokale Installation: Es gibt nichts mehr je Arbeitsplatz zu installieren und zu aktualisieren, die Verkaufsdaten des Bons werden direkt übergeben und Änderungen an der Global-Blue-Oberfläche kommen zentral von Global Blue.

Beide Varianten bestehen nebeneinander. Je Kasse ist genau eine aktiv, gesteuert über den Parameter TAXFREE: V für die bisherige Anbindung, W für IC2 Integra.

Dieses Kapitel beschreibt die Einrichtung durch den Administrator. Der Ablauf an der Kasse steht im Kapitel „Tax Free mit Global Blue (IC2 Integra) – Bedienung an der Kasse".

Voraussetzungen

●       Ein Vertrag mit Global Blue. Benutzername, Passwort, Shop-Kennung und Desk-Kennung stellt Global Blue je Shop bereit.

●       WebUI 2 an der Kasse (WEBUION = 2). Das Overlay und die Statusanzeige laufen über die WebUI-2-Oberfläche.

●       Netzwerkfreigabe für *.globalblue.com über Port 443. Wird der Pass-Scan über die Kamera genutzt, zusätzlich reporting.anyline.com über Port 443. Ein Proxy wird über HTTPWINPROXYON unterstützt.

●       Eine Druckvorlage vom Typ 32 (Taxfree-Beleg Global Blue) für den Formulardruck.

●       Der Parameter FISKALLAND muss zum Land des Global-Blue-Shops passen.

●       Die Zahlarten der Kasse müssen korrekt typisiert sein. Aus der Typisierung leitet POSMAN die Zahlart ab, die an Global Blue gemeldet wird.

Hinweis: Die aktuelle Ausbaustufe ist für Deutschland und Belgien abgestimmt. Für weitere Länder gelten zusätzliche Anforderungen von Global Blue; sprechen Sie uns dazu an.

Dokumentation

Parameter setzen

Die folgenden Parameter steuern die Anbindung. Benutzername und Passwort sind Zugangsdaten des Shops und gehören weder in Tickets noch in Mails.

Parameter

Wert

Beschreibung

TAXFREE

W

Aktiviert IC2 Integra. V steht für die bisherige Anbindung. Ohne W wird das Modul nicht geladen.

WEBUION

2

Zwingend. Die Global-Blue-Oberfläche läuft als Overlay in der WebUI-2-Kassenoberfläche.

TAXFREEGBI2URL

Basis-URL

Basis-URL des Global-Blue-Systems ohne Pfadangaben. Testsystem: https://ic2integra.test.globalblue.com , Produktivsystem: https://ic2integra.globalblue.com .

TAXFREEGBI2USER

von Global Blue

Benutzername, gilt je Shop.

TAXFREEGBI2PASSWORD

von Global Blue

Passwort zum Benutzer.

TAXFREEGBI2SHOPID

von Global Blue

Shop-Kennung.

TAXFREEGBI2DESKID

von Global Blue

Desk-Kennung der Kasse. Sie steuert bei Global Blue auch, ob das Formular als Bontext oder als A4-PDF geliefert wird.

TAXFREEGBI2LANGUAGE

de

Sprache der Global-Blue-Oberfläche, zum Beispiel de, en-gb oder fr.

TAXFREEGBI2LOGODRUCK

d oder 1 bis 3

Zoll-Logo auf dem Formular. d lädt die Logodatei zur Laufzeit aus dem Kassenordner; sie muss dort unter dem Namen liegen, den Global Blue im Formular angibt (üblich taxfree_std.LGO im dl-Format). 1 bis 3 drucken aus dem permanenten Druckerspeicherplatz.

TAXFREEGBI2AUTODETECT

0, 1 oder 2 (leer = 0)

Automatische Eignungsprüfung. 0: Prüfung erst nach der Aktivierung am Bon. 1: zusätzlich bei Kundenanmeldung oder Landauswahl mit einem Nicht-EU-Land, das Ergebnis wird dem Kassierer als Frage angeboten. 2: zusätzlich stille Prüfung bei jeder Summenänderung.

TAXFREEGBI2MSGBOXEN

J oder N (leer = N)

J: Meldungen erscheinen als Dialogboxen. N: Meldungen laufen ausschließlich über die Statusanzeige. Blockierende Fehlermeldungen beim Bon-Abschluss erscheinen immer als Dialogbox.

TAXFREEGBI2ACTIVETEXT

GB

Text, der im Statusfeld globalblue/active steht, solange Tax Free für den Bon aktiv ist. Ohne Aktivierung bleibt das Feld leer.

TAXFREEGBI2ARTNR

Feldname (leer = artnr1)

Quelle der Artikelnummer, die an Global Blue übergeben wird: artnr1, artnr2, artnr3 oder arttxt. Ist das gewählte Feld am Artikel leer, wird artnr1 verwendet.

TAXFREEGBI2ARTBEZ

Feldname (leer = artbez)

Quelle der Artikelbezeichnung: artbez, arttxt, artzus2 oder kombi, also artbez und arttxt in einem Feld. Ist das gewählte Feld leer, wird artbez verwendet.

FISKALLAND

Länderkürzel

Bestehender Parameter, der mitgenutzt wird: das Shop-Land im Beleg an Global Blue. Es muss zum eingerichteten Shop passen, sonst werden Belege abgelehnt. Leer: EIGENESLAND.



 Hinweis: Die Artikelnummer und die Artikelbezeichnung sollen auf dem Tax-Free-Formular dem Bonbild entsprechen. Diese können mit TAXFREEGBI2ARTNR und TAXFREEGBI2ARTBEZ für den Global Blue Ausdruck angepasst werden.

Tasten im WebUI belegen

Für Tax Free stehen die folgenden Tastenfunktionen zur Verfügung:

Tastenfunktion

Zweck

TaxFreeGlobalBlueI1

Tax Free für den laufenden Bon aktivieren. Die Taste wird von beiden Anbindungen genutzt.

TaxFreeGlobalBlueI1Karte

Reisenden-Kennung als Freitext erfassen: Global-Blue-Karte, Reisepass oder Handynummer.

TaxFreeGlobalBlueI1NeuDruck

Nachdruck des zuletzt an dieser Kasse ausgestellten Formulars.

TaxFreeGlobalBlueI1Direkt

Global Blue nachträglich für den letzten abgeschlossenen Bon der Kasse.

TaxFreeGlobalBlueI1Auswahl

Wie TaxFreeGlobalBlueI1Direkt, jedoch mit Auswahlbrowser über die Bons der eigenen Kasse seit dem letzten Tagesabschluss.


Beispiel für die Taste zum Aktivieren von Global Blue im Vorgang an der Kasse.
Die Beschriftung der Tasten ist frei wählbar. In den Abbildungen dieses Kapitels heißt die Aktivierungstaste „GB OptIn". Die Tasten werden im WebUI-Editor im Kassenlayout angelegt:

  1. Öffnen Sie das Kassenlayout im WebUI-Editor.

  1. Ziehen Sie eine Taste an die gewünschte Position oder wählen Sie eine vorhandene Taste aus.

  1. Tragen Sie unter „Name" die Beschriftung ein.

  1. Wählen Sie unter „Tasten-Funktion" den Eintrag TaxFreeGlobalBlueI1 aus.

  1. Klicken Sie auf „Speichern".

grafik-20260827-124913.png

Scan-Template für die Global-Blue-Karte anlegen

Der Scan einer Global-Blue-Karte wirkt wie die Aktivierungstaste und übernimmt zusätzlich die Kennung des Reisenden. Legen Sie dazu in der Tabelle scantemplate einen Eintrag vom Typ 23 (GlobalBlueKarte) an.

Empfohlenes Muster, dreifach gegen Verwechslungen mit EANs und Zahlkarten verriegelt:

●       Match-Pattern 3086????????????# – festes Präfix 3086 und genau 16 Stellen

●       Prüfziffer nach Luhn, also checktyp = 2

●       Interpretation {16;GBKARTE} – die vollen 16 Stellen gehen als Kennung in das Tax-Free-Modul

Einrichtung mit Global Blue abstimmen

Global Blue konfiguriert einige Funktionen auf seiner Seite je Shop- und Desk-Kennung. Stimmen Sie deshalb vorab ab, welche Kassenkategorien es gibt und welche Funktionen dort aktiv sein sollen:

●       Bildschirmtastatur in der Global-Blue-Oberfläche, wenn die Kasse keine Hardware-Tastatur hat

●       Integrierte Erfassung über die Kamera, wenn die Kasse über eine geeignete Kamera verfügt

Rabatte und länderabhängige Vorgaben

Rabattartikel, also Rabatte als eigene negative Bon-Position, dürfen bei Tax-Free-Nutzung in Österreich und Frankreich nicht verwendet werden: Die Vorgaben von Global Blue verbieten dort Positionen mit einem Betrag von null oder darunter. In Spanien sind Rabattzeilen derzeit ebenfalls nicht zu verwenden. Für Deutschland und Belgien gibt es keine ausdrückliche Regelung.

Einrichtungsregel: Bilden Sie Rabatte bei Tax-Free-Nutzung grundsätzlich als Positions- oder Zwischensummenrabatt ab, also eingerechnet in den Artikelpreis. POSMAN meldet dann die bereits rabattierten Bruttobeträge je Position und die an Global Blue übergebenen Beträge sind in allen Ländern korrekt. Rücknahmen werden davon unabhängig nie an Global Blue gemeldet.

Auswirkung

Nach der Einrichtung

●       steht die Aktivierungstaste am Bon zur Verfügung und der Kartenscan wirkt wie diese Taste

●       druckt POSMAN das Tax-Free-Formular nach der Ausstellung automatisch über die Druckvorlage Typ 32