konfipay-Service Integrator
6 Minuten Lesezeit
Einführung
Der Webservice konfipay der windata GmbH & Co.KG (https://www.konfipay.de/) ermöglicht die Automatisierung und sichere Abwicklung von Prozessen im digitalen Zahlungsverkehr. Als Dienstleister erfüllt windata (https://www.windata.de/) hohe Sicherheitsanforderungen (EBICS, ISO 20022 sowie Rechenzentren in Deutschland) und übernimmt die Übertragung von Zahlungsaufträgen sowie den Abruf von Kontoumsätzen.
Einrichtung
Zur Einrichtung der Konfipay-Erweiterung steht die Konfipay Unterstützte Einrichtung auf der Seite Unterstützte Einrichtung in RELion zur Verfügung.
Der Aufruf erfolgt über Einstellungen. Mit dem Einrichtungsassistenten lassen sich alle erforderlichen Informationen für die Nutzung der Erweiterung erfassen.
Hinweis
Vor der Nutzung von Konfipay ist für das Zusatzmodul eine entsprechende Lizenz zu beantragen.
Für die Nutzung der RELion Konfipay-Erweiterung sind folgende Angaben erforderlich:
| API-Schlüssel | Dies ist der Autorisierungsschlüssel für das Konfipay-System, der individuell für jeden Kunden ist. Der Schlüssel kann unter https://portal.konfipay.de/ abgerufen werden. Nachdem der Schlüssel eingegeben wurde, kann der Benutzer durch Anklicken der Aktion Verbindung prüfen testen, ob eine Verbindung zu Konfipay von Business Central aus möglich ist. Der Schlüssel wird sicher gespeichert und ist für Benutzer in Business Central nicht lesbar, da Microsoft-Sicherheit Technologie verwendet wird. |
Die folgenden Einstellungen werden im Konfipay-Einrichtungsassistent standardmäßig als funktionierende Konfipay-API-Einstellungen bereitgestellt. Derzeit ist keine Änderung dieser Werte erforderlich. Eine Änderungsmöglichkeit ist jedoch vorgesehen, falls die Werte in Zukunft auf der Konfipay-Seite angepasst werden, sodass sie auch in der RELion Konfipay Erweiterung angepasst werden können:
- API Basis URL
- Pain API Endpunkt
- Camt API Endpunkt
- MT940 API Endpunkt
Im Konfipay-Einrichtungsassistent kann konfiguriert werden:
- Automatisches Senden von Pain-Format-Zahlungsdateien nach Erstellung in Debitoren- oder Kreditoren-Zahlungen
- Alternativ: Nachträgliches Senden (manuell oder über die Aufgabenwarteschlange)
- Aktivierung bzw. Deaktivierung des Imports von Camt- und MT940-Dateien
Die Einstellungen können zusätzlich auf der Seite Konfipay Einrichtung angepasst werden. Beim Öffnen der Seite werden die Standardwerte automatisch gesetzt. Folgende Aktionen stehen zur Verfügung:
| Verbindung | |
| Verbindung prüfen | Überprüft, ob eine Verbindung zu Konfipay mit dem angegebenen API-Schlüssel und der API Basis URL möglich ist, wenn die Aktion Verbindung prüfen ausgeführt wird. |
| Einrichtung | |
| Standardeinstellungen wiederherstellen | Stellt die Standardwerte für Felder wie API Basis URL, Pain Api Endpunkt, Camt API Endpunkt, Camt Version und MT940 API Endpunkt wieder her. |
| Zeitplan Import Dokumente Aufgabenwarteschlange | Erstellt und aktiviert eine Aufgabenwarteschlange mit den Standardeinstellungen für den Import von Zahlungsdateien von Konfipay. |
| Importdokumente Aufgabenwarteschlange anzeigen | Zeigt die bestehende Aufgabenwarteschlange für den Import von Zahlungsdateien von Konfipay an. Sichtbar nur, wenn die Aufgabenwarteschlange existiert. |
| Importdokumente Aufgabenwarteschlange deaktivieren | Deaktiviert die Aufgabenwarteschlange für den Import von Zahlungsdateien von Konfipay. Sichtbar nur, wenn die Aufgabenwarteschlange existiert. |
| Zeitplan Senden Dokumente Aufgabenwarteschlange | Erstellt und aktiviert eine Aufgabenwarteschlange mit den Standardeinstellungen für das Senden von Zahlungsdateien an Konfipay. |
| Sendedokumente Aufgabenwarteschlange anzeigen | Zeigt die bestehende Aufgabenwarteschlange für das Senden von Zahlungsdateien an Konfipay an. Sichtbar nur, wenn die Aufgabenwarteschlange existiert. |
| Dokumente Senden Aufgabenwarteschlange deaktivieren | Deaktiviert die Aufgabenwarteschlange für das Senden von Zahlungsdateien an Konfipay. Sichtbar nur, wenn die Aufgabenwarteschlange existiert. |
Integration Zahlungsprotokolleinträge
Die Integration Zahlungsprotokolleinträge dient als zentraler Speicherort für eingehende (Camt, MT940) und ausgehende (ISO 20022 Pain) Zahlungsdateien. Einträge entstehen entweder durch den Import von Zahlungsdateien aus Konfipay oder durch die Erstellung von Zahlungsdateien in Debitoren- bzw. Kreditoren-Zahlungen. Über die Seite können folgende Aktionen durchgeführt werden:
- Start von Sende- und Importprozessen für Zahlungsdateien
- Navigation zu:
- Kontoauszügen
- Aufgabenwarteschlangen
- Zahlungsdateiinhalten
- Konfipay Einrichtung
Die Seite enthält folgende Felder:
| Lfd. Nr. | Gibt die Eintragsnummer an. |
| Anbieter Typ | Gibt den Anbieter Typ an. |
| Richtung | Eingehend oder Ausgehend, je nachdem, ob Daten gesendet oder empfangen werden. |
| Status | Gibt den Status eines Eintrags an. |
| Dateiformat | Pain, MT940 oder Camt. Durch Anklicken des Feldwerts kann der Inhalt der Datei angezeigt werden. |
| Version | Gibt die Version der Zahlungsdatei an. |
| IBAN | Gibt die IBAN der Zahlungsdatei an. |
| Fehlermeldung | Wenn ein Fehler im Prozess auftritt, wird die erste Fehlermeldung hier angezeigt. Weitere Nachrichten können durch Klicken auf den Meldungstext eingesehen werden. |
| User Id | Der Benutzer, der den Zahlungsprotokolleintrag erstellt hat. |
| Erstellt am | Gibt das Erstellungsdatum des Zahlungsprotokolleintrags an. |
| Geändert am | Gibt das Änderungsdatum des Zahlungsprotokolleintrags an. |
| Methode Code | Zeigt eine Methode, die verwendet wurde, um eine API aufzurufen. |
| Externer Systemidentifikator Id | Gibt die Konfipay-ID an. Das Feld ist standardmäßig ausgeblendet. |
Zusätzlich stehen folgende Funktionen zur Verfügung:
- ZIP-Download mehrerer Zahlungsdateien über die Aktion Dateien herunterladen
- Einsicht in Kommunikationsdaten über:
- Anfragedaten anzeigen
- Antwortdaten anzeigen
Import von Konfipay-Zahlungsdateien und Weiterverarbeitung in Importierte Kontoauszüge – Global
Der Import von Zahlungsdateien erfolgt IBAN-basiert. Hierfür wurde das Feld Provider Typ in der Bankkonto-Karte und der Bankkonto-Liste ergänzt. Aktuell stehen zwei Werte zur Verfügung:
- leer
- Konfipay
Für jede IBAN darf der Wert Konfipay nur einmal vergeben werden. Wird eine IBAN bereits einem Bankkonto mit aktiviertem Konfipay zugeordnet, ist eine weitere Nutzung dieser IBAN mit Konfipay in anderen Bankkonten nicht möglich.
Es gibt manuelle und automatische Wege, um Zahlungsdateien von Konfipay zu importieren. Beide Wege funktionieren nur, wenn der Import von Dateien in der Konfipay Einrichtung aktiviert ist:
Manueller Import:
- Seite Integration Zahlungsprotokolleinträge öffnen
- Aktion Zahlungsdateien importieren ausführen
- Dateien werden als Zahlungsprotokolleinträge angelegt
- Bei erfolgreichem Import: Weiterverarbeitung möglich
- Bei Fehler: Status Fehlgeschlagen mit Fehlermeldung
Automatischer Import:
- Aktivierung der Aufgabenwarteschlange in der Konfipay Einrichtung.
Nach dem erfolgreichen Import können die Daten in Importierte Kontoauszüge – Global übernommen werden.
Manuelle Verarbeitung:
- Auswahl der gewünschten Zahlungsprotokolleinträge
- Aktion Import in Kontoauszüge ausführen
Automatische Verarbeitung:
- Aktivierung der Aufgabenwarteschlange über
- Zeitplan Import Kontoauszüge Aufgabenwarteschlange Anpassung der Zeitplanung bei Bedarf
Hinweis
Die Aufgabenwarteschlange für den Import in Kontoauszüge soll nach der Aufgabenwarteschlange für den Dokumentenimport aus Konfipay laufen.
Nachdem die Zahlungsprotokolleinträge in Kontoauszüge importiert wurden, sind diese beiden Entitäten miteinander verknüpft. Der verknüpfte Eintrag kann durch Anklicken der Aktion Kontoauszug auf der Seite Zahlungsprotokolleinträge angezeigt werden.
Falls der Import der Zahlungsprotokolleinträge in die Kontoauszüge fehlschlägt, wird der Status des Zahlungsprotokolleintrags auf Fehler geändert. Nachdem das Problem behoben wurde, kann der Status mit der Aktion Status zurücksetzen wieder auf Importiert gesetzt werden und Sie können den Import erneut durchzuführen.
ISO20022 Pain-Zahlungsdateien senden
Es gibt folgende Möglichkeiten, Pain-Zahlungsdateien an Konfipay zu senden:
Manuelles Senden
Ist in der Konfipay Einrichtung das Senden von Pain-Dateien aktiviert und wird eine Zahlungsdatei in Debitoren- oder Kreditoren-Zahlungen erstellt, wird automatisch ein Eintrag in den Integration Zahlungsprotokolleinträgen erzeugt.
Der Versand kann anschließend über folgende Wege erfolgen:
-
In Integration Zahlungsprotokolleinträge:
- Eintrag auswählen
- Aktion Pain-Datei senden ausführen
-
Alternativ direkt in:
- Debitoren-Zahlungen oder Kreditoren-Zahlungen
- Aktion Senden an Konfipay
Automatisches Senden über Aufgabenwarteschlange
Der Versand kann automatisiert über eine Aufgabenwarteschlange erfolgen:
- Einrichtung über die Aktion Zeitplan Senden Dokumente Aufgabenwarteschlange in der Konfipay Einrichtung
Sofortiges automatisches Senden
Optional ist ein direkter Versand nach Erstellung der Zahlungsdatei möglich:
- Aktivierung der Funktion Dokumente automatisch senden in der Konfipay Einrichtung
Hinweis
In der RELion Core-Erweiterung können Zahlungsdateien, die in Debitoren- oder Kreditoren-Zahlungen erstellt wurden, storniert werden. Wurde bereits ein zugehöriger Zahlungsprotokolleintrag erzeugt, erhält dieser den Status Storniert. Wurde die Zahlungsdatei bereits an Konfipay übertragen, erscheint vor der Stornierung lediglich ein Warnhinweis. Ein Rückruf der Zahlungsdatei nach Verarbeitung durch Konfipay bzw. die Bank ist nicht möglich.