Einrichtung von EBICS für die Verknüpfung mit dem Bankkonto

Über die API kann eine Verbindung zum eigenen Bankkonto hergestellt werden, damit für jede QR-Rechnung automatisch geprüft werden kann, ob Zahlungen eingegangen sind. Der Status der Rechnungen und der damit verbundenen WooCommerce-Bestellungen kann dadurch automatisch aktualisiert werden.

Damit Buchungen von deinem Bankkonto abgerufen werden können, um Rechnungen bei WooCommerce abzugleichen und zu aktualisieren, müssen folgende Voraussetzungen erfüllt sein:

  1. QR-IBAN für das Bankkonto vorhanden und unter „QR-Rechnung > Einstellungen“ eingetragen. Falls keine QR-IBAN vorhanden ist, kann sie bei der Bank beantragt werden.
  2. EBICS-Zugang für das Bankkonto vorhanden (siehe unten).
  3. Gültige „QR-Bill for WooCommerce“ Plugin-Lizenz.

 

1. EBICS-Zugang beantragen

Bitte wende dich an deine Bank, um die Parameter für die Einrichtung des EBICS-Zugangs für dein Bankkonto zu erhalten. Der EBICS-Zugang wird nur benötigt, um eingehende Zahlungen im camt.054-Format abzurufen (d. h. es müssen keine Zahlungen getätigt werden). Du benötigst ausserdem eine QR-IBAN für dein Bankkonto, um QR-Referenzen für QR-Rechnungen erstellen zu können.

 

2. Service aktivieren

Nachdem du die Parameter von deiner Bank erhalten hast, kannst du dich in dein Konto bei mamedev.app einloggen. Den Benutzernamen und das Passwort für mamedev.app findest du in deinem Konto bei mamedev.ch. Alternativ kannst du das Registrierungsformular unter mamedev.app/register ausfüllen.

Gehe auf die Seite „Applikationen > QR-Rechnung > EBICS-Integration > Einstellungen“, um die Einrichtung zu starten.

 

2.1 Zahlungsart

Im ersten Schritt muss eine Zahlungsart hinzugefügt werden, um den Service zu aktivieren. Der Service kann jederzeit gestoppt werden.

 

2.2 Store hinzufügen

Im nächsten Schritt kann ein neuer Store hinzugefügt werden. Gib einen Namen für den Shop ein, um ihn später leichter zu identifizieren.

In das Feld „Bankkonto IBAN“ muss die IBAN, nicht die QR-IBAN, eingetragen werden.

Die Notification URL ist die URL für die JSON REST API der WordPress-Website. Normalerweise ist diese zusammengesetzt aus der Website-URL und der Endung „/wp-json“.

 

3. EBICS-Einrichtung

Nach der Aktivierung des Dienstes und dem Hinzufügen eines Stores kannst du auf der Seite „Applikationen > QR-Rechnung > EBICS-Integration > Einstellungen > EBICS-Verbindung hinzufügen“ mit der EBICS-Einrichtung beginnen.

 

3.1 EBICS-Parameter

Wähle einen beliebigen Namen für die Verbindung, um sie später leichter identifizieren zu können. Wähle deine Bank aus und gib die IBAN ein (nicht die QR-IBAN). Bitte kontaktiere uns, wenn deine Bank nicht in der Dropdown-Liste erscheint.

Trage die Parameter, die du von Ihrer Bank erhalten hast, in die Felder „EBICS-Partner-ID / Kunden-ID“ und „EBICS-Benutzer-ID / Teilnehmer-ID“ ein und klicke auf „Initialisierung“.

 

3.2 Bankbrief einsenden

Downloade den Bankbrief im nächsten Schritt, unterschreibe ihn auf jeder Seite und schicke ihn an die Bank. Klicke anschliessend auf „Bankbrief versendet“.

 

3.3 Bankschlüssel abholen

Die Bank wird dich bezüglich des Status der EBICS-Anbindung kontaktieren (normalerweise innerhalb der nächsten Tage). Nachdem die Anbindung durch die Bank eingerichtet wurde, kannst du auf den Button „Bankschlüssel abholen“ klicken, um die Einrichtung der EBICS-Verbindung abzuschliessen.

 

3.4 EBICS-Verbindung zu Store hinzuweisen

Bearbeite den Store und weise die EBICS-Verbindung zu.

4. API-Zugangsdaten

Nach dem Einrichten der EBICS-Anbindung muss das Plugin mit deinem Account bei mamedev.app verbunden werden.

Gehe dazu auf die Seite „Einstellungen (Zahnrad oben rechts) > API-Einstellungen“. Auf dieser Seite kannst du über den Button „Neuen Schlüssel generieren“ einen neuen Webhook-Key generieren.

Auf der gleichen Seite kann unter „API-Tokens > API-Token hinzufügen“ ein neues Token generiert werden. Gib einen beliebigen Namen ein (z. B. den Namen deines Shops) und wähle im Auswahlfeld „QR-Rechnung“ aus. Bitte speichere das Token, da es nur einmal angezeigt wird und im Nachhinein nicht mehr abgerufen werden kann.

 

5. Einstellungen im WordPress-Backend

Logge dich ins WordPress-Backend deiner Website ein und rufe die Seite „QR-Rechnung > Einstellungen“ auf. Trage auf dieser Seite das API-Token und den Webhook-Key aus Schritt 4 ein und speichere anschliessend die Einstellungen.

Klicke anschliessend unter „EBICS > Store-ID“ auf „Synchronisieren“, um den Store zu laden, den du in deinem Account bei mamedev.app hinzugefügt hast. Wähle den Store aus und speichere die Einstellungen, um die Einrichtung abzuschliessen.