Przejdź do głównej treści
Shopee Marketplace Connector

Uruchomienie Shopee Marketplace Connector (APAC) w Odoo: pola, mapowania i pierwszy tydzień

Aby uruchomić Shopee Marketplace Connector (APAC), tworzysz w Odoo konto marketplace z firmą, magazynem, Partner ID / App Key, Shop ID i Partner Key swojej aplikacji Shopee, wybierasz środowisko i ustalasz, od kiedy zamówienia mają stawać się ofertami. Potem łączysz kategorie i atrybuty Odoo z tymi z Shopee, a w pierwszym tygodniu przeglądasz logi synchronizacji, konflikty i kolejkę. Poniżej znajdziesz kroki po kolei i znaczenie każdego pola.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 4 listopada 2026

Najważniejsze

Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
4 min

Co przygotować przed otwarciem Odoo

Konto marketplace w module wymaga danych z Shopee oraz danych z Twojej organizacji. Warto zebrać je przed startem:

  • partner_id Twojej aplikacji Shopee i jej partner key, które znajdziesz w Shopee Open Platform > App list.
  • shop_id sklepu, który chcesz podłączyć.
  • Jeśli chcesz najpierw testować: testowy partner ID i klucz aplikacji oraz testowy sklep Shopee.
  • Firmę w Odoo, która będzie właścicielem konta, oraz magazyn, z którego będziesz synchronizować stany.
  • Adresy e-mail, na które mają trafiać powiadomienia.

Moduł jest dostępny w Odoo Apps dla wersji 17, 18, 19 i 20 i według karty każdej wersji jest darmowy we wszystkich (jednorazowa płatność za wersję, netto (bez VAT)). Znajdziesz go na karcie w Odoo Apps i na stronie modułu.

Kroki zakładania konta Shopee

Każdy krok odpowiada jednemu polu konta marketplace. Nazwy podajemy dokładnie tak, jak w module.

  1. Wpisz Account Name, czyli nazwę konta.
  2. Wybierz Company. Moduł izoluje konta według firm: każda firma ma własne konfiguracje marketplace.
  3. Wskaż Default Fulfillment Warehouse. To domyślny magazyn do synchronizacji stanów, który można zmienić dla poszczególnych produktów.
  4. Wybierz Shopee Environment. W trybie Sandbox używane są testowy partner ID i klucz aplikacji oraz testowe sklepy Shopee.
  5. Uzupełnij Partner ID / App Key wartością partner_id z Shopee, a Shop ID wartością shop_id sklepu.
  6. Wklej do Partner Key partner key aplikacji. Według opisu pola to on podpisuje każde wywołanie.
  7. Użyj linku Connect Shopee shop. Moduł zapisuje w Authorization State losową wartość z ostatnio wygenerowanego linku i sprawdza ją, gdy Shopee odsyła sprzedawcę z powrotem. Konto ma też pola OAuth Access Token, OAuth Refresh Token i Access Token Expires.
  8. Ustaw Create Sales Orders From. Zamówienia złożone w Shopee przed tym momentem są wstrzymywane (Held Orders) zamiast zamieniać się w oferty.
  9. Dostosuj Sync Frequency (minutes), czyli interwał odpytywania o zamówienia i stany, od 5 do 60 minut.
  10. Ustaw Low Stock Threshold (units): poniżej tego poziomu moduł wysyła alert o niskim stanie. Jeśli zaznaczysz też Auto-Create PO on Low Stock, tworzy szkic zamówienia zakupu, gdy zapasy spadną poniżej progu.
  11. W Alert Email Recipients wpisz rozdzielone przecinkami adresy, na które trafią alerty synchronizacji, podsumowanie i powiadomienia o błędach.
  12. Wybierz strategię Auto-Conflict Resolution dla wykrytych konfliktów oraz Conflict Detection Threshold (%), czyli procent różnicy, od którego wykrywany jest konflikt.
  13. Gdy wszystko powyżej jest sprawdzone, zaznacz Enable Sync, które włącza lub wyłącza wszystkie synchronizacje konta.

Pole API Key widnieje na koncie, ale jego własny opis mówi, że Shopee go nie używa.

Mapowanie kategorii, atrybutów i produktów

Konto ma trzy powiązania między Odoo a Shopee: Category Mappings, Attribute Mappings i Product Mappings.

Kategorie

W Category Mappings łączysz kategorię z Odoo z kategorią z Shopee. Każdy wiersz zawiera Marketplace Account, Odoo Category, Marketplace Category ID (category_id z Shopee) i Marketplace Category Name, czytelną nazwę, którą moduł zapisuje do wyświetlania. Kolumna Created pokazuje, kiedy wiersz utworzono.

Lista mapowań kategorii z kolumnami Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name i Created
Lista mapowań kategorii, jeszcze bez rekordów, z przyciskiem Nowy i paskiem wyszukiwania.

Atrybuty

W Attribute Mappings łączysz atrybut z Odoo (Odoo Attribute, np. kolor, rozmiar lub marka) z kluczem atrybutu marketplace w Marketplace Attribute Key. Każdy wiersz ma też swoje Marketplace Account i datę Created.

Produkty

W Product Mappings przechowywane są powiązania między każdym produktem w Odoo a jego ID produktu w marketplace. Poniższa sekwencja pokazuje przykładowy rekord konta Shopee SG ze statusem Synced.

Lista mapowań produktów z rekordem Shopee SG w statusie Synced, lista kont marketplace i pusta lista mapowań atrybutów
Przegląd przykładowego mapowania produktu, listy kont z danymi testowymi i listy mapowań atrybutów, jeszcze bez rekordów.

Jeśli chcesz zobaczyć, jak te elementy współpracują od środka, opisujemy to w artykule jak działa konektor od środka.

Co sprawdzać w pierwszym tygodniu

Po włączeniu synchronizacji na początku warto codziennie zaglądać do tych miejsc konta:

  • Sync Logs: dziennik audytowy interakcji z API.
  • Sync Conflicts: wykryte konflikty czekające na rozwiązanie. Przejrzyj oczekujące konflikty i w razie potrzeby dostosuj strategię Auto-Conflict Resolution lub Conflict Detection Threshold (%).
  • Sync Queue: wewnętrzna kolejka asynchronicznych zadań synchronizacji.
  • Wstrzymane zamówienia: jeśli widzisz zamówienia w Held Orders, sprawdź, czy data w Create Sales Orders From jest tą, o którą chodziło.
  • Token: sprawdź datę Access Token Expires na koncie.
  • Niski stan: jeśli włączyłeś Auto-Create PO on Low Stock, odszukaj szkice zamówień zakupu i upewnij się, że Low Stock Threshold (units) ma sens dla Twoich produktów.
  • E-mail: potwierdź, że adresy w Alert Email Recipients są poprawnie wpisane i rozdzielone przecinkami.

Moduł zawiera też listy podsumowania i raportów wydajności. Na zrzutach ekranu nie mają jeszcze danych:

Lista podsumowania panelu marketplace z kolumnami Company, Total Reve…, Total Or…, Critical… i Major E…
Lista podsumowania panelu, jeszcze bez danych.
Lista raportów wydajności z kolumnami Company, Marketplace, Product Category, Date From i Date To
Lista raportów wydajności, jeszcze bez rekordów.

Jeśli w tych dniach pojawi się niezrozumiały komunikat, dosłowne treści i sposób naprawy znajdziesz w komunikatach błędów konektora.

Jak pomaga FlexigoTech

W FlexigoTech wdrażamy Odoo 17, 18, 19 i 20 oraz tworzymy konektory i integracje na zamówienie. Jeśli chcesz, żebyśmy przejrzeli konfigurację konta Shopee, mapowania albo integrację, której moduł nie obejmuje, napisz do nas ze strony modułu.

Czytaj dalej

Błędy Shopee Marketplace Connector (APAC): kiedy pojawia się każdy komunikat i co zrobićCo oznacza każdy komunikat błędu Shopee Marketplace Connector (APAC) w Odoo, kiedy się pojawia i co zrobić, na zmyślonym przykładzie i z dosłownymi tekstami.Jak działa Leroy Merlin Connector w Odoo: menu, zaplanowane akcje i przegląd ekranówJakie menu dodaje Leroy Merlin Connector w Odoo, jakie dziesięć zaplanowanych akcji uruchamia i jak często oraz co przechodzi przez FlexigoTech Cloud.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła