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. Diese umfassen
- Benutzername
- API-Passwort
- API-ClientID
- sowie 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:
Allgemeine Parameter 
Für jede Filiale müssen neben den untenstehenden anybill-Parametern, folgende Parameter konfiguriert sein. Diese Informationen druckt anybill auf den Bon.
- EIGENERORT
- EIGENESTRASSE
- EIGENERNAME
- EIGENEPLZ
- EIGENESLAND (z.B.: DE, immer 2 stellig )
- EIGENESTID, anybill will die EIGENEUSTID in Zukunft auch umsetzen.
anybill Parameter
| name | Zu setzender Wert | Information | POSMAN Version |
|---|---|---|---|
| ANYBILL | J | Default auf N, auf J setzen um die anybill-Integration zu verwenden | 2.242.0 |
| ANYBILLSTOREID | von anybill erhaltene StoreID für die zu konfigurierende Filiale | anybill Store-ID der Filiale | 2.242.0 |
| 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. | 2.242.0 |
| ANYBILLARTZUSTEXTDEF | Erlaubte Werte: 0 - artzus, 1 - artnr3, 2 - artzus2 | Datenbankfeld für Artikelzusatztext konfigurieren | 2.242.0 |
| ANYBILLBONLOGO | J/N | Auf "J" setzen, wenn ein eigenes Logo auf dem anybill Bon abgedruckt werden soll. | 2.242.0 |
| ANYBILLBONLOGOURL | Zu setzen, wenn der ANYBILLBONLOGO auf J steht | Logo-URL für eigenes Logo auf anybill-Bon (z.B. Verlinkung von der eigenen Webseite) | 2.242.0 |
| ANYBILLKDDATENWEITERGEBEN | J/N | Dieser Parameter entscheidet darüber, ob die Bons anonym an anybill gesendet werden oder ob, wenn ein Kunde an der Kasse angemeldet wurde, dessen Kundendaten an anybill mitgeschickt werden sollen. | 2.242.0 |
| ANYBILLSTEUERBEFREIUNG | J/N | Sie sind ein komplett steuerbefreites Unternehmen? Dann stellen Sie diesen Parameter auf "J" ein. | 2.242.0 |
| ANYBILLSTEUERBEFREIUNGGRUND | Grund der Steuerbefreiung hier eintragen | Tragen Sie hier einen Grund für ihre Steuerbefreiung ein. | 2.242.0 |
| ANYBILLPASSWORD | von anybill erhaltenes API-Passwort | Passwort für OAuth 2.0 Token Generierung | 2.242.0 |
| ANYBILLUSERNAME | von anybill erhaltener API-Benutzername | Username für OAuth 2.0 Token Generierung | 2.242.0 |
| ANYBILLCLIENTID | von anybill erhaltene API-Client-ID | Client-ID für OAuth 2.0 Token Generierung | 2.242.0 |
ANYBILLAPIURL | Default: https://vendor.anybill.de/api/v3/bill | Gewünschter API Endpoint von anybill | 2.242.0 |
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 | 2.242.0 |
| ANYBILLDISPLAYTARGET | PosDisplay | Ausgabegerät (PosDisplay, VerifoneTerminal, None) | 2.242.0 |
| ANYBILLWARTEAUFBON | J/N |
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, sodass dieser dem Kunden auch zur Verfügung gestellt werden kann (neben dem anybill Bon). Dies kann allerdings umgangen werden, in dem man den Parameter ANYBILLQRCODEFRUEH aktiviert. | 2.243.0 |
| ANYBILLQRCODEUNTERSCHRIFT | Jetzt Kassenbon scannen | Text, der im Kundendisplay unter dem QR-Code von anybill angezeigt wird. | 2.242.0 |
| ANYBILLNUREIGENERBON | J/N | Deaktiviert den von anybill generierten Bon und zeigt dem Kunden stattdessen den Bon, der von der Kasse ausgestellt wurde.
| 2.243.0 |
| ANYBILLQRCODEFRUEH | J/N | Ermöglicht es, den QR-Code für den Kunden bereits beim Kassieren des ersten Artikels anzuzeigen. Der Kunde kann ihn dann bereits einscannen und die URL aufrufen. Der Bon erscheint später automatisch auf dieser URL. | 2.243.0 |
| ANYBILLBESTAETIGUNG | J/N | Dieser Parameter ermöglicht es eine zusätzliche Bestätigung in den Kassiervorgang einzubauen. Der Kassierer muss dann zu Beginn eines neuen Kassiervorganges bestätigen, ob der Kunde anybill nutzen möchte oder nicht. Ist der Parameter aus, wird immer anybill gemacht, sofern das Modul aktiviert ist. (Nicht abgerufene Bons werden irgendwann gelöscht von anybill, könnten so aber ganz vermieden werden, wenn gewünscht). | 2.249.0 |
| ANYBILLZUSATZBELEGE | J/N | Steht dieser Parameter auf "J" wird nicht nur der Kassenbeleg, sondern auch andere relevante Zusatzbelege wie Gutscheine, Einnahmen, Ausgaben, etc. an anybill geschickt und sind somit dann vom Kunden abrufbar.
| 2.249.0 |
Wenn die Parameter in den Kassen entsprechend konfiguriert sind und alle erhaltenden Daten korrekt eingepflegt wurden, steht der Verwendung von anybill nichts mehr im Wege.
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 QR-Code 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 als Dialog.
Der Nachdruck des Bons kann dann über die Funktion Belege → Alle Belege → Beleg auswählen → Drucken erfolgen.
Android / POSMANpop
Unter Android wird der QR-Code in einem Dialogfenster angezeigt, den der Kunde mit seinem Smartphone abscannen kann.
