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.
Zur Verwendung der Versandschnittstellen werden Zugangsdaten für den Versanddienstleister benötigt.
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.
Ein Artikel kann im Artikelstamm als Sperrgut markiert werden. Wird ein Artikel mit dem Merkmal in ein Paket verpackt, wird in der Versandschnittstelle automatisch die Versandoption Sperrgut gebucht, sofern diese angeboten wird.
Aufgrund des neuen Postgesetzes § 73 PostG 2024, welches zum 01.01.2025 in Kraft tritt, dürfen Pakete nicht mehr ohne Gewicht an die KEP-Dienstleister übermittelt werden!
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, V62KP, V66WPI |
| mit Retourenetikett | Legt fest, ob ein Retourenetikett erzeugt werden kann |
| Kontonummer für Retouren | 14-stellige Kontonummer für Retouren |
| Druckformat | Wird das Feld leer gelassen, wird die Standardgröße (ist im DHL Account hinterlegt) verwendet. Werte ohne Anführungsstriche "" kopieren: - Wert "910-300-700-oz" für 105 x 205mm Laserdruck-Etiketten - Wert "910-300-300-oz" für 105 x 148mm Laserdruck-Etiketten - Wert "910-300-610" für 105 x 208mm Laserdruck-Etiketten - Wert "100x70mm" für 100 x 70mm Etiketten - Wert "910-300-700" für 103 x 199mm Thermo-Etiketten - Wert "910-300-400" für 103 x 150mm Thermo-Etiketten - Wert "A4" für A4-Etiketten hochkant mit Whitespace |
* Für die Verfahren V01PAK, V53WPAK können jeweils eine Konfiguration mit und ohne Versandoption (+ Service) erstellt werden. Sobald mindestens eine Versandoption gesetzt wird, wird immer die Konfiguration mit dem Verfahren + Service ausgewählt. Versandoptionen wie Sperrgut oder Altersfreigabe werden über den Artikelstamm festgelegt und automatisch gesetzt, wenn der Artikel sich im Paket befindet. Weitere Informationen im nächsten Abschnitt Versandoptionen.
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.
Ist in der Systemkonfiguration für Versicherung von 2.500 EUR ein minimaler Warenwert von 500 EUR hinterlegt, wird die Versandoption Transportversicherung bis 2.500 immer dann gesetzt, wenn der Warenwert 500 EUR überschreitet.
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 |
| 120 | DHL Warenpost / Kleinpaket | Warenpost / Kleinpaket (V62KP) | Sendungen mit einer Größe von bis zu 25 cm x 35,3 cm x 8 cm (Höchstgewicht 1 kg) |
| 121 | DHL Warenpost International | Warenpost International (V66WPI) | Internationale Sendungen mit einer Größe von bis zu 35 cm x 25 cm x 10 cm (Höchstgewicht 2 kg) |
Versandoptionen, die fest einer Versandart zugeordnet sind, werden kursiv dargestellt. Es können weitere Versandoptionen automatisch durch Auftrags- oder Artikelstammdaten hinzugefügt werden.
Werden bei der Versandart 100 und 107 automatische Versandoptionen hinzugefügt, wird die Konfiguration _Paket (V01PAK)
- Service_ bzw. Paket International + Service ausgewählt.
Hinweise
Bei internationalen Sendungen mit DHL werden ggf. weitere Zusatzinformationen aus den Artikelstammdaten benötigt wie z.B.: Herkunftsland, Preis, Gewicht, CustomsTariff (HS Nummer für Zollinhaltserklärung), CustomsContent (Warenbeschreibung für Zollinhaltserklärung). Bei fehlenden Werten kann eine Bestellung des Etiketts abgewiesen werden.
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 |
| 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 |
Versandoptionen, die fest einer Versandart zugeordnet sind, werden kursiv dargestellt. Es können weitere Versandoptionen automatisch durch Auftrags- oder Artikelstammdaten hinzugefügt werden.
Hinweise
Bei internationalen Sendungen mit DPD werden ggf. weitere Zusatzinformationen aus den Artikelstammdaten benötigt wie z.B.: Herkunftsland, Preis, Gewicht, CustomsTariff (HS Nummer für Zollinhaltserklärung), CustomsContent (Warenbeschreibung für Zollinhaltserklärung), EORI-Nummer. Bei fehlenden Werten kann eine Bestellung des Etiketts abgewiesen werden.
Für die Zollbestimmungen werden die Frankaturen (Incoterms) folgendermaßen von ix4 vergeben.
| Incoterm | Bedingung |
|---|---|
| 01 - DAP | bei Versand in EFTA-Land |
| 03 - DDP | bei Versand nach GB |
| 06 - DAP | bei Versand in ein Drittstaat |
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) |
| 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. |
* Für die Zollbestimmungen können pro Konfiguration die Frankaturen (Incoterms) für EU, EFTA und Drittstaat Sendungen separat gesteuert werden. Nachfolgende Icoterms können vom Benutzer konfiguriert werden.
| Wert | Beschreibung |
|---|---|
| 10 | DDP |
| 20 | DAP |
| 30 | DDP, VAT unpaid |
| 40 | DAP, cleared |
| 50 | DDP (Freischreibung) |
| 12 | DDU/EU |
| 13 | Free of freight, duty and tax paid |
| 18 | Free of freight, duty and tax paid |
| 23 | Free of freight, duty and tax unpaid |
** Die Verwendung einer extra Konfiguration für Sperrgut, ermöglicht eine seperate Abrechnung von Sperrgutsendungen über eine andere GLS Kundennummer.
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 |
|---|---|
| Saturday10:00Service | Samstagszustellung bis 10:00 Uhr |
| Saturday12:00Service | 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 |
Versandoptionen, die fest einer Versandart zugeordnet sind, werden kursiv dargestellt. Es können weitere Versandoptionen automatisch durch Auftrags- oder Artikelstammdaten hinzugefügt werden.
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.
Bei Verwendung der Versandoption PaketShop-Zustellung wird automatisch die Versandoption Paketankündigung dazu gebucht, auch wenn diese nicht in der Versandkonfiguration aktiviert ist.
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.
Mehrere Werte können im Feld ShippingOptions ;-getrennt übergeben werden. z.B.: HERMES_PSHDS;HERMES_HSS
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.
Bei Verwendung der Versandoption PaketShop-Zustellung wird automatisch die Versandoption Paketankündigung dazugebucht, auch wenn diese nicht in der Versandkonfiguration aktiviert 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 |
Versandoptionen, die fest einer Versandart zugeordnet sind, werden kursiv dargestellt. Es können weitere Versandoptionen automatisch durch Auftrags- oder Artikelstammdaten hinzugefügt werden.
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 |
| 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 |
* Über die Spezialkonfiguration kann festgelegt werden, ob für eine Sendung in ein anderes Land ein anderes Konto zum Bezahlen verwendet werden soll.
In dem nachfolgenden Beispiel wird für den Paketversand nach Norwegen "CountryCode":"NW" bei Aufträgen mit Auftragsart: Standard "OrderType":1
festgelegt, dass der Account 043E2V für 02 = Duties and Taxes bezahlen muss.
Weitere Information kann der API-Dokumentation von UPS entnommen werden.
{
"CountryCode": "NW",
"OrderType": 1,
"ShipmentChargeType": {
"Type": "02",
"BillShipper": {
"AccountNumber": "043E2V"
}
}
}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.
Nachnahmesendungen dürfen nur verwendet werden, wenn die Ware in einem Paket versendet wird.
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 |
Versandoptionen, die fest einer Versandart zugeordnet sind, werden kursiv dargestellt. Es können weitere Versandoptionen automatisch durch Auftrags- oder Artikelstammdaten hinzugefügt werden.
Hinweise
Bei internationalen Sendungen mit UPS werden ggf. weitere Zusatzinformationen aus den Artikelstammdaten benötigt wie z.B.: Herkunftsland, Preis, Gewicht, CustomsTariff (HS Nummer für Zollinhaltserklärung), CustomsContent (Warenbeschreibung für Zollinhaltserklärung). Bei fehlenden Werten kann eine Bestellung des Etiketts abgewiesen werden.
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 |