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 im TM2 kassenspezifisch 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 | Entscheidet, ob der POSMAN-BON an anybill geschickt wird. Funktioniert nur, wenn ANYBILLZUSATZBELEGE aktiv ist | 2.249.X |
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 gerenderten Bon und zeigt dem Kunden nur den Bon, der von der Kasse hochgeladen wurde. Funktioniert nur, wenn ANYBILLWARTEAUFBON und ANYBILLZUSATZBELEGE aktiv sind | 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 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" werden andere relevante Zusatzbelege wie Gutscheine, Einnahmen, Ausgaben, etc. an anybill geschickt und sind somit dann vom Kunden abrufbar. Für Einnahmen und Ausgaben gilt, dass diese nur mitgeschickt werden, wenn sie in einem Bon mit Artikeln auftauchen und somit einen Kundenbezug haben. | 2.249.X |
ANYBILLDRUCKABFRAGE | J/N | Dieser Parameter fragt zu einem durch einen Tastencode: "AnybillDruckAbfrage" wählbaren "Zeitpunkt" den Kassierer, ob ein physischer Druck des Bons gemacht werden soll oder nicht. Der Tastencode muss über im Touch-Editor auf die gewünschte Taste gelegt werden. | 2.249.X |
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.