anybill Integration
Wir haben die digitale Bon-Lösung unseres Partners anybill realisiert (https://anybill.de/)
Um diese Integration zu nutzen, müssen mehrere Einrichtungsschritte durchlaufen werden.
Zunächst benötigen Sie seitens anybill Zugangsdaten. Diese umfassen
- einen Benutzernamen
- ein API-Passwort
- eine API-ClientID
- sowie für jede Filiale eine sog. StoreID.
Mithilfe dieser Parameter kann die Einrichtung der anybill-Integration für die jeweilige Filiale im TM2 kassenspezifisch durchgeführt werden.
Dafür sind in den Parametereinstellungen 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 in Zukunft auch die EIGENEUSTID 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 Store-ID für die zu konfigurierende Filiale | anybill StoreID 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 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 abgebildet 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 der eigenen Webseite) | 2.242.0 |
| ANYBILLKDDATENWEITERGEBEN | J/N | Dieser Parameter entscheidet darüber, ob die Bons anonym an anybill gesendet oder, wenn ein Kunde an der Kasse angemeldet wurde, dessen Daten 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 | Entscheidet, ob der POSMAN-BON an anybill geschickt wird.
| 2.249.X |
| ANYBILLQRCODEUNTERSCHRIFT | Jetzt Kassenbon scannen | Text, der auf dem Kundendisplay unter dem QR-Code von anybill angezeigt wird. | 2.242.0 |
| ANYBILLNUREIGENERBON | J/N | Deaktiviert den von anybill gerenderten Bon und zeigt dem Kunden nur den Bon, der von der Kasse hochgeladen wurde.
| 2.249.X |
| 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 einscannen und die URL aufrufen. Der Bon erscheint später automatisch unter 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 dafür zu Beginn eines neuen Kassiervorganges bestätigen, ob der Kunde anybill nutzen möchte oder nicht. Ist der Parameter aus und das Modul aktiviert, wird immer anybill ausgewählt (Nicht abgerufene Bons werden irgendwann durch anybill gelöscht, könnten so aber ganz vermieden werden). | 2.249.0 |
| ANYBILLZUSATZBELEGE | J/N | Steht dieser Parameter auf "J", werden andere relevante Zusatzbelege wie Gutscheine, Einnahmen, Ausgaben etc. an anybill geschickt und sind dann vom Kunden abrufbar. Für Einnahmen und Ausgaben gilt, dass diese nur mitgeschickt werden, wenn sie auf einem Bon mit Artikeln auftauchen und somit einen Kundenbezug haben. | 2.249.X |
| ANYBILLDRUCKABFRAGE | J/N | Dieser Parameter fragt, zu einem durch den Tastencode: "AnybillDruckAbfrage" wählbaren "Zeitpunkt" den Kassierer, ob ein physischer Druck des Bons erfolgen soll oder nicht. Der Tastencode muss im Touch-Editor auf die gewünschte Taste gelegt werden. | 2.249.X |
Wenn die Parameter in den Kassen entsprechend konfiguriert sind und alle erhaltenen Daten korrekt eingepflegt wurden, steht der Verwendung von anybill nichts mehr im Wege.
Die Kasse prüft bereits beim Start, ob sie sich mit den Daten erfolgreich anmelden kann. Wenn dies nicht erfolgt, gibt die Kasse dem Kassierer einen entsprechenden Hinweis.
Sollte die anybill-API im seltenen Fall beim Kassiervorgang Mal nicht zu erreichen sein, 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 bzw. angezeigt werden.
Dann ist es erforderlich, dem Kunden manuell einen Beleg auszudrucken. Der Kassierer erhält hierüber eine Information als Dialog.
Der Nachdruck des Bons kann ü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.
