1. Einführung
Dieses Kapitel gibt einen Überblick über das Dokument und führt dich in das ShipIT-Add-on für Microsoft Dynamics NAV ein.
1.1 Über ShipIT
ShipIT ist ein Add-on für Microsoft Dynamics NAV, das eine einfache Lösung bietet, um mit Carriern weltweit umzugehen. Für deine Transportaufträge kannst du Carrier wie DHL, UPS, FEDEX, TNT, PostNL – um nur einige zu nennen – auswählen. Jeder von ihnen hat sein eigenes Interface, seine eigene Art der Etikettierung, Informationsbereitstellung und Benachrichtigung, was schwer zu verwalten ist. Deshalb hat idyn ShipIT entwickelt – die einfache Möglichkeit, deine internationalen Transportaufträge direkt aus deinem Microsoft Dynamics NAV heraus zu verwalten.
Ganz gleich, ob du nur mit einem Verkaufsauftrag oder mit Warenausgangslieferungen arbeitest, ein einziger Klick bringt dich zu ShipIT. Optional kannst du deinen bevorzugten Carrier auswählen oder die Tarife und Lieferzeiten durchsuchen. Sobald dein transport order bereit ist, klick einfach auf „Book & Print“, um den Versand auszulösen. Das Einzige, was du tun musst, ist, das Label auf den Karton zu kleben. Track-&-Trace-Links und Statusaktualisierungen erscheinen automatisch in Microsoft Dynamics NAV.
ShipIT wurde zusammen mit unserem Partner Transsmart, dem führenden Anbieter von Logistikdaten, entwickelt; sie konzentrieren sich auf die Optimierung der Kommunikation zwischen Carriern und ERP-Systemen. Transsmart arbeitet mit Hunderten von Carrier-Interfaces und bietet idyn eine nahtlose Möglichkeit, innerhalb von Microsoft Dynamics NAV zu arbeiten. Dies macht den Wechsel zwischen Carriern oder das Hinzufügen neuer Carrier sehr einfach.
Die Funktionalität des Add-ons umfasst die folgenden Hauptfunktionen:
- Carrier-Konnektivität mit nahezu jedem Carrier weltweit
- Auswahl des Carriers basierend auf den besten Tarifen und/oder Lieferzeiten
- Echtzeitverbindung über Web Services
- Etikettendruck direkt aus Microsoft Dynamics NAV
- Druck auf jedem Drucker innerhalb Ihrer Organisation
- Individuell angepasste E-Mail-Benachrichtigungen
- Echtzeit-Statusinformationen zu Sendungen
- Echtzeit-Track-&-Trace-Informationen innerhalb von Microsoft Dynamics NAV
- Freight-Audit-Services
- BI-Reporting
- Umfangreiche Service Level Agreements
- Anbieten von Abholstationen abhängig vom Standort des Kunden
- Versandkosten basierend auf dem Inhalt des Warenkorbs
- Track-&-Trace-Informationen direkt für Kunden verfügbar
- Verwendung von Track-&-Trace- und anderen Sendungsinformationen in Benachrichtigungen
1.2 Über dieses Dokument
Dieses Dokument ist ein Benutzerhandbuch mit einer Anleitung zur Einrichtung des ShipIT -Add-ons für Microsoft Dynamics NAV. Es enthält spezifische Anweisungen zur Konfiguration des Add-ons. Die Anleitung umfasst außerdem das Installationsverfahren.
2. Was ist neu in Version 4.0
Hauptthemen
- Verwendung von API V2 anstelle von API V1.
Bitte beachten Sie, dass API V1 nicht mehr unterstützt wird.
2. Factbox mit Transport Order-Informationen zu allen Quelldokumenten.
3. Verbesserte Carrier Select, um mögliche/unmögliche Carrier/Service Level-Kombinationen, Daten und Preise anzuzeigen.
4. Integration von Handbuch und Online Help direkt aus der Anwendung.
5. Item Type aktivieren, sodass Positionen vom Typ SERVICE nicht in den Transport Order aufgenommen werden.
6. Verbesserte Fehlerdarstellung.
7. Debug-Mechanismus zum Produkt hinzugefügt, sodass es möglich wird, alle Request-/Response-Nachrichten zu protokollieren.
8. Befüllung des Feldes Origin, damit Transsmart erkennen kann, welche NAV/SI-Version für das Erstellen eines Transport Order verantwortlich ist.
9. Zusätzliche Felder (Route ID, Driver ID) zum Transport Order hinzugefügt.
10. Zugriff von Transport Order auf die Transsmart Portal-Übersicht, nicht nur auf die Shipment selbst.
11. Verbesserte Verarbeitung von Transportaufträgen im Fehlerfall, zum Beispiel die Möglichkeit, einen bestehenden
Transport Order nach Behebung des Fehlers erneut zu buchen.
Die üblichen Wartungsarbeiten
- Implementierung aller bestehenden Hotfixes aus allen SI3.X.X-Versionen
- Mehrere kleinere Korrekturen (falsche oder fehlende Beschriftungen usw.)
Dokumentation
- Neues Handbuch zum Produkt hinzugefügt. Ebenfalls aus dem NAV Add-on heraus verfügbar.
- Du siehst es dir gerade an! :) Feedback ist willkommen!
3. Wie man auf ShipIT V4 aktualisiert
Aktualisiere das ShipIT NAV Add-on von 3.00 auf 4.00:
- Aktualisiere die Anwendung
- Aktualisiere deine Transsmart Service-URLs https://xyz.api.transwise.eu auf https://acceptapi.transsmart.com or https://api.transsmart.com für die Produktionsumgebung.
- Gib deine Zugangsdaten ein
- Aktualisiere die Stammdaten über das Menü – dadurch werden alle (neuen) Stammdaten von Transsmart abgerufen.
- Prüfe/aktualisiere das Mapping der NAV Daten auf die neuen Transsmart Stammdaten.
Etikettendruck
- Deinstalliere dein aktuelles QZ Print Utility.
- Installiere das neueste Smart Print Utility gemäß dem folgenden Handbuch: Installing the SmartPrint Client
- Konfiguriere deine Druckerpfade und -namen im MyTranssmart-Portal mit deinen E-Mail- und Passwort-Zugangsdaten.
4. Installation und Einrichtung
In diesem Kapitel findest du Anleitungen zur Installation und Einrichtung des ShipIT Add-ons.
4.1 Installation
Bevor mit der ShipIT Einrichtung in einer Microsoft Dynamics NAV-Umgebung begonnen wird, sollte ein Transsmart Konto beschafft werden, um mit den Transsmart Webservices für die Transport order-Verarbeitung zu kommunizieren. Weitere Informationen unter www.nshift.com oder über unseren Support über diesen Link. Außerdem müssen die ShipIT Module in Ihrer Microsoft Dynamics NAV-Lizenz verfügbar sein.
4.1.1 Komponenten installieren
Kopieren Sie die benötigten ddl-Dateien in den Ordner \Add-ins\TranssmartV2\ innerhalb des NAV Service-Ordners auf dem/den NAV Service Tier-Server(n). Wenn Sie mehrere Service Tiers ausführen, müssen Sie diese Aufgabe für alle Service Tiers wiederholen.
Abbildung 2-1: ShipIT- und Transsmart-Installationskomponenten
Diese Komponenten werden zusammen mit den Objekten ausgeliefert.
4.1.2 NAV-Objekte importieren oder mergen
Verwenden Sie die FOB-Datei, die Ihrer NAV Zielversion entspricht, und importieren oder mergen Sie die Objekte, falls zutreffend.
Abbildung 2-2: NAV-Zielversion identifizieren
Abbildung 2-3: NAV-Objekte importieren oder zusammenführen
Kompilieren Sie alle Objekte sowie alle MenuSuite-Objekte neu und starten Sie den Dynamics NAV-Client neu.
4.2 Upgrade älterer Versionen
Wenn Sie eine ältere Version von ShipIT aktualisieren, ist es wichtig, zunächst die alten Komponenten zu entfernen. Suchen Sie bitte die folgenden Dateien im NAV-Service-Ordner und löschen Sie sie. Sie finden diese Dateien möglicherweise unter: C:\Program Files\Microsoft Dynamics NAV\90\Service oder C:\Program Files\Microsoft DynamicsNAV\100\Service.
4.3 Einrichtung
Das Einrichtungsmenü des ShipIT-Add-ons enthält zahlreiche Bereiche, die sehr flexible Konfigurationsmöglichkeiten sowohl innerhalb von Microsoft Dynamics NAV als auch mit Transsmart bieten. Dieses Kapitel beschreibt die allgemeine ShipIT-Einrichtung, die Benutzereinrichtung sowie die Einrichtung von Zuordnungen für den Spediteur, die Versandart, die Währung und das Land bzw. die Region. Dieses Kapitel beschreibt außerdem Transsmart-spezifische settings, die von der ShipIT-Applikation verwendet werden.
4.3.1. Administration Setup
Um auf die Administration Setup zuzugreifen, wechseln Sie in Microsoft Dynamics NAV zu Departments > ShipIT > Setup. Das Einrichtungsmenü listet die folgenden Elemente auf:
Abbildung 2-4: ShipIT Setup-Menüelemente
4.3.2 ShipIT Benutzereinrichtung
Wähle ShipIT User Setup und gib alle relevanten Dynamics NAV-Benutzer und deren jeweilige Transsmart Anmeldedaten ein.
Abbildung 2-5: ShipIT Benutzereinrichtung
Alle Benutzer können entweder ihr eigenes persönliches Konto haben oder dasselbe Transsmart Konto unternehmensweit gemeinsam nutzen, abhängig von der Vielfalt der benutzerspezifischen Drucker-settings.
4.3.3 ShipIT Einrichtung
Wähle in Departments > ShipIT > Setup den Punkt ShipIT Setup und fülle alle erforderlichen Felder aus.
Abbildung 2-6: ShipIT Einrichtung
Die Tabelle ShipIT Setup Fields Description unten listet alle verfügbaren Felder, Wertoptionen und description der Verwendung für die Seite ShipIT Setup auf.
Tabelle 2-1: ShipIT Setup Fields Description
4.3.4 Transsmart Stammdaten aktualisieren
Beginnen Sie in ShipIT Setup mit der Eingabe der API Base URL (in diesem Beispiel eine Test-URL).
Abbildung 2-7: ShipIT Setup General FastTab Transsmart URLs
Klicken Sie auf Update Master Data , um eine Verbindung zu den Transsmart Webdiensten herzustellen und alle verfügbaren Transsmart Stammdaten herunterzuladen:
Abbildung 2-8: ShipIT Setup Transsmart Master Data
Im folgenden Beispiel wurden zwei verfügbare Carrier ID’s heruntergeladen. In den nächsten Schritten müssen diese IDs Ihren Microsoft Dynamics NAV Shipping Agents, Shipment Methods, Currencies und Country/Region Codes zugeordnet werden. In ShipIT > Setup > Transsmart Master Data klicken Sie auf Carriers.
Abbildung 2-9: ShipIT Einrichtung Transsmart Stammdaten, Frachtführer
Wähle eine Zeile aus und klicke auf Carrier Profiles, um Details zu bestimmten Versandarten anzuzeigen, die von diesem Versanddienstleister angeboten werden, und welche Methoden mit deinem Dynamics NAV „gemappt“ sind.
Abbildung 2-10: ShipIT Einrichtung Transsmart Stammdaten, Carrier Profiles
Ein weiteres Beispiel unten zeigt die Liste der Shipment Method*s, referred as *Incoterms, die von Transsmart verfügbar sind:
Abbildung 2-11: ShipIT Einrichtung Transsmart Stammdaten, Incoterms
Im nächsten Schritt werden die heruntergeladenen Codes mit deinen Dynamics NAV-Codes „gemappt“.
4.3.5 Zuordnung von Dynamics NAV-Codes zu Transsmart Codes
Unter Departments > ShipIT > Setup > Administration werden die von Transsmart heruntergeladenen Codes anhand des untenstehenden Beispiels deinen Dynamics NAV-Codes „gemappt“. Mindestens ein Dynamics NAV-Code muss für alle aufgeführten Themen einem Transsmart Code zugeordnet („gemappt“) werden:
- Shipping Agent-Zuordnungen
- Versandart-Zuordnungen
- Währungszuordnungen
- Country/Region-Zuordnungen
4.3.6 Shipping Agent Service-Zuordnungen
Gehe zu Shipping Agent-Zuordnungen und wähle eine Zeile aus:
Abbildung 2-12: ShipIT-Einrichtung, Shipping Agent-Zuordnungen
Klicke auf Shipping Agent Service-Zuordnungen und gib die Werte ein, die Shipping Agent Service Code, Description und Transsmart -Code beschreiben, die sich auf deine Auswahl beziehen.
Abbildung 2-13: ShipIT-Einrichtung, Shipping Agent Service-Zuordnungen
Im Beispiel wurde der Dynamics NAVShipping Agent-Code DHL auf Transsmart Carrier ID 5 mit einem Servicelevel 1DAY „gemappt“.
4.3.7 Einrichtung überprüfen
Um die ShipIT -Einrichtung zu überprüfen, gehe zu Departments > ShipIT > Setup > ShipIT Setup. Klicke auf der Seite ShipIT Setup auf Verify Setup und überprüfe deine Einrichtung über die Seite Setup Verification Result:
Abbildung 2-14: ShipIT-Einrichtung überprüfen, Ergebnis
Überprüfen Sie, ob alle erforderlichen Felder und Tabellen korrekt konfiguriert wurden. Kehren Sie zurück, um das Mapping oder die Datensynchronisation abzuschließen, und führen Sie die Einrichtungsüberprüfung erneut aus, um den erfolgreichen Abschluss der Einrichtung sicherzustellen. Ziehen Sie die Tabelle im Kapitel ShipIT Setup heran, um die Einrichtung aller anderen erforderlichen Werte abzuschließen, und settings, um zu konfigurieren, wie sich ShipIT in Ihrer Dynamics NAV -Anwendung verhalten wird.
5. Ausführen der Funktionalität
Dieses Kapitel bietet einen Überblick über die im ShipIT Add-on innerhalb von Microsoft Dynamics NAV verfügbare Funktionalität sowie einige gängige Anwendungsfälle.
5.1 Transport Order testen
Nachdem die Einrichtung des ShipIT Add-ons abgeschlossen ist, können Sie Ihre Anwendung testen und mit der Erstellung von Transportaufträgen beginnen. Gehen Sie dazu beispielsweise zu Sales Orders, klicken Sie auf New und erstellen Sie einen normalen Sales Order.
Abbildung 3-1: Verwendung von ShipIT, Erstellung eines Sales Order
Bitte stelle sicher, dass du die Werte auswählst, die in den Feldern Shipment Method, Shipping Agent und Agent Service auf Transsmart Werte „gemappt“ sind, da sonst kein Transport Order auf Basis dieses Sales Order erstellt wird. Gib anschließend die Artikelzeilen in deinem Sales Order ein und klicke auf Create Transport Order auf der Registerkarte Actions im Menüband. Wenn ein Transport Order erstellt wurde, siehst du diesen Dialog, der es dir ermöglicht, direkt zum Transport Order zu wechseln.
Abbildung 3-2: Verwendung von ShipIT, Benachrichtigung bei erfolgreich erstelltem Transport Order
Klicke auf Yes und sieh dir den resultierenden Transport Order an:
Abbildung 3-3: Verwendung von ShipIT, resultierender Transport Order
Die Factbox mit Transsmart Details zeigt Codes an, die sich auf den ausgewählten Shipping Agent, Shipment Method und Shipment Service beziehen. Bitte gehe zurück zum gebuchten Sales Order und beachte, dass die Transport Order Details Factbox mit den verfügbaren Logistikinformationen gefüllt wurde:
Abbildung 3-4: Verwendung von ShipIT, Transport Order Infobox im Verkaufsauftrag
Die Transport Order ist bereit, gebucht und gedruckt zu werden!
5.2 Transportaufträge
Um die Liste Transport Orders zu öffnen, gehe zu Departments > ShipIT > Order Processing > Lists und klicke auf Transport Orders:
Abbildung 3-5: Verwendung von ShipIT, Liste Transport Orders
Die Liste der Aktionen, die für die Transport Orders verfügbar sind, ist im folgenden Bild dargestellt:
Abbildung 3-6: Verwendung von ShipIT, Aktionsliste Transport Orders
Wähle eine beliebige Transport Order-Zeile in der Liste aus und klicke auf View oder Edit, um die Transport Order Card zu öffnen.
Abbildung 3-7: Verwendung von ShipIT, Transport Order Card, Aktionsliste
Die Felder auf der Transport Order-Karte sind selbsterklärend. Es ist erwähnenswert, dass der Additional References FastTab in der NAV Datenbank nicht vorhanden ist und dazu dient, nützliche Informationen zu speichern, zum Beispiel Driver ID oder Route ID. Transsmart wird einige Werte in diesem Feld verwenden, um genauere Kostenberechnungen und eine bessere Logistik zu ermöglichen. Die Liste der auf der Transport Order Card verfügbaren Aktionen ist der Transport Orders List sehr ähnlich und ist im Bild unten dargestellt:
Abbildung 3-8: Verwendung von ShipIT, Transport Orders Actions List
Um die möglichen und verfügbaren Kombinationen von Shipping Agent, Shipment Method und Shipment Service automatisch zu berechnen, klicke auf Carrier Select im Menüband.
Abbildung 3-9: Verwendung von ShipIT, Carrier Select List
Die passenden Zeilen werden mit grüner Farbe markiert, während die fehlerhaften Kombinationen in Rot markiert werden. Die Verarbeitung von Transport Order wird durch eine benutzerfreundliche Fehlerbehandlung unterstützt. Wenn du vergessen hast, einen Shipping Agent hinzuzufügen und auf Book geklickt hast, kannst du zurückgehen, den Fehler beheben und die Transport Order erneut buchen.
Abbildung 3-10: Verwendung von ShipIT, Buchen von Transport Order mit Fehlern
Im obigen Beispiel wird im Fehler deutlich angegeben, dass ein Shipping Agent Code einen Wert haben muss, was die Ursachensuche für eine fehlgeschlagene Verarbeitung erheblich vereinfacht. Da es in Dynamics NAV keine Berichte mit ShipIT Informationen gibt, ist es mit dem Add-on möglich, eine Liste von Berichten pro Transport Order zu erstellen. Um die Liste der Berichte zu erstellen, klicke auf Reports auf der Registerkarte Transsmart im Menüband.
Diese Berichte werden zu einem bestimmten Zeitpunkt während der Bearbeitung eines Transport Order verwendet (gedruckt) (zum Beispiel vor oder nach dem Buchen). Der NAV Partner und der Endkunde sollten entscheiden, zu welchem Zeitpunkt die Berichte gedruckt werden. Außerdem müssen sie entscheiden, ob einem Transport Order automatisch ein Standardsatz von Berichten zugeordnet werden soll.
5.3 Transport Worksheet
Gehe zu Departments > ShipIT > Order Processing > Tasks und klicke auf Transport Worksheet. Verwende den Filter, um die Quelldokumente zu ermitteln (zum Beispiel nach Shipping Agent), und erstelle mehrere T*ransport Orders* aus den Quelldokumentzeilen.
Abbildung 3-11: Verwendung von ShipIT, Verarbeitung des Transport Worksheet
5.4 Archivierung von Transport Orders
Es ist manchmal notwendig, einen Transport Order zu archivieren, ohne jedoch eine tatsächliche Transportbuchung vorzunehmen. Mit ShipIT ist es möglich, einen Transport Order zu archivieren, ohne eine Buchung zu Transsmart durchzuführen. Um die archivierten Transport Orders anzuzeigen, gehe zu Departments > ShipIT > Order Processing > Archive und klicke auf Archived Transport Orders.
Abbildung 3-12: Verwendung von ShipIT, Archivierung von Transport Orders
Angehängt ist das Dokument ShipIT 4.0, ein Benutzerhandbuch mit einer Anleitung zur Einrichtung des ShipIT Add-ons für Microsoft Dynamics NAV.
Es enthält spezifische Anweisungen zur Konfiguration des Add-ons. Die Anleitung beschreibt außerdem das Installationsverfahren.