Vorabinfo - 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
Informationen zur Umstellung auf Paypal-REST-API-Zugang
Beachten Sie für die Nutzung eines PayPal Kontos über REST-API Zugangsdaten in büro+ folgende Besonderheiten:
...
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"):
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 enthalten
Diese Filterung soll dazu dienen, nicht buchungsrelevante Buchungen nicht mehr importiert werden.
Dazu zählen beispielsweise Datensätze des Typs „T21nn Reserves and releases" („Hold“)
4) 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
3) Event Code und Referenz:
Allen PayPal Buchungen wird im Verwendungszweck der Event Code und wenn vorhanden auch die Referenz hinzugefügt
4) Performance:
Die Routine zum Hinzufügen von PayPal Zahlungen wurde verschnellert
...
Durch die erfolgten Anpassungen entspricht die Nutzung eines PayPal Kontos über REST-API Zugang in büro+ (in der neuen Produktlinie Ab "M") dem gewohnten Ablauf, wie dies bisher auch über den SOAP-API-Zugang erfolgt ist.
Bei Nutzung der alten Produktline (büro+ professional, commercial, univsersal, ERP-complete) werden die Gebühren nur als Information im "Payment Datensatz" geliefert.
| Note | ||
|---|---|---|
| ||
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 hier auch den Hinweis auf der PayPal Developer Webseite. PayPal informiert derzeitig über eine Migration der Daten in die Cloud (August 2021), wodurch derzeitig Störungen auftreten 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:
...
| Info | ||
|---|---|---|
| ||
Informationen zum Vorgabe Status für PayPal Kontoauszüge erhalten Sie in folgendem Artikel: Zahlungsverkehr Parameter. |
REST-API Zugangsdaten für Ihre bestehende PayPal Bankverbindung verwenden
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
...