PayPal (API)
Der Live Import der Kontoauszüge (Anbindung an Xentral und Abholung der Auszüge per Knopfdruck) ist für Bankkonten mit FinTS und HBCI4PHP sowie PayPal möglich. Hierbei können die Auszüge der letzten X Tage abgeholt werden. Es darf nur ein Benutzer pro Konto hinterlegt werden, da es sonst zu doppelten Buchungen kommt. Bitte legen Sie ein Geschäftskonto nicht mehrfach an.
Diese Einstellungen sind nur beim Live-Abholen des Kontoauszuges (z.B. PayPal) relevant. Buchungen können direkt automatisiert per Knopfdruck abgeholt werden.
Folgende Einstellungen sind hier relevant: - Typ → Konto: PayPal (API)
- Live-Import aktiv → Haken aktiviert den Live-Import (Voraussetzung: korrekte Eingabe der API Daten bei „Zugangsdaten Live-Import)
- Zugangsdaten Live-Import → API Code für den Live-Import (zu finden in Ihrem PayPal Account → Anleitung s.u.)
Diese Felder werden mindestens benötigt:- API_USERNAME → PayPal API Username (zu finden in Ihrem PayPal Account → Anleitung s.u.)
- API_PASSWORD → PayPal API Passwort (zu finden in Ihrem PayPal Account → Anleitung s.u.)
- API_SIGNATURE → PayPal API Signature (zu finden in Ihrem PayPal Account → Anleitung s.u.)
- API_DAYS → individuelle Einstellungsmöglichkeit (Abholung der letzten X Tage → kann individuell eingestellt werden, dabei ist die tägliche Menge der Transaktionen zu berücksichtigen. bei großen Mengen muss evtl. der Servertimeout umgestellt werden)
- API_ALLPAYMENTS → Optional (kann auch weggelassen werden): Wert "1" bedeutet, dass sowohl Einnahmen, als auch Ausgaben abgeholt werden. Ohne diese Zeile (API_ALLPAYMENTS=>1;) werden nur die Einnahmen abgeholt.
Einzutragen in Xentral (ganz unten in die Box: Live-Import):
API_USERNAME=>XXXXXXX;
API_PASSWORD=>XXXXX;
API_SIGNATURE=>XXXXXXXXXX;
API_DAYS=>5;
API_ALLPAYMENTS=>1;
Info: Der Pfeil ist ein Gleichzeichen und Größerzeichen. 
Der Live-Import holt die Einnahmen der letzten X Tage ab. Ausgaben können auch über den .csv Import eingespielt werden. Bei Ausgaben entstehen bei PayPal sehr viele Querbuchungen (z.B. Prüfungen und Währungsumrechnungen), die im Live-Import und .csv Import nicht ausgefiltert werden. Diese Buchungen können entweder auf ein "Durchlaufende Posten Konto" weggebucht werden oder als Importfehler verbucht werden.PayPal Api Daten abrufen:
Die Daten für die PayPal Api erhalten Sie über Ihr PayPal Konto - Loggen Sie sich ein
- Klicken Sie rechts oben auf: Mein Profil → Kontoeinstellungen → Verkäufer/Händler → API-Zugriff "aktualisieren" → Option2 → API-Berechtigung anfordern → Fordern Sie eine API-Signatur an.
Aufruf PayPal-Konto zur Verarbeitung der Kontoauszüge:
Sofern das PayPal Konto fertig in Xentral eingerichtet ist, können die Kontoauszüge abgerufen werden über:
Buchhaltung → Zahlungseingang → 
Sollte der PayPal Live-Import per API nicht zur Verfügung stehen, können Sie alternativ den CSV-Import von PayPal wie folgt nutzen.
PayPal (CSV)
Manuelles Einspielen von .csv Dateien:
Der Live-Import holt die letzten X Tage ab. Größere Zeiträume können auch manuell eingespielt werden. Folgende Dateien können direkt von Ihrem PayPal Konto heruntergeladen und in Xentral eingespielt werden: Im PayPal Account sind die Dateien hier zu finden: Aktivitäten → Transaktionsliste herunterladen. Hier eignen sich folgende PayPal Export Typen:- Abgeschlossene Zahlungen (CSV, kommagetrennt) → Geldeingänge/Guthaben z.B. von Shop Payment Transaktionen
- Guthaben-relevante Zahlungen (CSV, kommagetrennt) → Zahlungen von Ihrem PayPal Konto aus
PayPalPlus
PayPalPlus (API)
Analog zu PayPal können über die Kontoeinstellung auch PayPal Plus Auszüge abgeholt werden. Die API Einstellungen werden durch die API Felder ergänzt werden, so dass die Transaktionsnummern von PayPalPlus ins Bankkonto abgeholt werden.
- Kontoauszug holt man klassisch mit API von Paypal
- Paypal Plus liefert typischerweise nur die TransaktionsID und nicht die PaymentID
- Um diese auch entsprechend korrekt aufzulösen kann man zusätzlich einen PayPal ClientID Account aus PaypalPlus in der Datenstruktur bei Paypal definieren
- Um Kontoauszüge abzuholen, muss man per API API_CLIENTID und API_SECRET definieren
- Anschließend wird automatisch versucht aus der TransaktionsID die PaymentID zu wandeln
Angabe für PayPalPlus (ausreichend, sofern nur PayPalPlus verwendet wird):
API_CLIENTID=>Du5zeUgKDsabRXBimeYKkLnnMpspMCgAP4HRmo8MHFzBPS;
API_SECRET=>4y8Lyf-fPPdyNVAPNj-3wiCvySZafkeBnAKcFkdF6g-5uG8eD97zTog5SPsFY;Angabe für PayPalPlus+PayPal (sofern gemischte Zahlungen aus PayPalPlus und PayPal verwendet werden → Fallback für Möglichkeit beide Account-Zahlungsbuchungen):
API_USERNAME=>meinusername.firma.de;
API_PASSWORD=>DF9RT6Z4EFCVPSL;
API_SIGNATURE=>ZtWafvPMMu5vafX7W3Z32VgvmJqvWcKJ3XQ;
API_DAYS=>2;
API_ALLPAYMENTS=>1;
API_CLIENTID=>Du5zeUgKDsabRXBimeYKkLnnMpspMCgAP4HRmo8MHFzBPS;
API_SECRET=>4y8Lyf-fPPdyNVAPNj-3wiCvySZafkeBnAKcFkdF6g-5uG8eD97zTog5SPsFY;
PayPal-Plus (CSV)
Manuelles Einspielen von .csv Dateien: Der Live-Import holt die letzten X Tage ab. Größere Zeiträume können auch manuell eingespielt werden. Folgende Dateien können direkt von Ihrem PayPal Konto heruntergeladen und in Xentral eingespielt werden: Die fettgedruckten Felder sind Pflichtfelder/ bzw. die relevanten Felder für die Zuordnung der Kontoauszüge: Feldeinstellungen:
1: Datum
2: Zeit
3: Zeitzone
4: Name
5: Typ
6: Status (z.B. Abgeschlossen)
7: Betreff
8: Währung
9: Brutto (Gesamtbetrag)
10: Gebühr (PayPal Gebühr)
11: Netto (Betrag abzgl. Gebühr)
12: Hinweis (Hinweis des Käufers)
13: Von E-Mail-Adresse
14: An E-Mail-Adresse
15: Transactionscode
16: Zahlungsart
17: Status der Gegenpartei (z.B. US-Verifiziert)
18: Adressstatus (z.B. Außerhalb der USA)
19: Artikelbezeichnung (z.B. Order)
20: Artikelnummer
21: Betrag für Versandkosten
22: Versicherungsbetrag
23: Umsatzsteuer
24: Option 1 - Name
25: Option 1 - Wert
26: Option 2 - Name
27: Option 2 - Wert
28: Auktions-Site
29: Käufer-ID
30: Artikel-URL
31: Angebotsende
32: Txn-Referenzkennung
33: Rechnungsnummer
34: Individuelle Nummer
35: Belegnummer
36: Guthaben (PayPal Kontoguthaben nach jeder Zahlung)
37: Adresszeile 1
38: Zusätzliche Angaben
39: Ort
40: Staat/Provinz/Region/Landkreis/Territorium/Präfektur/Republik
41: PLZ
42: Land
43: Telefonnummer