Einrichtung
Zweck
Diese Seite beschreibt die gemeinsame Einrichtungslogik von Shipping Labels in Microsoft Dynamics 365 Business Central. Bevor Sie einen konkreten Versanddienstleister konfigurieren, bereiten Sie die gemeinsamen Stammdaten vor, legen die benötigten Versandagenten und Dienste an und vervollständigen die globale Shipping-Labels-Einrichtung, damit spätere Labelanfragen auf konsistenten Daten basieren.
Voraussetzungen
- Shipping Labels ist in der Business-Central-Umgebung installiert und verfügbar.
- Die benötigten Carrier-Konten, API-Zugangsdaten, Kundennummern oder Onboarding-Daten liegen vom Versanddienstleister vor.
- Absender- und Empfängerstammdaten wie Adressen, Kontaktdaten, Telefonnummern und E-Mail-Adressen sind in der vom jeweiligen Carrier benötigten Qualität gepflegt.
- Benutzer haben Zugriff auf die Seiten für Versandagenten, Versandagentendienste, Versandagentendienst-Einrichtungen und die zentrale Shipping-Labels-Einrichtung.
Empfohlene Reihenfolge
- Klären Sie, welche Carrier, Produkte und Serviceoptionen im Geschäftsprozess benötigt werden.
- Bereiten Sie die Stammdaten für Adressen, Paketabwicklung, Gewichte, Maße und Incoterms vor.
- Legen Sie die Versandagenten und Versandagentendienste in Business Central an.
- Pflegen Sie die gemeinsame Shipping-Labels-Einrichtung einschließlich zugeordneter Belegquellen und Incoterms.
- Bauen Sie die Versandagentendienst-Matrix für die gültigen Carrier- und Servicekombinationen auf.
- Ergänzen Sie die carrierspezifischen Eigenschaften, Zugangsdaten und Tests auf den jeweiligen Carrier-Seiten.
Einrichtungsbausteine
Stammdaten vor der ersten Labelanfrage vorbereiten
Erfolgreiche Labelanfragen hängen von konsistenten Geschäftsdaten ab. In der Praxis ist nicht zuerst die Carrier-Seite entscheidend, sondern die Qualität der Absender- und Empfängerdaten, die später in die Anfrage einfließen.
Prüfen Sie vor dem produktiven Einsatz mindestens diese Bereiche:
- Absender- und Empfängeradressen
- Ansprechpartner, Telefonnummern und E-Mail-Adressen
- Paketmaße, Gewichte und Maßeinheiten
- kundenspezifische Lieferregeln und Incoterms
- interne Voreinstellungen für Lager-, Versand-, Verkaufs- oder andere Quelldokumente
Diese Vorbereitung reduziert vermeidbare Anfragefehler und macht die spätere carrierspezifische Einrichtung planbarer.
Für einen ersten produktiven Rollout sollten Sie die zugrunde liegenden Stammdaten noch gezielter prüfen:
Firmeninformationen und Absenderdaten realistisch pflegen
- Pflegen Sie reale Absenderadressen und Kontaktdaten. Mehrere Carrier prüfen die Plausibilität der absendenden Adresse, statt Platzhalterdaten zu akzeptieren.
- Prüfen Sie die Firmen- und Lagerortdatensätze, die im Geschäftsprozess tatsächlich als Absender verwendet werden. Eine korrekte Firmenkarte hilft nicht, wenn die Anfrage später mit einer abweichenden Lageradresse arbeitet.
- Wenn DSV Teil des Rollouts ist, behandeln Sie das Telefonnummernformat des Absenders als strikte Carrier-Regel und validieren Sie es vor der ersten Anfrage.
Länder- und Regionsdaten vor REST-Tests vervollständigen
- Für DHL Shipping REST benötigen die relevanten Länder gepflegte ISO-Alpha-3-Werte und ein gefülltes ISO-Code-Feld.
- Prüfen Sie genau die Länder, die im Rollout wirklich benötigt werden, einschließlich Retourenziele und grenzüberschreitender Szenarien. Unvollständige Länderzuordnungen führen dazu, dass REST-Anfragen nicht sauber verarbeitet werden.
Kunden- und Empfängerstammdaten vollständig pflegen
- Verwenden Sie auf Kunden- und Belegebene reale Empfängernamen, Adressen, Telefonnummern und E-Mail-Adressen.
- Einige Carrier validieren die Qualität der Empfängeradresse direkt und lehnen unvollständige oder unplausible Kombinationen ab.
- Prüfen Sie erneut, ob der operative Beleg tatsächlich mit den erwarteten Debitor-, Liefer- und Lagerortdaten arbeitet. Label-Fehler entstehen oft in einem anderen Quelldatensatz, als der Benutzer vermutet.
Artikelattribute vorbereiten, bevor Fallback-Paketwerte eingesetzt werden
- Shipping Labels kann mit vier logistikrelevanten Artikelattributen arbeiten: Höhe, Breite, Länge und Gewicht.
- Legen Sie diese Attribute zuerst auf der Seite für Artikelattribute an und pflegen Sie danach die Werte auf den relevanten Artikelkarten.
- Artikelbezogene Maße und Gewichte sollten die bevorzugte Datenquelle sein. Carrierspezifische Fallback-Paketwerte sind als Sicherheitsnetz nützlich, sollten aber fehlende Logistikstammdaten im Produktivbetrieb nicht verdecken.
Arbeitsdatum und Versanddatum bewusst prüfen
- Einige Carrier validieren das Arbeitsdatum oder das operative Versanddatum als Teil des Anfragekontexts.
- Prüfen Sie beide Werte vor Tests besonders dann, wenn die Umgebung mit kopierten Demodaten, älteren Belegen oder verzögerter Auftragsbearbeitung arbeitet.
Versandagenten und Versandagentendienste zentral pflegen
Shipping Labels verwendet die Standardobjekte von Business Central für Versandagenten und Versandagentendienste als gemeinsamen Einstiegspunkt für alle unterstützten Carrier. Jeder Carrier sollte daher konsistent über eine Versandagentenkarte und die relevanten Dienstekombinationen abgebildet werden, die im Tagesgeschäft verwendet werden.
Konzentrieren Sie sich bei der Pflege dieser Datensätze auf die fachliche Bedeutung jeder Kombination:
- welcher Carrier dem Benutzer zur Verfügung stehen soll
- welche Produkte oder Service-Level zu diesem Carrier gehören
- welcher interne Code in Stammdaten und Belegen konsistent verwendet werden soll
- welche Kombinationen produktiv, nur für Tests oder bereits veraltet sind
Die spätere Carrier-Einrichtung ersetzt dieses Modell nicht, sondern baut darauf auf.
Shipping-Labels-Einrichtung als gemeinsamen Steuerungspunkt nutzen
Die gemeinsame Shipping-Labels-Einrichtung definiert, welche Quelldokumente Labels anfordern können und welche allgemeinen Geschäftsregeln carrierübergreifend gelten. Hier pflegen Sie das Basisverhalten, das nicht auf jeder Carrier-Seite erneut eingerichtet werden sollte.
Prüfen Sie insbesondere diese gemeinsamen Einrichtungsbereiche:
- zugeordnete Belegquellen für die unterstützten Belegursprünge
- zugeordnete Incoterms für Export- und carrierspezifische Anforderungen
- globales Anfrageverhalten und allgemeine Voreinstellungen, soweit vorhanden
- die betriebliche Einrichtung für Anfrageanalyse und späteres Troubleshooting
Diese gemeinsame Schicht ist auch der richtige Ort, um allgemeine Regeln von wirklich carrierspezifischen Daten zu trennen. Carrier-Zugangsdaten, Produktmerkmale und providerspezifische Einschränkungen gehören auf die Carrier-Seiten, während das allgemeine Beleg- und Zuordnungsmodell hier gepflegt wird.
Zugeordnete Herkunftsarten vor dem Belegtest verstehen
Die zugeordneten Herkunftsarten definieren, welche Business-Central-Belege überhaupt Versandetiketten erzeugen dürfen und welche zusätzlichen Tabelleninformationen dabei in den Anfragekontext einfließen.
- Die Table ID legt fest, aus welcher Business-Central-Tabelle zusätzliche Informationen gelesen werden.
- Der Source Type legt fest, über welchen Belegursprung die Labelerzeugung möglich ist.
- Nach Auswahl der Table ID wird der Tabellenname automatisch gefüllt, was die Validierung der Zuordnung erleichtert.
Typische Herkunftsarten umfassen Verkaufsauftrag, Lagerausgang, gebuchten Lagerausgang, Umlagerungsauftrag, gebuchte Umlagerung, Package Header und Package Header Archive. Die ausgelieferte Einrichtung startet in der Regel mit einem kleineren Satz empfohlener Standardkombinationen. Erweitern Sie diese Zuordnungen nur dann, wenn ein Carrier oder ein Belegszenario tatsächlich zusätzliche Business-Central-Daten benötigt.
Zugeordnete Incoterms als Übersetzungsschicht verstehen
Die zugeordneten Incoterms verknüpfen die Standard-Incoterms aus Business Central mit den internen Codes, die ein bestimmter Carrier erwartet.
- Standard-Incoterms beschreiben Verantwortlichkeiten, Kostenübernahme und Risikoübergang im internationalen Handel.
- Carrier akzeptieren diese Standardcodes in der API oft nicht direkt.
- Shipping Labels muss daher den fachlichen Standardbegriff in den carrierspezifischen internen Code übersetzen.
Beispielsweise kann ein Carrier einen internen Code wie F1 verwenden, um den Standard-Incoterm FOB darzustellen. In diesem Fall muss die Zuordnung gepflegt sein, bevor Export- oder grenzüberschreitende Anfragen korrekt verarbeitet werden können. Diese Einrichtung wird besonders wichtig, sobald der Geschäftsprozess nicht mehr rein national oder innerhalb der EU bleibt.
Globale Schalter und Fallbacks bewusst einsetzen
Die gemeinsame Shipping-Labels-Einrichtung enthält außerdem globale Schalter, die carrierübergreifend wirken und deshalb nicht als harmlose Komfortfelder behandelt werden sollten.
- Ein global aktivierter Test Mode setzt die nachgelagerten Carrier-Setups effektiv in den Testbetrieb und macht die lokalen Testschalter auf den einzelnen Versandagentendienst-Einrichtungen in der Praxis nicht mehr frei steuerbar. Nutzen Sie diesen Schalter bewusst für geschlossene Testphasen und nicht parallel zu produktiven Abläufen.
- Default Country und Default Recipient Country dienen nur als Fallback, wenn auf dem operativen Beleg kein Länderwert gepflegt ist. Sobald der Beleg selbst einen Länderwert enthält, hat dieser Vorrang. Wenn weder Beleg noch Default einen verwertbaren Wert liefern, kann die Anfrage scheitern.
- Convert Special Characters ist kein kosmetischer Schalter, sondern eine technische Vorverarbeitung für Carrier, die Zeichen wie
Ä,ÖoderÜin Anfragen nicht sauber akzeptieren. Aktivieren Sie die Funktion gezielt, wenn der Carrier oder die Fehlerbilder auf dieses Problem hindeuten. - Die Log Deletion Date Formula sollte so gewählt werden, dass genügend Anfragehistorie für Troubleshooting erhalten bleibt. Löschen Sie alte Request Logs nicht so aggressiv, dass wiederkehrende Fehlerbilder oder Go-live-Probleme nicht mehr nachvollzogen werden können.
Die Versandagentendienst-Matrix bewusst aufbauen
Die Versandagentendienst-Matrix ist der operative Kern von Shipping Labels. Sie verbindet das Versandmodell in Business Central mit den carrierspezifischen Servicekombinationen, die im produktiven Einsatz tatsächlich erlaubt sind.
Stellen Sie für jede aktive Kombination sicher, dass die Einrichtung diese Fragen klar beantwortet:
- welcher Versandagent und welcher Dienstecode verwendet werden
- welches Carrier-Produkt angefragt wird
- welche Serviceoptionen oder zusätzlichen Eigenschaften gelten
- welche Zugangsdaten oder welcher Kontokontext zu der Kombination gehören
- ob die Kombination für produktive Anfragen, Tests oder einen begrenzten Anwendungsfall gedacht ist
Behandeln Sie die Matrix als gesteuerten Katalog. Wenn zu viele inkonsistente oder doppelte Kombinationen gepflegt werden, können Benutzer eine technisch mögliche, aber fachlich ungeeignete Einrichtung auswählen.
Beispiel einer gepflegten Versandagentendienst-Matrix in Business Central:
Carrierspezifische Einstellungen vervollständigen und durchgängig testen
Nachdem die gemeinsame Einrichtung steht, ergänzen Sie auf den dedizierten Carrier-Seiten die carrierspezifischen Felder, Zugangsdaten, Produktzuordnungen und optionalen Serviceeinstellungen. Testen Sie danach den vollständigen Ablauf vom Quelldokument bis zum erzeugten Label.
Verwenden Sie für jedes relevante Carrier-Szenario mindestens einen realistischen End-to-End-Test:
- Erstellen oder öffnen Sie ein unterstütztes Quelldokument.
- Wählen Sie den vorgesehenen Versandagenten und Dienst.
- Erzeugen Sie die Labelanfrage.
- Prüfen Sie das zurückgelieferte Label und die Anfragedetails.
- Korrigieren Sie fehlende Eigenschaften, Datenzuordnungen oder Zugangsdaten, bevor Sie die Einrichtung breiter ausrollen.
Process Wichtige Einrichtungsregeln Diese Prüfungen reduzieren vermeidbare Anfragenausfälle und inkonsistente Carrier-Einrichtungen.
- Bereiten Sie Adressen, Kontaktdaten, Paketdaten und Incoterms vor, bevor Sie eine Carrier-Integration testen.
- Halten Sie die gemeinsame Shipping-Labels-Einrichtung auf die allgemeine Beleglogik und Zuordnungen fokussiert, nicht auf providerspezifische Zugangsdaten.
- Pflegen Sie nur die Carrier- und Servicekombinationen, die tatsächlich für den produktiven Einsatz freigegeben sind.
- Testen Sie jedes relevante Carrier-Szenario vollständig, nachdem sowohl die gemeinsame Einrichtung als auch die carrierspezifische Seite abgeschlossen sind.
- Nutzen Sie die Anfrageanalyse bereits in der Einrichtungsphase, damit späteres Troubleshooting im Betrieb einfacher wird.
Links