Hochladen und Herunterladen von Dateien mit ConCardis Batch (basic)

Transkript

1 Hochladen und Herunterladen von Dateien mit ConCardis Batch (basic)

2 Inhaltsverzeichnisses 1. Einleitung 2. Manuelles Hochladen einer Datei 2.1 Vorbereitung der Transaktionsdateien 2.2 Manuelles Hochladen schritt1: Dateiauswahl Schritt 2: Formatprüfung Schritt 3: Hochladen der Ergebnisse 3. Hochgeladene Dateien ansehen 3.1 Einige Dateikriterien Unterschiedliche Dateireferenzen Dateistatus Codes 4. Herunterladen einer Datei 4.1 Elektronische Berichterstattung 5. Anlage: Dateilayout Page 1 of 12-30/06/2017

3 1. Einleitung Der ConCardis Batch-Modus erlaubt Ihnen die Gruppierung Ihrer Zahlungen in formatierte Dateien, die Sie anschließend hochladen können. Diese Option eignet sich besonders für eine große Anzahl von Zahlungen oder sich wiederholende Abrechnungen. Das vorliegende Handbuch beschreibt wie Sie Batch-Dateien zu erstellen und zu verwalten und hochladen. Weitere Details zur technischen Integration (z. B. Automatisierung des Upload-und Download-Prozess) entnehmen Sie Advanced Batch. Page 2 of 12-30/06/2017

4 2. Manuelles Hochladen einer Datei 2.1 Vorbereitung der Transaktionsdateien Bei den Dateien, die Sie hochladen, muss es sich um Klartext-Dateien (Plain Text Files) handeln, die ein bestimmtes Dateiformat aufweisen, das mit jeder Anwendung (z.b. MS Access, MS Excel etc.) erstellt werden kann. Falls Sie nicht über eine Applikation verfügen, die diese formatierten Transaktionsdateien erstellen kann, können Sie die Dateien manuell erzeugen. In diesem Fall müssen Sie Transaktionszeile für Transaktionszeile eingeben (max Linien). Wir stellen Ihnen jedoch eine MS Excel-Datei bereit, die Ihnen helfen wird, die formatierten Transaktionsdateien zu generieren. Das MS Excel-Spreadsheet beinhaltet ein Makro, das Ihnen die Erstellung einer einfachen Textdatei ermöglicht, die alle Informationen des Spreadsheets enthält. Es handelt sich nicht um das Spreadsheet selbst, das Sie hochladen müssen, sondern um die Textdatei, die Sie mithilfe der Makro- Anwendung aus dem Spreadsheet erstellen. Weitere Informationen finden Sie unter Die Spezifikationen des Dateilayout. 2.2 Manuelles Hochladen Klicken Sie in Ihrem ConCardis Back-Office-Menü auf den Link Batchupload zum Hochladen einer neuen Zahlungsdatei schritt1: Dateiauswahl Gehen Sie auf die Schaltfläche Browse, um die Datei, die Sie hochladen möchten auf Ihrem Computer auszuwählen. Geben Sie eine Referenz (Name) für die Datei ein. Sie können diese Referenz verwenden, wenn Sie zu einem späteren Zeitpunkt noch einmal auf diese Datei zugreifen möchten. Klicken Sie auf die Schaltfläche Transaktionsdatei upload Schritt 2: Formatprüfung Nachdem Sie eine Datei hochgeladen haben, unterziehen wir die Datei einer Formatprüfung. Wir prüfen, ob das Layout der Datei korrekt ist und ob die Inhalte mit dem Format übereinstimmen. In diesem Stadium sind die Transaktionen noch nicht in unserer Datenbank gespeichert. Zu dem Zeitpunkt können Sie, sofern notwendig, die Datei noch stornieren. Auf der Seite der Formatprüfung sehen Sie: Die ersten gültigen Transaktionen der Datei (die Anzahl ist abhängig von der Anzahl, die Sie auf dem vorherigen Bildschirm eingegeben haben) Fehler, die bei der Prüfung des Transaktionsformates aufgetreten sind Gesamtbeträge pro Währung Unsere Dateireferenz Eine Liste mit hochgeladenen Dateien des letzten Monats, mit denselben Gesamtbeträgen und / oder derselben Summe/Addition von Page 3 of 12-30/06/2017

5 Kartennummern, so dass Sie dieselbe Datei nicht doppelt senden. Eine Liste der Dateien, die noch keinen endgültigen Dateistatus aufweisen. Wenn die Formatprüfung erfolgreich d.h. ohne das Aufdecken von Fehlern abgeschlossen wurde, klicken Sie auf Weiter", damit die Datei von unserem System verarbeitet wird. Falls Sie vergessen haben, auf die Schaltfläche Weiter" zu klicken, wird Ihre Datei nicht verarbeitet und verbleibt im Status Checked". Umfasst die Datei mehr als 100 Transaktionen, sehen Sie ein Auswahlmenü, mit dessen Hilfe Sie den Verarbeitungsmodus SYNC oder ASYNC der Datei wählen: Falls Sie den SYNC-Modus wählen, erhalten Sie im nächsten Schritt die Ergebnisse des Hochladens auf Ihrem Bildschirm. Vorausgesetzt Ihr Browser schließt nicht automatisch die Sitzung nach einer bestimmten Zeit. (Bei den angezeigten Ergebnissen handelt es sich nicht um die Autorisierungs-/Finanzergebnisse in Bezug auf die Acquirer, da dieser Prozessschritt - das Hochladen von Dateien stets offline abgewickelt wird). Im ASYNC-Modus erfolgt das Hochladen offline und Sie erhalten eine von uns, wenn die Datei von unserem System geprüft wurde. Der ASYNC-Modus ist empfehlenswert für Dateien, die eine große Anzahl von Transaktionen enthalten. Der folgende Screenshot zeigt eine Datei mit einer fehlerhaften Transaktion (ungültige Kreditkartennummer). Wenn Prüfungsfehler angezeigt werden, haben Sie zwei Möglichkeiten: Sie können auf die Schaltfläche Weiter" klicken. Dann wird unser System die Datei mit den fehlerfreien Transaktionen verarbeiten. Die Transaktionen, die Prüffehler aufweisen (rot markiert) werden nicht verarbeitet. Für alle rot" markierten Transaktionen müssen Sie später eine neue Datei erstellen und senden. Dabei müssen Sie sicherstellen, dass die ursprünglich mit diesen Transaktionen aufgetretenen Probleme behoben sind. Sie klicken auf die Schaltfläche Abbrechen", um die gesamte Datei zu stornieren. Dann beheben Sie die Fehler in den Transaktionen und senden die Datei erneut. Wenn Sie alle Probleme beseitigt haben, wird die Formatprüfung erfolgreich sein und Sie können mit der Verarbeitung fortfahren. Page 4 of 12-30/06/2017

6 Laden Sie dieselbe Datei nicht zweimal hoch (sofern Sie nicht die erste Einreichung storniert haben), selbst wenn Sie keine Antwort von unserem Server erhalten haben. Prüfen Sie immer erst den Status der Datei, bevor Sie weitere Schritte veranlassen Schritt 3: Hochladen der Ergebnisse Im Rahmen von Schritt 3 verarbeiten wir die Datei, d.h. wir importieren die Transaktionen in unsere Datenbank und senden sie an die Acquirer/Banken. Das Ergebnis dieses Prozessablaufs wird auf der Seite Upload Resultate angezeigt. SYNC modus: Auf der Seite Upload Resultate" sehen Sie folgende Zusatzinformationen: Die Anzahl der Transaktionen sowie die Anzahl der akzeptierten" Transaktionen d.h. der Transaktionen, die von unserem System für die Verarbeitung akzeptiert wurden, nicht das Finanzergebnis! Transaktionen, die nicht von unserem System verarbeitet wurden - aufgrund von Fehlern, die bei der Formatprüfung aufgetreten sind. Die PAYIDs der Transaktionen. Nach Ausführung von Schritt 3 weist die Datei den Status Loaded" auf. Dieser Status dauert an, bis der Versand aller Transaktionen an die Acquirer/Banken abgeschlossen ist und der endgültige Status von den Acquirern/Banken bestätigt wurde. Ist dies erfolgt, ändert sich der Dateistatus von Loaded" in Processed". Den endgültigen Status der Transaktionen können Sie in Ihrem Back-Office-Menü nachsehen. Der folgende Screenshot zeigt das Ergebnis des Hochladens einer Datei, die eine Transaktion enthält, die von unserem System abgelehnt wurde. Diese Transaktion wird nicht verarbeitet. Wenn Sie die Transaktion dennoch verarbeiten möchten, müssen Sie für diese rot" markierte Transaktion eine neue Datei erstellen und senden. Sie müssen dabei sicherstellen, dass das Problem aus dem die ursprüngliche Ablehnung dieser Transaktion resultierte, behoben wurde. Es ist möglich, dass in Schritt 3 die Zahl der Fehlermeldungen höher ist als in Schritt 2. Der Grund dafür ist, dass wir im Verlauf von Schritt 3 eine Anzahl zusätzlicher Prüfungen durchführen. ASYNC modus: Page 5 of 12-30/06/2017

7 Auf der Seite Upload Resultate" werden Ihnen keine zusätzlichen Informationen zur Verfügung gestellt, da die Datei im Offline-Modus hochgeladen wird. Sobald die Datei von unserem System geprüft wurde, erhalten Sie eine . Nach dem Schritt 3 befindet sich die Datei im Status To be loaded". Dieser Status dauert an, bis alle Transaktionen hochgeladen wurden, d.h. in unsere Datenbank importiert worden sind. Sobald dies abgeschlossen ist, weist die Datei den Status Loaded" auf solange bis alle Transaktionen an die Acquirer/Banken gesendet wurden und der endgültige Status von den Acquirern/Banken bestätigt wurde. Ist dies erfolgt, ändert sich der Dateistatus von Loaded" in Processed". Den endgültigen Status der Transaktionen können Sie in Ihrem Back-Office-Menü nachsehen. Anstelle eines manuellen Hochladeprozesses (über das Back-Office) können Sie Ihre Zahlungsdateien auch automatisch hochladen (mithilfe einer Anwendung). Weitere Informationen dazu finden Sie im Handbuch Advanced Batch". Page 6 of 12-30/06/2017

8 3. Hochgeladene Dateien ansehen Sie können in Ihrem Back-Office-Menü über den Link Batchübersicht Dateien, die Sie vor Kurzem hochgeladen haben (manuell oder automatisch) anschauen. Dateien, die sich nicht mehr in dieser Liste befinden, können Sie nachschlagen, indem Sie auf die Schaltfläche mehr Dateien klicken. Sie haben die Möglichkeit, sich eine Zusammenfassung der Dateidaten und eine Finanzhistorie der Dateitransaktionen anzusehen oder die Dateitransaktionsdaten herunterzuladen (s. Abschnitt Datei-Download ). Möchten Sie eine dieser Optionen ausführen, gehen Sie auf die entsprechende Schaltfläche Zusammenfassung, Details oder Herunterladen. Der folgende Screenshot zeigt eine Zusammenfassung von Dateidaten und Transaktionsergebnissen. Weitere Informationen finden Sie unter Transaktionen Ansehen. Die Transaktionsergebnisse sind erst endgültig, wenn die hochgeladene Datei den Status Processed anzeigt. 3.1 Einige Dateikriterien Dieser Abschnitt beschreibt einige wichtige Kriterien im Zusammenhang mit dem Nachschauen einer Datei. Für weitere Informationen, klicken Sie auf die "Mehr Informationen"-Link im Menü "Vörgange > Batchübersicht" Unterschiedliche Dateireferenzen Page 7 of 12-30/06/2017

9 Datei ID (FileID): einmalige Dateireferenz, die von unserem System vergeben wird. Händler Ref: Dateireferenz, die Sie eingeben, wenn Sie die Datei hochladen Dateistatus Uploaded: Die Datei ist eingegangen, wurde jedoch noch nicht geprüft. To be checked: Die Datei ist noch zu prüfen. Checked: Die Datei wurde geprüft. Cancelled: Die Datei wurde nach dem Prozessschritt Prüfung storniert. To be loaded: Die Datei ist bereit, in unser Verarbeitungsmodul (nur im ASYNC-Modus) geladen zu werden. Being loaded: Die Datei wird gerade in unser Verarbeitungsmodul geladen. Loaded: Die Datei wurde in unser Verarbeitungssystem geladen, aber einige der Zahlungen sind noch nicht an die Acquirer/Banken gesendet. Processed: Alle Zahlungen in der Datei wurden an die Aquirer/Banken gesendet Codes Es gibt folgende Dateitransaktionscodes: ATR: Code für neue Transaktionen MTR: Code für Maintenance-Operationen an bestehenden Transaktionen Jede Datei, die Sie hochladen ist automatisch eine ATR-Datei, sofern Sie diese im Dateikopf nicht anders spezifizieren. Page 8 of 12-30/06/2017

10 4. Herunterladen einer Datei Sie können eine Zahlungsdatei (Transaktionsergebnisse) manuell herunterladen, indem Sie folgende Schritte ausführen: Klicken Sie in Ihrem Back-Office-Menü auf den Link Reporting. Wählen Sie dann Ihre bevorzugte Dateistruktur und das Dateiformat aus. Geben Sie die Suchkriterien für die Transaktionsergebnisse ein, die Sie in Ihrem Back-Office-Menü über die Links Transaktionsansicht oder Finanzielle Historie herunterladen möchten. Oder wählen Sie die Transaktionsdatei, die Sie herunterladen möchten über den Link Batchübersicht in Ihrem Back-Office-Menü. Klicken Sie auf die Schaltfläche Liste herunterladen". Sie können Ihre Zahlungsdateien auch automatisch herunterladen (mithilfe einer Anwendung) anstatt manuell (über das Back-Office). Weitere Informationen finden Sie unter Advanced Batch. 4.1 Elektronische Berichterstattung Auf der Seite Reporting können Sie das Format und die Struktur für die elektronische Berichterstellung festlegen, wie etwa das Herunterladen von Dateien. Ist für Ihr Konto die Option Push-Reports (Automatisierte Kontrollen und Plausibilitätsprüfungen) aktiviert, erhalten Sie über den Link Reporting Zugang zu der Liste dieser Reports. Abhängig von der Dateistruktur werden mit Ihren heruntergeladenen Dateien spezielle Felder zurückgesandt. Sie können zwischen unterschiedlichen Dateistrukturen wählen: Standard Extended File Management Dynamic Darüber hinaus stehen Ihnen unterschiedliche Rückgabeformate zur Verfügung: XML Format mit fester Länge (fixed-length) Abgegrenztes Format (delimited) Weitere Informationen über die Download-Strukturen finden Sie unter die "Beschreibung der Zahlungsdateien heruntergeladen"-seite im Support-Bereich des ConCardis Back-Office. Weitere Details zu den unterschiedlichen Dateiformaten finden Sie unter Advanced Batch. Tipps: Wir empfehlen Ihnen für den Erhalt von MS Excel-Ergebnisdateien die Verwendung der Dynamic Struktur mit einem abgegrenzten Delimited (;) Dateiformat mit.csv Erweiterung. Für den Spaltenkopf in Ihren Ergebnisdateien aktivieren Sie bitte auf der Seite Reporting die Funktion With column headers in der Rubrik Andere. Page 9 of 12-30/06/2017

11 5. Anlage: Dateilayout Bereiten Sie Ihre Datei vor, unter Berücksichtigung folgender Regeln: Bei den Dateien muss es sich um Text-ASCII-Dateien handeln Eine Zeile pro Auftrag (mit Ausnahme von Dateikopf und/oder Dateinachsatz), Zeilenumbruch durch Zeilenumschaltung und Zeilenvorschubzeichenpaar (ASCII : HEX : 0xD 0xA) Die Felder mussen durch Semikolon ; getrennt werden Die Felder selbst dürfen kein ; aufweisen. Übersicht der Dateifelder: Field # Field Erläuterung 1 AMOUNT Zahlungsbetrag multipliziert mit 100 (kein Komma oder Punkt zur Anzeige von Dezimalstellen) 2 CURRENCY Währung in ISO-Code Alpha, z.b.: EUR, USD, GBP, CHF, Hinweis: Um eine optimale Verarbeitung Ihrer Batch-Dateien zu gewährleisten, sollten alle in Ihrem ConCardis-Konto unter Konfiguration > Konto > Währung konfigurierten Währungen gemäß der verwendeten Zahlungsmethode konfiguriert werden (Konfiguration > Zahlungsmethoden > Vertragsdaten). 3 BRAND Card brand ( Direct Debits NL for Direct Debits NL oder Kartentyp order die Bezeichnung des Zahlungsmittels) 4 CARDNO Kartennummer/Kontonummer (eine Bankkontonummer sollte immer haben 10 Ziffern: wenn das Konto haben weniger als 10 Ziffern, komplett mit Nullen auf der linken Seite. Für die Postbank- Konten: "000" + 7 Ziffern oder "P00" + 7 Ziffern) 5 ED Gültigkeitsdatum (MM/JJ oder MMJJ (99/99 or 9999 for Direct Debits NL) 6 ORDERID Ihre einmalige Händlerreferenz (z.b. Bestellnummer) 7 COM Auftragsbeschreibung 8 CN Kundenname 9 PAYID Einmalige Referenz, die von unserem System für einen Auftrag vergeben wird (Bezahlungs ID) 10 OPERATION Die Zahlungsabwicklung, im Bereich Globale Transaktionsparameter, Abschnitt Standardoperationswert der technischen Informationen, definiert den Standardwert. Wenn Sie an dieser Stelle in der Datei einen Wert angeben, wird der Standardwert überschrieben. Im Parameter-Cookbook finden Sie eine Liste möglicher Werte 11 AUTHORIZATION CODE Autorisierungscode eines Auftrags (nicht von unserem System generiert) 12 AUTHORIZATION MODE Der Modus, in dem der Autorisierungscode (in Feld 11) eingegangen ist. Möglicher Wert: TEL für telefonische Autorisierung Page 10 of 12-30/06/2017

12 13 AUTHORIZATION DATE Das Datum/Zeit, an dem der Autorisierungscode (in Feld 11) eingegangen ist. (MM/TT/JJ HH:MM:SS) 14 PSPID Your affiliation name in our system 15 GLOBORDERID Globale Referenz für mehrere Aufträge. Erforderlich, um eine Maintenance-Operation für mehrere Aufträge anzufragen... Blank fields OWNERADDRESS Adresse des Käufers 23 OWNERZIP PLZ des Käufers 24 OWNERTOWN Stadt des Käufers 25 OWNERCTY Land des Käufers. (ISO-Code Alpha) 26 OWNERTELNO Telefonnummer des Käufers 27 CVC Card Verification Code (Kartenprüfnummer)... Blank fields... Electronic Commerce Indicator. Im Bereich Globale Transaktionsparameter, Abschnitt Standard-ECI-Wert, in den technischen Informationen, können Sie einen Standardwert definieren. Wenn Sie an dieser Stelle in der Datei einen Wert angeben, wird der Standardwert überschrieben. 35 ECI Mögliche ECI-Werte (Nummerisch): 0 Karte durchgezogen (Karte ausgelesen) 1 Manuelle Eingabe: Mail Order/Telephone Order (MOTO) (Karte liegt nicht vor) 2 Wiederkehrende Zahlungen, von MOTO abstammend 3 Ratenzahlungen 7 E-Commerce mit SSL-Verschlüsselung 9 Wiederkehrend nach der ersten E-Commerce-Transaktion Hinweis: Sie können gegebenenfalls auch zusätzliche Felder senden, wenn Sie bestimmte Optionen/Funktionalitäten in Ihrem ConCardis Konto aktiviert haben. Überprüfen Sie die Dokumentation der Option für weitere Informationen über die damit verbundenen Zusatzfeldern. Dateikopf und Dateinachsatz: OHL: Login-Information (nicht erforderlich, wenn Sie eine Datei manuell hochladen) OHF: Dateikopf mit den allgemeinen Dateiparametern (nur erforderlich, wenn der Transaktionscode MTR ist) Format: OHF;Händler-Dateireferenz;Transaktionscode (ATR/MTR);Operation;Anzahl der Aufträge OTF: Allgemeiner Dateinachsatz, festgelegt am Ende der Datei (nur notwendig, wenn die Datei über einen Dateikopf verfügt) Weitere Informationen finden Sie unter Advanced Batch. Beispiele: ATR-Datei OHF;File ;ATR;;3; Page 11 of 12-30/06/2017

13 1000;EUR;; ;11/02;Order0001;;Paul Smith; 100;EUR;; ;11/02;Order0002;;Bill Durand; 2032;EUR;; ;11/02;Order0003;;John Doe; OTF; oder 1000;EUR;; ;11/02;Order0001;;Paul Smith; 100;EUR;; ;11/02;Order0002;;Bill Durand; 2032;EUR;; ;11/02;Order0003;;John Doe; MTR-Datei OHF;Filename;MTR;SAS;1; 1000;EUR;;;;;;; ; OTF; Page 12 of 12-30/06/2017