Envia.com-Integration¶
Envia.com ist ein Versanddienstleister, der Unternehmen mit mehreren Zustellern in Odoo verbindet. Zu den wichtigsten Funktionen gehören:
Versand mit mehreren Zustellern & internationaler Versand: Vergleichen Sie Tarife von mehreren Zustellern und wählen Sie die beste Option für nationale oder internationale Sendungen aus.
Automatisierte Generierung von Etiketten: Generieren Sie Versandetiketten bei der Auftragsbestätigung.
Echtzeit-Tarifberechnung: Rufen Sie Tarife auf der Grundlage von Paketumfang und Zielort ab.
Einrichtung in Envia¶
Um Envia.com mit Odoo zu integrieren, müssen Sie zuerst ein Konto erstellen und die erforderlichen Versandzusteller aktivieren. Anschließend erhalten Sie die API-Anmeldedaten, die verwendet werden, um Envia.com mit der Odoo-Datenbank zu verbinden
Ein Konto erstellen und Transportunternehmen aktivieren¶
Gehen Sie zunächst zu Envia.com.
Klicken Sie nach der Anmeldung in der linken Seitenleiste auf
(Einstellungen –> Druckoptionen und Zusteller). Wählen Sie dann das Land aus, um eine Währung festzulegen und die verfügbaren Versandzusteller anzuzeigen.Wichtig
Achten Sie bei der Anmeldung darauf, in der rechten oberen Ecke die richtige Sprache und das richtige Land auszuwählen. Dies wirkt sich auf die Währung des Kontos aus!

Klicken Sie nach der Auswahl des gewünschten Zustellers auf Activate (Aktivieren), dann auf Services (Dienstleistungen), um die verfügbaren Versandoptionen des Zustellers auszuwählen.
Tipp
Die Rechnungsstellung erfolgt immer in der Währung des Landes, das der primären Rechnungsadresse entspricht. Wenn das Unternehmen in mehreren Ländern tätig ist, sollten Sie die Einrichtung separater Konten für jeden Standort in Betracht ziehen.
Bemerkung
Envia sendet eine SMS- oder WhatsApp-Nachricht, um die E-Mail-Adresse und die Telefonnummer zu bestätigen.

Envia.com-Anmeldedaten generieren¶
Gehen Sie zu Envia.com, navigieren Sie im linken Menü zu (Entwickler –> API-Schlüssel) und klicken Sie auf add (hinzufügen), um einen neuen Schlüssel zu generieren.
Der Schlüssel ist erforderlich, um Odoos Verbindung zu Envia.com zu authentifizieren. Rufen Sie ihn jederzeit ab, indem Sie zum Abschnitt API Keys (API-Schlüssel) zurückkehren.

Einrichtung in Odoo¶
Installieren Sie das Modul Envia-Versand (delivery_envia
) und befolgen Sie die Anweisungen in den folgenden Abschnitten, um die Integration mit Odoo zu konfigurieren.
Konfiguration des Versandkonnektors Envia.com¶
Erstellen Sie nach der Aktivierung des Envia.com-Konnektors eine Liefermethode, indem Sie zu Neu klicken.
gehen und aufFüllen Sie folgende Formularfelder aus:
Versandmethode: Name der Versandmethode, z. B.
Envia.com
.Anbieter: Wählen Sie Envia aus dem Drop-down-Menü aus.
Lieferprodukt: Das Produkt, das auf dem Verkaufsauftrag als Liefergebühr aufgeführt ist. Es muss ein spezielles Lieferprodukt für Envia.com erstellt werden.
Geben Sie im Reiter Envia-Konfiguration das Envia-Zugriffstoken für Produktion ein.
Geben Sie im Reiter Envia-Konfiguration das Envia-Zugriffstoken für Sandbox ein.
Versicherungssatz: Wenn eine Versicherung erforderlich ist, geben Sie einen Prozentsatz des zu versichernden Wertes an. Wenn nicht, lassen Sie den Wert auf 0 stehen. Beachten Sie, dass die Versicherungsgebühr erst nach der Erstellung des Etiketts berechnet wird, auch bei LTL-Sendungen. Envia.com muss erstellt werden.
Tipp
Es ist zwingend erforderlich, sowohl die Produktions- als auch die Sandbox-Token auszufüllen, aber es könnte ein zufälliges Zeichen übrig bleiben, da es zu diesem Zeitpunkt nicht validiert wird.
Zusätzliche Überlegungen für das Envia-Standardpaket:
Das Paket wird in mm und kg angegeben. Das Gewicht bezieht sich auf den Behälter selbst, nicht auf seinen Inhalt. Lassen Sie das Gewicht auf
0`n, wenn kein Gewicht angegeben ist, und setzen Sie das Maximalgewicht auf `0
, wenn es keine angegebene Grenze gibt.Envia-Pakettyp: Standardmäßig auf Box eingestellt. Achten Sie darauf, dass der richtige Typ ausgewählt ist, da dies Auswirkungen auf die verfügbaren Zusteller und angezeigten Optionen hat, die je nach Auswahl variieren.
Sobald die vorherigen Felder richtig eingestellt sind, navigieren Sie zum Reiter Envia-Konfiguration und klicken Sie im Feld Service-Name von Envia.com auf das Symbol (Aktualisieren), um die Zusteller zu synchronisieren. Wählen Sie im angezeigten Pop-up-Fenster einen Zusteller und ein Service-Level aus der Liste aus.

Wichtig
Envia behält die Hauptwährung des Kontos bei. Um genauere Umrechnungen für die Versandkosten zu erhalten, geben Sie die Währung an, die für das Konto auf Envia festgelegt ist. Bei Bedarf bietet Odoo die Möglichkeit, das Land zu ändern. Standardmäßig wird das mit dem Unternehmen verknüpfte Land verwendet.
Bemerkung
Wenn mehr als eine Versandoption benötigt wird, erstellen Sie weitere Versandmethoden in Odoo und ändern Sie alle Parameter wie Paket, Zusteller oder Service.
Versandinformationen¶
Um Envia.com zur Generierung von Versandetiketten zu verwenden, müssen die folgenden Informationen in Odoo genau und vollständig ausgefüllt werden:
Kundeninformationen: Achten Sie beim Erstellen eines Angebots darauf, dass der ausgewählte Kunde über eine gültige Telefonnummer, E-Mail-Adresse und Lieferadresse verfügt.
Um dies zu überprüfen, wählen Sie das Feld Kunde, um die Kontaktseite zu öffnen. Geben Sie hier die Lieferadresse in das Feld Kontakt ein, zusammen mit der Mobiltelefonnummer und der E-Mail-Adresse.
Produktgewicht: Stellen Sie sicher, dass alle Produkte in einem Lieferauftrag ein bestimmtes Gewicht im Reiter Lager ihres Produktformulars haben. Detaillierte Anweisungen finden Sie im Abschnitt Produktgewicht dieses Artikels.
Lageradresse: Standardmäßig werden alle Pakete von der angegebenen Adresse im Lager aus versendet. Stellen Sie sicher, dass Sie die Adresse für die korrekte Etikettenerstellung festlegen.
Anleitung zum Ausfüllen von Adressen¶
Jedes Land hat eigene Regeln für das Ausfüllen von Adressen. Dies ist eine umfassende Anleitung zu den erwarteten Feldern der einzelnen Länder mit Ausnahmen:
Land |
Straße |
Straße 2 |
Stadt |
State_id |
---|---|---|---|---|
Argentinien |
Straße und Hausnummer |
Örtlichkeit |
Stadt |
Provinz |
Brasilien |
Ausnahme |
Viertel |
Stadt |
Status |
Chile |
Straße und Hausnummer |
Stadt |
Gemeinde |
Region |
Kolumbien |
Straße und Hausnummer |
Nicht benötigt |
Gemeinde |
Abteilung |
Guatemala |
Straße und Hausnummer |
Viertel |
Stadt |
Status |
Mexiko |
Straße und Hausnummer |
Viertel |
Stadt |
Status |
Uruguay |
Straße und Hausnummer |
Zusazuinformationen |
Örtlichkeit |
Status |
Länder, die hier nicht aufgeführt sind, sollten eingegeben werden.
Bemerkung
In einigen Ländern ist die Postleitzahl nicht erforderlich. Wenn das Feld leer ist, verwendet Odoo die Funktionen zur Ermittlung der Postleitzahl von Envia.
Für Kolumbien wird die Postleitzahl aus der in city_id
ausgewählten Stadt extrahiert, wenn die Lokalisierung installiert ist, andernfalls verwendet Odoo das PLZ-Feld.
Bemerkung
Kolumbien und Mexiko haben eine Liste von Städten, die in Odoo als city_id
bezeichnet wird. Wenn city_id
festgelegt ist, wird es als Stadtfeld verwendet. Wenn es nicht festgelegt ist, versucht Odoo, das Stadtfeld zu verwenden.
Bemerkung
In Mexiko benötigen einige Zusteller möglicherweise das Feld Kolonie, das allgemein als Viertel bekannt ist. Es ist nicht immer obligatorisch, aber bei Verwendung des Moduls EDI für Mexiko (Erweiterte Funktionen) ist das Feld Kolonie erforderlich.
Bemerkung
In Brasilien wird die Adresse aufgeteilt, um den Vorschriften zu entsprechen, sodass street_name
nur für den Straßennamen verwendet wird. street_number1
wird für die Hausnummer verwendet und street_number2
wird für die Zusatzinformation verwendet. Diese Logik gilt auch, wenn das Modul Erweiterte Adressen installiert ist.
Etiketten mit Envia generieren¶
Wenn Sie in Odoo ein Angebot erstellen, fügen Sie den Versand und das Envia.com-Versandprodukt hinzu. Validieren Sie dann die Lieferung. Versandetikettdokumente werden automatisch im Chatter generiert, die Folgendes enthalten:
Versandetikett(en) je nach Anzahl der Pakete.
Rücksendeetikett(en), wenn der Envia.com-Konnektor für Rücksendungen konfiguriert ist.
Wichtig
Wenn Etiketten erstellt werden, belastet Envia.com automatisch das konfigurierte Konto und der Endbetrag wird im Chatter protokolliert. Bei Transaktionen mit mehreren Währungen wird der protokollierte Betrag anhand des Odoo-Tarifs berechnet. Die tatsächlichen Kurse können variieren.
Außerdem ist jetzt die Sendungsverfolgungsnummer verfügbar.
Bemerkung
Die brasilianischen Behörden können die Rechnung für den Versand (NFe) anfordern. Es wird empfohlen, die Rechnung der Bestellung zusammen mit dem Etikett beizufügen.
Internationaler Versand¶
Für internationale Sendungen müssen sowohl der HS-Code als auch das Land der Herkunft der Waren ausgefüllt werden. Beide Angaben finden Sie im Reiter Lager des Produkts.
LTL-Sendungen¶
LTL-Versandetiketten können über den Envia-Konnektor erstellt werden. Die Versicherung für LTL-Sendungen basiert auf dem Versicherungssatz, der im Formular für die Versandart angegeben ist.
Wichtig
Für Mexiko muss ein Konnossement für die Sendung erstellt werden. Odoo muss daher den UNSPSC-Code des Inhalts sowie eine Maßeinheit für den Transport senden, die standardmäßig X8A - Pallet de madera lautet.
Bemerkung
Zusätzliche Dienstleistungen sind verfügbar, wenn Sie Palette
als Envia-Pakettyp für die Liefermethode auswählen. Dadurch können Sie zusätzliche Dienstleistungen wie Hebehilfe und Lieferungen am Wochenende auswählen.
Sendungsverfolgung und Stornierung¶
Sendungen, die bei Envia registriert sind, können über die Schaltfläche Sendungsverfolgung im Lieferauftrag oder über den Tracking-Link im Kundenportal verfolgt werden.

FAQ¶
Messung des Volumengewichts¶
Viele Transportunternehmen messen das Gewicht auf verschiedene Weise. Es gibt das tatsächliche Gewicht der Produkte im Paket, und es gibt das Volumengewicht. Das Volumengewicht ist das Volumen, das ein Paket während des Transports einnimmt, d. h. es ist die physische Größe eines Pakets.
Bemerkung
Aufgrund des Volumengewichts ist es möglich, dass das tatsächliche Gewicht auf dem Etikett höher als der berechnete Wert ist.
Welche Druckoptionen stehen zur Verfügung?¶
Stellen Sie auf Envia.com in
(Einstellungen –> Druckoptionen und Druckoptionen für Zusteller` für jeden angezeigten Zusteller sicher, dass Sie das richtige Format für den ausgewählten Zusteller verwenden.Der gewünschte Dienst ist nicht verfügbar¶
Vergewissern Sie sich, dass alle verfügbaren Zusteller über Envia aktiviert sind.
Wer zahlt die Zollabgaben?¶
Es ist wichtig sicherzustellen, dass bei Exporten in andere Länder die Einstellungen des Zustellers von Envia verwendet werden, um festzulegen, ob die Zahlung vom Absender oder vom Empfänger erfolgt.
Was ist ein „Envia-Fehler“?¶
Diese Meldung erscheint, wenn in Envia ein Fehler auftritt. In dieser Meldung wird angegeben, was auf ihrer Plattform schiefgelaufen ist, damit das Problem behoben werden kann.