UPS Worldship

Die UPS-Worldship Schnittstelle ist eine Versandschnittstelle über UPS.

Die Abwicklung der Versendung erfolgt über das mx.erp im Fenster “Verpackung & Versand”.

Inhalt

Voraussetzungen

• mx.erp Version 5.28.0.0

• Das Zusatzmodul “UPS Worldship” - Dieses wird über den multiflex-Lizenzschlüssel bereitgestellt

• Einen Kunden-Account bei UPS
  + Eine konfigurierte “Applikation” mit den APIs: Authorization (OAuth), Shipping, Tracking
  Info: Anleitung zum Erstellen einer Applikation

Ansicht

Fenster Versandarten

Konfiguration Versandart

• Damit der UPS-Worldship-Service genutzt wird, ist in der Spalte “Typ” der Wert “UPS Worldship” auszuwählen

• Bei FTP-Server kann die URL zur UPS-API eingetragen.
  Wenn keine URL angegeben wurde, wird standardmäßig folgende Adresse verwendet: https://onlinetools.ups.com/api
  Die URL zur Test-(Integrations)-API ist: https://wwwcie.ups.com

• Die Felder FTP-Benutzer und FTP-Passwort sind Pflichtfelder, hier werden Client-ID und Client-Secret für den Zugang zur UPS-API hinterlegt.

  

• Druckmethode "WebService" bedeutet, dass das vom WebService zurückgelieferte GIF gedruckt wird, andernfalls wird das eigene Etikett gedruckt, entweder über "Active Reports" oder “Bartender”.

• Für die Generierung der Trackinglinks kann in der Spalte "Tracking-Link" die Vorlage für den Tracking-Link angegeben werden. Per 26.11.2024 wird, wenn keine Vorlage angegeben wurde, folgender Wert als Tracking-Link-Vorlage verwendet:

  CODE

  https://www.ups.com/track?loc=de_DE&tracknum=<Paketnummer>
  
  Der Platzhalter "<Paketnummer>" wird im Multiflex durch die jeweilige Paketnummer ersetzt.

Versender

Die Daten des Versenders werden über die Kundennummer der OE des Dokuments (Lieferscheins) selektiert.
Über die Kundenprofilierung sind hier einige Vorgabewerte einzustellen.
Die benötigten Informationen sind im UPS Center abrufbar.

Beispiel

Lieferschein 4711 mit OE 10 → OE 10 hat die Kundennummer 21234 zugeordnet → Beim Kunden 21234 sind Adress- sowie Bankdaten hinterlegt.

Auswahl/Ermittlung des Druckers

Der Drucker wird in dieser Reihenfolge ermittelt (der erste gefundene Drucker in der Reihe wird verwendet:)
1) Versandarten-Benutzer-Drucker
2) Versandarten.Drucker
3) Default Drucker für Versandetiketten aus der Druckerzuordnung (Typ 14)

Grundlageneinstellung

Unter Grundlagen - Grundlagen Manager - Versand muss unter Versand Allgemein der Punkt "Konstanter Teil der NVE-Nummer" befüllt werden. Beispielsweise mit 11111

Weiters gibt es in den Grundlageneinstellungen unter Versand den Punkt Gewichtprüffaktor. Wenn dort -1 eingetragen wird, erfolgt keine Gewichtsprüfung.

Fenster Verpackung&Versand

Versand abschließen

Sobald der Versand abgeschlossen wird, wird der UPS-Worldship-Service kontaktiert und die "shipment"-Methode ausgeführt. Dabei werden die generierten Paketnummern mit den zuvor generierten Paketnummern ausgetauscht.

Sollten bei der Übermittlung zu UPS Probleme auftreten, wird eine Informationsmeldung angezeigt.

Neue Etiketten

Ein Etiketten-Nachdruck ist per Vorgabe nicht möglich. Wenn neue Etiketten ausgedruckt werden sollen, wird ein Storno (voidShipment-Methode) durchgeführt und danach die Pakete erneut erzeugt.

Sendungen stornieren

Eine bereits an UPS übermittelte Versendung kann im Fenster Verpackung&Versand wieder storniert werden.
Dazu muss die Versendung erneut aufgerufen und mit der Funktion "Versendung zurücknehmen" storniert werden.
EIne Storno Aufruf wird in diesem Fall an UPS übermittelt.

SmartCenter

Die Versendungs-Erstellung funktioniert auch im SmartCenter im Fenster "Kommissionierung mit Kommliste" (Liefervorschlag). Dabei ist die entsprechende Einstellung im CONFIG.xml vorzunehmen.

Logging

Das Logging ist nur per SQL-Command einstellbar. Wenn ein Lgging-Pfad eingetragen ist, dann werden dort die WebService-Requests, Requests, Responses und Exceptions gespeichert.

insert into grundlagen_werte (name,wert) values ('UPS_WORLDSHIP_LOGPATH','\\server\iptor\logs');

Standard Services und individuelle Services

Nach der Grundkonfiguration können Sendungen per UPS Schnittstelle (inklusive Nachnahme) im Fenster "Verpackung&Versand" versendet werden.

Mittels dynamischem Werte-Übersetzer sind zusätzlich je Versandart individuelle Services definierbar ( Export, Dokumenttyp: Shipment, Schnittstelle: UPSWorldship )

Übergebene Daten

• LIEFERSCHEINE.L_EMAIL und als Fallback Kundenstamm.EMAIL.

• LIEFERSCHEINE.MOBILNUMMER

• LIEFERSCHEINE.L_TELEFON bzw. Fallback Kundenstamm.TELEFON

Daten Kundenstamm => aus LIEFERSCHEINE.KUNDENNUMMER

SmartCenter

Die Versendungs-Erstellung funktioniert auch im SmartCenter im Fenster "Kommissionierung mit Kommliste" (Liefervorschlag). Dabei ist die entsprechende Einstellung im CONFIG.xml vorzunehmen.

API-Dokumentation

https://developer.ups.com/get-started?loc=de_DE

Methode: Create Shipment

Dynamischer Werteübersetzer: Sektion “ShipmentRequest”

JSON

{
	"ShipmentRequest": {
		"Request": {
			"RequestOption": "nonvalidate",
			"SubVersion": "2205"
		},
		"Shipment": {
			"Description": "Ship WS test",
			"Shipper": {
				"Name": "Zentrale",
				"TaxIdentificationNumber": "U52109800AT",
				"Phone": {
					"Number": "07228"
				},
				"ShipperNumber": "930357",
				"FaxNumber": "07228",
				"Address": {
					"AddressLine": [
						"Achleiten"
					],
					"City": "Kematen a.d.Krems",
					"PostalCode": "4531",
					"CountryCode": "AT"
				}
			},
			"ShipTo": {
				"Name": "Mustermann",
				"Address": {
					"AddressLine": [
						"Nussdorferstraße"
					],
					"City": "Wien",
					"PostalCode": "1090",
					"CountryCode": "AT"
				}
			},
			"PaymentInformation": {
				"ShipmentCharge": [
					{
						"Type": "01",
						"BillShipper": {
							"AccountNumber": "930357"
						}
					}
				]
			},
			"Service": {
				"Code": "11",
				"Description": "Ground"
			},
			"Package": [
				{
					"Packaging": {
						"Code": "02"
					},
					"PackageWeight": {
						"UnitOfMeasurement": {
							"Code": "KGS",
							"Description": "Kilograms"
						},
						"Weight": "5"
					}
				}
			]
		},
		"LabelSpecification": {
			"LabelImageFormat": {
				"Code": "GIF",
				"Description": "GIF"
			},
			"HTTPUserAgent": "Mozilla/4.5",
			"LabelStockSize": {
				"Height": "6",
				"Width": "4"
			}
		}
	}
}

Beispielkonfigurationen für den Import in "dyn. Werteübersetzer"