paywise für Billomat
Verbinden Sie Ihr Billomat-Konto mit paywise und übergeben Sie offene und
überfällige Rechnungen mit wenigen Klicks an den Forderungseinzug. Rechnungs-PDF,
Kundendaten und bereits gebuchte Teilzahlungen kommen automatisch mit – ebenso Ihre
in Billomat verschickten Mahnungen samt Mahngebühren.
paywise liest aus Billomat und schreibt nichts zurück. In Ihrer Buchhaltung wird
nichts geändert, storniert oder als bezahlt markiert.
Bevor Sie starten
Der Billomat-API-Zugriff ist ab dem Business-Tarif verfügbar. Im
Professional-Tarif lässt sich kein API-Schlüssel erzeugen.
- Ein Billomat-Konto ab dem Business-Tarif.
- Ihre Billomat-ID und einen API-Schlüssel (siehe unten).
- Ein paywise-Konto.
- Für Ihr paywise-Unternehmen darf kein aktiver DATEV-Import bestehen. Deaktivieren
Sie ihn unter DATEV Einstellungen → Gefahrenzone → Integration deaktivieren,
bevor Sie Billomat verbinden.
Was paywise abruft
Der API-Schlüssel wird ausschließlich lesend verwendet.
Billomat-ID und API-Schlüssel finden
In paywise erreichen Sie diese Anleitung jederzeit über Anleitung öffnen auf der
Billomat-Seite.
Ihre Billomat-ID steht in der Adresszeile Ihres Billomat-Kontos: Bei
https://muster.billomat.net lautet sie muster.
Den API-Schlüssel erzeugen Sie so:
Einstellungen öffnen
In Billomat auf das Zahnrad Einstellungen klicken.
Nutzer öffnen
Unter Administration den Punkt Nutzer öffnen.
Nutzer bearbeiten
Beim gewünschten Nutzer oben rechts auf bearbeiten klicken.
API-Zugriff aktivieren
Bei API Zugriff das Häkchen aktivieren? setzen.
Schlüssel anzeigen und kopieren
Auf API-Schlüssel anzeigen klicken und den Schlüssel kopieren.
Speichern
Unbedingt auf Speichern klicken – ohne Speichern ist der Schlüssel nicht
aktiv.
1. Billomat verbinden
Billomat-ID eintragen
Tragen Sie im Feld Billomat-ID nur den Namen ein – ohne https://, ohne
.billomat.net und ohne Schrägstriche.
API-Schlüssel einfügen
Fügen Sie den kopierten Schlüssel in das Feld API-Schlüssel ein.
Verbinden
Wählen Sie Verbinden. Mit dem Verbinden akzeptieren Sie die
Nutzungsbedingungen der Billomat-Anbindung.
Nach dem Verbinden zeigt die Seite Billomat ist verbunden mit Ihrer Billomat-ID
und den letzten Zeichen des hinterlegten Schlüssels.
Optional: eigenes Anfrage-Kontingent. Registrieren Sie in Billomat unter
Einstellungen → Administration → Apps eine eigene App (z. B. „paywise“), erhält
die Anbindung ein eigenes Anfrage-Kontingent und teilt es sich nicht mit Ihren
anderen Integrationen. Tragen Sie App-ID und App-Secret beim Verbinden mit
ein – oder lassen Sie beide Felder leer.
2. Rechnungen einreichen
Rechnungsauswahl öffnen
Wählen Sie auf der Billomat-Seite in paywise Rechnungen einreichen.
Rechnungen auswählen
paywise listet Ihre offenen und überfälligen Rechnungen live aus Billomat – mit
Rechnungsnummer, Kunde, Rechnungsdatum, Fälligkeit, Gesamtbetrag und offenem
Betrag.Das Fälligkeitsdatum kommt direkt aus Billomat. paywise berechnet hier
nichts selbst. Der offene Betrag berücksichtigt bereits gebuchte
Teilzahlungen.
Schuldnerdaten prüfen
Name und Anschrift kommen aus dem Billomat-Kunden, das Rechnungs-PDF wird
automatisch angehängt. Prüfen Sie die Angaben und ergänzen Sie, was fehlt.
Mahnungen kontrollieren
Bereits versendete Mahnungen zu der Rechnung übernimmt paywise automatisch –
mit Datum, Frist, Betrag, Mahnungs-PDF und, sofern Billomat sie als solche
ausweist, der Mahngebühr. Haben Sie außerhalb von Billomat gemahnt, ergänzen
Sie das hier von Hand.
Auftrag absenden
Legen Sie fest, wie der Einzug starten soll, beantworten Sie die rechtlichen
Fragen, akzeptieren Sie die Bedingungen und wählen Sie Auftrag absenden.
Rechnungen, die nicht eingereicht werden können
paywise prüft die Beitreibbarkeit selbst und verlässt sich nicht allein auf den
Status in Billomat:
- Rechnungen ohne offenen Betrag. Eine Rechnung wird nur angeboten, wenn sie in
Billomat den Status offen oder überfällig hat und ein offener Betrag
größer null verbleibt. Das ist Absicht: Eine vollständig bezahlte Rechnung behält
in Billomat den Status überfällig, wenn die Zahlung nicht mit „Rechnung als
bezahlt markieren” gebucht wurde.
- Entwürfe und stornierte Rechnungen.
- Unvollständige Empfängerdaten. paywise übernimmt die Rechnung als
bearbeitbaren Entwurf. Ergänzen Sie Name und Anschrift in paywise, bevor Sie den
Auftrag absenden.
- Bereits eingereichte Rechnungen werden als Eingereicht angezeigt.
3. Verbindung trennen
Wählen Sie auf der Billomat-Seite Verbindung trennen und bestätigen Sie.
paywise löscht den gespeicherten API-Schlüssel und ruft keine Rechnungen mehr aus
Billomat ab. Bereits übergebene Forderungen sind davon nicht betroffen.
Der Schlüssel selbst bleibt in Billomat gültig. Ein Zurücksetzen oder
Deaktivieren des API-Zugriffs in Billomat macht ihn nicht ungültig. Wenden Sie sich
an den Billomat-Support, wenn der Schlüssel vollständig entwertet werden soll.
Fehlerbehebung
„Diese Billomat-ID gibt es nicht“
Prüfen Sie den Namen in Ihrer Billomat-Adresse. Tragen Sie nur den Namen ein –
ohne https://, ohne .billomat.net und ohne Schrägstriche.
„Der API-Schlüssel wurde nicht akzeptiert“
Prüfen Sie, ob der API-Zugriff in Billomat aktiviert und gespeichert wurde.
Ohne den Klick auf Speichern ist der Schlüssel nicht aktiv.
„App-ID oder App-Secret wurden von Billomat nicht akzeptiert“
Prüfen Sie beide Werte in Billomat unter Einstellungen → Administration →
Apps – oder lassen Sie die Felder leer. Die eigene App ist optional.
„Billomat ist derzeit nicht erreichbar oder das Anfragelimit ist ausgeschöpft“
Billomat begrenzt die Anzahl der Anfragen pro Konto und Zeitfenster. Versuchen
Sie es in einigen Minuten erneut. Wenn das häufiger vorkommt, registrieren Sie in
Billomat eine eigene App und hinterlegen Sie App-ID und App-Secret – die
Anbindung erhält dann ein eigenes Kontingent.
Eine bezahlte Rechnung steht noch in der Liste
Prüfen Sie, ob die Zahlung in Billomat der Rechnung zugeordnet ist. paywise
entscheidet anhand des offenen Betrags, nicht anhand des Status.
Fragen
Schreiben Sie an [email protected].