Wir haben die Digitale Bon-Lösung unseres Partners anybill realisiert. https://anybill.de/
Um diese Integration zu nutzen, müssen folgende Einrichtungsschritte durchgeführt werden.
Zunächst benötigen Sie seitens anybill Zugangsdaten, um die Integration nutzen zu können:
- Benutzername
- API-Passwort
- API-ClientID
- für jede Filiale: eine sog. StoreID
Mithilfe dieser Parameter kann die Einrichtung der anybill-Integration für die jeweilige Filiale kassenseitig durchgeführt werden.
In den Parametereinstellungen sind dafür folgende Parameter zu pflegen:
WICHTIG!!!: Allgemeine Parameter
Für jede Filiale eines Kunden müssen neben den untenstehenden anybill-Parametern, folgende Parameter konfiguriert sein:
- EIGENERORT
- EIGENESTRASSE
- EIGENERNAME
- EIGENEPLZ
- EIGENESLAND (= DE, immer 2 stellig!!!)
Anybill Parameter
| name | Zu setzender Wert | Information |
|---|---|---|
| ANYBILL | J | Default auf N, auf J setzen um die anybill-Integration zu verwenden |
| ANYBILLSTOREID | von Anybill erhaltene StoreID für die zu konfigurierende Filiale | anybill Store-ID der Filiale |
| ANYBILLARTZUSTEXT | J/N | Ist dieser Parameter auf J gesetzt kann mit dem nächsten Parameter konfiguriert werden, dass auf dem Bon ein weiterer Artikelzusatztext zu einem Artikel auf den Bon gedruckt wird. |
| ANYBILLARTZUSTEXTDEF | Erlaubte Werte: 0 - artzus, 1 - artnr3, 2 - artzus2 | Datenbankfeld für Artikelzusatztext konfigurieren |
| ANYBILLBONLOGO | J/N | Auf "J" setzen, wenn ein eigenes Logo auf dem anybill Bon abgedruckt werden soll |
| ANYBILLBONLOGOURL | Zu setzen, wenn der ANYBILLBONLOGO auf J steht | Logo-URL für eigenes Log auf anybill-Bon (z.B. Verlinkung von der eigenen Webseite) |
| ANYBILLKDDATENWEITERGEBEN | N | Dieser Parameter entscheidet darüber, ob die Bons anonym an anybill gesendet werden oder ob, wenn ein Kunde in der Kasse angemeldet wurde, dessen Kundendaten mit an anybill mitgeschickt werden sollen. |
| ANYBILLSTEUERBEFREIUNG | N | Sie sind ein komplett steuerbefreites Unternehmen? Dann stellen Sie diesen Parameter auf "J" ein. |
| ANYBILLSTEUERBEFREIUNGGRUND | Grund der Steuerbefreiung hier eintragen | Tragen Sie hier einen Grund für ihre Steuerbefreiung ein. |
| ANYBILLPASSWORD | von Anybill erhaltenes API-Passwort | Passwort für OAuth 2.0 Token Generierung |
| ANYBILLUSERNAME | von Anybill erhaltener API-Benutzername | Username für OAuth 2.0 Token Generierung |
| ANYBILLCLIENTID | von Anybill erhaltene API-Client-ID | Client-ID für OAuth 2.0 Token Generierung |
ANYBILLAPIURL | Default: https://vendor.anybill.de/api/v3/bill | Gewünschter API Endpoint von Anybill |
ANYBILLAUTHURL | Default: https://adanybill.b2clogin.com/ad.anybill.de/oauth2/v2.0/token?p=b2c_1_ropc_vendor | Aktuell gültiger OAuth 2.0 Endpoint von Anybill für Bearer Tokens |
| ANYBILLDISPLAYTARGET | PosDisplay | Ausgabegerät (PosDisplay, VerifoneTerminal, None) |
| ANYBILLWARTEAUFBON | N/J | Wird dieser Parameter auf "J" gesetzt, wird der QRCode etwas später angezeigt, da auf die Erstellung des sonst üblichen eigenen Bons gewartet wird und dieser anschließend mit an anybill gesendet wird, so dass dieser dem Kunden auch zur Verfügung gestellt werden kann, neben dem anybill Bon. |
Wenn die Parameter in den Kassen entsprechend so konfiguriert sind, steht der Verwendung von anybill nichts mehr im Wege, wenn alle von anybill erhaltenen Daten korrekt eingepflegt wurden.
Die Kasse prüft bereits beim Starten, ob Sie sich mit den Daten erfolgreich bei anybill anmelden kann, wenn dies nicht erfolgt, gibt die Kasse dem Kassierer einen entsprechenden Hinweis.
Sollte die anybill-API im seltenen Fall mal nicht zu erreichen sein beim Kassiervorgang, so können keine Daten an anybill gesendet werden, also wird auch kein Bon von anybill erstellt und es kann für den Kunden kein QRCode generiert und angezeigt werden.
Daher ist es dann erforderlich, dass dem Kunden manuell ein Beleg ausgedruckt wird. Der Kassierer erhält hierüber eine Information, die wie folgt aussieht und bestätigt werden muss:
Der Nachdruck des Bons kann über die Funktion Belege → Alle Belege → Beleg auswählen → Drucken erfolgen.
Android
Unter Android wird der QR-Code für den Kunden in einem Dialog angezeigt:
