Einführung
Diese Funktion bietet Nutzern die Möglichkeit, Informationen aus der Currencycloud-Plattform im CSV-Format (.csv) zu extrahieren.
Es gibt 2 verschiedene Arten von Berichten:
● Zahlungsbericht
● Umrechnungsbericht
Berechtigungen für die Berichterstattung
Es gibt zwei Berechtigungen im Zusammenhang mit der Berichtsfunktion von Currencycloud Direct:
● Bericht lesen: Mit dieser Berechtigung können die entsprechenden Nutzer auf die Liste der in ihrem Konto erstellten Berichte zugreifen.
● Bericht schreiben: Diese Berechtigung erlaubt es dem entsprechenden Nutzer, die Erstellung eines neuen Berichts über die Currencycloud-API anzufordern.
Bericht erstellen
Der Ausgangspunkt für die Berichterstellung sind die Suchseiten „Payments“ und „Conversions“. Nachdem Sie eine Suche nach Zahlungen oder Umrechnungen durchgeführt haben, können Sie sich die Ergebnisse auf dem Bildschirm ansehen. Sie können die Ergebnisse weiter filtern, indem Sie die Suchkriterien ändern und eine neue Suche durchführen, indem Sie auf die Schaltfläche „Search“ klicken. Um einen Bericht zu erstellen, der die auf dem Bildschirm angezeigten Ergebnisse enthält, klicken Sie auf die Schaltfläche „Request Report“. Bitte beachten Sie, dass die maximale Größe eines Zahlungs- oder Umrechnungsberichts 200.000 Zeilen beträgt. Wenn Sie einen größeren Bericht benötigen, müssen Sie mehrere Berichte erstellen und die Anzahl der Ergebnisse in jedem Bericht auf weniger als 200.000 Zeilen begrenzen.
Nachdem Sie auf die Schaltfläche „Request Report“ geklickt haben, wird eine Bestätigungsmeldung auf dem Bildschirm angezeigt und der Bildschirm aktualisiert, um die Details der Berichtsanforderung anzuzeigen.
Bericht finden
Alle innerhalb eines Kontos angeforderten Berichte sind auf der Registerkarte „Reports“ auf der Suchen-Seite der Anwendung verfügbar. Der Zugriff auf diese Registerkarte erfolgt über die Berechtigung „Read Report“.
Die Suchfelder oben auf der Seite können verwendet werden, um die Liste der auf dem Bildschirm angezeigten Berichte zu filtern. Wenn ein Bericht den Status „Completed“ hat, steht die Datei des Berichts zum Download bereit. Durch Klicken auf die entsprechende Schaltfläche „Download“ wird die entsprechende .csv-Datei heruntergeladen. Wenn Sie auf die Referenz des Berichts klicken, wird die Seite mit den Details des Berichts angezeigt, wie unten dargestellt.
Statusmeldungen
Processing – Ausgangszustand, d. h. Ihre Anfrage wird verarbeitet (Daten sammeln, Bericht erstellen, Bericht speichern).
Completed – der Bericht wurde erfolgreich erstellt und enthält einen Link zum Bericht. Sie können ihn nach ID abrufen und alle Informationen zu diesem Bericht sowie eine URL zum Herunterladen des CSV-Berichts anzeigen.
Failed – dieser Status bedeutet, dass ein Fehler aufgetreten und die Berichterstellung fehlgeschlagen ist. Der Link zum CSV-Bericht wird nicht angezeigt.
Expired – wenn ein Bericht erfolgreich erstellt wurde, läuft er nach einem Tag ab.
Inhalt des Berichts
Zahlungsbericht
Die Zahlungsberichtsdateien enthalten die folgenden Informationen im CSV-Format.
Entität | Feld | Spaltentitel im CSV-Bericht |
---|---|---|
Kontakt | your_reference | Kontaktreferenz |
Kontakt | id | Kontakt-ID |
Kontakt | login_id | Ersteller-Login-ID |
Kontakt | first_name | Vorname des Autors |
Kontakt | last_name | Nachname des Autors |
Kontakt | account_name | Kontobezeichnung des Autors |
Zahler | Id | Zahler-ID |
Zahler | legal_entity_type | Zahler-Typ |
Zahler | company_name | Unternehmensname des Zahlers |
Zahler | first_name | Vorname des Zahlers |
Zahler | last_name | Nachname des Zahlers |
Umrechnungen | uuid | Eindeutige ID Umrechnung |
Umrechnung | short_reference | Umrechnungsreferenz |
Umrechnung | Unique_request_id | Eindeutige ID Umrechnungsanforderung |
Umrechnung | sell_currency | Verkaufswährung der Umrechnung |
Umrechnung | sell_amount | Verkaufsbetrag der Umrechnung (client_sell_amount) |
Umrechnung | Order_sell_amount | Betrag der verkauften Währung für die betreffende Zeile. Dieser sollte Folgendem entsprechen: (Zahlungsbetrag / Kundentarif) |
Umrechnung | client_rate | Kundentarif |
Umrechnung | Settlement_date | Abwicklungsdatum der Umrechnung |
Umrechnung | Settlement_reference | Abwicklungskurzbezeichnung der Umrechnung |
Umrechnung | Conversion_date | Datum der Umrechnung |
Zahlung | uuid | Eindeutige ID Zahlung |
Zahlung | short_reference | Kurzbezeichnung der Zahlung |
Zahlung | amount | Betrag |
Zahlung | Unique_request_id | Eindeutige ID Zahlungsanforderung |
Zahlung | currency | Währung |
Zahlung | status | Status |
Zahlung | payment_type | Zahlungsart |
Zahlung | reference | Referenz |
Zahlung | reason | Grund |
Zahlung | failure_reason | Grund für den Fehler |
Zahlung | payment_group_id | ID der Zahlungsgruppe |
Zahlung | bulk_upload_reference | Referenz Massenupload |
Zahlung | payment_date | Datum der Zahlung |
Zahlung | created_at | Datum der Zahlungserstellung |
Begünstigter | name | Spitzname des Begünstigten |
Begünstigter | beneficiary_entity_type | Art der begünstigten Entität |
Begünstigter | beneficiary_company_name | Unternehmensname des Begünstigten |
Begünstigter | beneficiary_first_name | Vorname des Begünstigten |
Begünstigter | beneficiary_last_name | Nachname des Begünstigten |
Begünstigter | bank_account_holder_name | Name des Kontoinhabers der Begünstigtenbank |
Begünstigter | beneficiary_address | Adresse des Begünstigten |
Begünstigter | beneficiary_city | Ort des Begünstigten |
Begünstigter | beneficiary_postcode | Postleitzahl des Begünstigten |
Begünstigter | beneficiary_state_or_province | Bundesstaat oder Provinz des Begünstigten |
Begünstigter | beneficiary_country | Land des Begünstigten |
Begünstigter | E-Mail-Adresse des Begünstigten | |
Begünstigter | beneficiary_date_of_birth | Geburtsdatum des Begünstigten |
Begünstigter | beneficiary_identification_type | ID-Typ des Begünstigten |
Begünstigter | beneficiary_identification_value | ID-Wert des Begünstigten |
Begünstigter | account_number | Kontonummer des Begünstigten |
Begünstigter | routing_code_type_1 | Routing-Typ 1 des Begünstigten |
Begünstigter | routing_code_value_1 | Routing-Wert 1 des Begünstigten |
Begünstigter | routing_code_type_2 | Routing-Typ 2 des Begünstigten |
Begünstigter | routing_code_value_2 | Routing-Wert 2 des Begünstigten |
Begünstigter | bic_swift | BIC/SWIFT |
Begünstigter | iban | IBAN |
Begünstigter | bank_country | Land der begünstigten Bank |
Begünstigter | bank_name | Name der begünstigten Bank |
Begünstigter | bank_account_type | Begünstigter Bankkontotyp |
Begünstigter | bank_address | Adresse der begünstigten Bank |
Begünstigter | created_at | Begünstigter erstellt am |
Begünstigter | updated_at | Begünstigter aktualisiert am |
Umrechnungsbericht
Die Umrechnungsberichtsdateien enthalten die folgenden Informationen im CSV-Format.
Entität | Feld | Spaltentitel im CSV-Bericht |
---|---|---|
Konto | account_name | Kontoname |
Konto | your_reference | Kontoreferenz |
Kontakt | login_id | Kontakt Login-ID |
Kontakt | id | Kontakt-ID |
Kontakt | your_reference | Kontaktreferenz |
Kontakt | first_name | Kontakt Vorname |
Kontakt | last_name | Kontakt Nachname |
Umrechnung | uuid | Eindeutige ID Umrechnung |
Umrechnung | short_reference | Umrechnungsreferenz |
Umrechnung | Unique_request_id | Eindeutige ID Anforderung |
Umrechnung | settlement_date | Abwicklungsdatum |
Umrechnung | conversion_date | Datum der Umrechnung |
Umrechnung | created_at | Erstellungsdatum der Umrechnung |
Umrechnung | updated_at | Aktualisierungsdatum der Umrechnung |
Umrechnung | client_status | Kundenstatus |
Umrechnung | partner_status | Partnerstatus |
Umrechnung | buy_currency | Kaufwährung |
Umrechnung | sell_currency | Verkaufswährung |
Umrechnung | fixed_side | Feste Seite |
Umrechnung | partner_buy_amount | Partner Kaufbetrag |
Umrechnung | partner_sell_amount | Partner Verkaufsbetrag |
Umrechnung | client_buy_amount | Kunden Kaufbetrag |
Umrechnung | client_sell_amount | Kunden Verkaufsbetrag |
Umrechnung | core_rate | Kernrate |
Umrechnung | partner_rate | Partnerrate |
Umrechnung | client_rate | Kundentarif |
Umrechnung | unallocated_funds | Nicht zugewiesene Mittel |
Umrechnung | deposit_required | Einzahlung erforderlich |
Umrechnung | deposit_amount | Einzahlungsbetrag |
Umrechnung | deposit_currency | Einzahlungswährung |
Umrechnung | deposit_status | Einzahlungsstatus |
Umrechnung | deposit_required_at | Einzahlung erforderlich am |