...
Technische
...
Besonderheiten die nur für den Abruf von
...
PayPal Kontobewegungen über REST-API gelten:
Bislang wurden PayPal Buchungen ohne programmseitige Filterungen und Ergänzungen so importiert, wie sie von der eingesetzten Bankingkomponente übertragen wurden.
Da die Datenhaltung über REST-API jedoch eine andere ist, war es notwendig programmseitig Anpassungen vorzunehmen um dem Anwender einen Ablauf zu ermöglichen, der dem Ablauf über den klassischen NVP/SOAP-API Zugang ähnelt.
Nachfolgend eine Übersicht der programmseitigen Anpassungen für den Abruf von PayPal Datensätzen über die REST API:
1) Es werden programmseitig Gebühren Datensätze erzeugt (da der Abruf über REST-API keine separate Buchung mehr für die Gebühren liefert)
2) Die Programmroutinen in büro+ wurden dahingehend angepasst, dass die neuen Status Bezeichnungen von PayPal Berücksichtigung finden (siehe unter PARAMETER - ABRECHNUNG - ZAHLUNGSVERKEHR PARAMETER → "Vorgabe Status für PayPal Kontoauszüge")
Ab Update 6740 (veröffentlicht Ende Dezember 2022):
3) Eine programmseitige Filterung der Buchungen ("Bookings"), damit nicht buchungsrelevante Buchungen nicht mehr importiert werden. Dazu zählen beispielsweise Datensätze des Typs „T21nn Reserves and releases" („Hold“).
Es werden alle Bookings gefiltert, die eine ReferenzTyp auf eine andere PayPal Zahlung (TXN) haben
UND eine Referenznummer
UND der EventCode nicht mit T11 anfängt
UND die Gebühr nicht leer ist
UND Kein Surname, Givenname oder AlternateFullname enthalten4) Differenzierung zwischen Gebühr und Zahlung durch Ergänzung der Bezeichnung "Payment":
Allen PayPal Zahlungen die kein Gebühren-Datensatz darstellen, wird im Verwendungszweck programmseitig das Wort "Payment" hinzugefügt
34) Event Code "EC" und Referenz:
Allen PayPal Buchungen wird im Verwendungszweck der Event Code und wenn vorhanden auch die Referenz hinzugefügt hinzugefügt. Der Eventcode beginnt jeweils mit "EC" gefolgt vom PayPal Transaction Event Code. Als Beispiel: EC T0005
Eine Auflistung der Transaction Event Codes finden Sie auf dem nachfolgendem PayPal Weblink: https://developer.paypal.com/docs/transaction-search/transaction-event-codes/
54) Performance:
Die Routine zum Hinzufügen von PayPal Zahlungen wurde verschnellert
| Noteinfo | ||||
|---|---|---|---|---|
| ||||
Transaktionen werden über REST-API mit bis zu 3 Stunden Verzögerung abgerufen:Der Abruf über REST-API erfolgt über eine Reporting API. Diese Schnittstelle liefert die Transaktionen mit bis zu drei Stunden Verzögerung. Programmseitig kann kein Einfluss auf diese verzögerte Bereitstellung der Daten über die REST-API genommen werden. Limitierung von 10.000 Buchungen seitens PayPal: "RESULTSET_TOO_LARGE"Bei der Umsatzabfrage von PayPal Kontobewegungen über die REST-API“ gibt es ein Limit von 10.000 Buchungen. 2) Wir weisen darauf hin, dass das Limit nicht davon abhängig ist wie viele Datensätze tatsächlich in büro+ importiert werden, sondern davon abhängt, wie viele Buchungen in dem abgerufenen Zeitraum bei PayPal verbucht sind. 3) Es gilt zu beachten, dass der Abfrage-Zeitraum bei Verwendung des Kennzeichen: "Doppelte Buchungen über die Bankingkomponente filtern" von der eingesetzten Bankingkomponente gesteuert wird. Der Abgleich erfolgt hierbei auch immer für "ganze Tage", weshalb ein mehrmaliger untertägiger Abruf nicht zur Minderung der abzurufenden Datensätze führt. 4) Ist bei Ihnen im Unternehmen anzunehmen, dass das Limit von 10.000 Buchungen innerhalb einer Umsatzabfrage erreicht wird, so empfehlen wir Ihnen für die Dublettenfilterung das Kennzeichen "Doppelte Kontobewegungen aussortieren" (https://hilfe.microtech.de/x/XAyz) zu verwenden und den Abgleich der PayPal Kontobewegungen über eine "Automatisierungsaufgabe" (https://hilfe.microtech.de/x/DgDcDw) vorzunehmen, damit Sie für den Abruf der Kontobewegungen kurze Intervalle (beispielsweise alle 3 Stunden) festlegen können und damit eine geringeren Anzahl an Buchungen pro Umsatzabfrage erhaltenWir empfehlen Ihnen die büro+ seitige Umstellung zunächst mit einer weiteren, neuen büro+ PayPal Bankverbindung vorzunehmen und Ihre bestehende PayPal Bankverbindung (die noch über SOAP-API Zugang erfolgt) erst nach einem Test der neuen Bankverbindung neu zu initialisieren. Bitte beachten Sie auch dass durch die abweichende Datenhaltung der Datensätze die in der microtech büro+ verfügbaren Dublettenfilter nicht greifen können. |
Zugang zur REST-API von PayPal erstellen
Mit den folgenden Schritten erzeugen Sie auf der PayPal Developer Webseite einen Zugang zur PayPal REST-API, den Sie anschließend in der büro+ Software für den Abruf der PayPal Datensätze verwenden können:
...
| Note | ||
|---|---|---|
| ||
|
REST-API Zugangsdaten für Ihre bestehende PayPal Bankverbindung verwenden
| Noteinfo | ||
|---|---|---|
| ||
Informationen zum Vorgabe Status für PayPal Kontoauszüge erhalten Sie in folgendem Artikel: Zahlungsverkehr Parameter. |
...
| |
Wir empfehlen Ihnen die büro+ seitige Umstellung zunächst mit einer weiteren, neuen büro+ PayPal Bankverbindung vorzunehmen und Ihre bestehende PayPal Bankverbindung (die noch über SOAP-API Zugang erfolgt) erst nach einem Test der neuen Bankverbindung neu zu initialisieren. Bitte beachten Sie auch dass durch die abweichende Datenhaltung der Datensätze die in der microtech büro+ verfügbaren Dubletten Filter nicht greifen können. |
Um die neu erzeugten REST-API Zugangsdaten für Ihre bestehende PayPal Bankverbindung zu verwenden, gehen Sie bitte wie folgt vor:
1. Erstellen Sie eine aktuelle Datensicherung
2. Begeben Sie sich über die Registerkarte: DATEI - INFORMATIONEN - AKTUELLE FIRMA/FILIALE/MANDANT - MANDANT BEARBEITEN auf das Register: "Bankverbindungen"
3. Rufen Sie Ihre PayPal Bankverbindung zum "Ändern" auf
...