30.09.2025, 10:29
neue EBICS camt053 Funktion zum Abrufen der Kontoauszüge Abschaltung der MT940 Schnittstelle
Sehr geehrte POWERGAP-Shopbetreiber,
ab dem 01.11.2025 wird die MT940-Schnittstelle offiziell abgeschaltet und nicht mehr unterstützt.
Als Nachfolge steht die EBICS camt-Schnittstelle zur Verfügung. Für diejenigen, die bisher den MT940-Import genutzt haben, um Vorkasse-Bestellungen abzuwickeln, haben wir den Wechsel so einfach wie möglich gestaltet: Die bisherige MT940-Funktion wurde so angepasst, dass sie nun direkt mit dem neuen EBICS-camt-Verfahren arbeitet.
So können Sie z. B. weiterhin Ihre bestehenden Blacklists (falls gepflegt) nutzen und auch die Übersicht bereits abgewickelter Buchungen wie gewohnt aufrufen.
Vorteile des neuen Verfahrens
Einrichtungsschritte
Die einmalige Einrichtung ist etwas aufwändiger. Bitte gehen Sie wie folgt vor:
1. EBICS-Zugang bei Ihrer Bank beantragen
Beantragen Sie einen EBICS 3.0-Zugang für camt.053 (Tagesauszüge) und/oder camt.052 (Echtzeitbuchungen).
Von Ihrer Bank erhalten Sie:
Diese Daten hinterlegen Sie anschließend in den Grundeinstellungen Ihres Shops.
Zusätzlich vergeben Sie dort ein eigenes Passwort (nicht von der Bank). Dieses wird für die Erzeugung der Hashwerte benötigt und muss nicht an die Bank weitergegeben werden.
2. Initialisierung starten
3. Hashwerte und Bankbrief
In der EBICS-Maske starten Sie die Initialisierung und erzeugen die Hashwerte für INI und HIA.
Sobald beide erfolgreich erstellt wurden, können Sie den Bankbrief generieren.
Diesen speichern Sie, unterschreiben ihn und senden ihn an Ihre Bank zurück.
Nach Freigabe durch die Bank ist Ihr Zugang aktiv, und Sie können sowohl Echtzeit- als auch Tagesauszüge abrufen.
4. BFT-Parameter hinterlegen
Nach Erhalt der BFT-Parameter tragen Sie diese ebenfalls in den Grundeinstellungen ein.
Sie sind notwendig, damit die API-Aufrufe an die Bank korrekt ausgeführt werden können.
Unterstützt werden derzeit:
Format für die Eingabe:
Service Name;Scope;Container;Message Name;
Beispiel:
STM;DE;ZIP;camt.052; (für camt.052)
EOP;DE;ZIP;camt.053; (für camt.053)
Anmerkung:
Aktuell ist die Entwicklung auf ZIP Container ausgelegt, wenn Ihre Bank hier ein anderes Verfahren nutzt, sprechen Sie uns bitte vorher dazu an.
Dann können wir das für das genutzte Verfahren einbauen.
Abruf der Auszüge
Tagesauszüge werden standardmäßig per Cronjob jede Nacht abgerufen.
Auf Wunsch können wir auch abweichende Abrufzeiten für Ihren Shop einrichten – sprechen Sie uns dazu gerne an.
Über die EBICS-Maske können Sie den Import von Echtzeit- und Tagesauszügen zusätzlich jederzeit manuell starten.
Unterstützung bei der Einrichtung
Falls Sie Unterstützung bei der Einrichtung benötigen, stehen wir Ihnen selbstverständlich gerne zur Verfügung.
ab dem 01.11.2025 wird die MT940-Schnittstelle offiziell abgeschaltet und nicht mehr unterstützt.
Als Nachfolge steht die EBICS camt-Schnittstelle zur Verfügung. Für diejenigen, die bisher den MT940-Import genutzt haben, um Vorkasse-Bestellungen abzuwickeln, haben wir den Wechsel so einfach wie möglich gestaltet: Die bisherige MT940-Funktion wurde so angepasst, dass sie nun direkt mit dem neuen EBICS-camt-Verfahren arbeitet.
So können Sie z. B. weiterhin Ihre bestehenden Blacklists (falls gepflegt) nutzen und auch die Übersicht bereits abgewickelter Buchungen wie gewohnt aufrufen.
Vorteile des neuen Verfahrens
- Der Import läuft vollautomatisch.
- Über einen Cronjob können Kontoauszüge regelmäßig von Ihrer Bank abgeholt werden.
- Der Zahlstatus von Bestellungen wird bei erfolgreichem Abgleich automatisch auf bezahlt gesetzt.
- Buchungen, die keiner Bestellung zugeordnet werden können, müssen – wie bisher – manuell zugewiesen werden.
Einrichtungsschritte
Die einmalige Einrichtung ist etwas aufwändiger. Bitte gehen Sie wie folgt vor:
1. EBICS-Zugang bei Ihrer Bank beantragen
Beantragen Sie einen EBICS 3.0-Zugang für camt.053 (Tagesauszüge) und/oder camt.052 (Echtzeitbuchungen).
Von Ihrer Bank erhalten Sie:
- Kunden-ID
- Teilnehmer-ID
- Bank Host ID
- Bank-URL für die Schnittstellenkommunikation
- BFT-Parameter (zur Identifikation der abzurufenden Vorgänge)
Diese Daten hinterlegen Sie anschließend in den Grundeinstellungen Ihres Shops.
Zusätzlich vergeben Sie dort ein eigenes Passwort (nicht von der Bank). Dieses wird für die Erzeugung der Hashwerte benötigt und muss nicht an die Bank weitergegeben werden.
2. Initialisierung starten
- Aktivieren Sie in den Grundeinstellungen die Option EBICS 3.0 (auf „Ja“ stellen).
Melden Sie sich einmal aus der Verwaltung ab und wieder neu an.(Nicht mehr nötig!)- In der Bestellübersicht finden Sie nun den Button EBICS.
3. Hashwerte und Bankbrief
In der EBICS-Maske starten Sie die Initialisierung und erzeugen die Hashwerte für INI und HIA.
Sobald beide erfolgreich erstellt wurden, können Sie den Bankbrief generieren.
Diesen speichern Sie, unterschreiben ihn und senden ihn an Ihre Bank zurück.
Nach Freigabe durch die Bank ist Ihr Zugang aktiv, und Sie können sowohl Echtzeit- als auch Tagesauszüge abrufen.
4. BFT-Parameter hinterlegen
Nach Erhalt der BFT-Parameter tragen Sie diese ebenfalls in den Grundeinstellungen ein.
Sie sind notwendig, damit die API-Aufrufe an die Bank korrekt ausgeführt werden können.
Unterstützt werden derzeit:
- camt.052 (Echtzeitbuchungen)
- camt.053 (Tagesauszüge)
Format für die Eingabe:
Service Name;Scope;Container;Message Name;
Beispiel:
STM;DE;ZIP;camt.052; (für camt.052)
EOP;DE;ZIP;camt.053; (für camt.053)
Anmerkung:
Aktuell ist die Entwicklung auf ZIP Container ausgelegt, wenn Ihre Bank hier ein anderes Verfahren nutzt, sprechen Sie uns bitte vorher dazu an.
Dann können wir das für das genutzte Verfahren einbauen.
Abruf der Auszüge
Tagesauszüge werden standardmäßig per Cronjob jede Nacht abgerufen.
Auf Wunsch können wir auch abweichende Abrufzeiten für Ihren Shop einrichten – sprechen Sie uns dazu gerne an.
Über die EBICS-Maske können Sie den Import von Echtzeit- und Tagesauszügen zusätzlich jederzeit manuell starten.
Unterstützung bei der Einrichtung
Falls Sie Unterstützung bei der Einrichtung benötigen, stehen wir Ihnen selbstverständlich gerne zur Verfügung.