In der Transaktion [SYS21] API‑Logs sehen Sie alle technischen Protokolle (Logs), die beim Datenaustausch zwischen reybex und angebundenen Fulfillment‑Dienstleistern entstehen.
Die Logs helfen Ihnen, Übertragungen nachzuvollziehen, Fehler zu analysieren und fehlgeschlagene Requests erneut zu senden.
Zusätzlich zu den technischen Informationen werden die Logs jetzt um fachlich verständliche Endpoint-Beschreibungen und eine klare Quellenangabe ergänzt. Dadurch wird die Suche deutlich schneller und transparenter.
Die API‑Logs werden immer dann genutzt, wenn Daten zwischen Reybex und externen Systemen ausgetauscht werden, z. B.:
– Wareneingänge vom Fulfillment
- Versandmeldungen
- Bestandskorrekturen
- Artikel- oder Umlagerungsbewegungen
Typische Einsatzszenarien:
- Analyse fehlgeschlagener Übertragungen
- Support- und Fehleranalyse
- Nachverfolgung von Belegen und Beständen
- Kontrolle der Schnittstellenkommunikation
Voraussetzungen
- Zugriff auf reybex
- Berechtigung für die Transaktion [SYS21] API‑Logs
- Eine aktive API‑Anbindung zu einem Fulfillment‑Dienstleister
1. Schritt-für-Schritt-Anleitung:
- Öffnen Sie die Transaktion Gehen Sie zu [SYS21] API‑Logs
- Übersicht der API‑Requests s werden alle Requests angezeigt, die im Rahmen der API‑Kommunikation erzeugt wurden.
- Logs analysieren nutzen Sie die Spalten, um relevante Einträge schnell zu identifizieren.
- Eintrag markieren markieren Sie einen oder mehrere Log‑Einträge.
- Erneute Übertragung starten über die entsprechende Aktion kann der Request erneut an den Fulfillment‑Dienstleister gesendet werden.
Hinweis: Nach dem erneuten Versand wird der Status aktualisiert und eine neue Rückmeldung protokolliert.
2. Erklärung der wichtigsten Felder:
- Endpunkt
Technischer Name der angesprochenen API‑Schnittstelle.
- Beschreibung
Fachlich verständliche Bezeichnung des Endpoints.
Sie erkennen sofort, welcher Geschäftsprozess betroffen ist.
Beispiele: Wareneingang, Versand, Bestandskorrektur, Artikeltransfer
- Quelle zeigt an, woher das Datenpaket stammt.
Mögliche Quellen: Fulfillment‑Dienstleister, IP‑Adresse, Domainname eines externen Systems
Damit können Sie schnell unterscheiden, ob Daten aus einem internen oder externen System stammen.
3. Inhalt des Datenpakets Zeigt die übermittelten Daten (Request/Response) zur technischen Analyse.
- Übertragung
Zeitpunkt und Richtung der Übertragung (Senden / Empfangen).
- Status
Aktueller Verarbeitungsstatus des Requests (z. B. erfolgreich, fehlgeschlagen).
- Rückmeldung
Antwort des Zielsystems auf den API‑Request.
- Fehlercodes
Technische oder fachliche Fehlercodes bei fehlgeschlagenen Übertragungen.
4. Systemverhalten
- Jeder API‑Request wird automatisch in [SYS21] API‑Logs protokolliert.
- Die neuen Felder Beschreibung und Quelle werden direkt beim Laden der Übersicht angezeigt.
- Dadurch:
- bessere Performance bei der Analyse
- weniger Öffnen einzelner Detailansichten
- schnellere Identifikation relevanter Vorgänge
- Bei einer erneuten Übertragung:
- wird ein neuer Request ausgelöst
- der Status und die Rückmeldung werden aktualisiert
5. Beispiele aus der Praxis
Beispiel 1: Wareneingang nicht verbucht
- Beschreibung: Wareneingang
- Quelle: Fulfillment Sie erkennen sofort, dass der Datensatz vom Dienstleister stammt und den Wareneingang betrifft.
Beispiel 2: Versandmeldung aus externem System
- Beschreibung: Versand
- Quelle: Domain eines externen Systems Klare Zuordnung ohne Öffnen des Datensatzes.
Hinweise / Tipps / typische Fehler
- Tipp:
Nutzen Sie die Spalte Beschreibung, um nicht nach technischen Endpoint-Namen suchen zu müssen.
- Tipp:
Kombinieren Sie Beschreibung und Quelle, um Ursachen schneller einzugrenzen.
Achtung:
Die erneute Übertragung sollte nur erfolgen, wenn die Ursache des Fehlers bekannt oder behoben ist.
Typischer Fehler:
Logs werden mehrfach erneut gesendet, obwohl der Fehler auf Seiten des Zielsystems liegt.
Was tun, wenn es nicht funktioniert?
- Prüfen Sie den Fehlercode und die Rückmeldung
- Stellen Sie sicher, dass:
- der Fulfillment‑Dienstleister erreichbar ist
- die Schnittstelle aktiv ist
- Besteht das Problem weiterhin:
- Zeitraum der Logs einschränken
- Support mit Log‑ID und Beschreibung kontaktieren
Best Practices
- Erst Beschreibung prüfen, dann technische Details öffnen
- Erneute Übertragungen gezielt einsetzen
- Logs regelmäßig kontrollieren, besonders bei neuen Schnittstellen