UPS-Integration¶

UPS ist ein Versanddienstleister, der sich in Odoo integriert, um den Versand in alle Regionen zu koordinieren. Sobald die Integration erfolgt ist, können Benutzer Versandmethoden erstellen, die die Versandkosten abschätzen und Etiketten generieren.

Um den UPS-Versandkonnektor in Odoo einzurichten, führen Sie die folgenden Schritte aus:

1. Erstellen Sie ein UPS-Konto, um eine Kundennummer zu erhalten

2. Erstellen Sie ein UPS-Entwicklerkonto, um Kundenanmeldedatrn zu erhalten

3. Versandmethode in Odoo einrichten

Einrichtung des UPS-Kontos¶

Um loszulegen, gehen Sie auf die UPS-Website und klicken Sie auf die Schaltfläche Log in (Anmelden) in der oberen rechten Ecke, um sich anzumelden oder ein UPS-Konto zu erstellen.

Klicken Sie nach dem Einloggen auf das Profilsymbol in der oberen rechten Ecke und wählen Sie aus dem Dropdown-Menü Accounts and Payment (Konten und Zahlung).

Auf der Seite Accounts and Payment Options (Konten und Zahlungsoptionen) müssen zwei Konten konfiguriert werden: ein Odoo-Versandkonto und eine Zahlungskarte.

Versandkonto¶

Um ein Odoo-Versandkonto hinzuzufügen, wählen Sie Add New Account (Neues Konto hinzufügen) aus dem Dropdown-Menü Add a Payment Method (Zahlungsmethode hinzufügen) und klicken Sie auf Add (Hinzufügen).

Auf dem nächsten Bildschirm mit der Bezeichnung Open a Shipping Account (Ein Versandkonto eröffnen) füllen Sie die Formulare aus, um die Art des Versandkontos zu konfigurieren (z. B. Business) und ob regulierte Artikel versendet werden sollen. Schließen Sie dann die verbleibenden drei Schritte des Assistenten ab, um Add Addresses (Adressen hinzufügen), Verify Identity (Identität prüfen) und Explore Discounts (Rabatte anzeigen), wobei die letzte Option optional ist.

Wenn Sie fertig sind, senden Sie den Antrag auf der letzten Seite des Assistenten ab, um die Einrichtung des Versandkontos abzuschließen.

Kontonummer erhalten¶

Wenn das Versandkonto eingerichtet ist, wird die Account Number (Kontonummer) von UPS verfügbar. Um darauf zuzugreifen, navigieren Sie zu Profile ‣ Accounts and Payment (Profil –> Konten und Zahlungen) und verweisen auf das Feld Number (Number) für das Versandkonto.

Zahlungskarte¶

Gehen Sie zurück zur Seite Accounts and Payments (Konten und Zahlungen) und wählen Sie die Option Add Payment Card (Zahlungskarte hinzufügen) aus dem Dropdown-Menü Add a Payment Method (Zahlungsmethode hinzufügen). Füllen Sie dann das Formular aus, um die Kreditkarteninformationen hinzuzufügen.

Einrichtung eines UPS-Entwicklerkontos¶

Als Nächstes melden Sie sich beim UPS-Entwicklerkonto an, um den Entwicklerschlüssel zu generieren. Klicken Sie dazu auf das Profilsymbol in der oberen rechten Ecke und wählen Sie die Option Apps aus dem Dropdown-Menü.

App hinzufügen¶

Klicken Sie dann auf die Schaltfläche Add Apps (Apps hinzufügen), um mit dem Ausfüllen des Formulars zu beginnen. Wählen Sie im Feld I need API credentials because * (Ich brauche API-Zugangsdaten, weil *) die Option I want to integrate UPS technology into my business (Ich möchte die UPS-Technologie in mein Unternehmen integrieren).

Unter der nächsten Bezeichnung, Choose an account to associate with these credentials. * (Wählen Sie ein Konto, das Sie mit diesen Zugangsdaten verknüpfen möchten), wählen Sie Add existing account (Vorhandenes Konto hinzufügen) aus dem Dropdown-Menü im entsprechenden Feld und wählen Sie dann die Kontonummer, die mit dem im vorherigen Schritt erstellten UPS-Konto verbunden ist.

Klicken Sie auf Next (Weiter), und fahren Sie mit dem Formular Add App (App hinzufügen) fort, und füllen Sie die Felder aus:

• App Name (App-Name): Geben Sie einen Namen ein, um die App zu identifizieren.

• Callback URL (Rückruf-URL): Geben Sie die URL der Odoo-Datenbank im Format: https://databaseName.odoo.com. Geben Sie nicht www in die URL ein.

Suchen Sie im Bereich Add Products (Produkte hinzufügen) auf der rechten Seite nach dem Symbol + (Plus) und klicken Sie darauf, um die folgenden Produkte zur App hinzuzufügen:

• Authorization (O Auth) (Autorisierung (OAuth): Wird verwendet, um das Autorisierungstoken für die Anforderung von Informationen von der UPS-API zu generieren.

• Address Validation (Adressvalidierung): Überprüft Adressen auf Straßenebene in den Vereinigten Staaten und Puerto Rico.

• Locator (Lokalisator): Ermöglicht die Suche nach UPS-Versandstandorten auf der Basis von Typ und verfügbaren Services.

• Paperless Documents (Papierlose Dokumente): Ermöglicht das Hochladen von Dokumentenbildern zur Verknüpfung mit Sendungen.

• Shipping (Versand): Ermöglicht den UPS-Versandservice, z. B. die Vorbereitung von Paketen für den Versand, die Verwaltung von Retouren und die Stornierung geplanter Sendungen.

• Rating (Bewertung): Vergleichen Sie Lieferservices und Versandtarife.

Klicken Sie abschließend auf Speichern und akzeptieren Sie die Allgemeinen Geschäftsbedingungen von UPS.

Client-ID und Client-Geheimnis¶

Wenn Sie die neue App erstellt haben, wählen Sie auf der Seite Profile ‣ My Apps ‣ App (Profil –> Meine Apps –> App) die App im Abschnitt Credentials (Anmeldedaten) aus, um die UPS-Anmeldedaten anzuzeigen.

Im Abschnitt Credentials (Anmeldedaten), kopieren Sie die Client ID (Client-ID) und das Client Secret (Client-Geheimnis).

Einrichtung in Odoo¶

Mit den erhaltenen Zugangsdaten konfigurieren Sie die UPS-Versandmethode in Odoo, indem Sie zu Lager ‣ Konfiguration ‣ Versandmethoden gehen.

Klicken Sie auf der Seite Versandmethoden auf die Schaltfläche Neu.

Wählen Sie im Feld Anbieter die Option UPS. Daraufhin öffnet sich der Reiter UPS-Konfiguration, auf der verschiedene Felder eingegeben werden müssen. Eine ausführliche Anleitung zur Konfiguration der anderen Felder der Versandmethode finden Sie in der Dokumentation Externes Versandunternehmen konfigurieren.

Füllen Sie im Reiter UPS-Konfiguration folgende Felder aus:

• UPS-Kundennummer: (erforderlich) Holen Sie sich die Kontonummer aus dem UPS-Portal.

• UPS-Client-ID: (erforderlich) Erhalten Sie die Client-ID von der UPS-Entwicklerseite.

• UPS-Client-Geheimnis: (erforderlich) Erhalten Sie das Client-Geheimnis von der UPS-Entwicklerseite.

• UPS-Servicetyp: Wählen Sie aus dem Dropdown-Menü die Art des Versanddienstes.

• UPS Package Type: (required) Select from the drop-down menu the package type that is supported for the shipping service.

• Gewichtseinheit des Pakets: Die Maßeinheit für das Gewicht des Pakets.

• Abmessungseinheit des Pakets: Die Maßeinheit für die Paketabmessungen.

• Etikettenformat: Wählen Sie das Format der Versandetiketten: PDF, ZPL, EPL, oder SPL.

Im Abschnitt Optionen sind folgende Funktionen verfügbar:

• Mein Konto abrechnen: Belasten Sie das UPS-Konto des Benutzers für den Versand in der E-Commerce-App.

• Lieferung per Nachnahme: Ziehen Sie die Zahlung von Kunden für den Versand ein, nachdem die Sendung zugestellt wurde.

• Rücksendeetikett generieren: Druckt das Rücksendeetikett für den Auftrag, nachdem der Lieferauftrag validiert wurde.

• Zollabgaben bezahlt von: Wählen Sie aus, ob dem Absender oder dem Empfänger des Auftrag Zölle oder andere Gebühren berechnet werden sollen.