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
- 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).
- Verbindung testen prüft die gespeicherten Einstellungen.
- 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) oderdeliveryId,status(sent,delivered,paid,rejected,failed,cancelled) und optionalproviderStatusundmessage. 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änger | Kennung |
|---|---|
| Privatperson | eBill-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
| Status | Bedeutung |
|---|---|
| In Warteschlange | wird gesendet; bei einer Störung versucht die App es automatisch erneut (bis 6 Stunden) |
| An Anbieter übergeben | der Netzwerkpartner hat die Rechnung angenommen |
| Zugestellt | die Rechnung liegt im E-Banking des Kunden |
| Bezahlt (laut Anbieter) | der Kunde hat die Zahlung freigegeben; den Zahlungseingang bucht weiterhin der Bankabgleich |
| Abgelehnt | der Kunde hat die Rechnung abgelehnt |
| Fehlgeschlagen | der Anbieter hat die Rechnung nicht angenommen oder war zu lange nicht erreichbar |
| Zurückgezogen | die 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.