Was ist das erweiterte Logistikdienstleister-Polling?
Mit dem erweiterten Logistikdienstleister-Polling ist es möglich, bisher durch pixi nicht unterstützte Logistikdienstleister, die das Polling-Verfahren verwenden, an pixi anzubinden.
Weiterhin kann mithilfe dieser Funktionalität beispielsweise das Polling für FSK18- oder Gefahrgut-Artikel angepasst und es können individuelle Abfragen, wie zum Beispiel "Teile den Nachnahmebetrag der Rechnung auf die Paketanzahl auf." oder "Wenn das Gewicht höher ist als X, dann nutze einen anderen Pakettyp." erstellt werden.
Dabei wird für den entsprechenden Logistiker ein eigenes Template erstellt. Darin wird der Aufbau der Polling-Datei, die nach dem Ship-Out der Rechnung in pixi erstellt wird, definiert, sodass Sie im Anschluss durch die entsprechende Logistikdienstleister-Software verarbeitet werden kann.
Beispiel-Polling-Dateien
Mithilfe des erweiterten Logistikdienstleister-Pollings lassen sich verschiedene Dateitypen erstellen. Es kann so je nach Anforderung des Logistikers eine passende Polling-Datei mit entsprechendem Aufbau und Inhalt erstellt werden.
CSV- / TXT-Datei
Aufbau der CSV-/TXT-Datei:
POOL_REFNR§POOL_V_ABS_REFNR§POOL_V_MAND_REFNR§DHL_verfahren§POOL_V_TEILNAHME§POOL_V_PRODUKT_CN§POOL_V_EXTRA§§
POOL_EMPF_NAME1§POOL_EMPF_NAME2§POOL_EMPF_PLZ§POOL_EMPF_ORT§POOL_EMPF_STRASSE§POOL_EMPF_HAUSNR§POOL_GEWICHT§
POOL_ANZAHL_SENDUNGEN§POOL_EMPF_LANDCODE§§POOL_V_ZOLL_WARENLISTE§§§OrderAddressRemarks§POOL_EMPF_TEL§§§ShipEMail
XML-Datei
Aufbau der XML-Datei:
<?xml version="1.0" encoding="iso-8859-1" ?>
<MHP_STRUKTUR>
<SHIPMENT>
<SHIPMENT_HEADER>
<SEND_KUNDENKENNUNG>SEND_KUNDENKENNUNG</SEND_KUNDENKENNUNG>
<SEND_REFERENZNR_01>SEND_REFERENZNR_01</SEND_REFERENZNR_01>
<INT_AKTPRINTER>INT_AKTPRINTER</INT_AKTPRINTER>
<EMPF_ADR_01>EMPF_ADR_01</EMPF_ADR_01>
<EMPF_ADR_02>EMPF_ADR_02</EMPF_ADR_02>
<EMPF_ADR_03>EMPF_ADR_03</EMPF_ADR_03>
<EMPF_STRASSE>EMPF_STRASSE</EMPF_STRASSE>
<EMPF_HNR>EMPF_HNR</EMPF_HNR>
<EMPF_ORT>EMPF_ORT</EMPF_ORT>
<EMPF_PLZ>EMPF_PLZ</EMPF_PLZ>
<EMPF_ISO>EMPF_ISO</EMPF_ISO>
<EMPF_LAND_KURZ>EMPF_LAND_KURZ</EMPF_LAND_KURZ>
<EMPF_STEUERNR>EMPF_STEUERNR</EMPF_STEUERNR>
<EMPF_TEL>EMPF_TEL</EMPF_TEL>
<SEND_BEIGEFDOKU_04>SEND_BEIGEFDOKU_04</SEND_BEIGEFDOKU_04>
<EMPF_FAX>EMPF_FAX</EMPF_FAX>
<EMPF_MAIL>EMPF_MAIL</EMPF_MAIL>
<SEND_ANZ>SEND_ANZ</SEND_ANZ>
<SEND_MANDANT>SEND_MANDANT</SEND_MANDANT>
<FRACHTFUEHRER>FRACHTFUEHRER</FRACHTFUEHRER>
<ZOLL_FRACHTENTGELD>ZOLL_FRACHTENTGELD</ZOLL_FRACHTENTGELD>
</SHIPMENT_HEADER>
<SHIPMENT_DETAILS>
<PACKAGE>
<PACKAGE_HEADER>
<SEND_2N_PRODCODE>SEND_2N_PRODCODE</SEND_2N_PRODCODE>
<SEND_VERSANDART>SEND_VERSANDART</SEND_VERSANDART>
<SEND_NR>SEND_NR</SEND_NR>
<SEND_GEWICHTEINZEL>SEND_GEWICHTEINZEL</SEND_GEWICHTEINZEL>
<SEND_VOLUMEN>SEND_VOLUMEN</SEND_VOLUMEN>
<SEND_NACHNAHMEBETRAG>SEND_NACHNAHMEBETRAG</SEND_NACHNAHMEBETRAG>
<SEND_WARENWERT>SEND_WARENWERT</SEND_WARENWERT>
<SEND_BESCHREIBUNGINHALT>SEND_BESCHREIBUNGINHALT</SEND_BESCHREIBUNGINHALT>
<SEND_VERWENDUNGSZWECK_01>SEND_VERWENDUNGSZWECK_01</SEND_VERWENDUNGSZWECK_01>
<SEND_ARTLADEMITTEL_01>SEND_ARTLADEMITTEL_01</SEND_ARTLADEMITTEL_01>
</PACKAGE_HEADER>
<PACKAGE_DETAILS>
<ARTICLE>
<ARTIKEL_NR_01>ItemNrInt</ARTIKEL_NR_01>
<ARTIKEL_VKPREIS_01>ItemPrice</ARTIKEL_VKPREIS_01>
<ZOLL_ART_ANZ>ItemQty</ZOLL_ART_ANZ>
<ZOLL_ART_INHALT>ItemText</ZOLL_ART_INHALT>
<ZOLL_ART_NETTOGEWICHT>ItemWeightInKG</ZOLL_ART_NETTOGEWICHT>
<ZOLL_ART_WERT>ItemPrice_Net</ZOLL_ART_WERT>
<ZOLL_ART_URSPLAND>CustomsCountryOfOrigin</ZOLL_ART_URSPLAND>
<ZOLL_ART_TARIFNO>CustomsTariffNumber</ZOLL_ART_TARIFNO>
</ARTICLE>
</PACKAGE_DETAILS>
</PACKAGE>
</SHIPMENT_DETAILS>
</SHIPMENT>Wie kann ich das erweiterte Logistikdienstleister-Polling nutzen?
Die Aktivierung zur Nutzung und Konfiguration des erweiterten Logistikdienstleister-Pollings kann ausschließlich durch pixi-Mitarbeiter vorgenommen werden, da hierzu Änderungen an der Logistikdienstleister-Tabelle im pixi Control Center vorgenommen werden müssen, auf die Sie als Kunde lediglich lesenden Zugriff haben.
Bitte wenden Sie sich bei Interesse an dieser Funktionalität an Ihren zuständigen Account Manager.
Wichtige pixi Control Center Einstellungen
Die Konfiguration des erweiterten Logistikdienstleister-Pollings erfolgt ausschließlich durch pixi-Mitarbeiter im pixi Control Center > Tabelle Logistikdienstleister. Die folgenden Einstellungen müssen entsprechend konfiguriert werden:
Template für Polling verwenden: Diese Option aktiviert die Nutzung des erweiterten Logistikdienstleister-Pollings.
Polling-Template: In dieses Feld muss der Quelltext für die Erstellung der Polling-Datei kopiert werden. Es sind maximal 2.147.483.647 Zeichen erlaubt. Welche Variablen im Template genutzt werden können, ist weiter unten aufgelistet (Haupt-Prozedur, Detail-Prozedur 1)
Endung für Polling-Datei: Hier muss die Dateiendung für die Polling-Dateien eingetragen werden - z. B. ".csv", ".xml", ".txt" oder ".dat".
Polling-Verzeichnis: Teilen Sie uns das Verzeichnis mit, in welches die Polling-Dateien nach Erstellung gespeichert werden sollen. Der Pfad darf maximal 128 Zeichen lang sein und muss mit einem "\" enden.
ACHTUNG: Wenn Sie einen neuen PC für den Versand in Betrieb nehmen, stellen Sie sicher, dass der Pfad auf diesem PC verfügbar ist! Alternativ können Sie dieses Verzeichnis über den pixi Support ändern lassen.Haupt-Procedure: Hier muss die Haupt-Prozedur eingetragen werden, auf die das Polling-Template zugreift. Diese Prozedur ist für die allgemeinen Sendungsinformationen wie z. B. Empfängeradresse, Betrag und Gewicht zuständig. Standardmäßig ist hier "Pixi_PollHeader" hinterlegt.
Detail-Procedure 1: Manche Logistiker, wie z. B. V-Log benötigen neben den allgemeinem Sendungsinformationen auch Informationen zu den Artikeln der Sendung. Diese Informationen lassen sich mit einer Detail-Prozedur mit dem Template verknüpfen. Standardmäßig ist hier "Pixi_PollDetail1" hinterlegt.
Detail-Procedure 2: Für den Zoll werden in einigen Fällen ebenfalls Informationen pro Artikel benötigt. Diese Informationen können in einer separaten Prozedur mit dem Template verknüpft werden. Standardmäßig wird hier - falls benötigt - die "Pixi_PollDetail2" Prozedur genutzt.
Nur Rechnungsnr. im Dateinamen: Mit Aktivierung dieser Option wird die Rechnungsnummer als Namen für die Polling-Dateien verwendet.
Variablen für die Haupt-Prozedur
Diese Variablen können im Polling-Template verwendet werden. Es werden hier die wichtigsten Variablen aufgelistet.
POOL_REFNR: Rechnungsnummer
-
POOL_V_ABS_REFNR: Absenderreferenz (Standard "01")
Wenn die Datenbank-Einstellung "Absenderreferenz von Shop übernehmen" aktiviert ist, wird die Absenderreferenz aus der Shops-Tabelle aus dem Feld "DHL Absender Ref." genutzt. Ist in der Länder-Tabelle im Feld "DHL ABS_REFNR" ein Wert eingetragen, wird dieser genutzt.
POOL_V_MAND_REFNR: Mandantenreferenz (Standard "01")
-
POOL_V_TEILNAHME: Enthält die Teilnahme der Bestellung und wird in Abhängigkeit verschiedener Datenbank-Einstellungen gesetzt:
DHL Teilnahme Inland
DHL Teilnahme Ausland
DHL Teilnahme für Expresssendungen
Teilname für Nachnahmesendungen
Teilnahme, Referenz von Shop übernehmen ("DHL Absender Ref." wird als Teilnahme genutzt)
DHL Teilnahme in Ländertabelle
DHL Teilnahme RegioAT
POOL_V_PRODUKT_CN: Enthält den Wert aus dem Feld "Produkt" der Bestellung.
POOL_V_EXTRA: Enthält den Wert aus dem Feld "Extra" der Bestellung.
POOL_EMPF_REFNR: Referenznummer des Empfängers
POOL_EMPF_NAME1: Enthält den Vor- und Nachnamen der Empfängeradresse.
POOL_EMPF_NAME2: Enthält den Wert aus dem Feld "Firma" der Empfängeradresse.
POOL_EMPF_PLZ: Enthält den Wert aus dem Feld "PLZ" der Empfängeradresse.
POOL_EMPF_ORT: Enthält den Wert aus dem Feld "Stadt" der Empfängeradresse.
POOL_EMPF_STRASSE: Enthält den Wert aus dem Feld "Straße" der Empfängeradresse.
POOL_EMPF_HAUSNR: Enthält den Wert aus dem Feld "Hausnummer" der Empfängeradresse.
POOL_EMPF_TEL: Enthält den Wert aus dem Feld "Telefonnummer" der Empfängeradresse.
POOL_EMPF_FAX: Enthält den Wert aus dem Feld "Faxnummer" der Empfängeradresse.
OrderAddressRemarks: Enthält den Text aus dem Feld "Adresszusatz" der Bestellung.
-
POOL_EMPF_LANDCODE: Enthält den Wert aus dem Feld "DHL Name" aus der Länder-Tabelle.
Ist dort kein Wert enthalten, wird der "Name des Landes" aus der Länder-Tabelle genutzt.
POOL_GEWICHT: Gewicht des Pakets
POOL_ANZAHL_SENDUNGEN: Anzahl Pakete der Rechnung
-
POOL_V_ZOLL_WARENLISTE: Setzt sich aus mehreren Werten zusammen, die jeweils durch ein Semikolon ";" getrennt sind.
Inhalt der Datenbank-Einstellung "DHL Zoll Warenliste"
Wert aus dem Feld "DHL Name" aus der Länder-Tabelle; wenn leer, dann "Name des Landes" aus der Länder-Tabelle
Inhalt der Datenbank-Einstellung "DHL ZOLL WARENLISTE Zollnummer"
Paketgewicht
Rechnungsbetrag
ShipEMail: Enthält den Wert aus dem Feld "E-Mail" der Empfängeradresse.
DHL_verfahren: Enthält den Wert aus dem Feld "Verfahren" der Bestellung.
Variablen für die Detail-Prozedur 1
Diese Variablen können im Polling-Template verwendet werden. Es werden hier die wichtigsten Variablen aufgelistet.
ItemNrInt: Shop-Artikelnummer des Artikels
ItemPrice: Einzelartikelverkaufspreis brutto
ItemQty: Bestellmenge des Artikels
ItemText: Artikelbezeichnung aus dem pixi Kundenservice
ItemWeightInKG: Gewicht des Artikels in kg
ItemPrice_Net: Einzelartikelverkaufspreis netto
oItemSpecialNote: Artikelbemerkung