Anbindung Konfipay an OPplus

Transkript

1 an OPplus 2.0 Vorbereitet für Kunden und Partner Projekt Konfipay Vorbereitet von Georg Böhlen

2 Inhalt Einrichtung Konfipay... 3 Einrichtung des Webservice zum Abholen der Kontoauszüge... 3 Einrichten des Webservice... 4 Abholen einer Liste der verfügbaren Kontoauszüge... 4 Abholen der Kontoauszüge... 5 Protokoll anzeigen... 5 Einrichtung des Webservice zum Senden der Zahldateien... 7 Einrichten des Webservice... 7 Senden der Zahldatei... 7 Seite 2 von 10

3 Einrichtung Konfipay Da es geplant ist, das Projekt an OPplus in den Standard zu übernehmen, wir aber bisher nur vereinzelt durch Kundeninstallationen tatsächlich praktische Erfahrungen aufweisen, stellen wir Ihnen die Objekte analog wie ein Hotfixpaket kostenlos zur Verfügung. Wir würden uns freuen, wenn Ihre Kunden Ihnen ein Feedback geben, an welchen Stellen Änderungen bzw. Erweiterungen dieses Moduls notwendig erscheinen. Erstellen Sie je einen Provider zum Abholen der Kontoauszüge und einen zum Übertragen der Zahlungsaufträge und geben Sie dort jeweils Ihre Kennung, das Passwort und die Credential Informationen ein, die Sie von windata erhalten haben. Diese Informationen sind notwendig, um den Webservice zum Abrufen von Kontoauszügen und/oder zum Senden von Zahlungsdateien zu verwenden. Nennen Sie den Dienst zum Abholen der Auszüge z. B. KONFI_CAMT und den zum Übertragen der Zahlungen z. B. KONFI_PMT. Im Feld Typ stellen Sie CAMT bzw. SEPA ein. Als Webservice URL tragen Sie jeweils ein. Die Codeunit für den Webservice zum Abholen der Kontoauszüge lautet , die zum Übertragen der Zahlungsdateien lautet Einrichtung des Webservice zum Abholen der Kontoauszüge Wechseln Sie in die Einrichtung OPplus Basis und dort in das Register Zlg. Import Füllen Sie das folgende Feld aus: Feld Inhalt Codeunit Webservice Tragen Sie zusätzlich einen Pfad und einen Backuppfad ein, in der der Webservice die Kontoauszugsinformationen zwischenspeichert. Seite 3 von 10

4 Bitte beachten Sie, dass diese Pfade vom Webservice (in der Regel das Mitteltier) und nicht vom Enduser zu erreichen sein müssen! Einrichten des Webservice Wechseln Sie in die Maske Offene Importjournale und dort unter Aktionen in die Maske Zahlungsprovider Erstellen Sie einen Eintrag KONFI_CAMT und füllen Sie die Felder wie folgt aus: Feld Code Beschreibung User ID Passwort Credential Typ Protokoll Test Bankkontenliste anfordern Streams speichern Webservice URL Inhalt KONFI_CAMT (Bezeichnung ist beliebig) z.b. Konfipay holt CAMT Auszüge Geben Sie hier Ihre User ID ein, die Sie von Windata erhalten haben Geben Sie das Passwort ein, dass Sie von Windata erhalten haben Geben Sie die Credentialinfo ein, die Sie erhalten haben CAMT Leer, Alle oder Fehler : Je nach Eintrag werden Protokolleinträge erzeugt Wenn Sie dieses Feld aktivieren, gelten die Auszüge als nicht abgeholt und können somit mehrfach abgeholt werden Bei der Ersteinrichtung können Sie durch Aktivierung dieses Feldes eine Liste der verfügbaren Bankkonten erhalten, die bei Konfipay freigeschaltet sind. Wenn Sie das Protokoll aktiviert haben, können Sie die ggf. die Antworten des Webservice protokollieren Codeunit Webservice Pfadangaben Die Pfadangaben können Sie leer lassen, da diese aus der OPplus Basiseinrichtung gelesen werden. Abholen einer Liste der verfügbaren Kontoauszüge Aktivieren Sie das Feld Bankkontenliste anfordern und erstellen Sie so eine Liste der unter Konfipay verfügbaren Bankkonten. Diese werden automatisch in die Zlg. Import Schnittstellen eingetragen. Achtung: Die Abholung der Auszüge über Konfipay erfolgt immer über die IBAN des jeweiligen Kontos. Leider werden in den CAMT Kontoauszügen nicht bei allen Banken die IBAN im Seite 4 von 10

5 Identifizierungsfeld mitgegeben. Wird die IBAN in der Liste der Bankkonten des aktuellen Mandanten gefunden, wird die Importschnittstelle vom System ausgefüllt. Auf jeden Fall müssen Sie die Importschnittstellen anschließend konfigurieren. Das Feld Bankkontenliste anfordern wird automatisch vom System zurückgesetzt. Abholen der Kontoauszüge Zum Abholen der Kontoauszüge wechseln Sie in die Maske Offene Importjournale und wählen den Menüpunkt: Aktionen Auszüge per Webservice holen. Alle nachfolgenden Schritte entsprechen denen, die Sie auch durchgeführt hätten, wenn Sie die Kontoauszüge über ein Bankprogramm wie SFirm oder Multicash geholt hätten. Wenn Sie neben den CAMT 053 Auszügen auch Vormerkposten im CAMT 052 Format importieren wollen, aktivieren Sie dies analog zum MT 940 Import in der entsprechenden Zlg. Import Schnittstelle. Protokoll anzeigen In der Übersicht der Zahlungsprovider können Sie über den Menüpunkt Protokoll die einzelnen Schritte, die der Webservice durchgeführt hat, anzeigen und ggf. Fehlermeldungen einsehen. Dies kann notwendig sein, wenn der Abruf nicht auf Anhieb klappt. Seite 5 von 10

6 Wenn vorhanden, können Sie im Protokoll über die Funktion Export den Stream anzeigen, den der Webservice zurückgesendet hat. Erfolgreich abgeholte Kontoauszüge werden nicht zusätzlich im Protokoll verfügbar gemacht, da Sie im Webservice Pfad zur Verfügung stehen. Seite 6 von 10

7 Einrichtung des Webservice zum Senden der Zahldateien Wechseln Sie in die Einrichtung OPplus Zahlungsverkehr und dort in das Register Allgemein Füllen Sie das folgende Feld aus: Feld Inhalt Codeunit Webservice Einrichten des Webservice Wechseln Sie in die Maske Zahlungsvorschläge und dort unter Aktionen in die Maske Zahlungsprovider Erstellen Sie einen Eintrag KONFI_PMT und füllen Sie die Felder wie folgt aus: Feld Code Beschreibung User ID Passwort Credential Typ Protokoll Streams speichern Webservice URL Inhalt KONFI_PMT (Bezeichnung ist beliebig) z.b. Konfipay sendet Zahlungsdateien Geben Sie hier Ihre User ID ein, die Sie von Windata erhalten haben Geben Sie das Passwort ein, dass Sie von Windata erhalten haben Geben Sie die Credentialinfo ein, die Sie erhalten haben SEPA Leer, Alle oder Fehler : Je nach Eintrag werden Protokolleinträge erzeugt Wenn Sie das Protokoll aktiviert haben, können Sie die ggf. die Antworten des Webservice protokollieren Codeunit Webservice Webservice Pfad Ausgang Geben Sie hier einen Pfad ein, in dem die Zahlungsdateien gespeichert werden sollen Bitte beachten Sie, dass dieser Pfad vom Webservice (in der Regel das Mitteltier) und nicht vom Enduser zu erreichen sein muss! Senden der Zahldatei Zum Senden der Zahldateien wechseln Sie in die Maske Zahlungsvorschläge und wählen den Menüpunkt: Aktionen Zahlung per Webservice übertragen. Seite 7 von 10

8 Seite 8 von 10

9 Die notwendigen Objekte stellen wir Ihnen als FOB und TXT Datei kostenlos im Downloadportal unter zur Verfügung: Folgende Objekte sind von der Integration betroffen: Die Objekte können Sie auf Basis einer der folgenden Versionen herunterladen und in Ihre Datenbank mergen: OPplus 9.10 für NAV 2016 OPplus für NAV 2016 OPplus für NAV 2016 eventbasiert Alle Objektänderungen sind wie gewohnt im Code entsprechend von Hotfixes mit der Change ID CHG_ gekennzeichnet. Selbstverständlich können Sie einen Merge der Objekte auch kostenpflichtig nach Aufwand bei uns beauftragen. Da ausschließlich OPplus Objekte betroffen sind, sollte Ihnen dies aber auch möglich sein, wenn Sie eine aktuelle Entwicklerlizenz verwenden, da diese ja mittlerweile auch das Anlegen von branchenspezifischen Feldern erlauben. Denken Sie daran, dass die Kundenlizenz aktualisiert werden muss, wenn Sie diese Objekte nutzen wollen. Seite 9 von 10

10 Weitere Informationen zu OPplus finden Sie unter und gbedv GmbH & Co. KG Loger Straße 22b Osterholz-Scharmbeck Telefon: / Telefax: / info@opplus.de Internet: Dieses Dokument dient nur zu Informationszwecken. Die in diesem Dokument enthaltenen Informationen können jederzeit ohne vorherige Ankündigung nach den technischen und inhaltlichen Anforderungen geändert werden. Diese Unterlagen dürfen weder in Teilen noch als Ganzes ohne vorherige schriftliche Zustimmung der gbedv GmbH & Co. KG in irgendeiner Form oder über irgendwelche Mittel reproduziert oder übertragen werden. Die gbedv GmbH & Co. KG lehnt jede Haftung für Fehler und Unterlassungen in diesem Dokument ab. gbedv Alle Rechte vorbehalten. Stand: Die hier genannte Software darf nur gemäß den Lizenzbedingungen angewendet oder kopiert werden; hier eventuell genannte Warenzeichen sind Eigentum ihrer Inhaber. Seite 10 von 10