Przewodnik użytkownika

download Instalacja

Wymagania wstępne

• Przeglądarka: Google Chrome (lub dowolna przeglądarka oparta na Chromium) z włączonymi rozszerzeniami.
• Odoo: Odoo 14–19+, na Odoo Online (*.odoo.com) lub Odoo.sh, z kontem użytkownika, do którego możesz się zalogować.
• Shopify: Sklep Shopify połączony z Odoo za pomocą obsługiwanego konektora (aktualnie Emipro).

Instalacja rozszerzenia

1. Otwórz stronę Chrome Web Store
   Przejdź do strony Odoo–Shopify Order Check w Chrome Web Store.
2. Dodaj do Chrome
   Kliknij "Dodaj do Chrome" i potwierdź monit. Rozszerzenie instaluje się w kilka sekund.
3. Przypnij ikonę (opcjonalne)
   Przypnij rozszerzenie do paska narzędzi, aby wyskakujące okienko ustawień było zawsze dostępne jednym kliknięciem.
4. Zaloguj się do Odoo
   Otwórz swoją instancję Odoo w tej samej przeglądarce i zaloguj się. To jedyny krok potrzebny przed rozpoczęciem porównywania zamówień.

rocket_launch Pierwsze kroki

Nic nie wymaga konfiguracji. Gdy rozszerzenie jest zainstalowane i jesteś zalogowany do Odoo, otwórz zamówienie, a porównanie pojawi się automatycznie.

1. Zaloguj się do Odoo
   Otwórz swoją instancję Odoo i zaloguj się jak zwykle. Rozszerzenie odczytuje Twoją aktywną sesję, aby wykryć instancję i bazę danych — bez klucza API, bez wpisywania adresu URL.
2. Otwórz zamówienie
   Otwórz dowolne zamówienie sprzedaży w Odoo (lub pasujące zamówienie w Shopify). Rozszerzenie automatycznie je wykrywa i wstrzykuje panel porównania.
3. Odczytaj werdykt
   Panel wyświetla globalny werdykt zgodności lub niezgodności, a następnie umożliwia rozwinięcie szczegółowego zestawienia pole po polu na żądanie.

verified Odczytywanie werdyktu

Górna część panelu daje Ci pojedynczy, natychmiastowy werdykt dla zamówienia:

• Zgodność: Odoo i Shopify zgadzają się co do zamówienia. Nie znaleziono rozbieżności w porównywanych polach.
• Niezgodność: Co najmniej jedno pole różni się między dwoma systemami. Zestawienie dokładnie wskazuje co i gdzie.
• Nie można porównać: Rozszerzenie nie mogło zbudować porównania — na przykład sesja Odoo wygasła lub zamówienie nie jest jeszcze połączone z Shopify. Panel informuje, co należy zrobić.

Rozwijanie szczegółów

Werdykt pojawia się natychmiast; zestawienie jest dostępne na żądanie. Rozwiń panel, aby zobaczyć każde porównane pole, wartość po każdej stronie i sekcję kontekstu z informacjami wyjaśniającymi różnicę bez klasyfikowania jej jako błędu.

dashboard Zestawienie rozbieżności

W przypadku niezgodności zestawienie pokazuje pole po polu, gdzie Odoo i Shopify się różnią:

• Kwoty łączne: Łączna kwota zamówienia porównana z kwotą netto zafakturowaną w Odoo (patrz następna sekcja, aby dowiedzieć się dlaczego).
• Podatki: Kwoty podatkowe po każdej stronie. W zamówieniach porównywanych z kwotą zafakturowaną podstawa opodatkowania i podatki mogą być w tej wersji oznaczone jako nieporównywalne.
• Ilości: Ilości na pozycję. Zafakturowana ilość w Odoo jest traktowana jako autorytatywna w stosunku do bieżącej ilości w Shopify.
• Pozycje zamówienia: Produkty dopasowane po SKU, z wyłączeniem artefaktów konektora (takich jak pozycje rabatu lub prezentu), aby nie pojawiały się jako pozorne różnice.
• Adresy: Adresy dostawy i rozliczeniowe, porównywane według ich znaczących części (ulica, miasto, kod pocztowy), a nie pojedynczej nazwy wyświetlanej.

swap_horiz Zafakturowane vs bieżące

Werdykt ekonomiczny porównuje bieżące zamówienie Shopify z tym, co faktycznie zostało zafakturowane w Odoo — nie z oryginalnym zamówieniem sprzedaży.

Dlaczego kwota netto zafakturowana?

Gdy zamówienie jest fakturowane, konektor zamraża zamówienie sprzedaży. Porównywanie tego zamrożonego zamówienia z zamówieniem Shopify, które od tego czasu uległo zmianie, generuje fałszywe alarmy. Zamiast tego rozszerzenie używa kwoty netto zafakturowanej w Odoo — wystawionych faktur klienta pomniejszonych o wystawione korekty — co rzeczywiście odpowiada bieżącemu stanowi Shopify.

Jak odczytywana jest każda strona

• Odoo: Łączna kwota netto zafakturowana (suma wystawionych faktur klienta pomniejszona o wystawione korekty) oraz zafakturowana ilość na pozycję jako dane autorytatywne.
• Shopify: Bieżąca kwota łączna zamówienia i bieżąca ilość na pozycję — żywe źródło prawdy o tym, co klient faktycznie posiada.

history Zwroty i anulowania

Zwroty, reklamacje i edycje zamówień rzadko oznaczają, że coś jest nie tak — to część normalnego cyklu życia zamówienia. Rozszerzenie wyświetla je jako kontekst, oddzielony od listy rozbieżności, aby nie generować fałszywych niezgodności:

• Zwroty pieniędzy: Oryginalna kwota, zastosowane zwroty i wynikowa kwota netto zafakturowana są wyświetlane razem, aby matematyka była przejrzysta.
• Zwroty towaru: Zwrot w toku jest wyświetlany jako kontekst po stronie realizacji, a nie liczony jako rozbieżność ilości.
• Edycje zamówień: Gdy zamówienie Shopify jest edytowane, historia (oryginał, zwroty, edycje) jest wyświetlana, aby uzasadniona zmiana nie wyglądała jak błąd.

Anulowane zamówienia

Gdy zamówienie jest anulowane, panel wyświetla wyraźny baner, dzięki czemu od razu rozumiesz, dlaczego liczby wyglądają tak jak wyglądają, zamiast interpretować anulowanie jako niezgodność.

business Zaczynanie od Shopify

Możesz również otworzyć porównanie z zamówienia Shopify — nie tylko z Odoo. W tym celu rozszerzenie musi wiedzieć, do której instancji Odoo należy sklep, i uczy się tego mapowania za pierwszym razem, gdy porównujesz zamówienie z Odoo.

Jak działa wyuczone mapowanie

1. Zaloguj się do Odoo i otwórz tam zamówienie raz. Rozszerzenie identyfikuje sklep i zapamiętuje, do której instancji Odoo i bazy danych jest przypisany.
2. Od tej pory otwieranie pasującego zamówienia w Shopify działa bezpośrednio — rozszerzenie już wie, gdzie szukać.
3. Mapowanie jest przechowywane lokalnie w Twojej przeglądarce; nic nie jest wysyłane nigdzie.

settings Ustawienia

Niewielka strona ustawień pozwala sprawdzić stan dostępu, zarządzać licencją i odczytać kilka danych diagnostycznych — bez opuszczania bieżącej strony.

Gdzie to znaleźć

• Wyskakujące okienko ikony rozszerzenia: Kliknij ikonę rozszerzenia na pasku narzędzi, aby otworzyć ustawienia z dowolnej karty.
• Zębatka w panelu: Otwórz zębatkę ⚙ w panelu porównania, aby zobaczyć te same ustawienia na miejscu, tuż obok przeglądanego zamówienia.

Co możesz zrobić

• Sprawdzić stan dostępu: Sprawdź, czy jesteś na bezpłatnym okresie próbnym, czy na aktywnej licencji, i ile dni okresu próbnego pozostało.
• Aktywować klucz licencyjny: Wklej klucz licencyjny Polar, aby odblokować rozszerzenie w dowolnym momencie — podczas okresu próbnego lub po jego zakończeniu.
• Zakupić plan: Przejdź prosto do płatności, aby kupić plan Starter, Growth lub Agency.
• Zarządzać subskrypcją: Otwórz hostowany portal klienta Polar, aby zmienić lub anulować subskrypcję.

Diagnostyka tylko do odczytu

Panel diagnostyki ma charakter wyłącznie informacyjny i wyświetla:

• Pozostałe dni okresu próbnego.
• Twój plan i poziom.
• Wykrytą instancję Odoo.
• Zainstalowaną wersję rozszerzenia.

credit_card Subskrypcja

Twój 14-dniowy bezpłatny okres próbny

Każda instalacja zaczyna się od 14-dniowego bezpłatnego okresu próbnego, który odblokowuje pełne rozszerzenie. Okres próbny jest śledzony lokalnie na Twoim urządzeniu w systemie opartym na zaufaniu — bez rejestracji i bez połączenia sieciowego, aby go rozpocząć.

Plany

• Starter: Obejmuje 1 instancję Odoo i 1 sklep Shopify.
• Growth: Obejmuje 1 instancję Odoo i nieograniczone sklepy Shopify.
• Agency: Obejmuje nieograniczone instancje Odoo i sklepy Shopify.

Jak kupić

1. Otwórz ustawienia z wyskakującego okienka ikony rozszerzenia lub zębatki ⚙ w panelu.
2. Wybierz Kup i wskaż plan Starter, Growth lub Agency.
3. Sfinalizuj zakup. Otrzymasz klucz licencyjny do aktywacji rozszerzenia.

Aktywacja klucza licencyjnego

1. Otwórz ustawienia i znajdź pole klucza licencyjnego.
2. Wklej klucz otrzymany po zakupie.
3. Aktywuj. Pełne rozszerzenie odblokowuje się natychmiast dla całego zespołu.

Zarządzanie lub anulowanie subskrypcji

Rozliczenia, zmiany planu i anulowanie są obsługiwane w hostowanym portalu klienta Polar — rozszerzenie jedynie tam odsyła.

1. Otwórz ustawienia z wyskakującego okienka lub zębatki w panelu.
2. Wybierz Zarządzaj subskrypcją, aby otworzyć portal klienta Polar.
3. Zmień plan, dane płatności lub anuluj z tego miejsca.

Rozszerzenie nigdy nie przechowuje Twoich danych płatniczych. Całe rozliczenie odbywa się w portalu Polar.

help Rozwiązywanie problemów

Nie wykryto sesji Odoo

Jeśli nie jesteś zalogowany do Odoo, rozszerzenie nie może wykryć Twojej instancji i wyświetla komunikat "zaloguj się do Odoo" zamiast zgadywać.

1. Otwórz swoją instancję Odoo w tej samej przeglądarce.
2. Zaloguj się jak zwykle.
3. Wróć do zamówienia — panel automatycznie wykryje Twoją sesję.

Zamówienie niepołączone z Shopify

• To nie jest zamówienie Shopify: Jeśli zamówienie nie ma odpowiednika w Shopify, nie ma nic do porównania i panel po cichu ustępuje.
• Najpierw otwórz z Odoo: Gdy zaczynasz od sklepu Shopify, którego rozszerzenie jeszcze nie widziało, otwórz zamówienie w Odoo raz, aby mogło nauczyć się mapowania sklepu na instancję.

Instancja nie wykryta

• Sesja wygasła: Jeśli Twoja sesja Odoo wygasła, zaloguj się ponownie i otwórz zamówienie.
• Nieobsługiwany hosting: Automatyczne wykrywanie w tej wersji obejmuje Odoo Online (*.odoo.com) i Odoo.sh. Odoo na w pełni niestandardowej domenie nie jest jeszcze obsługiwane.

Panel nie pojawia się

1. Odśwież stronę: Odśwież kartę zamówienia, aby content script uruchomił się ponownie i wykrył zamówienie.
2. Sprawdź, czy rozszerzenie jest włączone: Otwórz chrome://extensions i upewnij się, że Odoo–Shopify Order Check jest włączone.

quiz Często zadawane pytania

Ogólne

Subskrypcja

Prywatność i bezpieczeństwo

support Uzyskiwanie pomocy

Kontakt z pomocą techniczną

Jeśli coś nie działa lub masz pytanie, skontaktuj się z nami, a pomożemy:

• E-mail: odoointegrations.team@gmail.com
• Podaj wersję rozszerzenia (widoczną w diagnostyce ustawień).
• Zrzuty ekranu panelu i zamówienia znacznie przyspieszą udzielenie pomocy.