# Versand mit KEP-Dienstleistern

ix4 bietet Anbindungen an verschiedene KEP Versandschnittstellen an. ix4 agiert bei der Bestellung eines Versandlabels über eine Schnittstelle als Vermittler und nicht als Käufer.

In ix4 sind die Verwendungen der Versandschnittstellen zu DHL, DPD, GLS, Hermes und UPS möglich. Zudem können auch ix4 eigene Versandlabels ohne Trackingfunktion erstellt werden.

# Allgemein

Unter der Systemkonfiguration können für einen Mandanten eine oder mehrere Versandkonfigurationen zu den Versandschnittstellen angelegt werden. Über die Versandkonfiguration können verschiedene Werte hinterlegt werden, welche bei der Ausführung an die Schnittstelle übergeben werden.

Die Zuordnung einer Versandkonfiguration zu einem Auftrag findet über den Versandentscheider statt. Dieser wählt anhand des Mandanten, der Versandart und weiteren Werten die Versandkonfiguration, welche verwendet werden soll.

Über Auftrags- und Artikelstammdaten können automatisch Versandoptionen hinzugefügt werden, wenn gewisse Bedingungen erfüllt sind.

# DHL

Die Zuordnung der Versandkonfiguration findet über den Mandanten, Versandart und den gesetzten Versandoptionen statt. Für die Verfahren V01PAK, V53WPAK können jeweils eine zusätzliche Konfiguration erstellt werden, für den Fall, dass mindestens eine Versandoption gesetzt ist.

# Konfiguration

Name Beschreibung
Mandant Zuordnung der Konfiguration zu einem Mandanten
Kontonummer 10-stellige Kontonummer
Teilnahme 2-stellige Teilnahme
Verfahren* V01PAK, V01PAK + Service, V54EPAK, V53WPAK, V53WPAK + Service
mit Retourenetikett Legt fest, ob ein Retourenetikett erzeugt werden kann
Kontonummer für Retouren 14-stellige Kontonummer für Retouren

# Versandoptionen

Bei den Versandoptionen handelt es sich um eine oder mehrere zusätzliche Dienstleistungen, die beim Versenden des Paketes hinzugebucht werden können.

Folgende vom Versanddienstleister angebotene Versandoptionen werden von ix4 unterstützt.

# Retoure

Zur Aktivierung der Retoure muss in der Konfiguration der Haken im Feld mit Retourenetikett sowie die Kontonummer für Retouren gesetzt werden.

Damit für einen Auftrag eine Retoure erzeugt wird, muss in der Auftragsschnittstelle im Feld ShippingOptions einer der nachfolgenden Werte übermittelt werden.

ShippingOptions Beschreibung
DHL_RET Eine Retourennummer wird mit Etikett erzeugt
DHL_RETNOPRINT Eine Retourennummer wird ohne Etikett erzeugt

# Transportversicherung bis 2.500 EUR und bis 25.000 EUR

Die Versandoption Transportversicherung für einen Warenwert bis 2.500 EUR oder bis 25.000 EUR wird über die Wahl einer bestimmten Versandart (siehe Versandarten) oder das setzen eines Warenwertes (GoodsValue) im Auftrag hinzugebucht. Bei Verwendung des Warenwertes kann über die Systemkonfiguration der minimale Warenwert festlegen werden, der erreicht werden muss, damit die Versicherungsoption hinzugebucht wird.

# Sperrgut

Die Versandoption Sperrgut wird automatisch hinzugefügt, wenn mindestens ein Artikel im Paket das Merkmal Sperrgut (BulkyGoods) gesetzt hat. Das Merkmal kann im Artikelstamm gepflegt werden. Alternativ kann eine Versandart mit Sperrgut gewählt werden, um die Versandoption hinzuzufügen (siehe Versandart).

# Alterssichtprüfung für Mindestalter 18 Jahre

Die Versandoption Alterssichtprüfung für Mindestalter 18 Jahre wird automatisch hinzugefügt, wenn für mindestens ein Artikel im Paket das Merkmal Altersprüfung (AgeVerification) gesetzt ist. Das Merkmal kann im Artikelstamm gepflegt werden.

# Nachnahme

Die Versandoption Nachnahme wird automatisch hinzugefügt, wenn im Auftrag der Wert Nachnahmebetrag gesetzt ist.

# Closest Droppoint Delivery (CDP)

Zustellung an die nächstgelegene Abgabestelle, die der Adresse des Empfängers der Sendung am nächsten liegt. Für diese Art der Zustellung ist entweder die Telefonnummer und/oder die E-Mail-Adresse des Empfängers erforderlich. Für Sendungen in die Länder Schweden und Finnland ist CDP Pflicht und wird automatisch gesetzt. Andernfalls wird die Versandoption CDP hinzugebucht, wenn im Auftrag in Feld ShippingOptions der Wert DHL_CDP übermittelt wird.

# Versandarten

Bei DHL sind Versandart und Verfahren verknüpft (siehe Tabelle). Basierend auf Mandant, Versandart und gesetzten Versandoptionen wählt der Versandentscheider die geeignete DHL Konfiguration zum Abwickeln des Versandes aus.

Id Name Verfahren Beschreibung
100 DHL Paket Paket (V01PAK) Nationaler Versand
101 DHL Paket (Vers. 2500) Paket (V01PAK) + Service Versand mit Transportsicherung bis 2.500 EUR
102 DHL Paket (Vers. 25000) Paket (V01PAK) + Service Versand mit Transportsicherung bis 25.000 EUR
107 Paket International Paket International (V53WPAK) Internationaler Versand
110 DHL Europaket (DDP) Europaket (V54EPAK) Geschäftskunden Versand mit DDP
111 DHL Europaket (DAP) Europaket (V54EPAK) Geschäftskunden Versand mit DAP
115 DHL Paket (Sperrgut) Paket (V01PAK) + Service Versand mit Sperrgut

# Hinweise

# DPD

Die Zuordnung der Versandkonfiguration findet über den Mandanten statt. Pro Mandant kann nur eine Konfiguration angelegt werden.

# Konfiguration

Name Beschreibung
Mandant Zuordnung der Konfiguration zu einem Mandanten
Version Version 3.2 oder 4.4
Standard Gewicht Ersatzwert, der angegeben wird, wenn sich Paketgewicht nicht errechnen lässt
Predict Aktiviert den DPD Predict Service
EORI EORI Nummer

# Versandoptionen

Bei den Versandoptionen handelt es sich um eine oder mehrere zusätzliche Dienstleistungen, die beim Versenden des Paketes hinzugebucht werden können.

Folgende vom Versanddienstleister angebotene Versandoptionen werden von ix4 unterstützt.

# Höherversicherung

Die Versandoption Höherversicherung wird gesetzt, wenn der Warenwert im Auftrag den in der Systemkonfiguration hinterlegten Warenwert für Versicherungen (bis 2.500 EUR) überschreitet.

# Expressversand

Die Verwendung des Expressversand ist an die Versandart gekoppelt (siehe Versandart). Folgende Optionen für Express stehen zur Verfügung.

Zusatzleistung Beschreibung
DPD 08:30 Zustellung bis 08:30 Uhr
DPD 10:00 Zustellung bis 10:00 Uhr
DPD 12:00 Zustellung bis 12:00 Uhr
DPD 18:00 Zustellung bis 18:00 Uhr

# Predict

Die Versandoption Predict wird hinzugebucht, wenn diese in der Konfiguration aktiviert ist und in der Empfängeradresse E-Mail oder Telefon hinterlegt sind.

# Retoure

Damit für einen Auftrag eine Retoure erzeugt wird, muss in der Auftragsschnittstelle im Feld ShippingOptions einer der nachfolgenden Werte übermittelt werden.

ShippingOptions Beschreibung
DPD_RET Eine Retourennummer wird mit Etikett erzeugt
DPD_RETNOPRINT Eine Retourennummer wird ohne Etikett erzeugt

# Versandarten

Id Name Versandoption
400 DPD Classic DPD Versand
451 DPD Express 08:30 Uhr Expressversand mit DPD 08:30
452 DPD Express 10:00 Uhr Expressversand mit DPD 10:00
453 DPD Express 12:00 Uhr Expressversand mit DPD 12:00
454 DPD Express 18:00 Uhr Expressversand mit DPD 18:00

# Hinweise

# GLS

Die Zuordnung der Versandkonfiguration findet über den Mandanten und dem Sperrgutmerkmal im Paket statt. Für Sperrgutsendungen kann eine weitere Konfiguration angelegt werden.

# Konfiguration

Name Beschreibung
Mandant Zuordnung der Konfiguration zu einem Mandanten
Shipper Id Eindeutige GLS Kundennummer
Labelformat Format des Versandlabels (Standard: A6)
Standard Gewicht Ersatzwert, der angegeben wird, wenn sich Paketgewicht nicht errechnen lässt
Incoterm* EU Legt den Incoterm für Sendungen in EU-Länder fest
Incoterm* EFTA Legt den Incoterm für Sendungen in EFTA-Länder fest
Incoterm* Others Legt den Incoterm für Sendungen in alle anderen Länder fest
Hat Sperrgut** Merkmal hat Sperrgut um eine zusätzliche Konfiguration anzugeben. Gibt es nur eine Konfiguration ohne Sperrgutmerkmal, kann über diese ebenefalls Sendungen mit Sperrgut abgewickelt werden.

# Versandoptionen

Bei den Versandoptionen handelt es sich um eine oder mehrere zusätzliche Dienstleistungen, die beim Versenden des Paketes hinzugebucht werden können.

Folgende vom Versanddienstleister angebotene Versandoptionen werden von ix4 unterstützt.

# Wunschzustellung (FlexDeliveryService)

Die Versandoption Wunschzustellung ist an eine Versandart gebunden (siehe Versandart). Zur Verwendung dieser Versandoption muss die E-Mail Adresse des Empfängers vorhanden sein.

# Express-Versand

Die Versandoption Express-Versand ist an eine Versandart gebunden (siehe Versandart).

# Terminzustellung (TimeDefiniteService)

Die Versandoptionen für die Terminzustellung sind Zusatzoptionen des Express-Versand und an Versandarten gebunden (siehe Versandart). Es sind verschiedene Terminzustellungen möglich.

Service Beschreibung
08:00Service Zustellung bis 08:00 Uhr
09:00Service Zustellung bis 09:00 Uhr
10:00Service Zustellung bis 10:00 Uhr
12:00Service Zustellung bis 12:00 Uhr

# Samstagszustellung (SaturdayService)

Die Versandoption für die Samstagszustellung sind Zusatzoptionen des Express-Versand und an Versandarten gebunden (siehe Versandart). Es sind verschiedene Samstagszustellungen möglich.

Service Beschreibung
Saturday​10:00​Service Samstagszustellung bis 10:00 Uhr
Saturday12:00​Service Samstagszustellung bis 12:00 Uhr

# Versandarten

Id Name Beschreibung
300 GLS Versand
301 GLS Express 08:00 Uhr Express-Versand mit Terminzustellung bis 08:00 Uhr
302 GLS Express 09:00 Uhr Express-Versand mit Terminzustellung bis 09:00 Uhr
303 GLS Express 10:00 Uhr Express-Versand mit Terminzustellung bis 10:00 Uhr
304 GLS Express 12:00 Uhr Express-Versand mit Terminzustellung bis 12:00 Uhr
305 GLS Express Express-Versand
306 GLS Express SAT 10:00 Uhr Express-Versand mit Samstagszustellung bis 12:00 Uhr
307 GLS Express SAT 12:00 Uhr Express-Versand mit Samstagszustellung bis 12:00 Uhr
308 GLS FlexDelivery Versand mit Wunschzustellung

# Hermes

Die Zuordnung der Versandkonfiguration findet über den Mandanten statt.

# Konfiguration

Name Beschreibung
Mandant Zuordnung der Konfiguration zu einem Mandanten
Benachrichtigung Aktiviert, die Benachrichtigung des Kunden durch Hermes

# Versandoptionen

Bei den Versandoptionen handelt es sich um eine oder mehrere zusätzliche Dienstleistungen, die beim Versenden des Paketes hinzugebucht werden können.

Folgende vom Versanddienstleister angebotene Versandoptionen werden von ix4 unterstützt.

# Sperrgut (bulkGoodService)

Die Versandoption Sperrgut wird immer gesetzt, wenn sich mindestens ein Artikel im Paket befindet, der das Sperrgutmerkmal gesetzt hat.

# PaketShop-Zustellung (parcelShopDeliveryService)

Die Versandoption PaketShop-Zustellung wird gesetzt, wenn in der Empfängeradresse des Auftrags das Feld CollectStation gesetzt und das Feld ExternalId mit der PaketShop-Id von Hermes befüllt ist. Zudem muss sichergestellt sein, dass die Adresse des Empfängers vollständig übergeben werden muss.

# Verbieten der Paket-Abholung aus PaketShop mit Vollmacht (excludeParcelShopAuthorization)

Die Versandoption wird hinzugebucht, wenn im Auftrag in Feld ShippingOptions der Wert HERMES_PSHDS übermittelt wird.

# Paketankündigung (customerAlertService)

Die Versandoption Paketankündigung wird gesetzt, wenn diese in der Versandkonfiguration aktiviert ist und in der Empfängeradresse das E-Mail Feld ausgefüllt ist.

# Wunschtagzustellung (statedDayService)

Die Versandoption ist an eine Versandart gebunden (siehe Versandarten). Der gewünschte Zustellungstag muss im Auftrag im Feld Veranddatum angegeben werden. Der Wunschtag muss mindestens 2 Tage in der Zukunft liegen und darf nicht mehr als 210 Tage in der Zukunft liegen.

# Ausschluss der Nachbarschaftsabgabe (householdSignatureService)

Die Versandoption wird gesetzt, wenn im Auftrag das Feld ShippingOptions den Wert HERMES_HSS beinhaltet. Der Service verhindert, dass das Paket beim Nachbarn abgegeben werden darf.

# Versandarten

Id Name Beschreibung
600 Hermes Versand
601 Hermes (stated day) Versand mit Wunschtagzustellung

# UPS

Die Zuordnung der Versandkonfiguration findet über den Mandanten statt.

# Konfiguration

Name Beschreibung
Mandant Zuordnung der Konfiguration zu einem Mandanten
Lizenznummer UPS Lizenznummer
Versendernummer UPS Versendernummer
Standard Gewicht Ersatzwert, der angegeben wird, wenn sich Paketgewicht nicht errechnen lässt
Email-Benachrichtigung Aktiviert, die Benachrichtigung des Kunden durch UPS
Spezial Konfiguration* Spezielle Konfiguration zum Überschreiben des Abrechnungskontos
Beschreibung Paket Standard Beschreibung für Paketinhalt
Beschreibung Lieferung Standard Beschreibung für Lieferung

# Versandoptionen

Bei den Versandoptionen handelt es sich um eine oder mehrere zusätzliche Dienstleistungen, die beim Versenden des Paketes hinzugebucht werden können.

Folgende vom Versanddienstleister angebotene Versandoptionen werden von ix4 unterstützt.

# Sperrgut

Die Versandoption Sperrgut wird immer gesetzt, wenn sich mindestens ein Artikel im Paket befindet, der das Sperrgutmerkmal gesetzt hat.

# Nachnahme

Die Versandoption Nachnahme wird gesetzt, wenn im Auftrag der Nachnahmebetrag gesetzt ist. Über den Auftrag kann ebenfalls die Währung des Nachnahmebetrags gesetzt werden. Ist diese nicht ausgefüllt, wird der Wert EUR gesetzt.

# Altersnachweis

Die Versandoption Altersnachweis wird immer gesetzt, wenn sich mindestens ein Artikel im Paket befindet, der das Altersnachweismerkmal gesetzt hat.

# Versandarten

Id Name Beschreibung
500 UPS Standard Versand mit UPS Standard
501 UPS Express Versand mit UPS Express
502 UPS Worldwide Saver Versand mit UPS Worldwide Saver

# Hinweise

# LogistikBroker

Das ix4 Versandlabel ist ein einfaches Label mit den Adressinformationen. Eine Sendungsverfolgung ist nicht möglich, daher wird das Label immer ohne Sendungsnummer erzeugt. Das Versandlabel kann für Umlagerungen an einen anderen Standord verwendet werden oder für andere Anwendungsfälle verwendet werden.

# Versandarten

Id Name Beschreibung
801 Standard Etikett LogistikBroker Standard Etikett