mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-11-14 20:17:14 +01:00
1 line
10 KiB
Plaintext
1 line
10 KiB
Plaintext
<h1 id="paypal">PayPal (API)</h1><span class="wiki-text">Der Live Import der Kontoauszüge (Anbindung an Xentral und Abholung der Auszüge per Knopfdruck) ist für Bankkonten mit FinTS und <span class="highlight" rel="HBCI">HBCI</span>4PHP sowie PayPal möglich. Hierbei können die Auszüge der letzten X Tage abgeholt werden. </span> <span class="wiki-text">Es darf nur <strong>ein</strong> Benutzer pro Konto hinterlegt werden, da es sonst zu doppelten Buchungen kommt. Bitte legen Sie ein Geschäftskonto nicht mehrfach an.<br />Diese Einstellungen sind nur beim Live-Abholen des Kontoauszuges (z.B. PayPal) relevant. Buchungen können direkt automatisiert per Knopfdruck abgeholt werden. </span><br /><br /><span class="wiki-text">Folgende Einstellungen sind hier relevant: </span><ul><li><strong>Typ</strong> → Konto: PayPal (API)</li><li><strong>Live-Import aktiv</strong> → Haken aktiviert den Live-Import (Voraussetzung: korrekte Eingabe der API Daten bei „Zugangsdaten Live-Import)</li><li><strong>Zugangsdaten Live-Import</strong> → API Code für den Live-Import (zu finden in Ihrem PayPal Account → Anleitung s.u.)</li></ul> <span class="wiki-text">Diese Felder werden mindestens benötigt:</span><ul><li><strong>API_USERNAME</strong> → PayPal API Username (zu finden in Ihrem PayPal Account → Anleitung s.u.)</li><li><strong>API_PASSWORD</strong> → PayPal API Passwort (zu finden in Ihrem PayPal Account → Anleitung s.u.)</li><li><strong>API_SIGNATURE</strong> → PayPal API Signature (zu finden in Ihrem PayPal Account → Anleitung s.u.)</li><li><strong>API_DAYS</strong> → 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)</li><li><strong>API_ALLPAYMENTS</strong> → 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.</li></ul> <span class="wiki-text">Einzutragen in Xentral (ganz unten in die Box: Live-Import):</span><br /><span class="hljs-attr">API_USERNAME</span>=>XXXXXXX;<br /><span class="hljs-attr">API_PASSWORD</span>=>XXXXX;<br /><span class="hljs-attr">API_SIGNATURE</span>=>XXXXXXXXXX;<br /><span class="hljs-attr">API_DAYS</span>=><span class="hljs-number">5</span>;<br /><span class="hljs-attr">API_ALLPAYMENTS</span>=><span class="hljs-number">1</span>;<br /><br /><span class="wiki-text"><strong>Info:</strong> Der Pfeil ist ein Gleichzeichen und Größerzeichen. </span> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/wawision/geschaeftskonten_einrichten_und_verwenden_neuanlegen_2paypalk.png" src="https://xentral.com/images/wiki-import/wawision/geschaeftskonten_einrichten_und_verwenden_neuanlegen_2paypalk.png" style="cursor: pointer;" /></span><br /><br /><span class="wiki-text">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.</span><h2>PayPal Api Daten abrufen:</h2><span class="wiki-text">Die Daten für die PayPal Api erhalten Sie über Ihr PayPal Konto </span><ul><li>Loggen Sie sich ein</li><li>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.</li></ul><h2><span class="wiki-text"><img data-mfp-src="/images/wiki-import/wawision/geschaeftskonten_einrichten_und_verwenden_neuanlegen_4paypalk.png" src="https://xentral.com/images/wiki-import/wawision/geschaeftskonten_einrichten_und_verwenden_neuanlegen_4paypalk.png" style="cursor: pointer;" /></span> <h2>Aufruf PayPal-Konto zur Verarbeitung der Kontoauszüge:</h2><span class="wiki-text">Sofern das PayPal Konto fertig in Xentral eingerichtet ist, können die Kontoauszüge abgerufen werden über:<br />Buchhaltung → Zahlungseingang → <img data-mfp-src="/images/wiki-import/wawision/icon_edit.png" src="https://xentral.com/images/wiki-import/wawision/icon_edit.png" style="cursor: pointer;" width="20" /> </span><h4 id="paypal--csv-">Sollte der PayPal Live-Import per API nicht zur Verfügung stehen, können Sie alternativ den CSV-Import von PayPal wie folgt nutzen.</h4><h1>PayPal (CSV)</h1><h2>Manuelles Einspielen von .csv Dateien:</h2><span class="wiki-text">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: </span> <span class="wiki-text">Im PayPal Account sind die Dateien hier zu finden: <strong>Aktivitäten → Transaktionsliste herunterladen</strong>. </span> <span class="wiki-text">Hier eignen sich folgende PayPal Export Typen:</span><ul><li><strong>Abgeschlossene Zahlungen (CSV, kommagetrennt)</strong> → Geldeingänge/Guthaben z.B. von Shop Payment Transaktionen</li><li><strong>Guthaben-relevante Zahlungen (CSV, kommagetrennt)</strong> → Zahlungen von Ihrem PayPal Konto aus</li></ul> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/wawision/geschaeftskonten_einrichten_und_verwenden_bsp_paypal_aktivitaeten.png" src="https://xentral.com/images/wiki-import/wawision/geschaeftskonten_einrichten_und_verwenden_bsp_paypal_aktivitaeten.png" style="cursor: pointer;" /></span><br /><br /> <p id="paypalplus"><strong><span style="font-size:28px;">PayPalPlus</span></strong></p><h1 id="paypalplus--api-">PayPalPlus (API)</h1><span class="wiki-text">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.</span><br /> <div><div><ul><li>Kontoauszug holt man klassisch mit API von Paypal</li><li>Paypal Plus liefert typischerweise nur die TransaktionsID und nicht die PaymentID</li><li>Um diese auch entsprechend korrekt aufzulösen kann man zusätzlich einen PayPal ClientID Account aus PaypalPlus in der Datenstruktur bei Paypal definieren</li><li>Um Kontoauszüge abzuholen, muss man per API API_CLIENTID und API_SECRET definieren</li><li>Anschließend wird automatisch versucht aus der TransaktionsID die PaymentID zu wandeln</li></ul></div></div><br /><span class="wiki-text">Angabe für PayPalPlus (ausreichend, sofern nur PayPalPlus verwendet wird): </span><br /><span class="hljs-attr">API_CLIENTID</span>=>Du5zeUgKDsabRXBimeYKkLnnMpspMCgAP4HRmo8MHFzBPS;<br /><span class="hljs-attr">API_SECRET</span>=><span class="hljs-number">4</span>y8Lyf-fPPdyNVAPNj-<span class="hljs-number">3</span>wiCvySZafkeBnAKcFkdF6g-<span class="hljs-number">5</span>uG8eD97zTog5SPsFY;<p><span class="wiki-text">Angabe für PayPalPlus+PayPal (sofern gemischte Zahlungen aus PayPalPlus und PayPal verwendet werden → Fallback für Möglichkeit beide Account-Zahlungsbuchungen):</span><br /><span class="hljs-attr">API_USERNAME</span>=>meinusername.firma.de;<br /><span class="hljs-attr">API_PASSWORD</span>=>DF9RT6Z4EFCVPSL;<br /><span class="hljs-attr">API_SIGNATURE</span>=>ZtWafvPMMu5vafX7W3Z32VgvmJqvWcKJ3XQ;<br /><span class="hljs-attr">API_DAYS</span>=><span class="hljs-number">2</span>;<br /><span class="hljs-attr">API_ALLPAYMENTS</span>=><span class="hljs-number">1</span>;<br /><span class="hljs-attr">API_CLIENTID</span>=>Du5zeUgKDsabRXBimeYKkLnnMpspMCgAP4HRmo8MHFzBPS;<br /><span class="hljs-attr">API_SECRET</span>=><span class="hljs-number">4</span>y8Lyf-fPPdyNVAPNj-<span class="hljs-number">3</span>wiCvySZafkeBnAKcFkdF6g-<span class="hljs-number">5</span>uG8eD97zTog5SPsFY;</p> <h1 id="paypal-plus--csv-">PayPal-Plus (CSV)</h1> <span class="wiki-text">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: </span> <span class="wiki-text">Die fettgedruckten Felder sind Pflichtfelder/ bzw. die relevanten Felder für die Zuordnung der Kontoauszüge: </span><h2>Feldeinstellungen:</h2><span class="wiki-text">1: <strong>Datum</strong><br />2: Zeit<br />3: Zeitzone<br />4: <strong>Name</strong><br />5: Typ<br />6: <strong>Status</strong> (z.B. Abgeschlossen)<br />7: <strong>Betreff</strong><br />8: <strong>Währung</strong><br />9: <strong>Brutto</strong> (Gesamtbetrag)<br />10: <strong>Gebühr</strong> (PayPal Gebühr)<br />11: Netto (Betrag abzgl. Gebühr)<br />12: Hinweis (Hinweis des Käufers)<br />13: Von E-Mail-Adresse<br />14: An E-Mail-Adresse<br />15: <strong>Transactionscode</strong><br />16: Zahlungsart<br />17: Status der Gegenpartei (z.B. US-Verifiziert)<br />18: Adressstatus (z.B. Außerhalb der USA)<br />19: Artikelbezeichnung (z.B. Order)<br />20: Artikelnummer<br />21: Betrag für Versandkosten<br />22: Versicherungsbetrag<br />23: Umsatzsteuer<br />24: Option 1 - Name<br />25: Option 1 - Wert<br />26: Option 2 - Name<br />27: Option 2 - Wert<br />28: Auktions-Site<br />29: Käufer-ID<br />30: Artikel-URL<br />31: Angebotsende<br />32: Txn-Referenzkennung<br />33: <strong>Rechnungsnummer</strong><br />34: Individuelle Nummer<br />35: <strong>Belegnummer</strong><br />36: Guthaben (PayPal Kontoguthaben nach jeder Zahlung)<br />37: Adresszeile 1<br />38: Zusätzliche Angaben<br />39: Ort<br />40: Staat/Provinz/Region/Landkreis/Territorium/Präfektur/Republik<br />41: PLZ<br />42: Land<br />43: Telefonnummer</span><br /><br /><br /><br /> <br /> |