Administration

Zweck

Diese Seite beschreibt die operative Administration von Shipping Labels, nachdem die gemeinsame Einrichtung und mindestens eine Zustellereinrichtung vorhanden sind. Im Mittelpunkt stehen URLs, wiederverwendbare Einrichtungspakete, Anfrageanalyse, Aufbewahrungsregeln und Support-Informationen.

Zugriff in Business Central

• Öffnen Sie Versandetiketteinrichtung für globale Einstellungen, Requestprotokolle, Löschregeln und den Zugriff auf verwandte Einrichtungsseiten.
• Öffnen Sie Versandetikett-URL, wenn produktive oder Test-Endpunkte angelegt oder geändert werden müssen.
• Öffnen Sie Konfigurationspakete, wenn Einrichtungsdaten exportiert, importiert oder über Gesellschaften oder Umgebungen hinweg ausgerollt werden sollen.
• Öffnen Sie BE-terna Support Info und die BE-terna-Lizenzaktualisierung, wenn Support oder Lizenzpflege erforderlich sind.

Voraussetzungen

• Die gemeinsame Einrichtung und mindestens eine Zustellereinrichtung sind bereits gepflegt.
• Der Benutzer darf Einrichtungsdaten, URLs und Konfigurationspakete ändern.
• Produktive und Test-Zugangsdaten oder URLs liegen vom jeweiligen Zusteller vor.
• Kundennummer, Ident und weitere Support-Metadaten sind verfügbar, wenn Lizenz- oder Supportaktionen notwendig sind.

Tätigkeiten

Versandetiketten-URLs für Produktiv- und Testbetrieb pflegen

Versandetiketten-URLs definieren, welcher Zusteller-Endpunkt von der jeweiligen Einrichtung aufgerufen wird. Pflegen Sie Test- und Produktivzugang getrennt und ordnen Sie den passenden Eintrag der Zustellereinrichtung zu.

Jeder URL-Eintrag sollte als gesteuerte technische Stammdatenpflege behandelt werden:

• vergeben Sie einen klaren Code für den URL-Eintrag
• pflegen Sie exakt den vom Zusteller gelieferten Endpunkt
• halten Sie Produktiv- und Test-Endpunkte getrennt
• entfernen Sie veraltete oder doppelte URLs, sobald der Rollout stabilisiert ist

Eine URL-Änderung ist technisch klein, hat aber große operative Wirkung. Testen Sie deshalb nach jeder relevanten Änderung sofort eine Labelanfrage.

Konfigurationspakete für wiederverwendbare Einrichtung nutzen

Die erste Versandetiketteinrichtung sollte manuell erfolgen, damit die fachlichen Zusammenhänge verstanden und geprüft werden. Danach können Konfigurationspakete genutzt werden, um die gemeinsame Einrichtung und zustellerspezifische Einrichtungspakete zu exportieren und zu importieren.

Die gemeinsamen Einrichtungspakete decken in der Regel Bereiche wie Zusteller, Zustellertransportarten, zugeordnete Herkunftsarten, Zustellertransportarteneinrichtungen, Versandetiketteinrichtung, Versandetikett-URLs und zugeordnete interne Handelsklauseln ab. Zustellerspezifische Pakete ergänzen anschließend diese gemeinsame Basis.

Das ist besonders hilfreich, wenn Sie:

• eine validierte Basiskonfiguration in eine andere Gesellschaft übernehmen möchten
• eine getestete Einrichtung aus einer unproduktiven Umgebung in eine produktive Umgebung überführen möchten
• Zustellereinrichtungen vergleichen oder auf einen bekannten guten Stand zurücksetzen möchten

In der Praxis umfasst diese gemeinsame Basiskonfiguration typischerweise folgende Einrichtungsbereiche:

• Zusteller
• Zustellertransportarten
• zugeordnete Herkunftsarten
• Zustellertransportarteneinrichtungen
• Versandetiketteinrichtung
• Versandetikett-URLs
• zugeordnete interne Handelsklauseln

Zustellerspezifische Pakete ergänzen diese Basiskonfiguration um Eigenschaften, Zugangsdaten und Codes des jeweiligen Zustellers. Sobald die erste Einrichtung validiert ist, exportieren Sie die gemeinsame Basis zusammen mit dem passenden Zustellerpaket zur Wiederverwendung.

Beispiel für gemeinsame und zustellerspezifische Konfigurationspakete in Shipping Labels:

Zum Vergrößern anklicken

Requestprotokolle prüfen und Anfragedetails nachverfolgen

Das Requestprotokoll ist der wichtigste operative Einstiegspunkt für die Diagnose. Es protokolliert erfolgreiche und fehlgeschlagene Anfragen und stellt die technischen Details bereit, die bei unerwartetem Verhalten benötigt werden.

Zu den wichtigsten Protokollinformationen gehören:

• Eintragsnummer und Zeitstempel der Anfrage
• Herkunftsart, Benutzer und Versandetikettentyp
• Fehlerkennzeichen, Fehlertext und HTTP-Status
• URL, HTTP-Methode, Request-Payload und Response-Payload

Für das tägliche Troubleshooting empfiehlt sich diese Reihenfolge bei der Auswertung der Protokollfelder:

Nutzen Sie diese Abfolge für die Diagnose:

• Wenn die Anfrage den Zusteller nie erreicht hat, beginnen Sie mit URL, Zugangsdaten, Internetverbindung und lokalem Fehlertext.
• Wenn der Zusteller die Anfrage abgelehnt hat, lesen Sie zuerst Antwort und HTTP-Status und vergleichen Sie danach die Request-Payload mit den erwarteten Quelldaten.
• Wenn bereits ein Label existiert, wechseln Sie anschließend in Zugeordnete Versandetiketten, um Datei, Tracking-ID und Retourentracking-ID zu prüfen.

Von der ausgewählten Anfrage aus können Sie außerdem die zugehörigen Detailseiten öffnen:

• Requestparameter für die Header-Informationen der Anfrage
• Zugeordnete Versandetiketten für Datei, Tracking-ID, Retourentracking-ID und Dateiendung bei erfolgreicher Anfrage

Globale Standardwerte und Aufbewahrung pflegen

Die Seite Versandetiketteinrichtung enthält globale Standardwerte. Änderungen können sich auf mehrere Zustellereinrichtungen auswirken.

• Testmodus wird beim Ändern auf vorhandene Zustellereinrichtungen übertragen. Prüfen Sie danach, ob Test- beziehungsweise Produktivzugang und URL zusammenpassen.
• Vorgabe Telefonnr. dient als Rückfallwert, wenn aus den verwendeten Absender- oder Empfängerdaten keine Telefonnummer ermittelt werden kann.
• Standardland und Standard-Empfängerland werden nur von den Herkunftsarten verwendet, die diese Rückfallwerte unterstützen.
• Sonderzeichen konvertieren normalisiert Zeichen in den für die Anfrage vorbereiteten Daten; Stammdatensätze werden dadurch nicht geändert.
• Richten Sie die Aufbewahrung der Requestprotokolle über Assistent zur Einrichtung der Aufbewahrungsrichtlinie beziehungsweise Aufbewahrungsrichtlinie für Anforderungsprotokoll ein.

Prüfen Sie nach Änderungen am Testmodus die jeweiligen Zustellereinrichtungen, bevor Sie den Versand fortsetzen.

Support- und Lizenzinformationen verfügbar halten

Für Eskalationen fasst die Funktion BE-terna Support Info Kunden- und App-Metadaten wie Kundennummer, Ident, Business-Central-Version, Umgebungstyp, Publisher, App-Name und App-Version zusammen. So kann das Support-Team die betroffene Installation schneller identifizieren.

Wenn die BE-terna-Lizenz aktualisiert werden muss, erfolgt die Aktualisierung mit Kundennummer, Kunden-Ident und der Aktion Update from Web Service. Stellen Sie sicher, dass Allow HttpClient Requests aktiviert bleibt, sonst kann die Aktualisierung nicht abgeschlossen werden.

Für eine kontrollierte Lizenzaktualisierung empfiehlt sich diese Reihenfolge:

1. Öffnen Sie die Seite für die BE-terna-Lizenz.
2. Tragen Sie Customer No. und Customer Ident aus den gepflegten BE-terna-Kundendaten ein.
3. Führen Sie Update from Web Service aus.
4. Prüfen Sie das Ergebnis, bevor die aktuelle Lizenzperiode endet.

Wenn die Aktualisierung fehlschlägt, prüfen Sie zuerst Internetverbindung, gepflegte Kundendaten und die Erweiterungseinstellung Allow HttpClient Requests. Eine deaktivierte HTTP-Ausgangskommunikation blockiert den Erneuerungsprozess auch dann, wenn die fachlichen Daten korrekt sind.

Die Lizenzseite zeigt die beiden benötigten Kundenfelder und die Aktualisierungsaktion klar an:

Zum Vergrößern anklicken

Halten Sie die Erweiterungseinstellung für ausgehende Requests während der Aktualisierung aktiviert:

Zum Vergrößern anklicken

Felder und Aktionen

Überwachung und Troubleshooting

• Beginnen Sie mit Fehlertext, Antwort und HTTP-Status im Requestprotokoll. So erkennen Sie, ob es sich um ein Verbindungsproblem, eine abgelehnte Anfrage oder eine unvollständige Einrichtung handelt.
• Nutzen Sie Requestparameter und die Request-Payload, um zu prüfen, welche Quelldaten tatsächlich an den Zusteller gesendet wurden.
• Wenn Anfragen wiederholt fehlschlagen, prüfen Sie URLs, Zugangsdaten, zugeordnete Herkunftsarten, zugeordnete Incoterms und die verpflichtenden Stammdaten auf Firmen-, Kunden-, Lagerort- oder Belegebene.
• Bewahren Sie genügend Anfragehistorie auf, um wiederkehrende Vorfälle analysieren zu können. Löschen Sie nur wirklich alte Protokolle.

Best Practices

• Trennen Sie produktive und Test-URLs sauber und validieren Sie jede URL-Änderung mit einer echten Labelanfrage.
• Erstellen Sie die erste Einrichtung manuell und nutzen Sie Konfigurationspakete erst, wenn die Basiskonfiguration nachweislich funktioniert.
• Bewahren Sie Requestprotokolle lange genug auf, um wiederkehrendes Troubleshooting und Go-Live-Stabilisierung zu unterstützen.
• Aktivieren Sie den globalen Testmodus nur bewusst und setzen Sie ihn nach der Testphase wieder zurück.
• Halten Sie Support-Metadaten und Lizenzinformationen aktuell, damit Eskalationen nicht erst mit Datensammlung beginnen.