Benutzerhandbuch

Alles, was Sie brauchen, um Odoo–Shopify Order Check zu installieren und das Urteil sicher zu lesen.

download Installation

Voraussetzungen

  • Browser: Google Chrome (oder ein beliebiger Chromium-basierter Browser) mit aktivierten Erweiterungen.
  • Odoo: Odoo 14–19+, auf Odoo Online (*.odoo.com) oder Odoo.sh, mit einem Benutzerkonto, bei dem Sie sich anmelden können.
  • Shopify: Ein Shopify-Shop, der über einen unterstützten Connector (derzeit Emipro) mit Odoo verbunden ist.

Erweiterung installieren

  1. Chrome Web Store-Seite öffnen
    Rufen Sie die Seite von Odoo–Shopify Order Check im Chrome Web Store auf.
  2. Zu Chrome hinzufügen
    Klicken Sie auf „Zu Chrome hinzufügen“ und bestätigen Sie die Abfrage. Die Erweiterung ist in wenigen Sekunden installiert.
  3. Symbol anheften (optional)
    Heften Sie die Erweiterung an Ihre Symbolleiste an, damit das Einstellungs-Popup jederzeit mit einem Klick erreichbar ist.
  4. Bei Odoo anmelden
    Öffnen Sie Ihre Odoo-Instanz im selben Browser und melden Sie sich an. Das ist der einzige Schritt, bevor Sie mit dem Auftragsvergleich beginnen können.
Nur lesend und sicher. Die Erweiterung schreibt niemals in Odoo oder Shopify. Sie liest ausschließlich Auftragsdaten für den Vergleich – daher ist sie auch auf Produktivsystemen unbedenklich.

rocket_launch Erste Schritte

Es ist keine Konfiguration erforderlich. Sobald die Erweiterung installiert und Sie in Odoo angemeldet sind, öffnen Sie einen Auftrag – der Vergleich erscheint automatisch.

  1. Bei Odoo anmelden
    Öffnen Sie Ihre Odoo-Instanz und melden Sie sich wie gewohnt an. Die Erweiterung liest Ihre aktive Sitzung, um Instanz und Datenbank zu erkennen – kein API-Schlüssel, keine URL-Eingabe erforderlich.
  2. Auftrag öffnen
    Öffnen Sie einen Verkaufsauftrag in Odoo (oder den entsprechenden Auftrag in Shopify). Die Erweiterung erkennt ihn automatisch und blendet ein Vergleichspanel ein.
  3. Urteil lesen
    Das Panel zeigt ein globales Übereinstimmungs- oder Abweichungsurteil und ermöglicht es Ihnen, die feldgenaue Analyse auf Abruf zu erweitern.
Keine Konfiguration. Es müssen keine Instanzen registriert, keine API-Schlüssel eingefügt und keine Optionsseite aufgerufen werden. Instanz und Datenbank stammen direkt aus Ihrer Odoo-Browsersitzung, cookie-first.
Netzwerkzugriff im Hintergrund. Alle Netzwerkanfragen laufen im Service Worker der Erweiterung. Das Shopify-Admin-Token wird über den Connector aus Odoo gelesen, ausschließlich im Arbeitsspeicher gehalten und weder gespeichert noch der Seite zugänglich gemacht.

verified Das Urteil lesen

Im oberen Bereich des Panels erhalten Sie auf einen Blick ein eindeutiges Urteil für den Auftrag:

  • Übereinstimmung: Odoo und Shopify stimmen für den Auftrag überein. In den verglichenen Feldern wurden keine Abweichungen gefunden.
  • Abweichung: Mindestens ein Feld unterscheidet sich zwischen den beiden Systemen. Die Übersicht zeigt genau, was und wo.
  • Vergleich nicht möglich: Die Erweiterung konnte keinen Vergleich erstellen – zum Beispiel ist Ihre Odoo-Sitzung abgelaufen oder der Auftrag ist noch nicht mit Shopify verknüpft. Das Panel teilt Ihnen den nächsten Schritt mit.

Details einblenden

Das Urteil erscheint sofort; die Aufschlüsselung erfolgt auf Abruf. Erweitern Sie das Panel, um alle verglichenen Felder, den Wert auf jeder Seite und einen Kontextbereich für alles zu sehen, das eine Differenz erklärt, ohne ein Fehler zu sein.

dashboard Die Abweichungsübersicht

Bei einer Abweichung zeigt die Übersicht Feld für Feld, wo Odoo und Shopify voneinander abweichen:

  • Gesamtbeträge: Der Auftragsbetrag, verglichen mit Odoos netto fakturiertem Betrag (warum das so ist, erklärt der nächste Abschnitt).
  • Steuern: Steuerbeträge auf beiden Seiten. Bei Aufträgen, die gegen den fakturierten Gesamtbetrag verglichen werden, können Steuerbemessungsgrundlage und Steuern in dieser Version als nicht vergleichbar markiert sein.
  • Mengen: Mengen pro Position. Odoos fakturierte Menge gilt als maßgeblich gegenüber der aktuellen Menge in Shopify.
  • Auftragspositionen: Produkte werden per SKU abgeglichen; Connector-Artefakte (z. B. Rabatt- oder Geschenkpositionen) werden ausgeschlossen, damit sie nicht als Phantomabweichungen erscheinen.
  • Adressen: Liefer- und Rechnungsadressen, verglichen anhand ihrer relevanten Bestandteile (Straße, Ort, Postleitzahl) und nicht anhand eines einzigen Anzeigenamens.
Schweregrad. Jede Abweichung wird gewichtet, sodass eine Differenz auf Rundungsebene nicht gleich bewertet wird wie eine fehlende Position oder ein falscher Gesamtbetrag. Das Urteil spiegelt die schwerwiegendste gefundene Abweichung wider.

swap_horiz Fakturiert vs. aktuell

Das wirtschaftliche Urteil vergleicht den aktuellen Shopify-Auftrag mit dem tatsächlich in Odoo fakturierten Betrag – nicht mit dem ursprünglichen Verkaufsauftrag.

Warum der netto fakturierte Betrag?

Wenn ein Auftrag fakturiert wird, friert der Connector den Verkaufsauftrag ein. Den eingefrorenen Auftrag mit einem inzwischen geänderten Shopify-Auftrag zu vergleichen, erzeugt falsch-positive Ergebnisse. Stattdessen verwendet die Erweiterung Odoos netto fakturierten Betrag – gebuchte Kundenrechnungen abzüglich gebuchter Gutschriften –, der tatsächlich dem aktuellen Zustand in Shopify entspricht.

Wie jede Seite ausgelesen wird

  • Odoo: Netto fakturierter Gesamtbetrag (Summe gebuchter Kundenrechnungen abzüglich gebuchter Gutschriften) und die fakturierte Menge je Position als maßgebliche Größe.
  • Shopify: Der aktuelle Auftragsbetrag und die aktuelle Menge je Position – die lebende Wahrheitsquelle für das, was der Kunde tatsächlich hat.
Noch nicht fakturiert? Wenn für den Auftrag keine gebuchten Rechnungen vorliegen, fällt die Erweiterung auf den Vergleich der bestellten Beträge zurück und kennzeichnet das Urteil als vorläufig, damit Sie wissen, dass eine Rechnung es später konkretisieren wird.

history Rückerstattungen, Retouren & Stornierungen

Rückerstattungen, Retouren und Auftragsänderungen bedeuten selten, dass etwas nicht stimmt – sie gehören zum normalen Auftragslebenszyklus. Die Erweiterung zeigt sie als Kontext, getrennt von der Abweichungsliste, damit keine falschen Abweichungen ausgelöst werden:

  • Rückerstattungen: Der ursprüngliche Betrag, die angewandten Rückerstattungen und der resultierende netto fakturierte Betrag werden gemeinsam angezeigt, damit die Rechnung transparent ist.
  • Retouren: Eine laufende Retoure wird als Kontext auf der Lieferseite angezeigt und nicht als Mengenabweichung gezählt.
  • Auftragsänderungen: Wenn ein Shopify-Auftrag bearbeitet wird, wird der Verlauf (Original, Rückerstattungen, Änderungen) angezeigt, damit eine legitime Änderung nicht wie ein Fehler aussieht.

Stornierte Aufträge

Wenn ein Auftrag storniert wird, zeigt das Panel ein deutliches Banner, damit Sie sofort verstehen, warum die Zahlen so aussehen, wie sie aussehen, anstatt die Stornierung als Abweichung zu lesen.

Kontext, keine Abweichungen. Alles in diesem Abschnitt ist informativ. Es erklärt Unterschiede; es fließt für sich allein niemals in das Übereinstimmungs- oder Abweichungsurteil ein.

business Start von Shopify aus

Sie können den Vergleich auch von einem Shopify-Auftrag aus starten – nicht nur von Odoo aus. Dazu muss die Erweiterung wissen, zu welcher Odoo-Instanz der Shop gehört, und erlernt diese Zuordnung beim ersten Mal, wenn Sie den Auftrag von Odoo aus vergleichen.

So funktioniert die erlernte Zuordnung

  1. Melden Sie sich bei Odoo an und öffnen Sie den Auftrag dort einmal. Die Erweiterung löst den Shop auf und merkt sich, welcher Odoo-Instanz und Datenbank er zugeordnet ist.
  2. Von da an funktioniert das Öffnen des entsprechenden Auftrags in Shopify direkt – die Erweiterung weiß bereits, wo sie suchen muss.
  3. Die Zuordnung wird lokal in Ihrem Browser gespeichert; es werden keine Daten weitergeleitet.
Shop noch nicht erlernt? Wenn Sie einen Shopify-Auftrag eines Shops öffnen, den die Erweiterung noch nicht über Odoo kennengelernt hat, fordert sie Sie auf, den Auftrag zuerst in Odoo zu öffnen, anstatt zu raten. Sobald die Zuordnung erlernt wurde, funktionieren Vergleiche direkt aus Shopify problemlos.

settings Einstellungen

Eine übersichtliche Einstellungsseite zeigt Ihren Zugangsstatus, ermöglicht die Lizenzverwaltung und zeigt einige Diagnoseinformationen – ohne die aktuelle Seite zu verlassen.

Wo Sie die Einstellungen finden

  • Erweiterungssymbol-Popup: Klicken Sie auf das Erweiterungssymbol in Ihrer Symbolleiste, um die Einstellungen von jedem Tab aus zu öffnen.
  • Zahnrad im Panel: Öffnen Sie das ⚙-Zahnrad im Vergleichspanel, um dieselben Einstellungen direkt neben dem betrachteten Auftrag aufzurufen.

Was Sie tun können

  • Zugangsstatus prüfen: Sehen Sie, ob Sie sich in der kostenlosen Testphase oder mit einer aktiven Lizenz befinden, und wie viele Testtage noch verbleiben.
  • Lizenzschlüssel aktivieren: Fügen Sie einen Polar-Lizenzschlüssel ein, um die Erweiterung jederzeit freizuschalten – während der Testphase oder danach.
  • Plan kaufen: Direkt zur Kasse, um einen Starter-, Growth- oder Agency-Plan zu kaufen.
  • Abonnement verwalten: Öffnen Sie das gehostete Kundenportal von Polar, um Ihr Abonnement zu ändern oder zu kündigen.

Nur lesende Diagnose

Das Diagnosepanel ist rein informativ und zeigt:

  • Verbleibende Testtage.
  • Ihren Plan und Tier.
  • Die erkannte Odoo-Instanz.
  • Die installierte Erweiterungsversion.

credit_card Abonnement

Ihre 14-tägige kostenlose Testphase

Jede Installation startet mit einer 14-tägigen kostenlosen Testphase, die die vollständige Erweiterung freischaltet. Die Testphase wird lokal auf Ihrem Gerät nach dem Ehrensystem verfolgt – keine Anmeldung und kein Netzwerkaufruf zum Starten.

Pläne

  • Starter: Deckt 1 Odoo-Instanz und 1 Shopify-Shop ab.
  • Growth: Deckt 1 Odoo-Instanz und unbegrenzte Shopify-Shops ab.
  • Agency: Deckt unbegrenzte Odoo-Instanzen und Shopify-Shops ab.

So kaufen Sie

  1. Öffnen Sie die Einstellungen über das Erweiterungssymbol-Popup oder das ⚙-Zahnrad im Panel.
  2. Wählen Sie Kaufen und den Plan Starter, Growth oder Agency.
  3. Schließen Sie den Kauf ab. Sie erhalten einen Lizenzschlüssel zur Aktivierung der Erweiterung.

Lizenzschlüssel aktivieren

  1. Öffnen Sie die Einstellungen und suchen Sie das Lizenzschlüsselfeld.
  2. Fügen Sie den nach dem Kauf erhaltenen Schlüssel ein.
  3. Aktivieren. Die vollständige Erweiterung wird sofort für Ihr gesamtes Team freigeschaltet.
Unternehmensweites Abonnement. Ein Abonnement deckt Ihr gesamtes Unternehmen ab — derselbe Lizenzschlüssel funktioniert im ganzen Team, ohne Limit pro Nutzer. Die Pläne unterscheiden sich nur im Umfang: wie viele Odoo-Instanzen und Shopify-Shops sie abdecken.

Abonnement verwalten oder kündigen

Abrechnung, Planänderungen und Kündigung werden im gehosteten Kundenportal von Polar abgewickelt – die Erweiterung verlinkt Sie lediglich dorthin.

  1. Öffnen Sie die Einstellungen über das Popup oder das Panelzahnrad.
  2. Wählen Sie „Abonnement verwalten“, um das Polar-Kundenportal zu öffnen.
  3. Aktualisieren Sie Ihren Plan, Ihre Zahlungsdaten oder kündigen Sie von dort aus.

Die Erweiterung speichert niemals Ihre Zahlungsdaten. Die gesamte Abrechnung liegt im Portal von Polar.

help Fehlerbehebung

Keine Odoo-Sitzung erkannt

Wenn Sie nicht bei Odoo angemeldet sind, kann die Erweiterung Ihre Instanz nicht erkennen und zeigt statt einer Vermutung eine handlungsorientierte Meldung „Bei Odoo anmelden“ an.

  1. Öffnen Sie Ihre Odoo-Instanz im selben Browser.
  2. Melden Sie sich wie gewohnt an.
  3. Kehren Sie zum Auftrag zurück – das Panel übernimmt Ihre Sitzung automatisch.

Auftrag nicht mit Shopify verknüpft

  • Kein Shopify-Auftrag: Wenn der Auftrag kein Shopify-Pendant hat, gibt es nichts zu vergleichen, und das Panel zieht sich still zurück.
  • Zuerst von Odoo aus öffnen: Wenn Sie von einem Shopify-Shop starten, den die Erweiterung noch nicht gesehen hat, öffnen Sie den Auftrag einmal in Odoo, damit sie die Shop-zu-Instanz-Zuordnung erlernen kann.

Instanz nicht erkannt

  • Sitzung abgelaufen: Wenn Ihre Odoo-Sitzung abgelaufen ist, melden Sie sich erneut an und öffnen Sie den Auftrag erneut.
  • Nicht unterstütztes Hosting: Die automatische Erkennung zielt in dieser Version auf Odoo Online (*.odoo.com) und Odoo.sh ab. Odoo auf einer vollständig eigenen Domain wird noch nicht unterstützt.

Das Panel erscheint nicht

  1. Seite neu laden: Aktualisieren Sie den Auftrags-Tab, damit der Content Script erneut ausgeführt wird und den Auftrag neu erkennt.
  2. Prüfen Sie, ob die Erweiterung aktiviert ist: Öffnen Sie chrome://extensions und bestätigen Sie, dass Odoo–Shopify Order Check eingeschaltet ist.
Immer noch nicht gelöst? Die Diagnose in den Einstellungen zeigt die erkannte Odoo-Instanz und Ihre Erweiterungsversion – praktische Details, die Sie beim Kontakt mit dem Support angeben sollten.

quiz Häufig gestellte Fragen

Allgemein

Was macht Odoo–Shopify Order Check?

Wenn Sie einen Auftrag in Odoo oder Shopify öffnen, vergleicht die Erweiterung beide Systeme Feld für Feld – Gesamtbeträge, Steuern, Mengen, Positionen und Adressen – und zeigt ein globales Übereinstimmungs- oder Abweichungsurteil mit einer Aufschlüsselung aller Abweichungen.

Ändert sie etwas in Odoo oder Shopify?

Nein. Die Erweiterung ist ausschließlich lesend. Sie erstellt, bearbeitet oder löscht niemals Daten in einem der beiden Systeme – sie liest nur, also ist sie auch auf Produktivsystemen unbedenklich.

Muss ich etwas konfigurieren?

Nein. Die Erweiterung erkennt Ihre Odoo-Instanz und Datenbank automatisch aus Ihrer aktiven Sitzung. Es gibt keine zu registrierenden Instanzen, keine API-Schlüssel und keine Optionsseite.

Abonnement

Gibt es eine kostenlose Testphase?

Ja. Jede Installation enthält eine 14-tägige kostenlose Testphase mit vollem Funktionsumfang. Nach der Testphase stehen die Pläne Starter, Growth und Agency zur Verfügung — jeder deckt Ihr gesamtes Team ab und richtet sich danach, wie viele Odoo-Instanzen und Shopify-Shops er umfasst.

Wie kündige ich?

Öffnen Sie die Einstellungen, wählen Sie „Abonnement verwalten“ und kündigen Sie im gehosteten Kundenportal von Polar. Die Erweiterung verlinkt Sie lediglich dorthin; sie speichert niemals Zahlungsdaten.

Datenschutz & Sicherheit

Woher stammt das Shopify-Token?

Es wird über den Connector aus Odoo gelesen und ausschließlich im Arbeitsspeicher innerhalb des Service Workers der Erweiterung gehalten. Es wird niemals auf die Festplatte geschrieben und der von Ihnen angezeigten Seite niemals zugänglich gemacht.

Verlassen meine Auftragsdaten meinen Browser?

Es gibt kein Backend. Die Erweiterung liest Odoo und Shopify direkt über Ihren Browser, um den Vergleich zu erstellen, und die erlernte Shop-zu-Instanz-Zuordnung wird lokal auf Ihrem Gerät gespeichert.

support Hilfe erhalten

Support kontaktieren

Wenn etwas nicht funktioniert oder Sie eine Frage haben, melden Sie sich – wir helfen Ihnen gerne:

  • E-Mail: odoointegrations.team@gmail.com
  • Geben Sie Ihre Erweiterungsversion an (in der Einstellungsdiagnose angezeigt).
  • Screenshots des Panels und des Auftrags beschleunigen die Hilfe erheblich.