Fashion Shipping Label Connector
Zweck
Der BE-terna Fashion Shipping Label Connector ermöglicht die Erstellung von Versandlabels für DHL und DPD direkt aus einer Fashion-Paketkopfzeile in Business Central. Das erzeugte Label wird automatisch als Anhang am Paketkopf gespeichert; ein manuelles Herunter- oder Hochladen ist nicht notwendig.
Voraussetzungen
Die folgenden Mindestversionen ergeben sich aus der App-Konfiguration:
| Komponente | Mindestversion |
|---|---|
| Microsoft Dynamics 365 Business Central – Plattform | 28.0.0.0 |
| Microsoft Dynamics 365 Business Central – Anwendung | 28.4.0.0 |
| BE-terna Fashion | 28.4.0.0 |
| BE-terna Shipping Labels | 28.0.0.0 |
Installieren Sie BE-terna Fashion und BE-terna Shipping Labels vor dem Connector. Benutzer, die Versandlabels erstellen, benötigen das Berechtigungsset EDIT; für die Einrichtung ist ADMIN vorgesehen.
Empfohlene Reihenfolge
- Installieren Sie die vorausgesetzten Apps in der angegebenen Reihenfolge und danach den Fashion Shipping Label Connector.
- Richten Sie die gemeinsame Shipping-Labels-Konfiguration sowie DHL oder DPD ein.
- Konfigurieren Sie unter Label Document Storage Setup für jede verwendete Quelltabelle den Speichertyp.
- Setzen Sie auf Shipping Label Setup den Save Label Type auf Dokumentenanhang.
- Genehmigen Sie vor dem ersten externen Upload die Privacy Notice. Prüfen Sie für internationale DHL-Sendungen außerdem die Zolldaten der Artikel.
- Migrieren Sie historische Fashion-Dokumente bei Bedarf mit dem separaten Migrationsassistenten, nachdem der Zielspeicher eingerichtet ist.
Einrichtungsbausteine
Speicherort für Labels einrichten
Öffnen Sie den Etikettendokumentspeicher über Shipping Label Setup – Navigieren oder über die Gruppe BE-terna Fashion to Shipping Label einrichten auf der Seite Unterstützte Einrichtung. Verwenden Sie den Einrichtungsassistenten, um den Speicherort je Quelltabelle festzulegen:
- Datenbank speichert den Dateiinhalt in Business Central als Dokumentenanhang.
- File Account lädt den Dateiinhalt in das für das File Scenario konfigurierte externe Dateikonto hoch. Die Anhangsmetadaten bleiben in Business Central.
Beide Varianten sind in der Dokumentenanhänge-Infobox sichtbar. Vor dem ersten Upload in ein externes File Account muss die Privacy Notice des Connectors genehmigt sein; ohne Genehmigung wird der Upload abgebrochen. Die Datenbankspeicherung ist davon nicht betroffen.
Save Label Type aktivieren
Setzen Sie auf Shipping Label Setup das Feld Save Label Type auf Dokumentenanhang. Damit wird die Speicherlogik des Connectors aktiviert. Die Dokumente werden entsprechend der Konfiguration je Quelltabelle im Etikettendokumentspeicher gespeichert.
DHL, DPD und Zolldaten
Die trägerspezifische Einrichtung erfolgt in DHL Shipping Setup und DPD Shipping Setup. Bei internationalen DHL-Sendungen überträgt der Connector Zolldaten aus den Fashion-Paketzeilen. Pflegen Sie dafür auf den Artikeln die Zolltarifnummer und das Ursprungsland/-region. Eine fehlende Zolltarifnummer verhindert die Label-Erstellung.
Historische Fashion-Dokumente migrieren
Der Einrichtungsassistent konfiguriert den Speicherort, migriert aber keine vorhandenen Dokumente. Verwenden Sie nach der Speichereinrichtung bei Bedarf den separaten Assistenten Etikettendokumentspeicher-Migration. Prüfen Sie dort jede Quelltabelle-/Anhangstyp-Kombination sorgfältig: Ein zugeordneter Anhangstyp zeigt nur an, dass passende Dokumente vorhanden sein können; er garantiert nicht, dass jedes Dokument ein Label, Retourenlabel oder Exportdokument ist.
Mit Alte Dokumente behalten bleiben die Fashion-Quelldokumente nach erfolgreicher Migration erhalten. Wenn die Option deaktiviert ist, werden erfolgreich migrierte Quelldokumente dauerhaft gelöscht.
Versandlabel erstellen
- Öffnen Sie die Fashion-Paketkopfzeile für das zu versendende Paket.
- Wählen Sie in der Aktionsleiste Versandlabel erstellen.
- Business Central kontaktiert den ausgewählten Träger, DHL oder DPD, und ruft das Label ab.
- Das Label wird automatisch als Anhang am Datensatz gespeichert.
Hinweis: Liefert der Träger zusätzlich ein Retourenlabel oder ein Exportdokument zurück, wird jedes Dokument als separater Anhang am selben Datensatz gespeichert.
Wo werden Labels gespeichert?
Labels werden als Microsoft Dokumentenanhänge am Quelldatensatz gespeichert. Sie können sie über die Dokumentenanhänge-Infobox direkt auf der Paketkopf- oder Paketarchivseite öffnen.
Wenn für die Quelltabelle File Account konfiguriert ist, bleiben die Anhangsmetadaten in Business Central gespeichert, während der Dokumentinhalt im konfigurierten externen Dateikonto liegt. Vor dem ersten externen Upload muss die Privacy Notice des Connectors genehmigt werden.
Gespeicherte Dokumente folgen diesem Benennungsschema:
| Dokument | Dateiname |
|---|---|
| Versandlabel | {TrackingID}.{Dateiendung} |
| Retourenlabel | {TrackingID}_R.{Dateiendung} |
| Exportdokument | {TrackingID}_D.{Dateiendung} |
Häufige Fehlermeldungen
„Zolltarifnummer auf Artikel muss gefüllt sein“
Bedeutung: Einer oder mehrere Artikel in diesem Paket haben keine Zolltarifnummer (HS-Code) im Artikelstamm eingetragen.
Was tun: Bitten Sie Ihren Administrator, die Zolltarifnummer für die betroffenen Artikel im Artikelstamm zu pflegen.
„Export Description is required when Export Type is OTHER“
Bedeutung: Die DHL-Konfiguration benötigt eine Exportbeschreibung, die noch nicht eingetragen wurde.
Was tun: Bitten Sie Ihren Administrator, Export Description im DHL Shipping Setup auszufüllen.
„Die Datenschutzerklärung für den externen Dateispeicher muss genehmigt werden, bevor Etiketten hochgeladen werden können“
Bedeutung: Für die Quelltabelle ist ein externes File Account eingestellt, aber die Privacy Notice des Connectors wurde noch nicht genehmigt.
Was tun: Bitten Sie einen Administrator, die Seite Privacy Notices zu öffnen, den Hinweis für das BE-terna Fashion Shipping Labels File Account zu prüfen und zu genehmigen. Erstellen Sie das Label anschließend erneut.
„Quellbeleg … wird für die DPD-Zollanmeldung nicht unterstützt“
Bedeutung: Eine DPD-Paketzeile verwendet einen Quelldokumenttyp, den der Connector für Zollwerte nicht unterstützt.
Was tun: Verwenden Sie einen unterstützten Quelldokumenttyp oder stimmen Sie das weitere Vorgehen vor dem erneuten Versand mit Ihrem Consultant ab.
Dokumentenanhänge auf der Paketkopf- oder Paketarchivseite nicht sichtbar
Ursache: Die Dokumentenanhänge-Infobox ist möglicherweise auf der Seite ausgeblendet.
Was tun: Öffnen Sie Personalisieren und blenden Sie die Infobox Dokumentanhangliste ein.
Aufbewahrung und Bereinigung
Der Connector entfernt nur die von ihm erstellten Dokumentenanhänge, wenn der zugehörige Eintrag im BET SAL Request Log gelöscht wird. Bei File Account wird dabei auch die externe Datei entfernt; manuell hinzugefügte Anhänge bleiben bestehen. Das Löschen der Fashion-Paketkopfzeile löscht den Request-Log-Eintrag und die dazugehörigen Labels nicht. Richten Sie bei Bedarf die Aufbewahrungsrichtlinie für das Requestprotokoll ein.
Links