Zum Hauptinhalt springen

eBill Schweiz: Rechnungen ins E-Banking zustellen

eBill einrichten, Empfänger beim Kunden hinterlegen, Rechnungen mit Prüfung vor dem Versand zustellen, Status verfolgen und Korrekturen als Gutschrift senden – mit Testmodus ohne Anbietervertrag.

Zuletzt aktualisiert: Inhaltlich verantwortlich: Hamza Mehmalat, Geschäftsführer Ouhud GmbH

Was eBill ist

eBill ist die elektronische Rechnung im E-Banking der Schweizer Banken (Infrastruktur von SIX). Ihr Kunde sieht die Rechnung im E-Banking und gibt die Zahlung mit einem Klick frei.

Stand in Ouhud Buchhaltung

Die App ist für eBill vorbereitet: Prüfung vor dem Versand, Versand, Status und Verlauf sind fertig. Eine echte Zustellung braucht einen Vertrag Ihrer Firma mit einem zertifizierten eBill-Netzwerkpartner – Rechnungssteller werden immer über einen Netzwerkpartner angebunden; Ouhud ist kein Netzwerkpartner. Ohne Vertrag nutzen Sie den Testmodus: Er simuliert Zustellung, Ablehnung und Zahlung, stellt aber nichts zu.

Einrichten

  1. Einstellungen → eBill Schweiz: eBill aktivieren und den Anbieter wählen.
    • Testmodus – eingebauter Testanbieter, sofort nutzbar, keine Zustellung.
    • Billte – Netzwerkpartner; Biller-PID (17 Ziffern, beginnt mit 41) und Biller-Secret erhalten Sie von Billte. Mit „Testumgebung des Anbieters“ geht der Versand an die Staging-Umgebung.
    • Allgemeine JSON-Schnittstelle – für einen Anbieter, der das Format der App annimmt (API-Adresse, Teilnehmer-ID, API-Schlüssel).
  2. Verbindung testen prüft die gespeicherten Einstellungen.
  3. Statusmeldungen per Webhook: Secret erzeugen und Adresse und Secret beim Anbieter hinterlegen. Das Secret ist nur einmal sichtbar. Eine Meldung ist JSON mit reference (Kennung des Anbieters) oder deliveryId, status (sent, delivered, paid, rejected, failed, cancelled) und optional providerStatus und message. Signatur: Header X-Ebill-Timestamp (Unix-Sekunden) und X-Ebill-Signature = sha256= plus HMAC-SHA256 mit dem Secret über „Zeitstempel.Body“; Meldungen älter als 5 Minuten werden abgelehnt. Die App fragt den Status zusätzlich regelmässig ab.

Empfänger beim Kunden

Unter Kunden → Bearbeiten → eBill-Empfänger tragen Sie eine dieser Kennungen ein:

EmpfängerKennung
PrivatpersoneBill-ID (17 Ziffern, beginnt mit 41) oder E-Mail-Adresse aus dem E-Banking
Unternehmen (eBill for Business)UID, z. B. CHE-123.456.789

Empfang prüfen fragt beim Anbieter nach, ob der Kunde eBill-Rechnungen Ihrer Firma annimmt. Das Ergebnis steht beim Kunden.

Rechnung senden

In der Rechnung im Bereich eBill Schweiz auf Per eBill senden klicken. Die App prüft zuerst:

  • Firmensitz Schweiz und vollständige Firmenadresse
  • Währung CHF (eBill erlaubt auch EUR, die QR-Rechnung der App gibt es bisher nur in CHF)
  • gültige QR-Rechnung im PDF: QR-IBAN mit QR-Referenz oder IBAN mit Creditor Reference bzw. ohne Referenz
  • eBill-Empfänger beim Kunden und – falls der Anbieter das anbietet – ob er eBill annimmt
  • Betrag grösser als 0, Rechnungsdatum höchstens 90 Tage alt, Fälligkeit plausibel

Ein Entwurf wird beim Senden ausgestellt und festgeschrieben. Übertragen wird genau die festgeschriebene QR-Rechnung; SHA-256 des PDF und der Anfrage stehen in der Zustellung und im Audit-Log.

Status

StatusBedeutung
In Warteschlangewird gesendet; bei einer Störung versucht die App es automatisch erneut (bis 6 Stunden)
An Anbieter übergebender Netzwerkpartner hat die Rechnung angenommen
Zugestelltdie Rechnung liegt im E-Banking des Kunden
Bezahlt (laut Anbieter)der Kunde hat die Zahlung freigegeben; den Zahlungseingang bucht weiterhin der Bankabgleich
Abgelehntder Kunde hat die Rechnung abgelehnt
Fehlgeschlagender Anbieter hat die Rechnung nicht angenommen oder war zu lange nicht erreichbar
Zurückgezogendie Zustellung wurde vor oder nach dem Versand zurückgezogen

Der Verlauf zeigt jeden Schritt mit Zeitpunkt. Ein Status geht nur vorwärts; späte Meldungen ändern einen Endzustand nicht.

Nicht doppelt senden

Eine Rechnung wird nur einmal per eBill zugestellt. Ein erneuter Versand ist nur nach Abgelehnt, Fehlgeschlagen oder Zurückgezogen möglich und muss ausdrücklich mit Erneut per eBill senden angefordert werden.

Storno und Gutschrift

Erstellen Sie zu einer per eBill zugestellten Rechnung eine Stornorechnung oder Gutschrift:

  • Noch nicht gesendet: die Zustellung wird zurückgezogen.
  • Gesendet, und der Anbieter kann Zustellungen zurückziehen: Bei einem vollständigen Storno zieht die App sie zurück.
  • Sonst senden Sie den Korrekturbeleg mit Gutschrift per eBill senden; er bezieht sich auf die ursprüngliche Zustellung.

Testmodus ausprobieren

Im Testmodus bestimmt die Empfänger-E-Mail das Ergebnis: mit „notfound“ nimmt der Empfänger kein eBill an, mit „fail“ gibt es eine vorübergehende Störung (Wiederholung), mit „reject“ lehnt er ab. Jede andere gültige Kennung wird zugestellt. Zahlung und Ablehnung können Sie zusätzlich auf der Rechnung simulieren. Alles im Testmodus ist als „Testmodus“ gekennzeichnet.

Nicht gefunden, was Sie suchen? Schreiben Sie an info@ouhud.com. Wir antworten in der Regel innerhalb eines Werktages; Reaktionszeiten nach Tarif stehen unter Support und Reaktionszeiten.