mention ERP Wiki - Benutzerbeiträge [de]

Hauptseite

2026-10-01T14:50:42Z

Johann:

mention ERP Wiki
Auf unseren Wiki-Seiten befinden sich Anleitungen sowie Nützliches zu '''Schnittstellen''', die '''in Verbindung mit der mention ERP Warenwirtschaft''' verwendet werden.
Unsere '''Online-Hilfe''' für die '''mention ERP Warenwirtschaft''' finden Sie auf [https://hilfe.mention-warenwirtschaft.de hilfe.mention-warenwirtschaft.de].

Online-Shops und Marktplätze - mention.Connect

* [[Connect/Allgemein|Allgemein]]
* [[Connect/Zugangsberechtigungen|Zugangsberechtigungen]]
* [[Connect/Shopware 5|Shopware 5]]
* [[Connect/Shopware 6|Shopware 6]]
* [[Connect/Euronics|Euronics]]
* [[Connect/Plentymarkets 7|Plentymarkets 7]]
* [[Connect/eBay|eBay]]
* [[Connect/CSV|CSV]]
* [[Connect/ElectronicSales|ElectronicSales]]

Versand - mention.Logistics

* [[Logistics/Allgemein|Allgemein]]
* [[Logistics/UPS|UPS (REST API)]]

Zahlungen - mention.Payments
* [[Payments|mention.Payments]]

Ressourcen / Downloads

.NET 8 SDK 8.0.424 von Microsoft 
[https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.424-windows-x86-installer x86 (32-Bit)] | [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.424-windows-x64-installer x64 (64-Bit)]

Hauptseite

2026-10-01T14:49:53Z

Johann:

Hauptseite

2026-10-01T14:46:24Z

Johann:

mention ERP Wiki
Auf unseren Wiki-Seiten befinden sich Anleitungen sowie Nützliches zu '''Schnittstellen''', die '''in Verbindung mit der mention ERP Warenwirtschaft''' verwendet werden.
Unsere '''Online-Hilfe''' für die '''mention ERP Warenwirtschaft''' finden Sie auf [https://hilfe.mention-warenwirtschaft.de hilfe.mention-warenwirtschaft.de].

Online-Shops und Marktplätze - mentionConnect

* [[Connect/Allgemein|Allgemein]]
* [[Connect/Zugangsberechtigungen|Zugangsberechtigungen]]
* [[Connect/Shopware 5|Shopware 5]]
* [[Connect/Shopware 6|Shopware 6]]
* [[Connect/Euronics|Euronics]]
* [[Connect/Plentymarkets 7|Plentymarkets 7]]
* [[Connect/eBay|eBay]]
* [[Connect/CSV|CSV]]
* [[Connect/ElectronicSales|ElectronicSales]]

Versand - mentionLogistics

* [[Logistics/Allgemein|Allgemein]]
* [[Logistics/UPS|UPS (REST API)]]

Ressourcen / Downloads

.NET 8 SDK 8.0.424 von Microsoft 
[https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.424-windows-x86-installer x86 (32-Bit)] | [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-8.0.424-windows-x64-installer x64 (64-Bit)]

Payments

2026-09-28T13:38:32Z

Johann: Übersicht: Statusleiste mit Dienst und Version statt Dienst-Schaltfläche; Protokollordner unter mentionERP (#1167)

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

Unten in der Übersicht liegt die Statusleiste. Sie zeigt, ob der Hintergrunddienst läuft und welche Version installiert ist.

{| class="wikitable"
! Eintrag !! Funktion
|-
| '''Dienst''' || Zeigt den Zustand des Hintergrunddienstes, zum Beispiel '''Dienst: Läuft''', '''Dienst: Angehalten''' oder '''Dienst: Nicht installiert'''. Ein Klick öffnet die Steuerung des Hintergrunddienstes.
|-
| '''Version''' || Zeigt die installierte Version. Ein Klick öffnet das Fenster '''Info''' mit dem Installationsordner, den Ordnern der Protokolle, den Lizenzen und dem Stand der Aktualisierungen.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

Der Reiter '''Einstellungen''' ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte '''Vorgabe''' nennt den Wert, mit dem ein neues Konto startet.

==== Konto ====

[[Datei:Payments_Konto_Einstellungen_Konto.png|780px|Bereich Konto]] 
''Abb.: Bereich Konto''

'''Name''' und '''Provider''' zeigt mention Payments hier nur an, ändern lassen sie sich nicht.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. || Der Benutzer, der das Konto angelegt hat
|}

==== Authentifizierung ====

[[Datei:Payments_Konto_Einstellungen_Authentifizierung.png|780px|Bereich Authentifizierung]] 
''Abb.: Bereich Authentifizierung''

Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]] und [[#Zugangsdaten eintragen|Zugangsdaten eintragen]].

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen. || Sandbox
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. || leer
|}

==== Kontoauszug-Export (KAEINLXML) ====

[[Datei:Payments_Konto_Einstellungen_Kontoauszug_Export.png|780px|Bereich Kontoauszug-Export (KAEINLXML)]] 
''Abb.: Bereich Kontoauszug-Export (KAEINLXML)''

Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. || Aus
|-
| '''Backfill-Tage''' || Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. || 7
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto. || Automatik (kein Override)
|}

==== Protokollierung ====

[[Datei:Payments_Konto_Einstellungen_Protokollierung.png|780px|Bereich Protokollierung]] 
''Abb.: Bereich Protokollierung''

Beide Einstellungen gibt es auch in den [[#Globale Einstellungen|globalen Einstellungen]]. Mit '''Systemstandard verwenden''' übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. || Systemstandard verwenden
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. || Systemstandard verwenden
|}

==== Konto löschen ====

[[Datei:Payments_Konto_Einstellungen_Loeschen.png|780px|Bereich Konto löschen]] 
''Abb.: Bereich Konto löschen''

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen.

* Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
* Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

'''PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit.''' Eine Zahlung, die Sie in Ihrem PayPal-Konto schon sehen, fehlt deshalb unter Umständen noch in mention Payments und in der Warenwirtschaft. Diese Verzögerung entsteht bei PayPal, und mention Payments kann sie nicht verkürzen. Sie müssen nichts tun, denn ein späterer Lauf von '''PayPal Transaction Sync''' holt solche Transaktionen von selbst ab. Fehlt eine Transaktion nach mehr als drei Stunden immer noch, gehen Sie vor wie unter [[#Es kommen keine Transaktionen an|Es kommen keine Transaktionen an]] beschrieben.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. In der Statusleiste steht dann '''Dienst: Nicht installiert''' oder '''Dienst: Angehalten'''. Klicken Sie auf '''Dienst verwalten''' oder in der Statusleiste auf den Eintrag '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Ist die Zahlung jünger als drei Stunden? PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit, siehe [[#Transaktionen|Transaktionen]]. Warten Sie in diesem Fall ab.
# Läuft der Hintergrunddienst? In der Statusleiste der Übersicht muss '''Dienst: Läuft''' stehen.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\mentionERP\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\mentionERP\Mention.Payments\Logs</code>. Beide Ordner öffnen Sie auch im Fenster '''Info'''. Es erscheint nach einem Klick auf die Version in der Statusleiste.

Datei:Payments Hinweis Dienst nicht installiert.png

2026-09-28T13:38:23Z

Johann: Johann lud eine neue Version von Datei:Payments Hinweis Dienst nicht installiert.png hoch

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Uebersicht Konto.png

2026-09-28T13:38:22Z

Johann: Johann lud eine neue Version von Datei:Payments Uebersicht Konto.png hoch

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Uebersicht leer.png

2026-09-28T13:38:22Z

Johann: Johann lud eine neue Version von Datei:Payments Uebersicht leer.png hoch

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Payments

2026-09-25T11:08:50Z

Johann: Alle Einstellungen eines Kontos: eigener Screenshot für jeden Bereich statt eines Gesamtbilds

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

Der Reiter '''Einstellungen''' ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte '''Vorgabe''' nennt den Wert, mit dem ein neues Konto startet.

==== Konto ====

[[Datei:Payments_Konto_Einstellungen_Konto.png|780px|Bereich Konto]] 
''Abb.: Bereich Konto''

'''Name''' und '''Provider''' zeigt mention Payments hier nur an, ändern lassen sie sich nicht.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. || Der Benutzer, der das Konto angelegt hat
|}

==== Authentifizierung ====

[[Datei:Payments_Konto_Einstellungen_Authentifizierung.png|780px|Bereich Authentifizierung]] 
''Abb.: Bereich Authentifizierung''

Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]] und [[#Zugangsdaten eintragen|Zugangsdaten eintragen]].

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen. || Sandbox
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. || leer
|}

==== Kontoauszug-Export (KAEINLXML) ====

[[Datei:Payments_Konto_Einstellungen_Kontoauszug_Export.png|780px|Bereich Kontoauszug-Export (KAEINLXML)]] 
''Abb.: Bereich Kontoauszug-Export (KAEINLXML)''

Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. || Aus
|-
| '''Backfill-Tage''' || Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. || 7
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto. || Automatik (kein Override)
|}

==== Protokollierung ====

[[Datei:Payments_Konto_Einstellungen_Protokollierung.png|780px|Bereich Protokollierung]] 
''Abb.: Bereich Protokollierung''

Beide Einstellungen gibt es auch in den [[#Globale Einstellungen|globalen Einstellungen]]. Mit '''Systemstandard verwenden''' übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. || Systemstandard verwenden
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. || Systemstandard verwenden
|}

==== Konto löschen ====

[[Datei:Payments_Konto_Einstellungen_Loeschen.png|780px|Bereich Konto löschen]] 
''Abb.: Bereich Konto löschen''

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen.

* Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
* Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

'''PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit.''' Eine Zahlung, die Sie in Ihrem PayPal-Konto schon sehen, fehlt deshalb unter Umständen noch in mention Payments und in der Warenwirtschaft. Diese Verzögerung entsteht bei PayPal, und mention Payments kann sie nicht verkürzen. Sie müssen nichts tun, denn ein späterer Lauf von '''PayPal Transaction Sync''' holt solche Transaktionen von selbst ab. Fehlt eine Transaktion nach mehr als drei Stunden immer noch, gehen Sie vor wie unter [[#Es kommen keine Transaktionen an|Es kommen keine Transaktionen an]] beschrieben.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Ist die Zahlung jünger als drei Stunden? PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit, siehe [[#Transaktionen|Transaktionen]]. Warten Sie in diesem Fall ab.
# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Datei:Payments Konto Einstellungen Protokollierung.png

2026-09-25T11:08:32Z

Johann: Screenshot für den Abschnitt Alle Einstellungen eines Kontos

Screenshot aus mention Payments: Reiter Einstellungen eines Kontos, Bereich Protokollierung. Kontoname und Client ID sind Beispieldaten.

Datei:Payments Konto Einstellungen Loeschen.png

2026-09-25T11:08:31Z

Johann: Screenshot für den Abschnitt Alle Einstellungen eines Kontos

Screenshot aus mention Payments: Reiter Einstellungen eines Kontos, Bereich Konto löschen. Kontoname und Client ID sind Beispieldaten.

Datei:Payments Konto Einstellungen Kontoauszug Export.png

2026-09-25T11:08:30Z

Johann: Screenshot für den Abschnitt Alle Einstellungen eines Kontos

Screenshot aus mention Payments: Reiter Einstellungen eines Kontos, Bereich Kontoauszug-Export (KAEINLXML). Kontoname und Client ID sind Beispieldaten.

Datei:Payments Konto Einstellungen Authentifizierung.png

2026-09-25T11:08:29Z

Johann: Screenshot für den Abschnitt Alle Einstellungen eines Kontos

Screenshot aus mention Payments: Reiter Einstellungen eines Kontos, Bereich Authentifizierung. Kontoname und Client ID sind Beispieldaten.

Datei:Payments Konto Einstellungen Konto.png

2026-09-25T11:08:28Z

Johann: Screenshot für den Abschnitt Alle Einstellungen eines Kontos

Screenshot aus mention Payments: Reiter Einstellungen eines Kontos, Bereich Konto. Kontoname und Client ID sind Beispieldaten.

Payments

2026-09-25T10:44:32Z

Johann: Es kommen keine Transaktionen an: Verzögerung bei PayPal als ersten Prüfpunkt ergänzt

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

Der Reiter '''Einstellungen''' ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte '''Vorgabe''' nennt den Wert, mit dem ein neues Konto startet.

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

==== Konto ====

'''Name''' und '''Provider''' zeigt mention Payments hier nur an, ändern lassen sie sich nicht.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. || Der Benutzer, der das Konto angelegt hat
|}

==== Authentifizierung ====

Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]] und [[#Zugangsdaten eintragen|Zugangsdaten eintragen]].

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen. || Sandbox
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. || leer
|}

==== Kontoauszug-Export (KAEINLXML) ====

Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. || Aus
|-
| '''Backfill-Tage''' || Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. || 7
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto. || Automatik (kein Override)
|}

==== Protokollierung ====

Beide Einstellungen gibt es auch in den [[#Globale Einstellungen|globalen Einstellungen]]. Mit '''Systemstandard verwenden''' übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. || Systemstandard verwenden
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. || Systemstandard verwenden
|}

==== Konto löschen ====

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen.

* Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
* Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

'''PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit.''' Eine Zahlung, die Sie in Ihrem PayPal-Konto schon sehen, fehlt deshalb unter Umständen noch in mention Payments und in der Warenwirtschaft. Diese Verzögerung entsteht bei PayPal, und mention Payments kann sie nicht verkürzen. Sie müssen nichts tun, denn ein späterer Lauf von '''PayPal Transaction Sync''' holt solche Transaktionen von selbst ab. Fehlt eine Transaktion nach mehr als drei Stunden immer noch, gehen Sie vor wie unter [[#Es kommen keine Transaktionen an|Es kommen keine Transaktionen an]] beschrieben.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Ist die Zahlung jünger als drei Stunden? PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit, siehe [[#Transaktionen|Transaktionen]]. Warten Sie in diesem Fall ab.
# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-25T10:44:27Z

Johann: Transaktionen: Hinweis auf die bis zu dreistündige Verzögerung bei PayPal

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

Der Reiter '''Einstellungen''' ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte '''Vorgabe''' nennt den Wert, mit dem ein neues Konto startet.

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

==== Konto ====

'''Name''' und '''Provider''' zeigt mention Payments hier nur an, ändern lassen sie sich nicht.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. || Der Benutzer, der das Konto angelegt hat
|}

==== Authentifizierung ====

Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]] und [[#Zugangsdaten eintragen|Zugangsdaten eintragen]].

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen. || Sandbox
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. || leer
|}

==== Kontoauszug-Export (KAEINLXML) ====

Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. || Aus
|-
| '''Backfill-Tage''' || Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. || 7
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto. || Automatik (kein Override)
|}

==== Protokollierung ====

Beide Einstellungen gibt es auch in den [[#Globale Einstellungen|globalen Einstellungen]]. Mit '''Systemstandard verwenden''' übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. || Systemstandard verwenden
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. || Systemstandard verwenden
|}

==== Konto löschen ====

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen.

* Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
* Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

'''PayPal stellt Transaktionen bis zu drei Stunden verzögert bereit.''' Eine Zahlung, die Sie in Ihrem PayPal-Konto schon sehen, fehlt deshalb unter Umständen noch in mention Payments und in der Warenwirtschaft. Diese Verzögerung entsteht bei PayPal, und mention Payments kann sie nicht verkürzen. Sie müssen nichts tun, denn ein späterer Lauf von '''PayPal Transaction Sync''' holt solche Transaktionen von selbst ab. Fehlt eine Transaktion nach mehr als drei Stunden immer noch, gehen Sie vor wie unter [[#Es kommen keine Transaktionen an|Es kommen keine Transaktionen an]] beschrieben.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-25T10:29:58Z

Johann: Alle Einstellungen eines Kontos: nach den Bereichen des Reiters gegliedert, Vorgaben ergänzt

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

Der Reiter '''Einstellungen''' ist in fünf Bereiche gegliedert. Sie sind hier in derselben Reihenfolge beschrieben wie im Programm. Die Spalte '''Vorgabe''' nennt den Wert, mit dem ein neues Konto startet.

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

==== Konto ====

'''Name''' und '''Provider''' zeigt mention Payments hier nur an, ändern lassen sie sich nicht.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. || Der Benutzer, der das Konto angelegt hat
|}

==== Authentifizierung ====

Wie Sie die Zugangsdaten bei PayPal anlegen und eintragen, steht unter [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]] und [[#Zugangsdaten eintragen|Zugangsdaten eintragen]].

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen. || Sandbox
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App. Sandbox und Live haben jeweils eigene. || leer
|}

==== Kontoauszug-Export (KAEINLXML) ====

Dieser Bereich legt fest, ob und wie mention Payments die Transaktionen als Kontoauszug an die Warenwirtschaft übergibt.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig. || Aus
|-
| '''Backfill-Tage''' || Wie viele Tage rückwirkend der Pending Check nach Transaktionen sucht, deren Kontoauszug fehlt, und sie nachträglich exportiert. Mit 0 schalten Sie das ab. || 7
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto. || Automatik (kein Override)
|}

==== Protokollierung ====

Beide Einstellungen gibt es auch in den [[#Globale Einstellungen|globalen Einstellungen]]. Mit '''Systemstandard verwenden''' übernimmt das Konto den globalen Wert, jede andere Auswahl gilt nur für dieses Konto.

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. || Systemstandard verwenden
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. || Systemstandard verwenden
|}

==== Konto löschen ====

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen.

* Vor dem Löschen fragt das Programm noch einmal nach und nennt, wie viele Läufe und Transaktionen betroffen sind.
* Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-25T07:32:29Z

Johann: /* Voraussetzungen */

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-24T14:46:17Z

Johann: Verweis auf die Einrichtung der Warenwirtschaft ergänzt

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein. Außerdem muss die Warenwirtschaft einmal eingerichtet sein, siehe [[#Warenwirtschaft und Finance|Warenwirtschaft und Finance]].

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-24T14:45:39Z

Johann: Einrichtung von Warenwirtschaft, Rückzahlungen und Finance aus der Doku des PayPal Connectors übernommen

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Warenwirtschaft und Finance ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft, im selben Format wie der frühere mention PayPal Connector. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und ordnet jede Zahlung einem Beleg zu. Die gebuchten Zahlungen übernehmen Sie danach nach Finance.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

Haben Sie bisher den mention PayPal Connector eingesetzt, sind Warenwirtschaft und Finance schon eingerichtet. Ändern müssen Sie dann nur das Programm für Rückzahlungen, siehe [[#Rückzahlungen über PayPal|Rückzahlungen über PayPal]].

=== Voreinstellungen in der Warenwirtschaft ===

Damit die Warenwirtschaft die Kontoauszüge von mention Payments verarbeitet, schalten Sie zwei Optionen ein. Das gilt für jeden Mandanten, für den mention Payments Konten hat.

# Öffnen Sie in der Warenwirtschaft (dsmain.exe) '''Voreinstellungen → Mandanten → Voreinstellungen Verkauf...''' und wechseln Sie auf den Reiter '''Buchh. 2'''.
# Wählen Sie bei '''Daten zur Bearbeitung speichern''' den Eintrag '''alle'''.
# Schalten Sie '''Separates Einlesen/Bearbeiten von Kontoauszügen''' ein.

=== Kontoauszüge automatisch einlesen ===

Die PayPal-Automatik starten Sie in der Warenwirtschaft unter '''Bearbeiten → offene Posten → Kontoauszüge → Kontoauszüge einlesen Automatik...'''. Unter '''Intervall''' legen Sie fest, nach wie vielen Minuten die Automatik die neuen Kontoauszüge von mention Payments einliest.

Die Automatik ordnet jede Zahlung nach diesen Kriterien einem Beleg zu, in dieser Reihenfolge:

# Transaktions-ID und Betrag. Die Automatik sucht die Transaktions-ID in den Feldern '''Zahlungsreferenznummer''', '''externe Referenz 1–3''', '''Kunden-Bestellnummer''' und '''Bezugnahme 2''' des Belegs.
# Rechnungs-ID und Betrag. Die Automatik sucht die Rechnungs-ID in den Feldern '''externe Referenz 1–3'''.
# E-Mail-Adresse des Käufers und Betrag.

Die zugeordneten und gebuchten Zahlungen sehen Sie unter '''Bearbeitung → Offene Posten → Zahlungseingangsbelege'''.

=== Rückzahlungen über PayPal ===

Rückzahlungen zu Kunden-Gutschriften kann die Warenwirtschaft über PayPal auszahlen. Dafür ist eine Zusatzlizenz erforderlich. Die Warenwirtschaft übergibt die Zahlungsaufträge an mention Payments, und die Pipeline '''PayPal Mass Payment''' zahlt sie aus.

Hinterlegen Sie dafür in den Stammdaten des Mandanten auf der Registerkarte '''Banken''' das Programm <code>Mention.Payments.Daemon.Host.exe</code>. Bei einer Standardinstallation liegt es unter <code>C:\Program Files\Mention.Payments\current\Mention.Payments.Daemon.Host.exe</code>. Haben Sie bisher den mention PayPal Connector eingesetzt, ersetzen Sie dort die <code>PayPal-Connector.exe</code>. Die Auszahlung startet nur, wenn der Hintergrunddienst läuft.

Ist im Beleg die Transaktionsnummer der ursprünglichen PayPal-Zahlung gespeichert, erstattet mention Payments genau diese Zahlung. Das gilt auch für Überzahlungen, solange die Bestellung noch nicht gelöscht ist, zu der die Zahlung ursprünglich gespeichert war. Andere Überzahlungen zahlt mention Payments ohne Bezug als PayPal-Auszahlung zurück. Welches Konto mention Payments für die Auszahlung nimmt, steht unter [[#Sammelzahlung findet kein Konto|Sammelzahlung findet kein Konto]].

=== Zahlungen nach Finance übernehmen ===

Die gebuchten Zahlungen importieren Sie anschließend nach Finance (dsfina.exe), zum Beispiel am nächsten Tag. Vor dem ersten Import hinterlegen Sie in Finance unter '''Voreinstellungen → Konten''' ein Konto für die PayPal-Gebühren.

Der Import läuft im selben Dialog wie der Import der Rechnungen aus der Warenwirtschaft.

# Öffnen Sie '''Bearbeiten → Import → Buchungen'''.
# Wählen Sie als Importart '''Zahlungen Debitoren PayPal-Automatik'''.
# Geben Sie Periode, Buchungsdatum und Stapel an wie beim Rechnungsimport.
# Verarbeiten Sie den Stapel. Erst danach erscheinen die Zahlungen auf den Konten.

Haben Sie den Stapel versehentlich gelöscht, wiederholen Sie den Import für denselben Zeitraum. Der wiederholte Import bucht allerdings auch Zahlungen noch einmal, die schon verarbeitet wurden.

=== Nicht zugeordnete Zahlungen buchen ===

Zahlungen, die die Automatik keinem Beleg zuordnen konnte, ordnen Sie in Finance von Hand zu. Öffnen Sie dazu '''Bearbeitung → Import → Kontoauszüge... → gespeicherte KA bearbeiten''' und wählen Sie unter '''neue Importart''' den Eintrag '''PayPal-Mention'''. Wie alle anderen Zahlungen landen diese Zahlungen erst nach dem Verarbeiten in der Warenwirtschaft.

Lesen Sie PayPal-Zahlungen nicht zusätzlich von Hand ein, solange die Automatik sie einliest. Stapel, die Finance in die Warenwirtschaft exportiert hat, lassen sich nicht zurück nach Finance importieren. Umgekehrt schreibt Finance Zahlungen, die in der Warenwirtschaft gebucht und nach Finance importiert wurden, beim Verarbeiten des Stapels nicht noch einmal in die Warenwirtschaft.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-24T14:45:19Z

Johann: Häufige Probleme: Prüfschritt für die Voreinstellungen der Warenwirtschaft ergänzt

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Was in der Warenwirtschaft passiert ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und sucht den passenden Beleg. Dafür vergleicht sie unter anderem die PayPal-Transaktions-ID mit der externen Referenz und der Zahlungsreferenz des Belegs, die E-Mail-Adresse des Käufers und die Rechnungs-ID.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.
# Kommen die Kontoauszüge in der Warenwirtschaft an, werden aber keinem Beleg zugeordnet? Prüfen Sie die [[#Voreinstellungen in der Warenwirtschaft|Voreinstellungen in der Warenwirtschaft]] und ob die Automatik unter '''Kontoauszüge einlesen Automatik...''' läuft.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-24T14:34:19Z

Johann:

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Was in der Warenwirtschaft passiert ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und sucht den passenden Beleg. Dafür vergleicht sie unter anderem die PayPal-Transaktions-ID mit der externen Referenz und der Zahlungsreferenz des Belegs, die E-Mail-Adresse des Käufers und die Rechnungs-ID.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-24T11:40:49Z

Johann: Transaktions-Bildschirmfoto durch Version mit Beispieldaten ersetzt

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Gemeint ist der Ordner mit der Datei <code>dspath.dbf</code>. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen_Beispiel.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Was in der Warenwirtschaft passiert ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und sucht den passenden Beleg. Dafür vergleicht sie unter anderem die PayPal-Transaktions-ID mit der externen Referenz und der Zahlungsreferenz des Belegs, die E-Mail-Adresse des Käufers und die Rechnungs-ID.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Im gewählten Ordner liegt keine <code>dspath.dbf</code>. Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein. '''Dieser Benutzername ist eine Gruppe, kein Login''' erscheint, wenn Sie den Namen einer Benutzergruppe statt eines Benutzers eingeben.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Datei:Payments Transaktionen.png

2026-09-24T11:40:48Z

Johann: Johann lud eine neue Version von Datei:Payments Transaktionen.png hoch

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Transaktionen Beispiel.png

2026-09-24T11:40:47Z

Johann: Transaktionen mit Beispieldaten statt Sandbox-Daten

Bildschirmfoto aus mention Payments mit Beispieldaten für die Seite [[Payments]].

Payments

2026-09-24T10:23:08Z

Johann: Breite Bildschirmfotos auf 780px begrenzt, damit sie in die Inhaltsspalte passen

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Gemeint ist der Ordner mit der Datei <code>dspath.dbf</code>. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|780px|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|780px|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|780px|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|780px|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|780px|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|780px|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|780px|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|780px|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen.png|780px|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Was in der Warenwirtschaft passiert ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und sucht den passenden Beleg. Dafür vergleicht sie unter anderem die PayPal-Transaktions-ID mit der externen Referenz und der Zahlungsreferenz des Belegs, die E-Mail-Adresse des Käufers und die Rechnungs-ID.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|780px|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|780px|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Im gewählten Ordner liegt keine <code>dspath.dbf</code>. Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein. '''Dieser Benutzername ist eine Gruppe, kein Login''' erscheint, wenn Sie den Namen einer Benutzergruppe statt eines Benutzers eingeben.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Payments

2026-09-24T09:53:18Z

Johann: Neue Seite: Benutzeranleitung mention Payments (Einrichtung, PayPal-Konto, Pipelines, Transaktionen, häufige Probleme)

mention Payments ruft Ihre PayPal-Zahlungen ab und übergibt sie als Kontoauszug an die mention Warenwirtschaft. Dort ordnet die PayPal-Automatik jede Zahlung dem passenden Beleg zu. Außerdem zahlt mention Payments Zahlungsaufträge aus der Warenwirtschaft über PayPal aus.

Das Programm hat zwei Teile. In der Anwendung '''Mention Payments''' legen Sie Konten an und sehen, was passiert ist. Die eigentliche Arbeit erledigt der Hintergrunddienst '''Mention Payments Daemon'''. Er läuft als Windows-Dienst, auch wenn niemand am Rechner angemeldet ist, und startet die Abrufe nach Zeitplan. Ohne laufenden Dienst passiert nichts.

== Voraussetzungen ==

* Windows in der 64-Bit-Version, für die Installation mit Administratorrechten
* eine installierte mention Warenwirtschaft, deren SQL Server vom Rechner aus erreichbar ist
* eine Lizenz für mention Payments. Jedes PayPal-Konto belegt einen Platz der Lizenz.
* ein Benutzer der mention Warenwirtschaft, dem mindestens ein Mandant zugeordnet ist
* ein PayPal-Geschäftskonto mit einer REST-App, siehe [[#Zugangsdaten bei PayPal anlegen|Zugangsdaten bei PayPal anlegen]]
* Internetzugang zu PayPal und zum Lizenzserver von mention

== Installation ==

Führen Sie das Installationspaket <code>Mention.Payments-<Version>-win.msi</code> aus. Es installiert mention Payments für alle Benutzer des Rechners, richtet den Hintergrunddienst mit automatischem Start ein und legt die Verknüpfung '''Mention Payments''' an. Starten Sie das Programm immer über diese Verknüpfung.

Nach der Anmeldung prüft mention Payments, ob eine neue Version bereitsteht. Gibt es eine, fragt das Programm nach. Mit '''Jetzt aktualisieren''' hält es den Hintergrunddienst kurz an, installiert die neue Version und startet den Dienst wieder. Während der Aktualisierung ruft mention Payments keine Transaktionen ab. Mit '''Später''' fragt es beim nächsten Start erneut.

== Erster Start ==

=== Warenwirtschaft auswählen ===

Beim ersten Start fragt mention Payments nach dem Installationsordner der mention Warenwirtschaft. Gemeint ist der Ordner mit der Datei <code>dspath.dbf</code>. Das Ordnersymbol neben dem Feld öffnet die Ordnerauswahl von Windows.

[[Datei:Payments_Einrichtung.png|Installationsordner der Warenwirtschaft auswählen]] 
''Abb.: Installationsordner der Warenwirtschaft auswählen''

Nach einem Klick auf '''Speichern''' prüft mention Payments die Verbindung zur Datenbank und legt dort die Tabellen an, die es braucht. Danach startet die Anwendung neu. Der Ordner gilt für alle Benutzer des Rechners und für den Hintergrunddienst. Sie wählen ihn also nur einmal.

=== Lizenz aktivieren ===

Findet mention Payments in der Warenwirtschaft noch keinen Lizenzschlüssel, erscheint '''Lizenz aktivieren'''. Tragen Sie den Lizenzschlüssel ein, den Sie von mention erhalten haben, und klicken Sie auf '''Speichern'''. Die Anwendung startet danach neu.

[[Datei:Payments_Lizenz_aktivieren.png|Lizenzschlüssel eintragen]] 
''Abb.: Lizenzschlüssel eintragen''

=== Anmelden ===

Melden Sie sich mit Benutzername und Passwort der mention Warenwirtschaft an. mention Payments verlangt die Anmeldung bei jedem Start.

[[Datei:Payments_Anmeldung.png|Anmeldung]] 
''Abb.: Anmeldung''

Sind Sie mehreren Mandanten zugeordnet, wählen Sie danach den Mandanten und klicken auf '''Auswählen'''. Ein Doppelklick auf die Zeile tut dasselbe. Mit nur einem Mandanten entfällt dieser Schritt. mention Payments zeigt immer nur die Konten des gewählten Mandanten.

[[Datei:Payments_Mandant_auswaehlen.png|Mandant auswählen]] 
''Abb.: Mandant auswählen''

== Die Übersicht ==

Nach der Anmeldung sehen Sie die Übersicht Ihrer Konten. Beim ersten Start ist sie leer.

[[Datei:Payments_Uebersicht_leer.png|Leere Übersicht nach dem ersten Start]] 
''Abb.: Übersicht ohne Konten''

{| class="wikitable"
! Schaltfläche !! Funktion
|-
| '''Aktualisieren''' || Lädt die Konten neu. Die Übersicht aktualisiert sich außerdem alle 45 Sekunden von selbst.
|-
| '''Dienst''' || Öffnet die Steuerung des Hintergrunddienstes. Ein grüner Punkt heißt, dass der Dienst läuft.
|-
| '''Einstellungen''' || Öffnet die [[#Globale Einstellungen|globalen Einstellungen]].
|-
| '''Neu''' || Legt ein neues Konto an.
|}

== PayPal-Konto einrichten ==

Ein Konto in mention Payments gehört zu genau einem PayPal-Geschäftskonto. Bis die ersten Zahlungen in der Warenwirtschaft ankommen, sind vier Schritte nötig. Sie legen bei PayPal eine App an, legen in mention Payments das Konto an, tragen die Zugangsdaten ein und stellen einen Zeitplan ein.

=== Zugangsdaten bei PayPal anlegen ===

mention Payments greift über die REST-Schnittstelle von PayPal auf Ihr Konto zu. Dafür brauchen Sie eine Client ID und ein Secret.

# Melden Sie sich unter [https://developer.paypal.com developer.paypal.com] mit Ihrem PayPal-Geschäftskonto am Dashboard an.
# Öffnen Sie '''Apps & Credentials''' und stellen Sie oben auf '''Live'''. Unter '''Sandbox''' finden Sie die Testumgebung von PayPal mit eigenen Apps und eigenen Zugangsdaten.
# Legen Sie mit '''Create App''' eine App an.
# Achten Sie darauf, dass in den Einstellungen der App die Funktion '''Transaction Search''' eingeschaltet ist. Ohne sie darf mention Payments keine Transaktionen abrufen. Wenn Sie Zahlungsaufträge über PayPal auszahlen wollen, schalten Sie auch '''Payouts''' ein.
# Kopieren Sie Client ID und Secret der App.

=== Konto anlegen ===

Klicken Sie in der Übersicht auf '''Neu'''. Geben Sie dem Konto einen Namen, zum Beispiel den Namen Ihres Shops, und wählen Sie als Provider '''PayPal'''. Klicken Sie dann auf '''Speichern'''.

[[Datei:Payments_Neues_Konto.png|Dialog Neues Konto]] 
''Abb.: Neues Konto anlegen''

Das Konto erscheint als Karte in der Übersicht. Unten links zeigt die Karte den Status des letzten Laufs, bei einem neuen Konto '''Noch keine Läufe'''. Später steht dort zum Beispiel '''Fehlerfrei''', '''Fehlgeschlagen''' oder '''Läuft'''.

[[Datei:Payments_Uebersicht_Konto.png|Übersicht mit dem neuen Konto]] 
''Abb.: Übersicht mit einem Konto''

Jedes Konto belegt einen Platz Ihrer Lizenz. Ist kein Platz mehr frei, lässt sich kein weiteres Konto anlegen.

=== Zugangsdaten eintragen ===

Klicken Sie auf die Karte oder auf das Zahnrad. Das Konto öffnet sich in einem eigenen Fenster mit den Reitern '''Einstellungen''', '''Pipelines''' und '''Transaktionen'''.

Auf dem Reiter '''Einstellungen''' sind alle Felder zunächst gesperrt. Oben rechts liegen drei Symbole. Der Stift schaltet die Bearbeitung ein, das Kreuz verwirft Ihre Änderungen und die Diskette speichert sie. Bereiche mit geänderten Werten markiert mention Payments mit '''Ungespeicherte Änderungen'''.

[[Datei:Payments_Konto_bearbeiten.png|Kontoeinstellungen in Bearbeitung]] 
''Abb.: Zugangsdaten eintragen und Kontoauszug-Export einschalten''

# Klicken Sie auf den Stift.
# Wählen Sie unter '''Umgebung''' den Eintrag '''Live'''. Neue Konten stehen auf '''Sandbox''', der Testumgebung von PayPal.
# Tragen Sie '''Client ID''' und '''Secret''' Ihrer PayPal-App ein.
# Schalten Sie unter '''Kontoauszug-Export (KAEINLXML)''' den Schalter '''Aktiviert''' ein. Bei neuen Konten ist er aus, und solange er aus ist, kommt in der Warenwirtschaft nichts an.
# Klicken Sie auf die Diskette.

mention Payments speichert das Secret verschlüsselt. Nach dem Speichern bleibt das Feld leer, obwohl das Secret hinterlegt ist. Sandbox und Live haben getrennte Zugangsdaten. Wenn Sie die Umgebung wechseln, bleiben die Zugangsdaten der anderen Umgebung erhalten.

=== Alle Einstellungen eines Kontos ===

[[Datei:Payments_Konto_Einstellungen.png|Alle Einstellungen eines Kontos]] 
''Abb.: Reiter Einstellungen eines Kontos''

{| class="wikitable"
! Einstellung !! Bedeutung
|-
| '''Mention-Benutzer''' || Mit diesem Benutzer meldet sich mention Payments bei der Warenwirtschaft an. Vorbelegt ist der Benutzer, der das Konto angelegt hat.
|-
| '''Umgebung''' || '''Sandbox''' zum Testen, '''Live''' für echte Zahlungen.
|-
| '''Client ID''' und '''Secret''' || Die Zugangsdaten Ihrer PayPal-App.
|-
| '''Aktiviert''' || Übergibt die Transaktionen als Kontoauszug an die Warenwirtschaft. Ist der Export aus, bleibt auch der Pending Check untätig.
|-
| '''Backfill-Tage''' || Steuert, ob der Pending Check Transaktionen nachträglich exportiert, deren Kontoauszug fehlt. Mit 0 schalten Sie das ab.
|-
| '''Buchungskonto-Override''' || Mit '''Automatik (kein Override)''' entscheidet die Warenwirtschaft, gegen welches Bankkonto sie bucht. Wählen Sie ein Bankkonto des Mandanten, bucht sie immer gegen dieses Konto.
|-
| '''Log-Level''' || Wie ausführlich mention Payments die Abläufe dieses Kontos protokolliert. '''Systemstandard verwenden''' übernimmt den Wert aus den globalen Einstellungen.
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler dieses Kontos automatisch an mention. '''Systemstandard verwenden''' übernimmt den globalen Wert.
|}

Ganz unten entfernt '''Konto löschen''' das Konto. mention Payments löscht dabei auch alle Läufe und alle abgerufenen Transaktionen des Kontos, und das lässt sich nicht rückgängig machen. Vorher fragt das Programm noch einmal nach. Solange eine Pipeline des Kontos läuft, ist die Schaltfläche gesperrt.

=== Zeitplan festlegen ===

Ein neues Konto ruft noch nichts von selbst ab, weil Transaction Sync und Pending Check keinen Zeitplan haben. Auf dem Reiter '''Pipelines''' steht dann '''Angehalten · kein Intervall konfiguriert'''. Diesen Schritt vergisst man leicht.

# Öffnen Sie den Reiter '''Pipelines''' und klicken Sie auf '''PayPal Transaction Sync'''.
# Wechseln Sie oben auf '''Einstellungen''' und klicken Sie auf den Stift.
# Tragen Sie unter '''Intervall''' ein, wie oft die Pipeline laufen soll, zum Beispiel alle 15 Minuten.
# Klicken Sie auf die Diskette.

[[Datei:Payments_Pipeline_Zeitplan.png|Zeitplan einer Pipeline]] 
''Abb.: Zeitplan für PayPal Transaction Sync''

Richten Sie '''PayPal Pending Check''' genauso ein. Dort genügt ein längeres Intervall, zum Beispiel eine Stunde.

Die übrigen Felder brauchen Sie nur in besonderen Fällen.

* '''Wochentage''' beschränkt die Läufe auf bestimmte Tage. Ohne Auswahl läuft die Pipeline jeden Tag.
* '''Pausenfenster''' legt eine Zeitspanne fest, in der die Pipeline nicht startet, etwa während der nächtlichen Datensicherung.
* '''Erster Lauf''' bestimmt, wie viele Tage der allererste Abruf zurückreicht. Vorgabe sind 30 Tage. Liegen in der Warenwirtschaft schon PayPal-Kontoauszüge aus einer früheren PayPal-Schnittstelle, setzt mention Payments beim letzten vorhandenen Kontoauszug an und holt nichts doppelt.

== Pipelines ==

Die Abläufe eines Kontos heißen in mention Payments Pipelines. Der Reiter '''Pipelines''' zeigt für jede Pipeline den letzten Lauf und den Zeitplan.

[[Datei:Payments_Pipelines.png|Reiter Pipelines]] 
''Abb.: Reiter Pipelines mit Status und Zeitplan''

{| class="wikitable"
! Pipeline !! Aufgabe !! Start
|-
| '''PayPal Transaction Sync''' || Ruft die neuen Transaktionen seit dem letzten Lauf ab und übergibt sie als Kontoauszug an die Warenwirtschaft. || nach Zeitplan oder von Hand
|-
| '''PayPal Pending Check''' || Fragt ausstehende Transaktionen erneut bei PayPal ab und übernimmt den neuen Status. Exportiert außerdem Transaktionen, deren Kontoauszug fehlt. || nach Zeitplan oder von Hand
|-
| '''PayPal Mass Payment''' || Zahlt die offenen Zahlungsaufträge aus der Warenwirtschaft über PayPal aus. Gehört zu einem Auftrag eine frühere PayPal-Zahlung, erstattet mention Payments diese Zahlung. Sonst überweist es den Betrag als PayPal-Auszahlung. || aus der Warenwirtschaft oder von Hand
|-
| '''PayPal DoRevision''' || Ruft die Transaktionen der letzten 7 Tage erneut ab, ergänzt fehlende Angaben wie E-Mail-Adresse, Rechnungs-ID oder Gebühr und übergibt geänderte Transaktionen erneut. || nur von Hand
|-
| '''PayPal Run Cleanup''' || Löscht alte Läufe und ihre Protokolle. || täglich
|}

Run Cleanup hebt erfolgreiche Läufe 30 Tage auf, höchstens 100 pro Pipeline, und fehlgeschlagene Läufe 90 Tage. Den neuesten Lauf jeder Pipeline löscht es nie. Die Fristen ändern Sie in den Einstellungen der Pipeline '''PayPal Run Cleanup''' unter '''Aufbewahrung'''.

=== Pipeline von Hand starten ===

Klicken Sie auf eine Pipeline. Oben rechts liegen drei Schaltflächen. Der Kreispfeil aktualisiert die Ansicht. Das Dreieck heißt '''Jetzt ausführen''' und startet sofort einen Lauf. Das Quadrat heißt '''Abbrechen''' und beendet einen laufenden Lauf.

Beides funktioniert nur, wenn der Hintergrunddienst läuft. Jede Pipeline hat höchstens einen Lauf zur Zeit. Solange einer läuft, ist '''Jetzt ausführen''' gesperrt.

=== Läufe und Protokoll ===

Unter '''Läufe''' stehen alle Läufe der Pipeline, der neueste oben. Mit '''Status''' und '''Zeitraum''' filtern Sie die Liste.

[[Datei:Payments_Pipeline_Laeufe.png|Läufe einer Pipeline]] 
''Abb.: Läufe von PayPal Transaction Sync''

Ein Klick auf einen Lauf zeigt links seine einzelnen Schritte. Wählen Sie einen Schritt aus, erscheint rechts sein Protokoll. Das Symbol über dem Protokoll kopiert es in die Zwischenablage, praktisch für eine Anfrage an den Support. Ist ein Lauf fehlgeschlagen, schickt '''Fehler an Mention senden''' den Fehler direkt an mention.

[[Datei:Payments_Lauf_Task_Log.png|Protokoll eines Laufs]] 
''Abb.: Schritte und Protokoll eines Laufs''

== Transaktionen ==

Der Reiter '''Transaktionen''' zeigt die abgerufenen PayPal-Transaktionen des Kontos, die neueste oben. Beim Öffnen sehen Sie die letzten 30 Tage.

[[Datei:Payments_Transaktionen.png|Reiter Transaktionen]] 
''Abb.: Transaktionsliste mit Details der ausgewählten Transaktion''

* Das Suchfeld oben rechts findet Transaktionen über die Transaktions-ID oder über Name oder E-Mail-Adresse des Zahlers.
* Der Trichter an der Spalte '''Datum''' wählt einen anderen Zeitraum. Mit '''Zeitraum ignorieren''' sehen Sie alle Transaktionen.
* Der Trichter an der Spalte '''Status''' filtert nach '''Abgeschlossen''', '''Ausstehend''', '''Abgelehnt''', '''Storniert''' und '''Abgebrochen'''.

Klicken Sie auf eine Transaktion, zeigt der untere Bereich ihre Details. Dazu gehören der Zahler, Gebühr und Nettobetrag, die Rechnungs-ID sowie PayPal-Angaben wie Zahlungsmittel und Käuferschutz. Das Symbol rechts neben dem Datum kopiert die Transaktions-ID.

== Was in der Warenwirtschaft passiert ==

mention Payments bucht nicht selbst. Es schreibt jede Transaktion als Kontoauszug-Datensatz in die Tabelle KAEINLXML der Warenwirtschaft. Die PayPal-Automatik der mention Warenwirtschaft liest diese Datensätze ein und sucht den passenden Beleg. Dafür vergleicht sie unter anderem die PayPal-Transaktions-ID mit der externen Referenz und der Zahlungsreferenz des Belegs, die E-Mail-Adresse des Käufers und die Rechnungs-ID.

Ist eine Transaktion noch ausstehend oder wurde sie abgelehnt, bucht die Warenwirtschaft sie nicht und vermerkt nur einen Hinweis am Beleg. Den späteren Status holt der Pending Check.

== Globale Einstellungen ==

Die Schaltfläche '''Einstellungen''' in der Übersicht öffnet die Einstellungen, die für alle Konten gelten. Auch hier schaltet der Stift die Bearbeitung ein und die Diskette speichert.

[[Datei:Payments_Globale_Einstellungen.png|Globale Einstellungen]] 
''Abb.: Globale Einstellungen''

{| class="wikitable"
! Einstellung !! Bedeutung !! Vorgabe
|-
| '''Standardsprache''' || Sprache der Oberfläche, Deutsch oder Englisch. Die neue Sprache gilt überall erst nach einem Neustart von mention Payments. || Deutsch
|-
| '''Log-Level''' || Wie ausführlich mention Payments protokolliert, in den Stufen '''Information''', '''Warnung''' und '''Fehler'''. Ein Konto kann einen eigenen Wert haben. || Information
|-
| '''Fehler direkt an Mention senden''' || Schickt Fehler automatisch an mention. Der Support sieht sie dann, ohne dass Sie ein Protokoll schicken müssen. Ein Konto kann einen eigenen Wert haben. || Aus
|}

== Häufige Probleme ==

=== Hintergrunddienst nicht installiert oder angehalten ===

[[Datei:Payments_Hinweis_Dienst_nicht_installiert.png|Hinweis Hintergrunddienst nicht installiert]] 
''Abb.: Hinweis in der Übersicht, wenn der Hintergrunddienst fehlt''

Ohne laufenden Hintergrunddienst startet keine Pipeline, weder nach Zeitplan noch von Hand. Der Punkt an '''Dienst''' ist dann rot oder grau. Klicken Sie auf '''Dienst verwalten''' oder in der Leiste auf '''Dienst'''.

[[Datei:Payments_Dienst_Fenster.png|Steuerung des Hintergrunddienstes]] 
''Abb.: Steuerung des Hintergrunddienstes''

* Steht dort '''Nicht installiert''', klicken Sie auf '''Registrieren'''. mention Payments richtet den Dienst mit automatischem Start ein.
* Steht dort '''Angehalten''', klicken Sie auf '''Starten'''.

Meldet mention Payments '''Zugriff verweigert''', starten Sie mention Payments als Administrator und registrieren den Dienst erneut. Meldet es, dass der Dienst nicht gefunden wurde, installieren Sie mention Payments neu.

=== Es kommen keine Transaktionen an ===

Prüfen Sie der Reihe nach:

# Läuft der Hintergrunddienst? Der Punkt an '''Dienst''' in der Übersicht muss grün sein.
# Hat '''PayPal Transaction Sync''' einen Zeitplan? Bei '''Angehalten · kein Intervall konfiguriert''' fehlt das Intervall, siehe [[#Zeitplan festlegen|Zeitplan festlegen]].
# Ist '''Aktiviert''' unter '''Kontoauszug-Export (KAEINLXML)''' eingeschaltet? Ohne Export landen die Transaktionen nur in mention Payments und nicht in der Warenwirtschaft.
# Passen Umgebung und Zugangsdaten zusammen? Ein Live-Konto braucht Client ID und Secret der Live-App. Das Protokoll des letzten Laufs zeigt, ob PayPal die Anmeldung abgelehnt hat.

=== Ein Konto zeigt Keine Lizenz ===

Sie haben mehr Konten angelegt, als Ihre Lizenz Plätze hat. Die Plätze gelten für die ganze Installation über alle Mandanten hinweg, und die ältesten Konten bekommen sie zuerst. Für Konten ohne Lizenz laufen keine Pipelines, ihre Daten bleiben aber sichtbar. Löschen Sie ein Konto, das Sie nicht mehr brauchen, oder erweitern Sie Ihre Lizenz bei mention.

=== Ein neues Konto lässt sich nicht speichern ===

'''No licenses remaining for this provider type''' heißt, dass kein Lizenzplatz mehr frei ist. '''An account with the name ... already exists''' heißt, dass es schon ein Konto mit diesem Namen gibt.

=== Sammelzahlung findet kein Konto ===

Für Zahlungsaufträge aus der Warenwirtschaft nimmt mention Payments das Live-Konto des Mandanten, und nur wenn es keines gibt, das Sandbox-Konto. Gibt es mehrere Konten mit derselben Umgebung, bricht der Lauf mit einem Fehler ab. Legen Sie daher pro Mandant nur ein Live-Konto an, wenn Sie Zahlungsaufträge über PayPal auszahlen.

=== Lizenzprüfung fehlgeschlagen ===

mention Payments prüft die Lizenz bei jedem Start beim Lizenzserver von mention. Ist der Server nicht erreichbar, arbeitet es bis zu 30 Tage mit der zuletzt geprüften Lizenz weiter. Danach, oder wenn noch kein Lizenzschlüssel hinterlegt ist, erscheint '''Keine zwischengespeicherte Lizenz verfügbar'''. Prüfen Sie die Internetverbindung und klicken Sie auf '''Erneut versuchen'''.

'''Für Payments ist keine Lizenz verfügbar''' bedeutet, dass Ihre Lizenz mention Payments nicht enthält oder abgelaufen ist. Wenden Sie sich in dem Fall an mention.

=== Kein gültiger dsmain-Installationsordner ===

Im gewählten Ordner liegt keine <code>dspath.dbf</code>. Wählen Sie den Ordner, in dem die mention Warenwirtschaft installiert ist.

=== Die Anmeldung schlägt fehl ===

Bei '''Benutzername oder Passwort ist falsch''' prüfen Sie Ihre Zugangsdaten der Warenwirtschaft. '''Dem Benutzer ist kein Mandant zugeordnet''' heißt, dass Ihr Benutzer in der Warenwirtschaft keinem Mandanten zugeordnet ist. Das richtet Ihr Administrator in der Warenwirtschaft ein. '''Dieser Benutzername ist eine Gruppe, kein Login''' erscheint, wenn Sie den Namen einer Benutzergruppe statt eines Benutzers eingeben.

=== Protokolldateien für den Support ===

Fragt der Support nach Protokolldateien, schicken Sie den Inhalt dieser beiden Ordner. Die Anwendung schreibt ihre Protokolle nach <code>%LOCALAPPDATA%\Mention.Payments\Logs</code>, der Hintergrunddienst nach <code>%ProgramData%\Mention.Payments\Logs</code>.

Datei:Payments Uebersicht leer.png

2026-09-24T09:53:10Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Uebersicht Konto.png

2026-09-24T09:53:07Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Transaktionen.png

2026-09-24T09:53:03Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Pipelines.png

2026-09-24T09:53:00Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Pipeline Zeitplan.png

2026-09-24T09:52:56Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Pipeline Laeufe.png

2026-09-24T09:52:53Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Neues Konto.png

2026-09-24T09:52:49Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Mandant auswaehlen.png

2026-09-24T09:52:46Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Lizenz aktivieren.png

2026-09-24T09:52:42Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Lauf Task Log.png

2026-09-24T09:52:38Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Konto bearbeiten.png

2026-09-24T09:52:34Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Konto Einstellungen.png

2026-09-24T09:52:30Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Hinweis Dienst nicht installiert.png

2026-09-24T09:52:29Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Globale Einstellungen.png

2026-09-24T09:52:27Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Einrichtung.png

2026-09-24T09:52:25Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Dienst Fenster.png

2026-09-24T09:52:23Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Datei:Payments Anmeldung.png

2026-09-24T09:52:22Z

Johann: Bildschirmfoto für die Benutzeranleitung mention Payments

Bildschirmfoto aus mention Payments für die Seite [[Payments]]. [[Kategorie:Payments]]

Connect/eBay

2026-09-14T13:58:05Z

Johann: Convert Artikel bearbeiten bullet lists into tables for consistency

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)
| Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das ''Online'' Feld aktiviert.
|-
| Behandlung Name
| Wenn ''Standard Behandlung'' aktiviert ist, werden Vorname und Nachname zusammen in ''Name2'' gespeichert. Wenn ''Privat Person: Vorname = Name1, Nachname = Name2'' ausgewählt ist, wird der Vorname in das Feld ''Name1'' gespeichert und das Feld ''Name2'' mit dem Nachnamen befüllt.
|-
| KD Kennz. Endkunde
| Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.
|-
| Druckoptionen speichern
| Aktiviert die folgenden Druckoptionen.
|-
| Druckoptionen Email
| Wenn aktiv, wird im Kundenstamm unter Druckoptionen ''E-Mail'' auf aktiv gesetzt.
|-
| Druckoptionen nicht drucken
| Bei aktiv wird im Kundenstamm unter Druckoptionen ''nicht drucken'' aktiviert.
|-
| Druckoptionen Transportweg
|
|-
| Druckoptionen Format
|
|-
| Druckoptionen Dateiname
|
|-
| Weitere SA: Nur Lieferschein
| Wenn aktiv, wird im Kundenstamm unter ''Weitere'' die Einstellung ''SA: Nur Lieferschein'' auf aktiv gesetzt.
|}

'''Vorlage Kundennummer'''

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kd.-Name1 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name1'' überprüft werden sollen.
|-
| Kd.-Name2 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name2'' überprüft werden sollen.
|-
| Kd.-Name3 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name3'' überprüft werden sollen.
|-
| Kd.-Straße prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Straße'' überprüft werden sollen.
|-
| Kd.-PLZ prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''PLZ'' überprüft werden sollen.
|-
| Kd.-Ort prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Ort'' überprüft werden sollen.
|-
| Kundensuche über Mailadresse
| Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.
|}

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese '''[[Connect/eBay#Aktualisierung und Import|hier]]''' aktualisiert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

'''Hinweise:'''

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den Button Test (siehe '''[[Connect/eBay#eBay|eBay]]''') betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor die '''eBay REST Authorisation''' (Login-Button im Bereich eBay) durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Profile aktualisieren
| Um diese unter '''[[Connect/eBay#Profile|Profile]]''' auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue hinzugefügt wurden.
|-
| eBay Kategorien aktualisieren
| Per Klick werden die eBay-Kategorien aktualisiert.
|-
| Angebote importieren
| Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet haben, können Sie diese hier importieren. Voraussetzung ist, dass die SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.
|-
| Versand- /Bezahlarten / Rückgabebedingungen
| Um diese unter '''[[Connect/eBay#Versand-/Bezahlart und Rückgabe|Versand-/Bezahlart und Rückgabe]]''' auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue Bedingungen hinzugefügt wurden.
|-
| Artikel-Zustand
| Importieren Sie hier die verfügbaren Artikel-Zustände.
|-
| Kategorie-Spezifikationen
| Mittels dieses Buttons werden sowohl Kategorien als auch deren Spezifikationen heruntergeladen. Der Vorgang kann '''mehrere Minuten''' in Anspruch nehmen, es werden über 2GB an Daten übertragen.
|}

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog '''Artikel bearbeiten''' erlaubt die Konfiguration einzelner eBay-Artikel. Die Einstellungen im unteren Bereich können je nach ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder Empfohlen-Felder).

'''Allgemeine Einstellungen'''

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Benennung
| In mention hinterlegte Artikelbenennung (schreibgeschützt).
|-
| Benennung eBay
| Abweichende Benennung für eBay, falls gewünscht.
|-
| Ebay Kategorie
| Auswahl der eBay-Kategorie (zuvor unter '''[[Connect/eBay#Aktualisierung und Import|Aktualisierung und Import]]''' aktualisieren). ''Hinweis:'' Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1 und 2) – jetzt nur noch eine.
|-
| Shop-Kategorien
| Entfernt. Shop-Kategorien werden nicht mehr im Artikeleditor verwaltet.
|-
| Zustand / Erweit. Zustand
| Artikelzustand (z. B. Neu, Gebraucht).
|-
| ProduktID
| EAN/GTIN des Artikels.
|-
| ebay Katalogdaten verwenden
| Aktiviert die Verwendung von eBay-Katalogdaten.
|-
| Template
| Auswahl des eBay-Artikeltemplates.
|-
| Einstelldauer
| Laufzeit des Angebots (z. B. 30 Tage, Gilt bis Widerruf).
|-
| XML
| Direkte Eingabe von eBay-XML für erweiterte Konfiguration.
|-
| Bestand (kein Akt.) / Preis (kein Akt.)
| Legt fest, ob Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert werden sollen.
|}

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]

'''Profile'''

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Verkäuferprofile (Zahlart, Versand, Rückgabe)
| Die Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten Business Policies. Anders als zuvor gibt es keine festen drei Felder mehr, sondern eine dynamische Liste aller verfügbaren Profile.
|}

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]

'''Spezifikationen / Aspekte'''

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Spezifikationen
| Kategoriespezifische Artikelmerkmale (Aspekte) – Werte variieren je nach Kategorie.
|-
| Aspekte: Freitext erzwingen
| Erzwingt die Eingabe von Freitext bei Artikelspezifikationen, auch wenn eBay eine Auswahlliste vorgibt.
|-
| Aspekte: Prüfung deaktivieren
| Reduziert die clientseitige Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft; weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden übersprungen.
|}

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]

'''Aktionen'''

{| class="wikitable" style="width:100%;"
! Aktion
! Beschreibung
|-
| Artikel öffnen (vfps)
| Öffnet den zugehörigen Artikelstammdatensatz in mention.
|-
| Über eBay suchen
| Durchsucht den eBay-Produktkatalog und ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen Artikel ab.
|-
| Von eBay herunterladen (Spezifikationen)
| Lädt die kategoriespezifischen Spezifikationen (Aspekte) für die ausgewählte eBay-Kategorie herunter.
|-
| Download eBay Site-Einstellungen
| Wenn aktiviert, werden beim Aktualisieren der Einstelldauer auch die aktuellen eBay-Siteeinstellungen heruntergeladen.
|-
| ProduktID / Für Kategorie abfragen
| Fragt die benötigten Produkt-IDs für die gewählte Kategorie ab.
|-
| Reaktivieren
| Reaktiviert ein beendetes Angebot (wahlweise mit angepasstem Preis).
|}

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}

Connect/eBay

2026-09-14T13:55:31Z

Johann: Fix formatting, restore bold labels and internal link

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)
| Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das ''Online'' Feld aktiviert.
|-
| Behandlung Name
| Wenn ''Standard Behandlung'' aktiviert ist, werden Vorname und Nachname zusammen in ''Name2'' gespeichert. Wenn ''Privat Person: Vorname = Name1, Nachname = Name2'' ausgewählt ist, wird der Vorname in das Feld ''Name1'' gespeichert und das Feld ''Name2'' mit dem Nachnamen befüllt.
|-
| KD Kennz. Endkunde
| Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.
|-
| Druckoptionen speichern
| Aktiviert die folgenden Druckoptionen.
|-
| Druckoptionen Email
| Wenn aktiv, wird im Kundenstamm unter Druckoptionen ''E-Mail'' auf aktiv gesetzt.
|-
| Druckoptionen nicht drucken
| Bei aktiv wird im Kundenstamm unter Druckoptionen ''nicht drucken'' aktiviert.
|-
| Druckoptionen Transportweg
|
|-
| Druckoptionen Format
|
|-
| Druckoptionen Dateiname
|
|-
| Weitere SA: Nur Lieferschein
| Wenn aktiv, wird im Kundenstamm unter ''Weitere'' die Einstellung ''SA: Nur Lieferschein'' auf aktiv gesetzt.
|}

'''Vorlage Kundennummer'''

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kd.-Name1 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name1'' überprüft werden sollen.
|-
| Kd.-Name2 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name2'' überprüft werden sollen.
|-
| Kd.-Name3 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name3'' überprüft werden sollen.
|-
| Kd.-Straße prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Straße'' überprüft werden sollen.
|-
| Kd.-PLZ prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''PLZ'' überprüft werden sollen.
|-
| Kd.-Ort prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Ort'' überprüft werden sollen.
|-
| Kundensuche über Mailadresse
| Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.
|}

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese '''[[Connect/eBay#Aktualisierung und Import|hier]]''' aktualisiert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

'''Hinweise:'''

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den Button Test (siehe '''[[Connect/eBay#eBay|eBay]]''') betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor die '''eBay REST Authorisation''' (Login-Button im Bereich eBay) durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Profile aktualisieren
| Um diese unter '''[[Connect/eBay#Profile|Profile]]''' auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue hinzugefügt wurden.
|-
| eBay Kategorien aktualisieren
| Per Klick werden die eBay-Kategorien aktualisiert.
|-
| Angebote importieren
| Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet haben, können Sie diese hier importieren. Voraussetzung ist, dass die SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.
|-
| Versand- /Bezahlarten / Rückgabebedingungen
| Um diese unter '''[[Connect/eBay#Versand-/Bezahlart und Rückgabe|Versand-/Bezahlart und Rückgabe]]''' auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue Bedingungen hinzugefügt wurden.
|-
| Artikel-Zustand
| Importieren Sie hier die verfügbaren Artikel-Zustände.
|-
| Kategorie-Spezifikationen
| Mittels dieses Buttons werden sowohl Kategorien als auch deren Spezifikationen heruntergeladen. Der Vorgang kann '''mehrere Minuten''' in Anspruch nehmen, es werden über 2GB an Daten übertragen.
|}

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog '''Artikel bearbeiten''' erlaubt die Konfiguration einzelner eBay-Artikel. Die Einstellungen im unteren Bereich können je nach ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder Empfohlen-Felder).

'''Allgemeine Einstellungen'''

* '''Benennung:''' In mention hinterlegte Artikelbenennung (schreibgeschützt).
* '''Benennung eBay:''' Abweichende Benennung für eBay, falls gewünscht.
* '''Ebay Kategorie:''' Auswahl der eBay-Kategorie (zuvor unter '''[[Connect/eBay#Aktualisierung und Import|Aktualisierung und Import]]''' aktualisieren). ''Hinweis:'' Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1 und 2) – jetzt nur noch eine.
* '''Shop-Kategorien:''' Entfernt. Shop-Kategorien werden nicht mehr im Artikeleditor verwaltet.
* '''Zustand / Erweit. Zustand:''' Artikelzustand (z. B. Neu, Gebraucht).
* '''ProduktID:''' EAN/GTIN des Artikels.
* '''ebay Katalogdaten verwenden:''' Aktiviert die Verwendung von eBay-Katalogdaten.
* '''Template:''' Auswahl des eBay-Artikeltemplates.
* '''Einstelldauer:''' Laufzeit des Angebots (z. B. 30 Tage, Gilt bis Widerruf).
* '''XML:''' Direkte Eingabe von eBay-XML für erweiterte Konfiguration.
* '''Bestand (kein Akt.) / Preis (kein Akt.):''' Legt fest, ob Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert werden sollen.

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]

'''Profile'''

* '''Verkäuferprofile (Zahlart, Versand, Rückgabe):''' Die Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten Business Policies. Anders als zuvor gibt es keine festen drei Felder mehr, sondern eine dynamische Liste aller verfügbaren Profile.

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]

'''Spezifikationen / Aspekte'''

* '''Spezifikationen:''' Kategoriespezifische Artikelmerkmale (Aspekte) – Werte variieren je nach Kategorie.
* '''Aspekte: Freitext erzwingen:''' Erzwingt die Eingabe von Freitext bei Artikelspezifikationen, auch wenn eBay eine Auswahlliste vorgibt.
* '''Aspekte: Prüfung deaktivieren:''' Reduziert die clientseitige Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft; weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden übersprungen.

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]

'''Aktionen'''

* '''Artikel öffnen (vfps):''' Öffnet den zugehörigen Artikelstammdatensatz in mention.
* '''Über eBay suchen:''' Durchsucht den eBay-Produktkatalog und ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen Artikel ab.
* '''Von eBay herunterladen (Spezifikationen):''' Lädt die kategoriespezifischen Spezifikationen (Aspekte) für die ausgewählte eBay-Kategorie herunter.
* '''Download eBay Site-Einstellungen:''' Wenn aktiviert, werden beim Aktualisieren der Einstelldauer auch die aktuellen eBay-Siteeinstellungen heruntergeladen.
* '''ProduktID / Für Kategorie abfragen:''' Fragt die benötigten Produkt-IDs für die gewählte Kategorie ab.
* '''Reaktivieren:''' Reaktiviert ein beendetes Angebot (wahlweise mit angepasstem Preis).

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}

Connect/eBay

2026-09-14T13:55:18Z

Johann: Fix formatting, restore internal links, present settings as a table, fix typos

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)
| Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das ''Online'' Feld aktiviert.
|-
| Behandlung Name
| Wenn ''Standard Behandlung'' aktiviert ist, werden Vorname und Nachname zusammen in ''Name2'' gespeichert. Wenn ''Privat Person: Vorname = Name1, Nachname = Name2'' ausgewählt ist, wird der Vorname in das Feld ''Name1'' gespeichert und das Feld ''Name2'' mit dem Nachnamen befüllt.
|-
| KD Kennz. Endkunde
| Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.
|-
| Druckoptionen speichern
| Aktiviert die folgenden Druckoptionen.
|-
| Druckoptionen Email
| Wenn aktiv, wird im Kundenstamm unter Druckoptionen ''E-Mail'' auf aktiv gesetzt.
|-
| Druckoptionen nicht drucken
| Bei aktiv wird im Kundenstamm unter Druckoptionen ''nicht drucken'' aktiviert.
|-
| Druckoptionen Transportweg
|
|-
| Druckoptionen Format
|
|-
| Druckoptionen Dateiname
|
|-
| Weitere SA: Nur Lieferschein
| Wenn aktiv, wird im Kundenstamm unter ''Weitere'' die Einstellung ''SA: Nur Lieferschein'' auf aktiv gesetzt.
|}

'''Vorlage Kundennummer'''

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kd.-Name1 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name1'' überprüft werden sollen.
|-
| Kd.-Name2 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name2'' überprüft werden sollen.
|-
| Kd.-Name3 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name3'' überprüft werden sollen.
|-
| Kd.-Straße prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Straße'' überprüft werden sollen.
|-
| Kd.-PLZ prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''PLZ'' überprüft werden sollen.
|-
| Kd.-Ort prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Ort'' überprüft werden sollen.
|-
| Kundensuche über Mailadresse
| Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.
|}

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese '''[[Connect/eBay#Aktualisierung und Import|hier]]''' aktualisiert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

'''Hinweise:'''

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den Button Test (siehe '''[[Connect/eBay#eBay|eBay]]''') betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor die '''eBay REST Authorisation''' (Login-Button im Bereich eBay) durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Profile aktualisieren
| Um diese unter '''[[Connect/eBay#Profile|Profile]]''' auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue hinzugefügt wurden.
|-
| eBay Kategorien aktualisieren
| Per Klick werden die eBay-Kategorien aktualisiert.
|-
| Angebote importieren
| Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet haben, können Sie diese hier importieren. Voraussetzung ist, dass die SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.
|-
| Versand- /Bezahlarten / Rückgabebedingungen
| Um diese unter '''[[Connect/eBay#Versand-/Bezahlart und Rückgabe|Versand-/Bezahlart und Rückgabe]]''' auswählen zu können, ist es zunächst erforderlich, diese hier zu importieren bzw. zu aktualisieren, sofern neue Bedingungen hinzugefügt wurden.
|-
| Artikel-Zustand
| Importieren Sie hier die verfügbaren Artikel-Zustände.
|-
| Kategorie-Spezifikationen
| Mittels dieses Buttons werden sowohl Kategorien als auch deren Spezifikationen heruntergeladen. Der Vorgang kann '''mehrere Minuten''' in Anspruch nehmen, es werden über 2GB an Daten übertragen.
|}

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog Artikel bearbeiten erlaubt die Konfiguration einzelner
eBay-Artikel. Die Einstellungen im unteren Bereich können je nach
ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder
Empfohlen-Felder).

Allgemeine Einstellungen

* Benennung: In mention hinterlegte Artikelbenennung
(schreibgeschützt).
* Benennung eBay: Abweichende Benennung für eBay, falls
gewünscht.
* Ebay Kategorie: Auswahl der eBay-Kategorie (zuvor unter Aktualisierung und Import aktualisieren). Hinweis: Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1
und 2) – jetzt nur noch eine.
* Shop-Kategorien: Entfernt. Shop-Kategorien werden nicht mehr
im Artikeleditor verwaltet.
* Zustand / Erweit. Zustand: Artikelzustand (z. B. Neu,
Gebraucht).
* ProduktID: EAN/GTIN des Artikels.
* ebay Katalogdaten verwenden: Aktiviert die Verwendung von
eBay-Katalogdaten.
* Template: Auswahl des eBay-Artikeltemplates.
* Einstelldauer: Laufzeit des Angebots (z. B. 30 Tage, Gilt
bis Widerruf).
* XML: Direkte Eingabe von eBay-XML für erweiterte
Konfiguration.
* Bestand (kein Akt.) / Preis (kein Akt.): Legt fest, ob
Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert
werden sollen.

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]
Profile

* Verkäuferprofile (Zahlart, Versand, Rückgabe): Die
Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten
Business Policies. Anders als zuvor gibt es keine festen drei
Felder mehr, sondern eine dynamische Liste aller verfügbaren
Profile.

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]
Spezifikationen / Aspekte

* Spezifikationen: Kategoriespezifische Artikelmerkmale
(Aspekte) – Werte variieren je nach Kategorie.
* Aspekte: Freitext erzwingen: Erzwingt die Eingabe von
Freitext bei Artikelspezifikationen, auch wenn eBay eine
Auswahlliste vorgibt.
* Aspekte: Prüfung deaktivieren: Reduziert die clientseitige
Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden
nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft;
weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden
übersprungen.

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]
Aktionen

* Artikel öffnen (vfps): Öffnet den zugehörigen
Artikelstammdatensatz in mention.
* Über eBay suchen: Durchsucht den eBay-Produktkatalog und
ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen
Artikel ab.
* Von eBay herunterladen (Spezifikationen): Lädt die
kategoriespezifischen Spezifikationen (Aspekte) für die
ausgewählte eBay-Kategorie herunter.
* Download eBay Site-Einstellungen: Wenn aktiviert, werden
beim Aktualisieren der Einstelldauer auch die aktuellen
eBay-Siteeinstellungen heruntergeladen.
* ProduktID / Für Kategorie abfragen: Fragt die benötigten
Produkt-IDs für die gewählte Kategorie ab.
* Reaktivieren: Reaktiviert ein beendetes Angebot
(wahlweise mit angepasstem Preis).

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}

Connect/eBay

2026-09-14T13:55:10Z

Johann: Fix formatting; present settings as tables, keep field list as bullets

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)
| Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das ''Online'' Feld aktiviert.
|-
| Behandlung Name
| Wenn ''Standard Behandlung'' aktiviert ist, werden Vorname und Nachname zusammen in ''Name2'' gespeichert. Wenn ''Privat Person: Vorname = Name1, Nachname = Name2'' ausgewählt ist, wird der Vorname in das Feld ''Name1'' gespeichert und das Feld ''Name2'' mit dem Nachnamen befüllt.
|-
| KD Kennz. Endkunde
| Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.
|-
| Druckoptionen speichern
| Aktiviert die folgenden Druckoptionen.
|-
| Druckoptionen Email
| Wenn aktiv, wird im Kundenstamm unter Druckoptionen ''E-Mail'' auf aktiv gesetzt.
|-
| Druckoptionen nicht drucken
| Bei aktiv wird im Kundenstamm unter Druckoptionen ''nicht drucken'' aktiviert.
|-
| Druckoptionen Transportweg
|
|-
| Druckoptionen Format
|
|-
| Druckoptionen Dateiname
|
|-
| Weitere SA: Nur Lieferschein
| Wenn aktiv, wird im Kundenstamm unter ''Weitere'' die Einstellung ''SA: Nur Lieferschein'' auf aktiv gesetzt.
|}

'''Vorlage Kundennummer'''

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Kd.-Name1 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name1'' überprüft werden sollen.
|-
| Kd.-Name2 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name2'' überprüft werden sollen.
|-
| Kd.-Name3 prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Name3'' überprüft werden sollen.
|-
| Kd.-Straße prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Straße'' überprüft werden sollen.
|-
| Kd.-PLZ prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''PLZ'' überprüft werden sollen.
|-
| Kd.-Ort prüfen Anzahl Zeichen
| Anzahl der Stellen, die im Feld ''Ort'' überprüft werden sollen.
|-
| Kundensuche über Mailadresse
| Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.
|}

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese '''[[Connect/eBay#Aktualisierung und Import|hier]]''' aktualisiert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

Hinweise :

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den
Button Test (siehe eBay ) betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie
zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor
die eBay REST Authorisation (Login-Button im Bereich eBay)
durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]
Profile aktualisieren

Um diese unter Profile auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue hinzugefügt wurden.

eBay Kategorien aktualisieren

Per Klick werden die eBay-Kategorien aktualisiert.

Angebote importieren

Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet
haben, können Sie diese hier importieren. Voraussetzung ist, dass die
SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.

Versand- /Bezahlarten / Rückgabebedingungen

Um diese unter Versand-/Bezahlart und Rückgabe auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue Bedingungen hinzugefügt
wurden.

Artikel-Zustand

Importieren Sie hier die verfügbaren Artikel-Zustzände

Kategorie-Spezifikationen

Mittels dieses Buttons werden sowohl Kategorien als auch deren
Spezifikationen heruntergeladen. Der Vorgang kann mehrere Minuten in Anspruch nehmen, es werden über 2GB an Daten
übertragen.

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog Artikel bearbeiten erlaubt die Konfiguration einzelner
eBay-Artikel. Die Einstellungen im unteren Bereich können je nach
ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder
Empfohlen-Felder).

Allgemeine Einstellungen

* Benennung: In mention hinterlegte Artikelbenennung
(schreibgeschützt).
* Benennung eBay: Abweichende Benennung für eBay, falls
gewünscht.
* Ebay Kategorie: Auswahl der eBay-Kategorie (zuvor unter Aktualisierung und Import aktualisieren). Hinweis: Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1
und 2) – jetzt nur noch eine.
* Shop-Kategorien: Entfernt. Shop-Kategorien werden nicht mehr
im Artikeleditor verwaltet.
* Zustand / Erweit. Zustand: Artikelzustand (z. B. Neu,
Gebraucht).
* ProduktID: EAN/GTIN des Artikels.
* ebay Katalogdaten verwenden: Aktiviert die Verwendung von
eBay-Katalogdaten.
* Template: Auswahl des eBay-Artikeltemplates.
* Einstelldauer: Laufzeit des Angebots (z. B. 30 Tage, Gilt
bis Widerruf).
* XML: Direkte Eingabe von eBay-XML für erweiterte
Konfiguration.
* Bestand (kein Akt.) / Preis (kein Akt.): Legt fest, ob
Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert
werden sollen.

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]
Profile

* Verkäuferprofile (Zahlart, Versand, Rückgabe): Die
Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten
Business Policies. Anders als zuvor gibt es keine festen drei
Felder mehr, sondern eine dynamische Liste aller verfügbaren
Profile.

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]
Spezifikationen / Aspekte

* Spezifikationen: Kategoriespezifische Artikelmerkmale
(Aspekte) – Werte variieren je nach Kategorie.
* Aspekte: Freitext erzwingen: Erzwingt die Eingabe von
Freitext bei Artikelspezifikationen, auch wenn eBay eine
Auswahlliste vorgibt.
* Aspekte: Prüfung deaktivieren: Reduziert die clientseitige
Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden
nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft;
weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden
übersprungen.

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]
Aktionen

* Artikel öffnen (vfps): Öffnet den zugehörigen
Artikelstammdatensatz in mention.
* Über eBay suchen: Durchsucht den eBay-Produktkatalog und
ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen
Artikel ab.
* Von eBay herunterladen (Spezifikationen): Lädt die
kategoriespezifischen Spezifikationen (Aspekte) für die
ausgewählte eBay-Kategorie herunter.
* Download eBay Site-Einstellungen: Wenn aktiviert, werden
beim Aktualisieren der Einstelldauer auch die aktuellen
eBay-Siteeinstellungen heruntergeladen.
* ProduktID / Für Kategorie abfragen: Fragt die benötigten
Produkt-IDs für die gewählte Kategorie ab.
* Reaktivieren: Reaktiviert ein beendetes Angebot
(wahlweise mit angepasstem Preis).

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}

Connect/eBay

2026-09-14T13:54:49Z

Johann: Fix hard-wrapped paragraph formatting

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]
Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)

Wenn diese Einstellung aktiv ist, wird beim Anlegen eines
Ansprechpartners das Online Feld aktiviert.

Behandlung Name

Wenn Standard Behandlung aktiviert ist, werden Vorname und
Nachname zusammen in Name2 gespeichert. Wenn Privat Person: Vorname = Name1, Nachname = Name2 ausgewählt ist,
wird der Vorname in das Feld Name1 gespeichert und das Feld Name2 mit dem Nachnamen befüllt.

KD Kennz. Endkunde

Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für
diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im
Kundenstamm als Endkunde gekennzeichnet.

Druckoptionen speichern

Aktiviert die folgenden Druckoptionen.

Druckoptionen Email

Wenn aktiv, wird im Kundenstamm unter Druckoptionen E-Mail auf
aktiv gesetzt.

Druckoptionen nicht drucken

Bei aktiv wird im Kundenstamm unter Druckoptionen nicht drucken aktiviert.

Druckoptionen Transportweg

Druckoptionen Format

Druckoptionen Dateiname

Weitere SA: Nur Lieferschein

Wenn aktiv, wird im Kundenstamm unter Weitere die Einstellung SA: Nur Lieferschein auf aktiv gesetzt.

Vorlage Kundennummer

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen
Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine
Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen
geprüft.

Kd.-Name1 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name1 überprüft werden sollen

Kd.-Name2 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name2 überprüft werden sollen

Kd.-Name3 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name3 überprüft werden sollen

Kd.-Straße prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Straße überprüft werden sollen

Kd.-PLZ prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld PLZ überprüft werden sollen

Kd.-Ort prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Ort überprüft werden sollen

Kundensuche über Mailadresse

Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse
in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese '''[[Connect/eBay#Aktualisierung und Import|hier]]''' aktualisiert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

Hinweise :

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den
Button Test (siehe eBay ) betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie
zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor
die eBay REST Authorisation (Login-Button im Bereich eBay)
durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]
Profile aktualisieren

Um diese unter Profile auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue hinzugefügt wurden.

eBay Kategorien aktualisieren

Per Klick werden die eBay-Kategorien aktualisiert.

Angebote importieren

Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet
haben, können Sie diese hier importieren. Voraussetzung ist, dass die
SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.

Versand- /Bezahlarten / Rückgabebedingungen

Um diese unter Versand-/Bezahlart und Rückgabe auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue Bedingungen hinzugefügt
wurden.

Artikel-Zustand

Importieren Sie hier die verfügbaren Artikel-Zustzände

Kategorie-Spezifikationen

Mittels dieses Buttons werden sowohl Kategorien als auch deren
Spezifikationen heruntergeladen. Der Vorgang kann mehrere Minuten in Anspruch nehmen, es werden über 2GB an Daten
übertragen.

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog Artikel bearbeiten erlaubt die Konfiguration einzelner
eBay-Artikel. Die Einstellungen im unteren Bereich können je nach
ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder
Empfohlen-Felder).

Allgemeine Einstellungen

* Benennung: In mention hinterlegte Artikelbenennung
(schreibgeschützt).
* Benennung eBay: Abweichende Benennung für eBay, falls
gewünscht.
* Ebay Kategorie: Auswahl der eBay-Kategorie (zuvor unter Aktualisierung und Import aktualisieren). Hinweis: Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1
und 2) – jetzt nur noch eine.
* Shop-Kategorien: Entfernt. Shop-Kategorien werden nicht mehr
im Artikeleditor verwaltet.
* Zustand / Erweit. Zustand: Artikelzustand (z. B. Neu,
Gebraucht).
* ProduktID: EAN/GTIN des Artikels.
* ebay Katalogdaten verwenden: Aktiviert die Verwendung von
eBay-Katalogdaten.
* Template: Auswahl des eBay-Artikeltemplates.
* Einstelldauer: Laufzeit des Angebots (z. B. 30 Tage, Gilt
bis Widerruf).
* XML: Direkte Eingabe von eBay-XML für erweiterte
Konfiguration.
* Bestand (kein Akt.) / Preis (kein Akt.): Legt fest, ob
Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert
werden sollen.

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]
Profile

* Verkäuferprofile (Zahlart, Versand, Rückgabe): Die
Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten
Business Policies. Anders als zuvor gibt es keine festen drei
Felder mehr, sondern eine dynamische Liste aller verfügbaren
Profile.

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]
Spezifikationen / Aspekte

* Spezifikationen: Kategoriespezifische Artikelmerkmale
(Aspekte) – Werte variieren je nach Kategorie.
* Aspekte: Freitext erzwingen: Erzwingt die Eingabe von
Freitext bei Artikelspezifikationen, auch wenn eBay eine
Auswahlliste vorgibt.
* Aspekte: Prüfung deaktivieren: Reduziert die clientseitige
Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden
nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft;
weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden
übersprungen.

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]
Aktionen

* Artikel öffnen (vfps): Öffnet den zugehörigen
Artikelstammdatensatz in mention.
* Über eBay suchen: Durchsucht den eBay-Produktkatalog und
ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen
Artikel ab.
* Von eBay herunterladen (Spezifikationen): Lädt die
kategoriespezifischen Spezifikationen (Aspekte) für die
ausgewählte eBay-Kategorie herunter.
* Download eBay Site-Einstellungen: Wenn aktiviert, werden
beim Aktualisieren der Einstelldauer auch die aktuellen
eBay-Siteeinstellungen heruntergeladen.
* ProduktID / Für Kategorie abfragen: Fragt die benötigten
Produkt-IDs für die gewählte Kategorie ab.
* Reaktivieren: Reaktiviert ein beendetes Angebot
(wahlweise mit angepasstem Preis).

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}

Connect/eBay

2026-09-14T13:54:48Z

Johann: Fix formatting, restore internal link, fix typo

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]
Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)

Wenn diese Einstellung aktiv ist, wird beim Anlegen eines
Ansprechpartners das Online Feld aktiviert.

Behandlung Name

Wenn Standard Behandlung aktiviert ist, werden Vorname und
Nachname zusammen in Name2 gespeichert. Wenn Privat Person: Vorname = Name1, Nachname = Name2 ausgewählt ist,
wird der Vorname in das Feld Name1 gespeichert und das Feld Name2 mit dem Nachnamen befüllt.

KD Kennz. Endkunde

Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für
diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im
Kundenstamm als Endkunde gekennzeichnet.

Druckoptionen speichern

Aktiviert die folgenden Druckoptionen.

Druckoptionen Email

Wenn aktiv, wird im Kundenstamm unter Druckoptionen E-Mail auf
aktiv gesetzt.

Druckoptionen nicht drucken

Bei aktiv wird im Kundenstamm unter Druckoptionen nicht drucken aktiviert.

Druckoptionen Transportweg

Druckoptionen Format

Druckoptionen Dateiname

Weitere SA: Nur Lieferschein

Wenn aktiv, wird im Kundenstamm unter Weitere die Einstellung SA: Nur Lieferschein auf aktiv gesetzt.

Vorlage Kundennummer

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen
Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine
Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen
geprüft.

Kd.-Name1 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name1 überprüft werden sollen

Kd.-Name2 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name2 überprüft werden sollen

Kd.-Name3 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name3 überprüft werden sollen

Kd.-Straße prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Straße überprüft werden sollen

Kd.-PLZ prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld PLZ überprüft werden sollen

Kd.-Ort prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Ort überprüft werden sollen

Kundensuche über Mailadresse

Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse
in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese '''[[Connect/eBay#Aktualisierung und Import|hier]]''' aktualisiert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

Hinweise :

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den
Button Test (siehe eBay ) betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie
zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor
die eBay REST Authorisation (Login-Button im Bereich eBay)
durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]
Profile aktualisieren

Um diese unter Profile auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue hinzugefügt wurden.

eBay Kategorien aktualisieren

Per Klick werden die eBay-Kategorien aktualisiert.

Angebote importieren

Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet
haben, können Sie diese hier importieren. Voraussetzung ist, dass die
SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.

Versand- /Bezahlarten / Rückgabebedingungen

Um diese unter Versand-/Bezahlart und Rückgabe auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue Bedingungen hinzugefügt
wurden.

Artikel-Zustand

Importieren Sie hier die verfügbaren Artikel-Zustzände

Kategorie-Spezifikationen

Mittels dieses Buttons werden sowohl Kategorien als auch deren
Spezifikationen heruntergeladen. Der Vorgang kann mehrere Minuten in Anspruch nehmen, es werden über 2GB an Daten
übertragen.

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft
übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog Artikel bearbeiten erlaubt die Konfiguration einzelner
eBay-Artikel. Die Einstellungen im unteren Bereich können je nach
ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder
Empfohlen-Felder).

Allgemeine Einstellungen

* Benennung: In mention hinterlegte Artikelbenennung
(schreibgeschützt).
* Benennung eBay: Abweichende Benennung für eBay, falls
gewünscht.
* Ebay Kategorie: Auswahl der eBay-Kategorie (zuvor unter Aktualisierung und Import aktualisieren). Hinweis: Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1
und 2) – jetzt nur noch eine.
* Shop-Kategorien: Entfernt. Shop-Kategorien werden nicht mehr
im Artikeleditor verwaltet.
* Zustand / Erweit. Zustand: Artikelzustand (z. B. Neu,
Gebraucht).
* ProduktID: EAN/GTIN des Artikels.
* ebay Katalogdaten verwenden: Aktiviert die Verwendung von
eBay-Katalogdaten.
* Template: Auswahl des eBay-Artikeltemplates.
* Einstelldauer: Laufzeit des Angebots (z. B. 30 Tage, Gilt
bis Widerruf).
* XML: Direkte Eingabe von eBay-XML für erweiterte
Konfiguration.
* Bestand (kein Akt.) / Preis (kein Akt.): Legt fest, ob
Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert
werden sollen.

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]
Profile

* Verkäuferprofile (Zahlart, Versand, Rückgabe): Die
Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten
Business Policies. Anders als zuvor gibt es keine festen drei
Felder mehr, sondern eine dynamische Liste aller verfügbaren
Profile.

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]
Spezifikationen / Aspekte

* Spezifikationen: Kategoriespezifische Artikelmerkmale
(Aspekte) – Werte variieren je nach Kategorie.
* Aspekte: Freitext erzwingen: Erzwingt die Eingabe von
Freitext bei Artikelspezifikationen, auch wenn eBay eine
Auswahlliste vorgibt.
* Aspekte: Prüfung deaktivieren: Reduziert die clientseitige
Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden
nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft;
weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden
übersprungen.

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]
Aktionen

* Artikel öffnen (vfps): Öffnet den zugehörigen
Artikelstammdatensatz in mention.
* Über eBay suchen: Durchsucht den eBay-Produktkatalog und
ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen
Artikel ab.
* Von eBay herunterladen (Spezifikationen): Lädt die
kategoriespezifischen Spezifikationen (Aspekte) für die
ausgewählte eBay-Kategorie herunter.
* Download eBay Site-Einstellungen: Wenn aktiviert, werden
beim Aktualisieren der Einstelldauer auch die aktuellen
eBay-Siteeinstellungen heruntergeladen.
* ProduktID / Für Kategorie abfragen: Fragt die benötigten
Produkt-IDs für die gewählte Kategorie ab.
* Reaktivieren: Reaktiviert ein beendetes Angebot
(wahlweise mit angepasstem Preis).

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}

Connect/eBay

2026-09-14T13:54:45Z

Johann: Fix formatting; present settings as a table

__TOC__

== Voraussetzungen ==

Für die OAuth2-Anmeldung bei eBay muss die '''Microsoft Edge WebView2 Runtime''' auf dem System installiert sein.

Die Runtime wird verwendet, um das eBay-Anmeldefenster innerhalb von mention®Connect anzuzeigen. 
Ohne installierte WebView2 Runtime kann die Authentifizierung nicht durchgeführt werden.

* Microsoft Edge WebView2 Runtime
* Download: https://developer.microsoft.com/microsoft-edge/webview2/

== eBay-Profil, Rahmenbedingungen, Lizenz ==

Nach erfolgreichen Anlegen eines Profils bei eBay und Hinterlegung von Rahmenbedingungen 
(mein eBay → Mitgliedskonto → Rahmenbedingungen für Ihre Angebote), 
hinterlegen Sie die Connect-Lizenzdatei im Hauptordner von mention®Connect, 
sofern nicht bereits im Vorfeld geschehen, und lassen diese einlesen. 
Näheres dazu [[Connect/Allgemein#Lizenz einbinden|hier]].

== Erstellen der Schnittstelle und Setzen der allgemeinen Einstellungen ==

[[Datei:Ebay_FixPreis_Schnittstelle_Button.png|thumb|center]]
Klicken Sie hierfür auf den Button mit dem Plus-Zeichen. Nun ist es notwendig, die Schnittstelle mit Ihren Daten einzurichten.

[[Datei:EBay_AllgEinstellungen20221018.png|800px|thumb|center]]

Zwingend erforderliche Angaben:

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Mandant
| Legen Sie hier fest, welchen Mandanten die eBay-Schnittstelle nutzen soll.
|-
| Lager (für Artikel)
| Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die die eBay-Schnittstelle zugreifen soll.
|-
| mention Benutzer
| Legen Sie hier den Benutzer fest, mit dem sich die eBay-Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
|-
| VK-Preis
| Hier legen Sie den primären VK-Preis fest, der für den Artikelupload verwendet werden soll.
|}

== eBay ==

[[Datei:Ebay-Setting.png|800px|thumb|center]]

Wählen Sie aus, in welchem Modus Sie die Schnittstelle betreiben möchten (Sandbox oder Live). Die API-URL wird automatisch anhand der Auswahl gesetzt und ist nicht manuell änderbar.

{| class="wikitable"
|-
! Modus
! API-URL
|-
| Sandbox
| https://sandbox.ebay.com
|-
| Live
| https://api.ebay.com
|}

<div style="border-left:4px solid #888; padding:10px 14px; margin:12px 0;">
'''Hinweis:''' Beim Wechsel des Modus wird der bestehende OAuth-Token zurückgesetzt.
</div>

'''Soap-Token'''

Falls Sie noch über keinen Token verfügen, folgen Sie dafür bitte [https://services.mention.de/ebay/ dieser Anleitung]. Der eBay-Soap-Token ist der Zugangsschlüssel zu eBay für die SOAP-Schnittstelle. Bitte kopieren Sie ihn und fügen ihn hier ein. Achten Sie bitte darauf, keine Zeilenumbrüche oder andere nicht zum Token gehörende Zeichen einzutragen. Andernfalls wird der Token ungültig. Bitte betätigen Sie anschließend den Button ''Test'' und warten das Ergebnis ab.

'''eBay REST Authorisation (OAuth2)'''

[[Datei:EbayPasswordOAuth2Screen.png|600px|thumb|center]]
Zusätzlich zum Soap-Token ist die OAuth2-Authentifizierung für die REST-Schnittstelle erforderlich. Klicken Sie auf den Button "Login", um den Authentifizierungsprozess zu starten. Es öffnet sich ein Browser-Fenster, in dem Sie sich bei eBay anmelden und die erforderlichen Berechtigungen erteilen.

Nach erfolgreicher Authentifizierung wird der Status angezeigt.

{| class="wikitable" style="width:100%;"
! Status
! Beschreibung
|-
| Grün
| Token gültig: die REST-Autorisierung ist aktiv.
|-
| Orange
| Token läuft in Kürze ab: bitte erneuern Sie die Autorisierung.
|-
| Rot
| Autorisierung erforderlich: bitte führen Sie den Login erneut durch.
|}

[[Datei:EbayPasswordPoliciesScreen.png|600px|thumb|center]]
Zusätzlich werden das Ablaufdatum des Refresh-Tokens sowie etwaige Warnungen angezeigt. Bei einem ungültigen oder bald ablaufenden Token erscheint ein entsprechender Hinweis.

'''eBay Business Policies Opt-in'''

Für die Nutzung der eBay REST-API ist das Opt-in für die '''eBay Business Policies''' (Verkäuferrichtlinien) erforderlich. Der Status wird im Bereich '''eBay Business Policies Opt-in''' angezeigt.

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Opt-in-Status
| Zeigt an, ob Sie den Business Policies bereits zugestimmt haben.
|-
| Opt-in / Opt-out
| Über die Buttons können Sie die Zustimmung erteilen oder zurücknehmen. Bei Sandbox-Accounts ist kein Opt-in erforderlich.
|}

== Übertragungsintervalle ==

[[Datei:EBay_UpDown20221018.png|800px|thumb|center]]
Das Upload-Intervall betrifft Artikelaktualisierungen und Bestände. Das Intervall Bestellungen/Paketnummern bezieht sich auf den Download von Bestellungen und das Übertragen von Sendungsdaten und Verkäufer-Feedback. Sollen für einen bestimmten Zeitraum keine Übertragungen erfolgen, kann eine entsprechende Pause hinterlegt werden. Falls Sie dsxml-Accounts für die Warenwirtschafts-Option ''Online-Daten pro Account'' nutzen, wählen Sie hier den Account, den Sie für eBay nutzen, aus.

== Zuordungen ==

[[Datei:EBay_Zuordnungen20221018.png|800px|thumb|center]]
Die Zuordungen der Zahl- und Versandarten sind erst nach einer erfolgreichen Bestellung möglich.

== Behandlung Bestand ==

[[Datei:EBay_Bestand20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Best. Online verwenden
| Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
|-
| Best. zzgl. Bestellte
| Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
|-
| Bestand abzgl. in Nachbearbeitung
| Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
|-
| Bestand abzgl. Dsxml in Nachbearbeitung
| Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.
|-
| Sperrbest abziehen
| Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
|-
| Vorbestellte abziehen
| Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
|-
| Änderungsdatum Lager deaktiviert
| Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
|-
| Bestände von Gruppenmitgliedern abschneiden
| Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
|}

== Neue Kunden ==

[[Datei:EBay_NeueKunden20221018.png|600px|thumb|center]]
Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)

Wenn diese Einstellung aktiv ist, wird beim Anlegen eines
Ansprechpartners das Online Feld aktiviert.

Behandlung Name

Wenn Standard Behandlung aktiviert ist, werden Vorname und
Nachname zusammen in Name2 gespeichert. Wenn Privat Person: Vorname = Name1, Nachname = Name2 ausgewählt ist,
wird der Vorname in das Feld Name1 gespeichert und das Feld Name2 mit dem Nachnamen befüllt.

KD Kennz. Endkunde

Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für
diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im
Kundenstamm als Endkunde gekennzeichnet.

Druckoptionen speichern

Aktiviert die folgenden Druckoptionen.

Druckoptionen Email

Wenn aktiv, wird im Kundenstamm unter Druckoptionen E-Mail auf
aktiv gesetzt.

Druckoptionen nicht drucken

Bei aktiv wird im Kundenstamm unter Druckoptionen nicht drucken aktiviert.

Druckoptionen Transportweg

Druckoptionen Format

Druckoptionen Dateiname

Weitere SA: Nur Lieferschein

Wenn aktiv, wird im Kundenstamm unter Weitere die Einstellung SA: Nur Lieferschein auf aktiv gesetzt.

Vorlage Kundennummer

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen
Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

* Versicherung (Weitere)
* Endkunde (Weitere)
* SA: nur Lieferschein (Weitere)
* Versandart (Weitere)
* Währung (Weitere)
* Transportweg (Weitere)
* Kennwort (Weitere)
* Adresse (Weitere)
* VK-Preis akzeptieren (Weitere)
* Format (Weitere)
* Mahnung (Weitere)
* Zahlart (Weitere)
* Frachtfrei (Weitere)
* Frachtfrei ab Wert (Weitere)
* Werkstatt (Weitere)
* Mindestfrachtkosten (Weitere)
* nicht Drucken (Druckoptionen)
* E-Mail (Druckoptionen)
* LFS, Leih-/Teststellung (Weitere)
* Proforma-Rechnung (Weitere)
* Keine Automatik (Weitere)
* Liefersperre (Weitere)
* Preis (Weitere)
* Keine Staffelpreise (Weitere)
* Kalkulation (Weitere)
* Konditionen (Weitere)
* Rabatt (Weitere)
* Limit (Weitere)
* Limit intern (Weitere)
* Gültigkeit von Limit (Weitere)
* Gültigkeit von Limit intern (Weitere)
* Rückscheck/RLS (Weitere)
* Factor-Nr. (Weitere)
* Gilt für Anschriften (Weitere)
* Rabatt drucken (Weitere)
* Sprachschlüssel (Weitere)
* Neue Nummer (Stammdaten)
* Gebiet (Stammdaten)
* Kennzeichen (Stammdaten)
* Keine Werbung (Stammdaten)
* Keine Fax-Werbung (Stammdaten)
* Keine E-Mail-Werbung (Stammdaten)
* Keine Post-Werbung (Stammdaten)
* Seriennummer extra drucken (Stammdaten)
* Belegdruck mit Seriennummern (Stammdaten)
* Warenausgangsetiketten nicht drucken (Stammdaten)
* Nicht Aktiv (Stammdaten)
* Techniker (Stammdaten)
* Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine
Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen
geprüft.

Kd.-Name1 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name1 überprüft werden sollen

Kd.-Name2 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name2 überprüft werden sollen

Kd.-Name3 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name3 überprüft werden sollen

Kd.-Straße prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Straße überprüft werden sollen

Kd.-PLZ prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld PLZ überprüft werden sollen

Kd.-Ort prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Ort überprüft werden sollen

Kundensuche über Mailadresse

Wenn aktiv, wird zunächst versucht, den Kunden anhand seiner Mailadresse
in der Warenwirtschaft zu finden, und bei Erfolg zuzuordnen.

== Belegdaten ==

[[Datei:EBay_Belegdaten20221018.png|600px|thumb|center]]

{| class="wikitable" style="width:100%;"
! Einstellung
! Beschreibung
|-
| Bezug1 Beleg
| Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
|-
| Hinweis Beleg
| Text, der im Beleg unter ''Hinweise'' eingesetzt wird.
|-
| Sperrkennzeichen
| Hier kann man ein Sperrkennzeichen für Belege zuweisen.
|-
| Kennz. Direktlieferung (Kennzeichen Direktlieferung)
| Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
|-
| Kennz. Automatik (Kennzeichen Automatik)
| Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
|-
| TransaktionsID Bezahlsystem
| Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
|-
| eBay Benutzername
| Legen Sie hier das Belegfeld fest, in das der eBay-Name des Käufers geschrieben wird.
|-
| Debitoren nicht berücksichtigen
| Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
|-
| Extended Order ID
| Hier kann das Belegfeld ausgewählt werden, in das die Extended Order ID geschrieben wird.
|-
| Haken 'Teillieferung zulässig' berücksichtigen
| ''(noch nicht dokumentiert)''
|-
| Datum/Uhrzeit
| Legt fest, in welches Belegfeld Kaufdatum und -uhrzeit geschrieben werden soll.
|-
| Externe Referenz 1 bis 3
| Sie können die Zahlungsreferenz und/oder Auftragsnummer einem der drei Referenzfelder zuweisen.
|}

== eBay-Einstellungen ==

[[Datei:Ebay_eBayEinstellungen20221018.png|800px|thumb|center]]

== Profile ==

[[Datei:EBay_Profile20221018.png|600px|thumb|center]]
Wählen Sie hier bitte die in Ihrem eBay-Konto eingestellten
Rahmenbedingungen aus. Voraussetzung dafür ist, dass Sie diese hier aktualisert haben.

== Versand-/Bezahlart und Rückgabe ==

[[Datei:EBay_Rückgabe.png|800px|thumb|center]]

== Aktualisierung und Import ==

Hinweise :

* Vor dem Aktualisieren der Kategorie-Spezifikationen bitte einmalig den
Button Test (siehe eBay ) betätigen. Es wird dabei ein spezielles Token abgerufen, das Sie
zum Abruf der Daten berechtigt.
* Für REST-basierte Funktionen (Business Policies, Opt-in) muss zuvor
die eBay REST Authorisation (Login-Button im Bereich eBay)
durchgeführt werden.

[[Datei:EBay_Aktualisierung20221018.png|800px|thumb|center]]
Profile aktualisieren

Um diese unter Profile auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue hinzugefügt wurden.

eBay Kategorien aktualisieren

Per Klick werden die eBay-Kategorien aktualisiert.

Angebote importieren

Sofern Sie vor Nutzung der eBay-Schnittstelle bereits Angebote gelistet
haben, können Sie diese hier importieren. Voraussetzung ist, dass die
SKU Ihrer Angebote mit mention Artikelnummern übereinstimmen.

Versand- /Bezahlarten / Rückgabebedingungen

Um diese unter Versand-/Bezahlart und Rückgabe auswählen zu können, ist es zunächst erforderlich, diese hier zu
importieren bzw. zu aktualsieren, sofern neue Bedingungen hinzugefügt
wurden.

Artikel-Zustand

Importieren Sie hier die verfügbaren Artikel-Zustzände

Kategorie-Spezifikationen

Mittels dieses Buttons werden sowohl Kategorien als auch deren
Spezifikationen heruntergeladen. Der Vorgang kann mehrere Minuten in Anspruch nehmen, es werden über 2GB an Daten
übertragen.

== Zu exportierende Bilder ==

[[Datei:EBay_Bilder20221018.png|600px|thumb|center]]
Wählen Sie hier aus, welche Artikelbilder Sie aus der Warenwirtschaft
übertragen möchten.

== Bestellungen ==

[[Datei:EBay_Bestellungen20221018.png|800px|thumb|center]]
Wählen Sie hier das Datum der jüngsten abzurufenden Bestellung aus.

== Artikel bearbeiten (EbayEditItem) ==

Der Dialog Artikel bearbeiten erlaubt die Konfiguration einzelner
eBay-Artikel. Die Einstellungen im unteren Bereich können je nach
ausgewählter eBay-Kategorie variieren (Pflicht-, Optional- oder
Empfohlen-Felder).

Allgemeine Einstellungen

* Benennung: In mention hinterlegte Artikelbenennung
(schreibgeschützt).
* Benennung eBay: Abweichende Benennung für eBay, falls
gewünscht.
* Ebay Kategorie: Auswahl der eBay-Kategorie (zuvor unter Aktualisierung und Import aktualisieren). Hinweis: Zuvor gab es zwei Kategoriefelder (Ebay Kategorie 1
und 2) – jetzt nur noch eine.
* Shop-Kategorien: Entfernt. Shop-Kategorien werden nicht mehr
im Artikeleditor verwaltet.
* Zustand / Erweit. Zustand: Artikelzustand (z. B. Neu,
Gebraucht).
* ProduktID: EAN/GTIN des Artikels.
* ebay Katalogdaten verwenden: Aktiviert die Verwendung von
eBay-Katalogdaten.
* Template: Auswahl des eBay-Artikeltemplates.
* Einstelldauer: Laufzeit des Angebots (z. B. 30 Tage, Gilt
bis Widerruf).
* XML: Direkte Eingabe von eBay-XML für erweiterte
Konfiguration.
* Bestand (kein Akt.) / Preis (kein Akt.): Legt fest, ob
Bestand bzw. Preis nach der Erstübertragung nicht mehr aktualisiert
werden sollen.

[[Datei:EbayEditItemScreen.png|600px|thumb|center]]
Profile

* Verkäuferprofile (Zahlart, Versand, Rückgabe): Die
Profilauswahl erfolgt dynamisch auf Basis der bei eBay hinterlegten
Business Policies. Anders als zuvor gibt es keine festen drei
Felder mehr, sondern eine dynamische Liste aller verfügbaren
Profile.

[[Datei:EbayEditItemProfile.png|600px|thumb|center]]
Spezifikationen / Aspekte

* Spezifikationen: Kategoriespezifische Artikelmerkmale
(Aspekte) – Werte variieren je nach Kategorie.
* Aspekte: Freitext erzwingen: Erzwingt die Eingabe von
Freitext bei Artikelspezifikationen, auch wenn eBay eine
Auswahlliste vorgibt.
* Aspekte: Prüfung deaktivieren: Reduziert die clientseitige
Validierung der Aspekte auf Pflichtfelder. Bei Aktivierung werden
nur noch erforderliche Spezifikationen auf Vollständigkeit geprüft;
weitergehende Prüfungen (Wertebereiche, Formatvorgaben) werden
übersprungen.

[[Datei:EbayEditItemSpezifikationenScreen.png|600px|thumb|center]]
Aktionen

* Artikel öffnen (vfps): Öffnet den zugehörigen
Artikelstammdatensatz in mention.
* Über eBay suchen: Durchsucht den eBay-Produktkatalog und
ruft die zugehörige eBay-Produkt-ID (EPID) für den aktuellen
Artikel ab.
* Von eBay herunterladen (Spezifikationen): Lädt die
kategoriespezifischen Spezifikationen (Aspekte) für die
ausgewählte eBay-Kategorie herunter.
* Download eBay Site-Einstellungen: Wenn aktiviert, werden
beim Aktualisieren der Einstelldauer auch die aktuellen
eBay-Siteeinstellungen heruntergeladen.
* ProduktID / Für Kategorie abfragen: Fragt die benötigten
Produkt-IDs für die gewählte Kategorie ab.
* Reaktivieren: Reaktiviert ein beendetes Angebot
(wahlweise mit angepasstem Preis).

== Template Variablen ==

{| class="wikitable"
|-
! mention-Feld
! Tabellen-Feld
! Variable
|-
| Stammdaten-Nummer
| ARANUMMER
| ArtikelNr
|-
| Stammdaten-Benennung
| ARBEN
| Title
|-
| Stammdaten-Beschreibung
| ARERWBEN
| Description
|-
| Katalog-Beschreibung
| ARKATERW
| arkaterw
|-
| eBay2-2.Titelzeile
| arebsubt
| SubTitle
|-
| Preise-Preis mit Währung
| --
| PriceCurrency
|-
| Preise-Preis ohne Währung
| --
| Price
|-
| Stammdaten-Hersteller-Nr.
| ARHERSTNR
| arherstnr
|-
| ebay1-Artikelzustand
| arebitmco
| arebitmco
|-
| Stammdaten-EAN-Code
| areancode
| aeeancode
|-
| Weitere Daten-Bermerkung1
| ARBEMERK1
| Mention_free_1
|-
| Stammdaten-Geschäftsbereich (Bezeichnung)
| ARGESBER
| argesber
|-
| Stammdaten-Geschäftsbereich (Nummer)
| --
| argesbernr
|-
| Katalog-Bezeichnung
| ARKATBEN
| arkatben
|-
| Weitere Daten-Kennzeichen
| aralkenn
| aralkenn
|-
| Weitere Daten-Letzte Änderung
| updtime
| updtime
|-
| Katalog-Abbildung1 bis Abbildung10
| arkatbild1 bis arkatbild10
| Image1 bis Image10
|-
| Allgemeine Daten-Kurzbeschreibung
| aronlshort
| aronlshort
|-
| eBay Artikelnummer
| -
| eBayNr
|}