mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 22:20:29 +01:00
1 line
20 KiB
Plaintext
1 line
20 KiB
Plaintext
<p><span style="font-size:28px;"><strong>Anbindung von DHL Versenden an Xentral</strong></span><br /> </p><h1>Features</h1><ul><li>Benutzer, Signature, EKP: aus DHL / Intraship Kundenportal</li><li>PartnerIDs: aus Kundenportal</li><li>Bei EU immer Welt verwenden: Bei Versand nach EU wird die Welt-Schnittstelle verwendet</li><li>Premiumversand verwenden: Premiumservice wird aktiviert</li><li>Retouren Account: Abrechnungsnummer für erstellte Retouren</li><li>Vorauswahl Retourenlabel: neben Paketlabel wird auch Retourenlabel gedruckt</li><li>Versenderinformationen: Daten des Paketversenders, werden auf Label gedruckt</li><li>Nachnahmeinformationen: Bankdaten des Zahlungsempfängers bei Zahlung per Nachnahme</li><li>Standard Gewicht: wird automatisch im Versanddialog vorausgefüllt</li><li>Gewicht runden: Gewicht wird beim Übertragen auf eine Ganzzahl gerundet, ist die Nachkommastelle des Gewichts >= 0.5 wird aufgerundet, ansonsten abgerundet</li><li>Standard Länge, Höhe, Breite: wird automatisch im Versanddialog vorausgefüllt</li><li>Standard Produkt: Produkt aus Kundenportal (z.B. in DE: V01PAK oder AT: V86PARCEL)</li><li>Vorausverfügung: Vorausverfügung des Pakets, gibt an was mit dem Paket bei Nichtzustellbarkeit passieren soll</li><li>Sperrgut: Markiert das Paket als Sperrgut, funktioniert nut mit Leitcodierung</li><li>Für Packstationen: Name ist Kundenname, Name2 ist die KundenPostIdentNr, bei Straße "Packstation" angeben und bei Hausnummer die Nummer der Packstation</li><li>Wunschzeitraum kann bei Erstellung der Paketmarke angegeben werden (18:00 - 22:00 Uhr und 19:00 - 21:00 Uhr verfügbar)</li><li>wertet die Altersfreigabe aus Artikeln aus (16 oder 18 Jahre, visueller Nachweis bei Paketübergabe erforderlich)</li><li>sendet die Trackingnummer an mögliche Shops zurück</li><li>als Versicherungssumme wird der Auftragswert übermittelt</li><li>Falls bei Packstation Name und Name2 vertauscht wurden, tauscht die Schnittstelle diese wieder um</li></ul> <h1>Einstellungen im Account</h1>Um per Intraship bzw. mit einem Account über das DHL Geschäftskundenportal verschicken zu können, müssen Sie im Portal einen zusätzlichen Account anlegen.<br /><br />Dieser kann dann in Xentral hinterlegt werden.<br /><br /><strong>Es muss ein zusätzlicher Account angelegt werden, da die Zugangsdaten des Hauptaccounts regelmäßig geändert werden müssen, und deswegen jedes Mal eine Anpassung der Schnittstellen-Konfiguration stattfinden müsste.Bitte beachten Sie, dass im Passwort des Benutzers nur ein * als Sonderzeichen verwendet werden darf.</strong><br /><br />Wichtig ist das der Benutzer alle im folgenden Screenshot angezeigten Rechte erhält:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=1" /><h2><br />Einstellungen in Xentral</h2>Xentral kann direkt Paketmarken über Versenden (alt:Intraship) anlegen und automatisch drucken. Die API Zugangsdaten müssen in der Versandart "DHL" eingetragen werden. Aufträge können auf diese Versandart gebucht und über die Logistik abgewickelt werden.<br /><br />Administration → Einstellungen → Versandarten → DHL (editieren) → Modul: "DHL Versenden" (alt:Intraship) auswählen<br /><br />Füllen Sie alle Felder (Nachnahme Felder nur bei Bedarf) vollständig aus. Ansonsten könnten Probleme beim Auslandsversand auftreten.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=2" /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=3" /><h2>Feldbezeichnungen</h2> <ul><li><strong>Bezeichnung</strong> → Frei wählbare Bezeichnung für die Versandart (wird in Xentral im Auftrag zur Auswahl angezeigt)</li><li><strong>Typ</strong> (z.B. dhl, ups, etc.) → Feldbezeichnung (idealerweise Voreinstellung beibehalten. Kann generell beliebig gewählt werden, sofern nicht für das Shop Mapping oder andere Mappings notwendig)</li><li><strong>Modul</strong> → "DHL Versenden" (alt:Intraship) oder gewünschten Paketdienstleister auswählen</li><li><strong>Projekt</strong> → optional: Projekt auswählen (optional: sofern für jedes Projekt eine eigene DHL Versandart angelegt wird)</li><li><strong>Aktiv</strong> → Nicht mehr verwendete Versandarten können deaktiviert werden → aktivieren für die Verwendung</li><li><strong>Kein Portocheck </strong>→ Es wird kein Portocheck im Auftrag durchgeführt</li><li><strong>Drucker Paketmarke </strong>→ Standarddrucker auf dem die Paketmarken gedruckt werden</li><li><strong>Drucker Export </strong>→ Standarddrucker auf dem die Exportpapiere gedruckt werden</li><li><strong>Versandmail</strong> → Standardverhalten (= Verhalten wie im Projekt eingestellt), keine Versandmail (=keine Trackingmail bei dieser Versandart), eigene Textvorlage (=für diese Versandart eine eigene Textvorlage, unabhängig vom Projekt und Logistikprozess)</li></ul> <ul><li><strong>Benutzer</strong> (geschaeftskunden_api (Versenden/Intraship-Benutzername)) → Ihr Benutzername für das DHL Geschäftskundenportal</li><li><strong>Signature</strong> (Dhl_ep_test1 (Versenden/IntrashipPasswort)) → Ihr Passwort für das DHL Geschäftskundenportal</li><li><strong>EKP</strong> gültige DHL Kundennummer (steht auf jeder Rechnung oder im Geschäftskundenportal: bitte nur die Nummer ohne "EKP" eintragen)</li><li>Partner ID Inland (meist 01, evtl. auch 02, 03 etc.) → zu finden bei Ihren gebuchten Produkten im Geschäftskundenportal (EKP + 4-stellige Kennung → hier die letzten beiden Ziffern verwenden, für DHL-AT (Österreichische DHL Portale) die letzten 4 Ziffern verwenden (falls 2-stellig eine Fehlermldung liefert)</li><li><strong>Partner ID Welt</strong> (falls leer wird die inländische Partner ID verwendet) → leer lassen, wenn identisch zu oben, alternativ die 2-stellige Kennung (oder für AT die 4-stellige). Info: hierbei ist darauf zu achten, dass beidesmal die 2-stellige oder die 4-stellige Nummer eingetragen wird. Stellenanzahl nicht mischen!</li><li><strong>Partner ID EU oder Connect</strong> → Der Versand von DE/AT in Länder Europas (Komplette EKP mit Endung 5401 in DE oder 8701 in AT)</li><li><strong>Bei EU immer Welt verwenden</strong> → Für Länder in der EU soll die Partner ID Welt verwendet werden</li><li><strong>Premiumversand verwenden</strong> → Der Premiumversand von DHL soll immer verwendet werden</li><li><strong>API User </strong>(Bitte anfragen beim Support) → bei Xentral anfragen</li><li><strong>API Passwort</strong> (Bitte anfragen beim Support) → bei Xentral anfragen</li><li><strong>Retouren Account</strong> (14 Stellige DHL-Retoure Abrechnungsnummer) → optional: nur wenn Produkt "Retuorenaccount" gebucht wurde → druckt mit jeder Paketmarke auch einen Retourenschein mit (nicht zu verwechseln mit dem extra DHL-Retourenportal, dieses wird hier nicht angesprochen)</li><li><strong>Vorauswahl Retourenlabel</strong> (Druckt Retourenlabel mit) → s.o.</li></ul> <ul><li><strong>Versender Firma - Stadt</strong>→ Ihr Firmendaten (identisch zu den Daten im DHL Portal)</li><li><strong>Versender Land (germany)</strong> → Land: für Deutschland "germany" eingeben (für AT "austria")Versender ISO Code → DE für Deutschland oder AT für Österreich</li><li><strong>Versender E-Mail / Telefon / Web</strong>→ Ihre E-Mail Adresse /Telefonnummer / Webadresse (identisch zu den Daten im DHL Portal)</li><li><strong>Versender Ansprechpartne</strong>r → ein Ansprechpartner (wird meist für Export Sendungen benötigt)</li></ul> <ul><li><strong>Nachnahme Bank Inhaber - Nachnahme BIC</strong> → Ihre Firmenbankdaten (identisch zu den Daten im DHL Portal) → meist benötigt für DHL Nachnahme</li><li><strong>Nachnahme Gebühr aktivieren </strong>→ Aktivieren der zusätzlichen nachnahme Gebühr</li><li><strong>Nachnahme Gebühr</strong> → Betrag der auf den Rechnungsbetrag draufaddiert wird, da DHL diesen als extra Gebühr für sich behält</li></ul> <ul><li><strong>Export</strong> (z.B. Computer Zubehör) → Ihre Produktbezeichnung → für Export Lieferungen</li><li><strong>Standard (in KG)</strong> → Hier das kleinstmögliche Gewicht hinterlegen, z.B. 1 (= 1 kg). Alternativ können auch Artikelgewichte gezogen werden, hier ist aber eine vollständige Pflege aller Artikelgewichte Voraussetzung!</li></ul><span style="color:#e74c3c;">(Achtung: dieses Gewicht bestimmt mit die Kosten für den Pakettarif)</span>. Bei einer angebundenen Waage, gilt dieses Gewicht als Mindestgewicht → Wird weniger gewogen, wird es in der Paketmarke auf das Mindestgewicht gesetzt.<br /><br /><strong>Hinweis</strong>: Als "Standardgewicht" ist derzeit 2kg fest codiert (kleinstes DHL - Paket), wenn Sie möchten das auch unter 2kg die Gewichte addiert werden, kann man als Standardgewicht eine kleine Zahl wie z.B. 0,05 eintragen, dann sollten die Gewichte auch addiert werden.<ul><li><strong>Standard Länge (in cm)</strong> → Abmessungen der Pakete <span style="color:#e74c3c;">(Achtung: diese Größe bestimmt mit die Kosten für den Pakettarif)</span></li><li><strong>Standard Breite (in cm) </strong>→ Abmessungen der Pakete <span style="color:#e74c3c;">(Achtung: diese Größe bestimmt mit die Kosten für den Pakettarif)</span></li><li><strong>Standard Höhe (in cm)</strong> → Abmessungen der Pakete<span style="color:#e74c3c;"> (Achtung: diese Größe bestimmt mit die Kosten für den Pakettarif)</span></li><li><strong>Standard Paket</strong> (z.B. PL) → meist "PL" eingebenStandard Produkt → für Deutschland z.B. V01PAK / für Österreich z.B. V86PARCEL</li><li><strong>Vorausverfügung</strong> → Diese legt fest, wie mit der Paketmarke bei Nichtzustellbarkeit umgegangen wird. Bei manchen Niedrigpreis Artikeln kann es sich lohnen das Paket preiszugeben (wird dann vom Versanddienstleister versteigert).</li><li><strong>Sperrgut</strong> → Dadurch wird im Geschäftskundenportal die Option "Sperrgut" für diese Sendung gesetzt und nach Sperrgut abgerechnet.</li><li><strong>Extra Versicherung ausschalten</strong> (Option muss von Hand im Paketmarkendialog gesetzt werden) → Haken setzen: es wird nicht automatisch vom Nettopreis die Paketversicherung angewählt (Achtung: diese Option bestimmt mit die Kosten für den Pakettarif → Versicherungsaufschlag)</li><li><strong>Leitcodierung aktivieren</strong> → Leitcodierung für Pakete (ohne diese Codierung berechnet DHL bei falschen Adressen/nicht leitcodierten Adressen einen Aufschlag) → Hinweis: die Leitcodierung ist nur für die neue API von DHL möglich. Bitte kontaktieren Sie hierzu Ihren Kundenbetreuer, sollte die Einstellung eine Fehlermeldung verursachen</li><li><strong>Tracking übernehmen </strong>→ Die Trackingnummer wird automatisch bei der Erstellung in Xentral hinterlegt und muss dadurch nicht mehr abgescannt werden</li><li><strong>Logging</strong> → Logdatei wird auf dem Server abgelegt für weitere Informationen</li></ul><br /><span style="color:#e74c3c;"><strong>Hinweis: Prüfen Sie die erstellten Paketmarken und Preise regelmässig (idealerweise beim Tagesabschluss). Besonders die Feldinhalte, die den Pakettarif mitbestimmen z.B. höhere Versicherung, Versandgewicht, Auslandsendungen (Wird auch das korrekte Produkt gezogen).</strong></span><h3>Weiterführende Infos zu den Feldbezeichnungen</h3><strong>Abrechnungsnummern</strong><br />Ihre Abrechnungsnummern finden Sie im Portal von Versenden unter:Vertragsdaten → Vertragsoptionen<br /><br />z.B. für Weltpaket oder Retourenerstellung<br /><br /><strong>Extra-Versicherung ausschalten</strong><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=4" /><br /><br />Wenn der Haken nicht gesetzt ist, wird der Haken für die Extra-Versicherung für DHL automatisch in der Paketmarke gesetzt. Stand Mai 2017 sind das extra: 6€ für 500€-2500€ und 18€ für 2500€ - 25000€.<br /><br /><strong>Sperrgut</strong><br />Es gibt die Option Sperrgut in der Versandart für DHL.<br />Dadurch wird im Geschäftskundenportal die Option "Sperrgut" für diese Sendung gesetzt und nach Sperrgut abgerechnet.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=5" /><br />Da dies wahrscheinlich nicht immer für die Paketmarke ausgewählt sein sollte, legt man sich für Sperrgut eine neue Versandart an, die diese Aktion aktiviert hat: z.B. "DHL Sperrgut".Gewicht runden auf Ganzahl<br />Es gibt eine weitere Option in der Versandart für DHL.<br /><br /><strong>Gewicht runden auf Ganzzahl</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=6" /><br /><strong>Wichtig</strong>: Diese Option rundet erst bei der Übergabe zu DHL API.<br />In der Paketmaske in Xentral kann noch eine Kommazahl stehen - im DHL Geschäftskundenportal wird das Gewicht aber schon gerundet ausgewiesen.<h1>DHL Österreich (AT)</h1>Es gelten die selben Voraussetzungen wie für DHL Deutschland. Folgende Änderungen beim Ausfüllen der Daten sind notwendig:<ul><li>Versender Land: <strong>austria</strong></li><li><strong>Partner ID Inland </strong>(meist 01, evtl. auch 02, 03 etc.) → zu finden bei Ihren gebuchten Produkten im Geschäftskundenportal (EKP + 4-stellige Kennung → hier die letzten beiden Ziffern verwenden, für DHL-AT (Österreichische DHL Portale) die letzten 4 Ziffern verwenden (falls 2-stellig eine Fehlermldung liefert)</li><li><strong>Partner ID Welt </strong>(falls leer wird die inländische Partner ID verwendet) → leer lassen, wenn identisch zu oben, alternativ die 2-stellige Kennung (oder für AT die 4-stellige). Info: hierbei ist darauf zu achten, dass beidesmal die 2-stellige oder die 4-stellige Nummer eingetragen wird. Stellenanzahl nicht mischen!</li></ul><br />In den Stammdaten muss ebenso der Länder ISO Code eingetragen werden:<br /><br />Administration → Einstellungen → Grundeinstellungen → Firmenanschrift<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=7" /><br /> <h1>Paketmarken</h1><h2>Paketmarkendruck</h2>Ist alles eingestellt können Sie über einen alten Lieferschein eine Paketmarke zum Testen drucken.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=8" /><br /><br />Über den markierten Reiter gelangen Sie zu der Paketmarke.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=9" /><br /><br />Auf dem eingestellten Drucker wird jetzt eine Paketmarke ausgedruckt.<h2>Paketmarke stornieren</h2>Damit die Gebühr für die Paketmarke nicht eingezogen bzw. in Rechnung gestellt wird, sollten Sie diese nach dem Testdruck direkt im Geschäftskunden-Portal von DHL stornieren. Hierzu melden Sie sich zunächst mit Ihren Zugangsdaten an und wechseln dann in den Bereich "Versenden".<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=10" /><br />Im Anschluss gehen Sie, wie folgt, in die Sendungsübersicht, um die Sendung zu sichten.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=11" /><br /><br />Im Reiter vollständige Sendungen finden Sie dann die Sendung zu Ihrer Paketmarke, die Sie stornieren möchten. Dazu einfach auf das "Delete"-Icon der entsprechenden Zeile klicken, um die Sendung zu stornieren.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=12" /><h1>Zollinhaltserklärung drucken</h1>Die Schnittstelle erlaubt einen automatischen Druck der Paketmarke CP-71 sowie der Zollinhaltserklärung CN-23 bei Nicht-EU-Exportlieferungen. Diese werden bei Exportlieferungen zur Paketmarke automatisch mitausgedruckt.<br /><br />Auf diese Zollinhaltserklärung werden die Zolltarifnummern der Artikel im Paket übernommen.<h1>Fehlermeldung beim Versuch die DHL-Paketmarke in Xentral zu erzeugen</h1><h3><br />DHL Login failed, der Nutzer des Webservice konnte nicht authentifiziert werden</h3>In unregelmäßigen Abständen fordert DHL die Vergabe eines neuen Passworts. Daher erhält man eine Fehlermeldung beim Versuch beim Druck der DHL Paketmarke in Xentral. Um diese nun wieder drucken zu können, müssen Sie wie folgt vorgehen:<ol><li>Xentral → in der Versandart DHL nachprüfen, welche Benutzerdaten eingetragen sind: Benutzer + Passwort</li><li>DHL Geschäftskundenportal → mit diesen Benutzerdaten aus Xentral direkt im DHL-Geschäftskundenportal einloggen. Hier erscheint dann eine Fehlermeldung und Sie können direkt ein neues Passwort vergeben</li><li>Xentral → tragen Sie dieses neue Passwort in Xentral in der Versandart DHL ein</li></ol><br />Anbei die Schritte nochmals einzeln:<br /><strong>1. Xentral Versandart DHL </strong>Gehen Sie in Xentral zur Versandart DHL: Administration → Einstellungen → Versandarten → DHL<ul><li><strong>Benutzer</strong> → DHL Benutzername (geschaeftskunden_api (Versenden/Intraship-Benutzername))</li><li><strong>Signature</strong> → DHL Passwort (Dhl_ep_test1 (Versenden/IntrashipPasswort))</li></ul><br /><strong>2. DHL Geschäftskundenportal</strong><br />Melden Sie sich mit diesen Daten im DHL Geschäftskundenportal an. Dort werden Sie aufgefordert ein neues Kennwort zu vergeben (Beim Login erscheint die Meldung, dass das Passwort falsch ist, Sie erhalten daraufhin direkt beim Login 2 Felder zur Vergabe eines neuen Passworts (DHL Geschäftskundenportal Stand 2018). <strong>Vergeben Sie direkt hier ein neues Passwort und tragen Sie dieses in Xentral ein</strong><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=13" /><br /><br /><strong>3. Neues Passwort in Xentral eintragen</strong><br />Dieses Kennwort müssen Sie dann nur in der Versandart DHL in Xentral in das Feld für "Signatur" eintragen und abspeichern.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_dhlversenden&fileid=14" /><br /><br />Im Anschluss sollte es wieder möglich sein eine Paketmarke zu erzeugen.<br /> |