Alt: API-Log
Im Menü Daten » API Log findest du eine Historie über sowohl interne Vorgänge als auch über Vorgänge, die über Schnittstellen ausgeführt wurden. Jeder Vorgang erhält einen Eintrag.
Neben dem allgemeinen API-Log findest du noch 4 weitere Tabs. Im Tab SOAP-Log findest du Informationen wie, wer wann welchen SOAP-Call ausgeführt hat. Im Tab SOAP-Statistik werden Zugriffszahlen aufgeführt. Im Amazon-API-Log sind die Log-Einträge zu Amazon noch einmal einzeln und teilweise auch ausführlicher aufgeführt. Über das Ordner-Symbol im Tab API-Log hinter einem Amazon-Eintrag gelangst du auch in das Amazon-API-Log. Im Versand-Center-API-Log findest du Meldungen zu Sendungen, die du über das Versand-Center angemeldet hast.
1. Log-Einträge filtern
Standardmäßig werden die Einträge absteigend nach ID aufgelistet. Die Einträge lassen sich filtern, sodass die Anzahl der aufgelisteten Einträge verringert wird. Zur Verfügung stehen dir ein API-Namensfilter und ein Datumsfilter.
Log-Einträge nach Name filtern:
-
Öffne das Menü Daten » API Log.
-
Wähle ein Format aus der Dropdown-Liste Vorgang.
-
Klicke auf Suchen, um die Suche auszuführen.
Format ist nicht aufgeführt
Die Formate stehen in der Dropdown-Liste Vorgang erst dann zur Verfügung, wenn der Prozess ausgeführt und protokolliert wurde. Wenn du neue Formate hier nicht findest, wurde der Prozess noch nicht ausgeführt oder es kam z.B. noch nicht zu einem entsprechenden Fehler. |
Log-Einträge nach Datum filtern:
-
Öffne das Menü Daten » API Log.
-
Wähle ein Datum aus dem Kalender.
-
Klicke auf Suchen, um die Suche auszuführen.
Natürlich lassen sich beide Filter auch kombinieren, um nur Einträge eines Formates eines Tages zu erhalten.
2. Vorgang: E-Mail
Der Vorgang E-Mail enthält Logs zu Meldungen, die z.B. bei Fehlern mit E-Mails oder bei der Konfiguration von E-Mail-Konten oder E-Mail-Adressen auftreten. Der Vorgang wird beim ersten Fehler in der Dropdown-Liste angelegt. In einer Fehlermeldung, z.B. beim erfolglosen Versand einer E-Mail, werden folgende Informationen angezeigt: Kunden-ID, Auftrags-ID und Fehlermeldung des Providers. Diese Information wird auch im Log-Eintrag angezeigt.
Ereignis | Erläuterung |
---|---|
Error sending email. CustomerId: 136 OrderId: 550 (Code 535): 5.7.8 Error: authentication failed: UGFzc3dvcmQ6 |
E-Mail wurde nicht versendet. Die Authentifizierung ist fehlgeschlagen aufgrund von fehlerhaften Parametern des E-Mail-Kontos, z.B. falsches Passwort oder ein nicht korrekter Benutzer:innen-Name. |
Error sending email. CustomerId: 153 OrderId: 103 (Code 0): stream_socket_client(): unable to connect to tcp://mail.servername.com:XXX (Connection refused) |
E-Mail wurde nicht versendet aufgrund einer fehlerhaften Portangabe. XXX = Port |
3. DHL Fulfillment-Log-Einträge
In diesem Kapitel findest du alle Einträge, die im Zusammenhang mit der Nutzung von DHL Fulfillment im Log aufgeführt werden können. Es gibt Vorgänge, bei denen Informationen an DHL Fulfillment übertragen werden. Bei Einträgen zu diesen Vorgängen gibt es jeweils 3 Ereignisse und es gibt Vorgänge, bei denen Informationen von DHL Fulfillment abgefragt werden. Bei diesen Vorgängen gibt es ein Ereignis.
3.1. DHLFulfillment ItemMaster
Dieser Eintrag erfolgt im Log bei Anmeldung des Artikelstammes. Der Eintrag selbst sagt noch nichts darüber aus, ob die Artikel tatsächlich erfolgreich übertragen wurden oder nicht. Für diesen Eintrag gibt es 3 mögliche Ereignisse, die über den genauen Status der Übertragung informieren.
Ereignis | Erläuterung |
---|---|
Successfully transmitted ItemMaster |
Artikelstamm wurde übermittelt. Wie viele Aufträge fehlerfrei angemeldet wurden, wird in einem weiteren Ereignis angezeigt. |
Could not transmit ItemMaster |
Artikelstamm wurde nicht übermittelt. |
Count ItemMaster: xxx entries done and xxx errors! |
Anzahl der Artikel, deren Artikelstamm übertragen wurde und Anzahl der Artikel, deren Artikelstamm nicht übertragen wurde. |
3.2. DHLFulfillment DeliveryAdvice
Dieser Eintrag erfolgt im Log bei Übertragung einer Vorabinformation über nachbestellte Ware, die demnächst geliefert wird. Der Eintrag selbst sagt noch nichts darüber aus, ob die Vorabinformationen tatsächlich erfolgreich übertragen wurden oder nicht. Für diesen Eintrag gibt es 3 mögliche Ereignisse, die über den genauen Status der Übertragung informieren. Die in der Spalte Paramenter angegebenen Parameter sind Nachbestellungs-IDs.
Ereignis | Erläuterung |
---|---|
Successfully transmitted DeliveryAdvices! |
Bestellungen wurden übermittelt. Wie viele Bestellungen fehlerfrei angemeldet wurden, wird in einem weiteren Ereignis angezeigt. |
Could not transmit DeliveryAdvices |
Bestellungen wurden nicht übermittelt. |
Count DeliveryAdvice: xxx entries done and xxx errors! |
Anzahl der Bestellungen, die angemeldet wurden und Anzahl der Bestellungen, die nicht angemeldet wurden. |
3.3. DHLFulfillment DeliveryReceipt
Dieser Eintrag erfolgt im Log bei Abfrage zur Lieferung von Nachbestellungen. Für diesen Eintrag gibt es 1 mögliches Ereignis, das angibt aus wie vielen Nachbestellungen Lieferungen eingegangen sind. Die Information sagt aber nicht aus, dass die Lieferung zu einer Nachbestellung vollständig war. In der Nachbestellung selbst wird angezeigt welche Artikel geliefert wurden.
Ereignis | Erläuterung |
---|---|
DHLFulfillment Delivery Receipt! Count Entries: xxx |
Anzahl der Nachbestellungen aus denen Lieferungen eingegangen sind. |
3.4. DHLFulfillment StockAdjustment
Dieser Eintrag erfolgt im Log bei Abfrage der Bestandsbewegungen. Für diesen Eintrag gibt es 1 mögliches Ereignis, das über die Anzahl der Bestandsbewegungen informiert.
Ereignis | Erläuterung |
---|---|
Processed StockAdjustment! Count Entries: xxx |
Anzahl der Bestandsbewegungen. |
3.5. DHLFulfillment Inventory
Dieser Eintrag erfolgt im Log bei Abfrage der aktuellen Bestände, auch Inventurabgleich genannt. Für diesen Eintrag gibt es 1 mögliches Ereignis, das die Anzahl der abgeglichen Bestände angibt.
Ereignis | Erläuterung |
---|---|
Processed Inventory! Count Entries: xxx |
Anzahl der Artikel, bei denen der Bestand abgeglichen wurde. |
3.6. DHLFulfillment Order
Dieser Eintrag erfolgt im Log beim Anmelden von Aufträgen. Für diesen Eintrag gibt es 3 mögliche Ereignisse, die über den genauen Status der Anmeldung informieren. Die in der Spalte Paramenter angegebenen Parameter sind Auftrags-IDs.
Ereignis | Erläuterung |
---|---|
Successfully transmitted Order! |
Aufträge wurden übermittelt. Wie viele Aufträge fehlerfrei angemeldet wurden, wird in einem weiteren Ereignis angezeigt. |
Could not transmit Orders |
Aufträge wurden nicht übermittelt. |
Count Order: xxx entries done and xxx errors! |
Genaue Anzahl der Aufträge, die angemeldet wurden und Anzahl der Aufträge, die nicht angemeldet wurden. |
Wenn ein Auftrag nicht angemeldet werden konnte und die Anmeldung erneut vorgenommen wird, ändert plentymarkets beim Anmelden automatisch die ID des Auftrags, da DHL Fulfillment trotz fehlgeschlagener Anmeldung jede Auftrags-ID nur einmal akzeptiert. In der Spalte Parameter wird trotzdem die korrekte Auftrags-ID aus plentymarkets angezeigt. Die Datei, die unter Vorgang angezeigt wird, enthält hingegen die ID, mit der der Auftrag bei DHL Fulfillment angemeldet wurde.
3.7. DHLFulfillment Transport
Dieser Eintrag erfolgt im Log bei der Abfrage nach versendeten Aufträgen. Für diesen Eintrag gibt es 1 mögliches Ereignis, das über versendet oder nicht informiert. Es kann sein, dass ein Auftrag in mehrere Lieferaufträge gesplittet wird, weil einige Artikel eher verschickt werden oder ein Auftrag wird generell in mehreren Paketen versendet. In der Spalte Paramenter sind Auftrag-IDs und auch IDs der Lieferaufträge aufgeführt. Wenn Lieferäufträge angelegt wurden, werden der Lieferauftrag und der Auftrag durch Schrägstrich (/) getrennt angegeben. Im Beispiel 1957/1956 bedeutet das, dass ein Lieferauftrag mit der ID 1957 zum Auftrag mit der ID 1956 angelegt wurde.
Ereignis | Erläuterung |
---|---|
Processed Transport! Count Entries: xxx, Count Errors: xxx |
Count Entries = Anzahl der Aufträge, die versendet wurden. |
3.8. DHLFulfillment OrderReturned
Dieser Eintrag erfolgt im Log bei der Abfrage von Retouren. Für diesen Eintrag gibt es 1 mögliches Ereignis, das über die abgerufenen Retouren informiert. Die in der Spalte Paramenter angegebenen Parameter sind Auftrag-IDs von Aufträgen zu denen Retouren angelegt wurden.
Ereignis | Erläuterung |
---|---|
Processed OrderReturned! Count Entries: xxx, Count Errors: xxx |
Count Entries = gibt an, wie viele Retouren in plentymarkets angelegt wurden. |
3.9. DHLFulfillment OrderCanceled
Der Eintrag im Log erfolgt bei der Abfrage von Stornierungen, d.h. die Stornierung kommt von DHL Fulfillment. Gründe für eine Stornierung durch DHL Fulfillment kann u.a. fehlerhafte Ware oder ähnliches sein. Für diesen Eintrag gibt es 1 mögliches Ereignis, das über abgefragte Stornierungen informiert. Die in der Spalte Paramenter angegebenen Parameter sind Auftrag-IDs von Aufträgen zu denen eine Stornierung in deinem System angelegt wurde.
Ereignis | Erläuterung |
---|---|
Processed OrderCanceled! Count Entries: xxx, Count Errors: xxx |
Count Entries = gibt an, wie viele Stornierungen in plentymarkets angelegt wurden. |
4. atriga-Log-Einträge
In diesem Kapitel findest du alle Einträge, die im Zusammenhang mit der Nutzung von atriga und atrigapaymax im Log aufgeführt werden können.
4.1. atriga
Die Log-Einträge zu atriga dienen der Informaiton über freigeschaltete Produkte.
Parameter | Erläuterung |
---|---|
atriga-Request |
Anfrage an atriga, um zu ermitteln, ob das Produkt atrigapaymax freigeschaltet ist. |
atriga-Response |
Antwort von atriga mit der Inforamtion, ob atrigapaymax freigeschaltet ist. |
4.2. atrigapaymax
Die Log-Einträge zu atrigapaymax enthalten Informationen zur Bonitätsprüfung.
Parameter | Erläuterung |
---|---|
Atrigapaymax-Request |
Anfrage an atriagapaymax, um eine Bonitätsprüfung auszuführen. |
Atrigapaymax-Response |
Antwort auf die Anfrage mit dem Ergebnis der Bonitätsprüfung. |
5. DPD Cloud Webservice-Log-Einträge
In diesem Kapitel findest du Hinweise zu Einträgen, die im Zusammenhang mit der Nutzung von DPD Cloud Webservice im Log aufgeführt werden können. Wähle im Tab Versand Center API-Log den Vorgang DPDCloudWebservice.
5.1. CLOUD_USERDATA_NOACCESS
Dieser Eintrag erfolgt im Log, wenn der Zugriff verweigert wird.
Meldung | Erläuterung |
---|---|
CLOUD_USERDATA_NOACCESS_SHIPMENTSERVICE |
Kein Zugriffsrecht auf den Versandservice. |
CLOUD_USERDATA_NOACCESS_COD |
Kein Zugriffsrecht auf den Versandservice Nachnahme. |
CLOUD_USERDATA_NOACCESS_PREDICT |
Kein Zugriffsrecht auf den Versandservice Predict. |
5.2. CLOUD_ADDRESS
Dieser Eintrag erfolgt im Log bei fehlerhaften oder fehlenden Adressdaten. Möglich ist auch eine Überschreitung der maximalen Zeichenlänge eines Parameters. In der Tabelle sind einige Beispiele aufgeführt, die Liste ist nicht vollständig.
Meldung | Erläuterung |
---|---|
CLOUD_ADDRESS_PHONE |
Telefonnummer falsch oder fehlt. Format: 5 bis 20 Zeichen. |
CLOUD_ADDRESS_NEEDMAIL |
E-Mail fehlt; die Angabe der E-Mail-Adresse des Empfängers ist Pflicht. |
CLOUD_STATE_STATESHORT |
Land nach ISO3166-2 Format: genau 2 Zeichen. |
CLOUD_ADDRESS_COMPANYANDNAMEEMPTY |
Firma oder Name erforderlich. |
CLOUD_API_ORDER_WEIGHT |
Maximales Gewicht überschritten. Maximal können 31,5 kg verschickt werden. |
5.3. CLOUD_API_ORDER
Dieser Eintrag erfolgt im Log bei Fehlern im Zusammenhang mit der Anmeldung der Versandaufträge.
Ereignis | Erläuterung |
---|---|
CLOUD_API_ORDER_MAXORDERS |
Maximale Anzahl der angemeldeten Versandaufträge überschritten. Es ist nicht möglich, mehrere Sendungen gleichzeitig anzumelden. |
CLOUD_API_ORDER_SHIPSERVICE |
Ungültiger Versandservice. |
CLOUD_API_ORDER_CODAMOUNT |
Unzulässiger Nachnahmebetrag. Dieser muss im Bereich zwischen 1.00 und 5000.00 Euro liegen. |
CLOUD_API_ORDER_EXPRESS_DEU_COUNTRY |
Gewählte Express-Option nur für Deutschland möglich. |
CLOUD_API_ORDER_CODPURPOSE |
Nachnahme-Referenz enthält zu viele Zeichen. Es sind maximal 14 Zeichen möglich. |
6. PayPal-Log-Einträge
In diesem Kapitel findest du alle Einträge, die im Zusammenhang mit der Nutzung des Abrufes der PayPal-Abrechnungsberichte im Log aufgeführt werden können.
6.1. CronPayPalSettlement
Die Log-Einträge zu CronPayPalSettlement betreffen den generellen Verbindungsaufbau zum SFTP-Server von PayPal.
Ereignis | Erläuterung |
---|---|
PayPal SFTP connection established |
Verbindung mit dem SFTP-Server von PayPal wurde aufgebaut. |
PayPal SFTP xxx files downloaded |
Gibt die Anzahl der heruntergeladenen CSV-Dateien an. |
PayPal SFTP no files found in /ppreports/outgoing directory |
Gibt an, dass keine Dateien zum Herunterladen gefunden wurden. |
PayPal SFTP disconnect |
Gibt an, dass die Verbindung zum Server beendet wird. |
PayPal SFTP Exception: … |
Gibt im Fehlerfall die Fehlermeldung des Servers aus. |
6.2. PayPalSettlement
Die Log-Einträge zu PayPalSettlement betreffen die in den Abrechnungsberichten enthaltenen Transaktionen. Die Transaktions-ID von PayPal wird in plentymarkets im Verwendungszweck einer Zahlung angezeigt.
Ereignis | Erläuterung |
---|---|
The settlement report xxx contains xxx lines and xxx transactions. |
Gibt die Anzahl der Zeilen des Berichts und die enthaltenen Transaktionen an. Ob und wie die Transaktionen verarbeitet wurden, gibt dieses Ereignis nicht an. |
xxx of xxx transactions were successfully assigned. xxx transactions were not assigned. |
Gibt die Gesamtanzahl der Transaktionen eines Abrechnungsberichtes an und wie viele dieser Transaktionen einem Auftrag zugeordnet werden konnten und wie viele nicht. Wenn eine Transaktion nicht verarbeitet wurde, kann es sein, dass kein Auftrag gefunden wurde, zu dem die Transaktion passt oder dass die Zahlung bereits dem Auftrag zugewiesen wurde und deshalb die Transaktion aus der Datei nicht mehr zugeordnet wird. |
The settlement report xxx could not be opened. |
Wird angezeigt, wenn die Datei nicht mehr vorhanden oder nicht lesbar ist. |
Transaction xxx was assigned. |
Wird für jede verarbeitete Transaktion aufgeführt. Die Transaktion stammt dem Abrechnungsbericht, der im zuletzt davor aufgeführten Ereignis The settlement report xxx contains xxx lines and xxx transactions genannt wird. |
Transaction xxx was not assigned. |
Wird für jede nicht verarbeitete Transaktion aufgeführt. Die Transaktion stammt dem Abrechnungsbericht, der im zuletzt davor aufgeführten Ereignis The settlement report xxx contains xxx lines and xxx transactions genannt wird. |