System ten tworzy pełną dwukierunkową synchronizację pomiędzy Odoo ERP a wieloma platformami sprzedażowymi (eBay, Amazon, Shopify itd.) za pośrednictwem AdlerDo. Produkty przepływają z Odoo na platformy sprzedażowe, aktualizacje stanów magazynowych są synchronizowane, a zamówienia automatycznie trafiają z powrotem do Odoo.

Architektura systemu

Odoo ERP (główne źródło danych) → AdlerDo (centrum integracji) → Platformy sprzedażowe (eBay, Amazon, Shopify itd.)

Pełny cykl integracji

• Produkty z Odoo: Wszystkie produkty są pobierane z systemu Odoo ERP i zapisywane w bazie danych AdlerDo. Obejmuje to szczegóły produktów, numery SKU, opisy, ceny oraz specyfikacje.
• Aktualizacje stanów magazynowych na platformach sprzedażowych: Stany magazynowe są pobierane z Odoo i automatycznie przesyłane na wszystkie podłączone platformy sprzedażowe (eBay, Amazon, Shopify itd.), aby zapewnić synchronizację zapasów.
• Zamówienia z platform sprzedażowych: Zamówienia klientów są przechwytywane ze wszystkich platform sprzedażowych i zapisywane w AdlerDo, a następnie automatycznie przesyłane do Odoo w celu realizacji i przetworzenia.
• Produkty przesyłane do Odoo: Aktualizacje produktów oraz nowe produkty z AdlerDo są przesyłane z powrotem do Odoo, co zamyka pełny cykl synchronizacji.

Cztery główne etapy synchronizacji

Etap 1: Produkty z Odoo do AdlerDo

Na czym polega: System pobiera wszystkie produkty z systemu Odoo ERP i zapisuje je w bazie danych AdlerDo. Tworzy to zsynchronizowany katalog produktów, który można dystrybuować na wiele platform sprzedażowych.

Jakie informacje są przenoszone?

1. Informacje o produkcie

• Nazwa i tytuł produktu
• Opis produktu
• SKU (jednostka magazynowa)
• Kod kreskowy / EAN
• Kategoria produktu

2. Ceny i koszty

• Cena sprzedaży
• Cena zakupu
• Cena katalogowa
• Waluta
• Informacje podatkowe

3. Szczegóły produktu

• Zdjęcia produktu
• Warianty produktu
• Waga i wymiary
• Atrybuty i specyfikacje
• Typ produktu

Etap 2: Aktualizacje stanów magazynowych na platformach sprzedażowych

Na czym polega: System pobiera aktualne stany magazynowe z Odoo i automatycznie aktualizuje wszystkie podłączone platformy sprzedażowe (eBay, Amazon, Shopify itd.), aby utrzymać synchronizację zapasów w czasie rzeczywistym.

Jakie informacje są przenoszone?

1. Informacje o stanach magazynowych

• Dostępna ilość
• Zarezerwowany zapas
• Mapowanie SKU produktu
• Lokalizacja magazynowa
• Informacje o magazynie

2. Aktualizacje na platformach sprzedażowych

• Aktualizacje zapasów eBay
• Stany magazynowe Amazon FBA/FBM
• Poziomy zapasów Shopify
• Stany magazynowe na innych platformach
• Obsługa wielu lokalizacji

3. Inteligentne funkcje

• Bufor zapasu bezpieczeństwa
• Zapobieganie nadmiernej sprzedaży
• Synchronizacja w czasie rzeczywistym
• Automatyczne obliczenia
• Alerty o niskim stanie magazynowym

Etap 3: Zamówienia z platform sprzedażowych do Odoo

Na czym polega: System przechwytuje wszystkie zamówienia klientów z podłączonych platform sprzedażowych, zapisuje je w AdlerDo i automatycznie tworzy odpowiadające im zamówienia sprzedaży w Odoo w celu realizacji.

Jakie informacje są przenoszone?

1. Informacje o zamówieniu

• Numer i identyfikator zamówienia
• Data i godzina zamówienia
• Pozycje zamówienia i ilości
• Numery SKU produktów
• Łączna kwota zamówienia

2. Dane klienta

• Imię i nazwisko klienta
• Adres e-mail
• Numer telefonu
• Adres dostawy
• Adres rozliczeniowy

3. Dane dodatkowe

• Metoda płatności
• Metoda wysyłki
• Uwagi do zamówienia
• Źródło (platforma sprzedażowa)
• Informacje o śledzeniu przesyłki

Etap 4: Produkty przesyłane do Odoo

Na czym polega: Aktualizacje produktów, nowe produkty oraz informacje o produktach zapisane w AdlerDo są przesyłane z powrotem do Odoo, aby utrzymać synchronizację głównej bazy danych i zamknąć cykl integracji.

Jakie informacje są przenoszone?

1. Aktualizacje produktów

• Zaktualizowane szczegóły produktu
• Zmiany cen
• Zmiany opisów
• Aktualizacje atrybutów
• Aktualizacje zdjęć

2. Nowe produkty

• Tworzenie nowych produktów w Odoo
• Warianty produktów
• Kategorie produktów
• Początkowe stany magazynowe
• Informacje o cenach

3. Funkcje synchronizacji

• Zapobieganie duplikatom
• Rozwiązywanie konfliktów
• Walidacja danych
• Obsługa błędów
• Rejestrowanie audytowe

Podsumowanie pełnego cyklu

Ten kompletny cykl synchronizacji zapewnia płynny przepływ danych we wszystkich kierunkach. Produkty przepływają z Odoo na platformy sprzedażowe, stany magazynowe są nieustannie synchronizowane, zamówienia trafiają z powrotem do Odoo, a aktualizacje produktów zamykają cykl. Wszystko odbywa się automatycznie, tworząc jednolity ekosystem obejmujący wszystkie kanały sprzedaży!

Dlaczego ten pełny cykl ma znaczenie

1. Pełna automatyzacja Kompletna dwukierunkowa synchronizacja eliminuje całe ręczne wprowadzanie danych

2. Jedno źródło prawdy Odoo pozostaje główną bazą danych wszystkich informacji o produktach

3. Synchronizacja w czasie rzeczywistym Wszystkie zmiany są natychmiast propagowane na wszystkie platformy

4. Łatwe skalowanie Dodawaj kolejne platformy sprzedażowe bez dodatkowej złożoności

AdlerDo

Pobierz tutaj

Wymagania systemowe

• RAM: 4 GB lub więcej
• CPU: 2 vCPU lub więcej
• Pamięć masowa: 40 GB SSD lub więcej

Krok 1: ASP.NET Core 8.0

Link do pobrania

https://builds.dotnet.microsoft.com/dotnet/aspnetcore/Runtime/8.0.22/aspnetcore-runtime8.0.22-win-x64.exe

Struktura projektu / pliki aplikacji

• Moduł backendu – nazwa: marketplace_api
• Moduł frontendu – nazwa: coresystem_wbf

Krok 2: Instalacja AdlerDo

• Najpierw zainstaluj Marketplace Setup Api

Zaznacz pole, aby zaakceptować licencje, a następnie kliknij Install. Następnie poczekaj na zakończenie instalacji.

• Po zakończeniu instalacji naciśnij finish.

Po instalacji koniecznie upewnij się, że usługa działa w tle.

Krok 3: Otwórz aplikację AdlerDo

• Instalacja została zakończona. Możesz teraz wprowadzić swoją nazwę użytkownika i hasło.

Dokumentacja konfiguracji integracji z platformami sprzedażowymi

Integracja kont (Podłącz i zarządzaj swoimi kontami platform sprzedażowych oraz ERP, aby zapewnić płynną sprzedaż wielokanałową)

Integracja AdlerDo:

• Podłączaj konta platform sprzedażowych (Kaufland, Shopify, PrestaShop, JTL itd.)
• Automatycznie synchronizuj produkty, stany magazynowe i zamówienia
• Zapewnij scentralizowane zarządzanie wszystkimi kanałami sprzedaży z jednego miejsca
• Oszczędzaj czas i ograniczaj błędy manualne

Etapy integracji

Krok 1: Przejdź do strony Konta

• W menu bocznym po lewej stronie kliknij „ Accounts ”.
• Otworzy się strona „ Accounts Integration ”.

Krok 2: Wybierz typ konta / platformę sprzedażową

Z menu rozwijanego „ Select ” wybierz platformę, którą chcesz zintegrować, spośród dostępnych platform sprzedażowych.

Krok 3: Wprowadzanie danych uwierzytelniających

Będziesz musiał wprowadzić następujące informacje (mogą się one nieznacznie różnić w zależności od platformy)

Krok 4: Dodaj nowe konto

• Na stronie Accounts Integration kliknij przycisk „ Add New Account ” (zielony przycisk w prawym górnym rogu strony).
• Pojawi się okno wyskakujące lub nowa strona umożliwiająca wprowadzenie danych konta.

Usuń konto

Ta funkcja pozwala odłączyć Twoje konto platformy sprzedażowej.

Po zalogowaniu się na konto pojawi się strona Adlerdo.

Czym jest zarządzanie produktami?

Ten interfejs stanowi Twoje centrum sterowania do zarządzania katalogiem produktów i stanami magazynowymi w systemie Adlerdo. Umożliwia dodawanie, edytowanie, importowanie i eksportowanie produktów, a następnie wysyłanie ich bezpośrednio na platformy sprzedażowe podłączone do Twojego konta.

1- Pasek wyszukiwania

Wyszukaj konkretny produkt, korzystając z jego nazwy, numeru SKU lub dowolnej innej informacji.

2- Sekcja wyboru platformy sprzedażowej i konta

• Select Marketplace: Menu rozwijane umożliwiające wybór platformy sprzedażowej, na której chcesz pracować (np. Amazon, Shopify, eBay itd.).
• Select Account: Menu rozwijane umożliwiające wybór konta powiązanego z tą platformą sprzedażową (przydatne, gdy masz wiele kont na tej samej platformie).
• Przycisk Send to Marketplace: Po wybraniu platformy sprzedażowej i konta kliknij ten przycisk, aby wysłać wybrane produkty na wybraną platformę.

3- Główne przyciski akcji

• Add: Aby ręcznie dodać nowy produkt
• Edit: Aby edytować szczegóły wybranych produktów (musi być zaznaczony co najmniej jeden produkt).
• Dynamic Import Product: Aby dynamicznie importować produkty z zewnętrznego źródła (np. pliku Excel lub API).
• Dynamic Import Variant: Aby dynamicznie importować warianty produktów (takie jak rozmiar, kolor itd.).
• Export: Aby wyeksportować bieżącą listę produktów do pliku (Excel lub CSV) do użytku zewnętrznego lub jako kopię zapasową

4- Opis kolumn tabeli produktów

• Name: Nazwa produktu (np. „Desk Combination”, „headcall”)
• SKU: Unikalny identyfikator produktu (jednostka magazynowa) — wymagany do synchronizacji
• Price: Cena produktu (automatycznie aktualizowana na platformach sprzedażowych po edycji).
• GTIN / MPN / ASIN / UPC: Globalne kody klasyfikacji produktów (ważne dla platform takich jak Amazon i eBay).
• TaricCoc: Europejski kod celny (jeśli dotyczy — ważny przy wysyłce międzynarodowej).
• OriginCountry: Kraj pochodzenia — wymagany przez niektóre platformy sprzedażowe
• Variants: Zielony przycisk przy każdym produkcie umożliwiający przeglądanie lub zarządzanie jego wariantami (np. kolory, rozmiary…).
• Gallery: Zielony przycisk umożliwiający przeglądanie lub dodawanie zdjęć produktu (zazwyczaj do wyświetlania na platformie sprzedażowej).

System udostępnia zaawansowane narzędzia importu i eksportu dynamicznego, które umożliwiają zarządzanie danymi produktów z maksymalną elastycznością. Funkcje te pozwalają z łatwością importować i eksportować informacje o produktach do i z dowolnego marketplace'u.

Import dynamiczny produktu

Funkcja importu dynamicznego produktu umożliwia przesyłanie danych produktów z dowolnego formatu lub struktury pliku, bez konieczności korzystania z predefiniowanego szablonu.

Kluczowe możliwości

• Obsługuje dowolny układ arkusza lub kolejność kolumn (Excel, CSV itp.).
• Automatycznie wykrywa i mapuje kolumny na pola systemowe.
• Umożliwia import dużych katalogów produktów w kilka sekund.
• Nadaje się do synchronizacji danych od dostawców lub z systemów zewnętrznych.

Jak korzystać z importu dynamicznego produktu

Krok 1 — Otwórz stronę importu

Przejdź do:

Produkty → Import → Import dynamiczny produktu

Krok 2 — Prześlij plik

• Kliknij import excel fill
• Wybierz swój plik (Excel / CSV / dowolny format)

System obsługuje dowolną strukturę kolumn — nie trzeba niczego przestawiać.

Krok 3 — Automatyczne mapowanie kolumn

Po przesłaniu:

• System automatycznie wykryje nazwy kolumn
• Zmapuje każdą kolumnę na odpowiednie pole (Nazwa, SKU, Cena, GTIN itp.)

Jeśli system nie będzie pewny co do danej kolumny, poprosi Cię o ręczny wybór właściwego pola.

Krok 4 — Sprawdź i potwierdź

Sprawdź podgląd mapowania:

• Upewnij się, że kolumny są dopasowane poprawnie
• W razie potrzeby wprowadź poprawki

Następnie kliknij Potwierdź.

Krok 5 — Prześlij

• Naciśnij prześlij.
• Twoje produkty zostaną natychmiast utworzone lub zaktualizowane.

Idealne rozwiązanie dla arkuszy dostawców, niestandardowych formatów lub eksportów z marketplace'ów.

Pobierz szablon importu

Gdy klikniesz zielony przycisk Pobierz szablon importu → system natychmiast pobierze gotowy do użycia plik Excel o nazwie Product_Import_Template.xlsx

Gdzie chcesz opublikować zaimportowane produkty?

Po zaimportowaniu produktów (czy to z pliku Excel, czy poprzez import dynamiczny) ta sekcja odpowiada za określenie, na których dokładnie marketplace'ach i kontach sprzedawcy produkty zostaną automatycznie opublikowane zaraz po zakończeniu importu. Jeśli nie wybierzesz tutaj żadnego marketplace'u ani konta → produkty zostaną dodane wyłącznie do Twojego katalogu i NIE zostaną opublikowane na żadnym marketplace.

Instrukcja krok po kroku

Krok 1

• Działanie: Z pierwszej listy rozwijanej „Wybierz marketplace" wybierz żądany marketplace.
• Oczekiwany rezultat: Druga lista rozwijana „Wybierz konto" aktualizuje się i pokazuje tylko konta powiązane z tym marketplace'em.

Krok 2

• Działanie: Z drugiej listy rozwijanej wybierz konkretne konto sprzedawcy, na którym chcesz publikować.

Krok 3

• Działanie: Kliknij pomarańczowy przycisk Dodaj do listy.
• Oczekiwany rezultat: Marketplace + konto pojawiają się w tabeli poniżej.

Krok 4

• Działanie: Powtórz kroki 1–3, aby dodać kolejne marketplace'y/konta (jeśli chcesz publikować w wielu miejscach).
• Oczekiwany rezultat: Każde nowe dodanie = zaimportowane produkty zostaną automatycznie opublikowane również na tym koncie.

Krok 5

• Działanie: Aby usunąć marketplace/konto z listy → kliknij Usuń w tabeli.
• Oczekiwany rezultat: Ten marketplace/konto nie będzie już otrzymywać zaimportowanych produktów.

Krok 6

• Działanie: Po zakończeniu → kliknij Prześlij wybrane lub Import na dole.
• Oczekiwany rezultat: Produkty zostają zaimportowane + natychmiast opublikowane na każdym marketplace i koncie wymienionym w tabeli.

Ważna uwaga

Jeśli pozostawisz tabelę pustą (bez dodanego marketplace'u ani konta), produkty zostaną zapisane wyłącznie w Twoim systemie i nie zostaną opublikowane na żadnym marketplace, dopóki nie dodasz ich ręcznie później z poziomu strony pojedynczego produktu.

Import dynamiczny wariantu

Funkcja importu dynamicznego wariantu umożliwia użytkownikom przesyłanie danych wariantów produktów z dowolnego formatu lub struktury pliku — bez konieczności korzystania z predefiniowanego szablonu.

Narzędzie to zostało zaprojektowane, aby uprościć import katalogów bogatych w warianty.

Kluczowe funkcje

• Brak wymogu stałego szablonu
• Automatyczne wykrywanie i mapowanie kolumn pliku
• Inteligentny system łączy warianty z ich produktami nadrzędnymi
• Obsługa nieograniczonej liczby atrybutów wariantów
• Idealne dla dostawców, eksportów z marketplace'ów lub systemów zewnętrznych

Jak to działa

Po pierwsze: Prześlij plik

1. Przejdź do: Produkty → Import → Import dynamiczny wariantu
2. Kliknij Prześlij plik wybierz

System akceptuje dowolną strukturę — kolumny mogą być w dowolnej kolejności.

Po drugie: Automatyczne wykrywanie kolumn

Po przesłaniu:

• System skanuje arkusz
• Wykrywa odpowiednie kolumny (SKU, SKU nadrzędny, Rozmiar, Kolor, Cena itp.)
• Automatycznie sugeruje mapowania pól

Jeśli któraś kolumna jest niejasna, system wyświetli listę rozwijaną, abyś mógł ręcznie wybrać właściwe pole.

Komponent atrybutów produktu

Ten komponent pozwala użytkownikowi przypisać atrybuty do produktu poprzez wybór nazwy atrybutu i odpowiadającej jej wartości, a następnie dodanie ich do listy.

Przeznaczenie komponentu

1. Sekcja atrybutów produktu umożliwia użytkownikowi: Wybór nazwy atrybutu, Wybór wartości atrybutu powiązanej z tą nazwą.
2. Dodanie wybranej pary do listy atrybutów
3. Zarządzanie (edycja/usuwanie) wpisami atrybutów z poziomu tabeli

Dzięki temu każdy produkt może mieć jedną lub więcej par atrybut/wartość opisujących jego warianty.

Przycisk Pobierz warianty

Przycisk Pobierz warianty umożliwia użytkownikowi pobranie gotowego pliku Excel, który zawiera szablon zaprojektowany do wprowadzania danych wariantów produktu.

Szablon ten pomaga użytkownikowi przygotować dane w odpowiednim formacie przed przesłaniem ich do systemu.

Przycisk Eksport

Przycisk Eksport umożliwia użytkownikom pobranie wszystkich produktów aktualnie wyświetlanych na ekranie Zarządzanie produktami — lub tylko wybranych produktów — w postaci przejrzystego i uporządkowanego pliku Excel.

Plik ten jest generowany natychmiast i zawiera kompletne dane produktów dokładnie w takiej formie, w jakiej są prezentowane w tabeli produktów systemu.

Gdy użytkownik kliknie Eksport, system:

Gromadzi:

• Tylko wybrane produkty (jeśli użytkownik zaznaczył konkretne wiersze).
• Generuje plik Excel zawierający uporządkowane informacje o produktach.
• Natychmiast pobiera plik na urządzenie użytkownika.

Format wyeksportowanego pliku

Wyeksportowany plik Excel zawiera wszystkie standardowe pola produktu, takie jak:

• Nazwa produktu
• SKU
• Cena
• GTIN
• MPN
• ASIN
• UPC
• Kod Taric
• Kraj pochodzenia
• Warianty (jeśli dostępne)
• Wszelkie dodatkowe niestandardowe atrybuty wyświetlane w tabeli

Plik wykorzystuje tę samą strukturę i kolumny co Twoja lista produktów w systemie, co zapewnia:

• Łatwą edycję
• Łatwy ponowny import za pomocą importu dynamicznego
• Zgodność ze wszystkimi połączonymi marketplace'ami

Strona Dodaj nowy produkt umożliwia łatwe dodawanie produktów i zarządzanie nimi na różnych marketplace'ach. Wprowadzając kluczowe dane produktu i wybierając swoje konta na marketplace'ach, możesz szybko wystawiać i aktualizować produkty na wielu platformach z jednego miejsca. Funkcja ta zapewnia bezproblemowe przesyłanie produktów, zarządzanie wariantami oraz synchronizację w czasie rzeczywistym z Twoimi kontami na marketplace'ach.

1- Kliknij zielony przycisk + Dodaj w lewym górnym rogu głównego paska działań

2- Otworzy się formularz tworzenia produktu

3- Konta marketplace'ów podczas tworzenia produktu

Konta marketplace'ów

Krok 1:

Z listy rozwijanej „Wybierz marketplace" wybierz żądany marketplace (np. Amazon)

Krok 2:

Lista rozwijana „Wybierz konto" automatycznie się odświeża i pokazuje tylko konta powiązane z wybranym marketplace'em

Krok 3:

Z listy rozwijanej „Wybierz konto" wybierz konkretne konto sprzedawcy, którego chcesz użyć

Krok 4:

Marketplace i konto są teraz wybrane

Krok 5:

Kliknij pomarańczowy przycisk Dodaj do listy

Krok 6:

Nowy wiersz natychmiast pojawi się w tabeli „Wybrane konta marketplace'ów"

4- Korzystanie krok po kroku (Jak dodawać nowe warianty i dodawać atrybut)

Krok 1:

Kliknij + Nowy wariant (zielony przycisk u góry)

Krok 2:

Wypełnij Nazwa wariantu

Krok 3:

Wprowadź unikalny SKU

Krok 4:

Ustaw Cenę i Dostępną ilość dla tego wariantu

Krok 5:

Kliknij + Dodaj atrybut → Wybierz Typ atrybutu

Krok 6:

Kliknij Zapisz produkt

Przewodnik po zarządzaniu kategoriami

Sekcja Zarządzanie kategoriami umożliwia organizowanie produktów w Twoim sklepie poprzez tworzenie, edytowanie i usuwanie kategorii.

Dostęp do strony zarządzania kategoriami

W lewym pasku bocznym kliknij Kategorie, jak pokazano na obrazku.

Zostaniesz przekierowany do strony zarządzania kategoriami, która zawiera:

1. Przycisk Dodaj do tworzenia nowej kategorii
2. Przycisk Edytuj do modyfikacji wybranej kategorii
3. Przycisk Usuń do usunięcia wybranej kategorii
4. Tabelę wyświetlającą nazwy istniejących kategorii

Krok 1: Dodawanie nowej kategorii (Dodaj kategorię)

1. Kliknij przycisk Dodaj (zielony przycisk).
2. Pojawi się formularz umożliwiający wprowadzenie szczegółów kategorii:
   Nazwa: nazwa kategorii
3. Po wprowadzeniu informacji kliknij Zapisz.
4. Nowa kategoria pojawi się natychmiast w tabeli.

Krok 2: Edytowanie kategorii (Edytuj kategorię)

Z tabeli kategorii wybierz kategorię, którą chcesz edytować (klikając na nią).

1. Kliknij przycisk Edytuj (pomarańczowy przycisk).
2. Pojawi się formularz pokazujący aktualne szczegóły kategorii.
3. Wprowadź niezbędne zmiany.
4. Kliknij Zapisz, aby zapisać zmiany.

Krok 3: Usuwanie kategorii (Usuń kategorię)

Z tabeli kategorii wybierz kategorię, którą chcesz usunąć.

1. Kliknij przycisk Usuń (czerwony przycisk).
2. Pojawi się komunikat potwierdzający usunięcie.
3. Kliknij Potwierdź, aby zakończyć proces.
4. Kategoria zostanie usunięta z listy.

Śledź zamówienia klientów i zarządzaj nimi.

Strona Zarządzanie zamówieniami umożliwia przeglądanie wszystkich zamówień klientów, sprawdzanie statusu płatności, wyświetlanie czasu utworzenia i wysyłki oraz otwieranie szczegółów każdego zamówienia.

Z paska bocznego po lewej stronie:

Kliknij Zamówienia, aby przejść do strony Zamówienia.

Wyszukiwanie zamówień

• Użyj paska wyszukiwania u góry strony, aby wyszukać zamówienie według numeru.
• Wpisz numer zamówienia, a następnie kliknij przycisk wyszukiwania (🔍).
• System wyświetli tylko te zamówienia, które pasują do wyszukiwanego hasła.

Odświeżanie danych

• Kliknij przycisk Odśwież znajdujący się w prawym górnym rogu strony.
• Ten przycisk pobiera najnowsze dane zamówień z serwera.

Tabela zamówień

Tabela wyświetla wszystkie zamówienia z następującymi kolumnami:

1- Numer zamówienia

Wyświetla unikalny numer zamówienia (np. #1057).

2- Status

Pokazuje status zamówienia (np. Opłacone).

3- Metoda płatności

Wskazuje metodę płatności użytą przez klienta (np. Karta kredytowa).

4- Czas utworzenia

Wyświetla datę i godzinę utworzenia zamówienia.

5- Czas wysyłki

Pokazuje czas wysyłki zamówienia (jeśli jest dostępny).

6- Szczegóły zamówienia

Każdy wiersz zawiera przycisk Szczegóły. Kliknięcie go umożliwia wyświetlenie pełnych szczegółów zamówienia.

Zarządzanie klientami

Sekcja Zarządzanie klientami umożliwia zarządzanie informacjami o klientach oraz relacjami z nimi w zorganizowany i prosty sposób.

Na pasku bocznym po lewej stronie kliknij Klienci, zgodnie ze wskazaniem czerwonej strzałki na obrazku.

Zostaniesz przekierowany na stronę Zarządzanie klientami, która zawiera:

• Pole wyszukiwania umożliwiające znalezienie klientów według nazwy lub numeru
• Przyciski Dodaj, Edytuj i Usuń do zarządzania informacjami o klientach
• Tabelę wyświetlającą aktualnych klientów wraz z ich nazwami i numerami, a także przycisk umożliwiający wyświetlenie adresu każdego klienta

Krok 1: Dodawanie nowego klienta (Dodaj klienta)

1. Kliknij przycisk Dodaj (zielony przycisk).
2. Pojawi się okno lub formularz do wprowadzenia danych klienta:
   • Nazwa klienta: nazwa klienta
   • Numer klienta: numer klienta
   • Inne informacje wymagane przez system (np. adres, e-mail, telefon…)
3. Po wprowadzeniu danych kliknij Zapisz, aby dodać klienta.
4. Nowy klient pojawi się w tabeli klientów.

Krok 2: Edytowanie informacji o kliencie (Edytuj klienta)

1. Wybierz z tabeli klientów klienta, którego informacje chcesz edytować (klikając jego nazwę).
2. Kliknij przycisk Edytuj (pomarańczowy przycisk).
3. Pojawi się okno z informacjami o kliencie.
4. Wprowadź niezbędne zmiany.
5. Kliknij Zapisz, aby zapisać zmiany.

Krok 3: Usuwanie klienta (Usuń klienta)

1. Wybierz z tabeli klienta, którego chcesz usunąć.
2. Kliknij przycisk Usuń (czerwony przycisk).
3. Pojawi się okno potwierdzenia usunięcia.
4. Kliknij Potwierdź, aby zakończyć usuwanie.
5. Klient zostanie usunięty z listy.

Moduł Zarządzanie wpisami dziennika umożliwia administratorom systemu monitorowanie aktywności systemu oraz rozwiązywanie problemów poprzez przeglądanie szczegółowych wpisów dziennika.

Dostęp do strony dziennika systemowego

Do strony dziennika systemowego możesz przejść z paska bocznego:

Pasek boczny → Wpisy dziennika

(Oznaczone czerwoną ramką na obrazku)

Tabela wpisów dziennika

Tabela wyświetla wszystkie wpisy dziennika systemowego z następującymi kolumnami:

• Komunikat dziennika:

  • Tekst lub typ zarejestrowanego zdarzenia (np. Warianty produktu).
  • Reprezentuje typ aktywności lub element powiązany z wpisem dziennika.

• Znacznik czasu:

  • Data i godzina zarejestrowania zdarzenia.
  • Pokazuje dokładny czas (np. 19.11.2025 13:10:40).

• Nazwa akcji:

  • Typ akcji wykonanej w systemie (np. Zmodyfikowano oznacza, że coś zostało edytowane).

• Użytkownik:

  • Nazwa użytkownika lub administratora, który wykonał akcję.

Karta Użytkownicy służy do zarządzania użytkownikami systemu poprzez dodawanie nowych użytkowników, edytowanie informacji o istniejących użytkownikach lub ich usuwanie.

Dostęp do karty Użytkownicy

Aby rozpocząć zarządzanie użytkownikami, wybierz Użytkownicy z paska bocznego. Spowoduje to otwarcie strony Użytkownicy, na której wymienieni są wszyscy użytkownicy systemu.

U góry strony znajdują się trzy przyciski do zarządzania danymi użytkowników:

Dodawanie nowego użytkownika

Kliknij przycisk Dodaj użytkownika u góry strony. Otworzy się okno z polami do wypełnienia, w tym:

• Nazwa wyświetlana
• Nazwa użytkownika
• E-mail
• Numer telefonu
• Hasło

Po wypełnieniu pól kliknij Zapisz, aby dodać nowego użytkownika do systemu.

Edytowanie istniejącego użytkownika

Wybierz z tabeli użytkownika, którego chcesz edytować, i kliknij Edytuj użytkownika. Zaktualizuj niezbędne informacje, a następnie kliknij Zapisz zmiany, aby zastosować aktualizacje.

Usuwanie użytkownika

Aby usunąć użytkownika, wybierz go z tabeli i kliknij Usuń użytkownika. Potwierdź usunięcie, aby trwale usunąć konto.

Wskazówki dotyczące zarządzania użytkownikami

• Zawsze dokładnie sprawdzaj informacje o użytkowniku przed zapisaniem zmian.
• Używaj silnych, bezpiecznych haseł dla wszystkich kont.
• Regularnie przeglądaj i usuwaj nieaktywnych lub zbędnych użytkowników, aby utrzymać porządek w systemie.

Ta strona jest poświęcona zarządzaniu przesyłkami zamówień klientów, śledzeniu ich statusu, identyfikacji firmy kurierskiej oraz przeglądaniu dat powiązanych z każdą przesyłką.

Krok 1: Otwieranie strony przesyłek

Na pasku bocznym po lewej stronie przewiń w dół, aż znajdziesz pozycję „Wysyłka”.

Kliknij ją, a otworzy się strona Zarządzanie przesyłkami, jak pokazano na obrazku.

Status wysyłki – jak z niego korzystać krok po kroku

Po pierwsze: gdzie w systemie pojawiają się statusy przesyłek

Statusy przesyłek pojawiają się na stronie Zarządzanie przesyłkami w następującym miejscu:

W menu po lewej stronie:

• Przewiń w dół, aż znajdziesz pozycję Wysyłka
• Kliknij ją

Otworzy się strona Zarządzanie przesyłkami.

W górnej części strony znajdziesz sekcję o nazwie Filtry.

Wewnątrz filtrów znajduje się lista rozwijana o nazwie: Status wysyłki

Po kliknięciu listy rozwijanej pojawią się następujące statusy:

• Oczekujące – Kliknij, aby wyświetlić przesyłki, które są nadal przygotowywane.
• Zakończone – Kliknij, aby wyświetlić przesyłki, które zostały dostarczone lub zrealizowane.
• Anulowane – Kliknij, aby wyświetlić przesyłki, które zostały anulowane.

Krok 2: Kliknij przycisk Filtruj

Po wybraniu statusu kliknij zielony przycisk Filtruj.

Krok 3: Wyświetl wyniki

Poniższa tabela zostanie zaktualizowana i wyświetli tylko te przesyłki, które odpowiadają wybranemu statusowi.

Gdzie pojawia się lista przewoźników

Na stronie Zarządzanie przesyłkami, powyżej tabeli przesyłek, znajdziesz sekcję Filtry.

W ramach filtrów znajduje się lista rozwijana zatytułowana Przewoźnik.

Funkcja listy przewoźników

Służy do wyboru firmy kurierskiej, której przesyłki chcesz wyświetlić.

Jak korzystać z listy przewoźników

Kliknij listę rozwijaną obok pozycji Przewoźnik.

Zobaczysz listę dostępnych firm kurierskich, takich jak:

• Wszystkie (aby wyświetlić wszystkie firmy)
• DHL Internetmarke
• DB Schenker Land
• DB Schenker Air
• DB Schenker Ocean FCL
• DB Schenker Ocean LCL

Wybierz firmę kurierską, której przesyłki chcesz wyświetlić.

Filtrowanie przesyłek według przewoźnika

Po wybraniu firmy kurierskiej kliknij zielony przycisk Filtruj obok list rozwijanych.

Tabela przesyłek zostanie zaktualizowana, aby wyświetlić tylko przesyłki korzystające z wybranej firmy kurierskiej.

Ważne uwagi

• Wybranie opcji Wszystkie na liście rozwijanej wyświetla przesyłki od wszystkich firm kurierskich bez filtrowania.
• Ta funkcja pomaga szybko i łatwo skupić się na przesyłkach konkretnej firmy.

Tabela informacji o przesyłce

Poniżej filtrów znajdziesz tabelę zawierającą informacje o przesyłce, która obejmuje następujące kolumny:

Ten interfejs umożliwia zarządzanie i łączenie kont różnych firm kurierskich w systemie, takich jak DHL i DB Schenker. Za jego pośrednictwem możesz dodawać nowe konta, edytować je, usuwać lub doładowywać saldo portfela wysyłkowego powiązanego z kontem.

1. Otwieranie strony kont przewoźników

Na pasku bocznym po lewej stronie:

Wybierz Konta przewoźników (zaznaczone na czerwono na obrazku).

Następnie zobaczysz listę dostępnych przewoźników w sekcji Połączone konta.

2. Dostępni przewoźnicy

W tym przykładzie pojawiają się następujące pozycje:

• DHL Internetmarke (zaznaczone na czerwono)
• DB Schenker

Po kliknięciu dowolnego przewoźnika zostaną wyświetlone jego ustawienia zarządzania.

3. Strona zarządzania kontem DHL

Po wybraniu DHL Internetmarke pojawia się strona zarządzania kontem DHL, która obejmuje:

• Dodaj konto (zielony) – Dodaj nowe konto DHL do systemu
• Edytuj konto (żółty) – Edytuj istniejące konto
• Usuń (czerwony) – Usuń konto z systemu
• Doładuj portfel konta (pomarańczowy) – Doładuj saldo portfela konta DHL

4. Tabela kont

Poniżej przycisków pojawia się tabela zawierająca zarejestrowane konta DHL.

Dostępne kolumny:

• Username: Nazwa użytkownika konta DHL
• Create Shipping List: Wskazuje, czy dla tego konta można utworzyć listę wysyłkową
• DPI: Wymagana rozdzielczość etykiety wysyłkowej
• Voucher Layout: Układ etykiety/dokumentu wysyłkowego

Obecnie tabela jest pusta, ponieważ nie dodano jeszcze żadnego konta.

Przegląd procesu

➤ Aby dodać nowe konto:

Po kliknięciu przycisku Dodaj konto w interfejsie zarządzania kontem DHL pojawia się nowe okno umożliwiające wprowadzenie informacji o nowym koncie DHL wraz z ustawieniami dotyczącymi drukowania i wysyłki.

Opis kluczowych pól

• Email i Password: Podstawowe dane logowania do konta. Muszą zostać wprowadzone dokładnie, aby zapewnić możliwość połączenia systemu z kontem DHL.
• Create Shipping List: Określa, ile list wysyłkowych zostanie utworzonych, co jest przydatne przy większej liczbie przesyłek.
• DPI: Rozdzielczość druku, która określa jakość i wyrazistość etykiet.
• Voucher Layout: Projekt lub szablon etykiety wysyłkowej, która zostanie wydrukowana.
• Page Format, Width, Height, Page Type, Orientation: Szczegółowe ustawienia kontrolujące rozmiar i układ strony do druku.
• Space X, Space Y: Odstępy między etykietami na stronie.
• Count X, Count Y: Liczba etykiet w poziomie i w pionie.
• Margin Top, Margin Left: Ustawia górny i lewy margines strony w celu kontrolowania pozycji druku.

Jak korzystać

1. Otwórz okno Dodaj nowe konto DHL, klikając przycisk Dodaj konto.
2. Wypełnij podstawowe pola (Email i Password).
3. Dostosuj ustawienia drukowania do swoich potrzeb (DPI, Voucher Layout, rozmiar strony, marginesy itp.).
4. Kliknij Zapisz lub Potwierdź (przycisk niewidoczny na obrazku, ale zwykle znajdujący się na dole formularza), aby zapisać nowe konto.
5. Po zapisaniu nowe konto pojawi się na liście kont DHL w oknie głównym.

➤ Aby edytować konto:

1. Wybierz konto z tabeli
2. Kliknij Edytuj konto
3. Zmodyfikuj wymagane informacje
4. Kliknij Zapisz

➤ Aby usunąć konto:

1. Wybierz konto z tabeli
2. Kliknij Usuń

➤ Aby doładować saldo konta:

1. Kliknij Doładuj portfel konta
2. Wprowadź kwotę doładowania
3. Potwierdź transakcję

Kroki tworzenia konta DHL (konta zapewniającego Email + Password)

Krok 1 — Wejdź na oficjalną stronę DHL

https://express-resources.dhl.com/mena-eng-sme-account-request.html

Krok 2 — Kliknij Zarejestruj się / Utwórz konto

Znajdziesz przycisk taki jak:

• Register
• Create Account
• Lub Business Login → Register

Krok 3 — Wybierz typ konta

DHL oferuje dwa typy kont:

1. Konto osobiste (nieodpowiednie do integracji z API)
2. Konto biznesowe (wymagane do integracji z systemem)

Należy wybrać: Konto biznesowe

Krok 4 — Wprowadź wymagane informacje

Zostaniesz poproszony o podanie:

• Adresu e-mail
• Utworzenia hasła
• Informacji o firmie
• Numeru telefonu komórkowego
• Twojego adresu

Krok 5 — Aktywuj konto

DHL wyśle Ci wiadomość e-mail w celu potwierdzenia konta.

Krok 6 — Zaloguj się na nowe konto

Po aktywacji możesz zalogować się do portalu DHL.

System DB Schenker zapewnia usługi wysyłkowe, umożliwiając użytkownikom dodawanie kont wysyłkowych DB Schenker i zarządzanie nimi w celu usprawnienia operacji wysyłkowych.

Dostęp do sekcji kont wysyłkowych

W menu po lewej stronie kliknij Carrier Accounts. Spowoduje to otwarcie strony Carrier Accounts Integration.

Dostęp do konta DB Schenker

Wyszukaj DB Schenker wśród połączonych kont. Kliknij je, aby otworzyć stronę zarządzania kontem.

Funkcja dodawania konta

Funkcja "Add Account" umożliwia dodanie nowego konta DB Schenker w celu efektywnego zarządzania operacjami wysyłkowymi.

Kroki dodawania nowego konta

• Przejdź do strony zarządzania kontem: W menu bocznym wybierz Carrier Accounts.
• Kliknij Add Account: W górnej części strony zarządzania kontem DB Schenker kliknij zielony przycisk Add Account.

• Wprowadź informacje o koncie:
  • Access Key: Pole wymagane, udostępniane przez DB Schenker
  • Measurement Type: System metryczny lub imperialny
  • Unit of Measurement: Kilogramy, metry, metry sześcienne, sztuki

Dodawanie metody wysyłki

Kliknij Add Method i wybierz metodę wysyłki:

• Fracht morski
• Fracht lotniczy
• Fracht lądowy

Kliknij Save Changes, aby potwierdzić, lub Cancel, aby anulować.

Edycja konta

Po dodaniu konta kliknij pomarańczowy przycisk Edit Account obok konta DB Schenker, aby zaktualizować dane.

Usuwanie konta

Kliknij Delete Account i potwierdź, aby trwale usunąć konto oraz wszystkie powiązane dane.

Gdzie pojawiają się konta

Konta są wyświetlane w tabeli zarządzania kontami DB Schenker, przedstawiającej:

• Account ID
• Access Key
• Measurement Type
• Measure Unit
• Methods Count
• Actions

Obecnie tabela jest pusta, ponieważ nie dodano jeszcze żadnych kont.

Bezproblemowe połączenie między Twoją platformą handlową, AdlerDo i Odoo

Witamy w integracji z platformą handlową

Ten system automatycznie łączy Twój sklep na platformie handlowej z systemem ERP Odoo za pośrednictwem AdlerDo. Produkty, zamówienia i stany magazynowe są synchronizowane automatycznie, co oszczędza czas i ogranicza liczbę błędów.

Architektura systemu

Platforma handlowa: Twój sklep internetowy → AdlerDo: platforma integracyjna → Odoo: system ERP

Trzy główne funkcje

1 – Synchronizacja produktów

Platforma handlowa → AdlerDo → Odoo

Co robi: Gdy tworzysz lub aktualizujesz produkt na swojej platformie handlowej, system automatycznie tworzy lub aktualizuje ten sam produkt w Odoo wraz ze wszystkimi jego danymi, takimi jak nazwa, opis, cena, SKU, zdjęcia i warianty.

Jak to działa

Produkt na platformie handlowej → AdlerDo → Produkt w Odoo

Jakie informacje są przenoszone?

Informacje podstawowe

• Nazwa i tytuł produktu
• Opis produktu
• SKU (jednostka magazynowa)
• Kod kreskowy / UPC
• Typ i kategoria produktu

Ceny i dane finansowe

• Cena sprzedaży
• Cena porównawcza
• Koszt jednostkowy
• Informacje podatkowe
• Waluta

Szczegóły produktu

• Zdjęcia produktu
• Warianty produktu (rozmiar, kolor itp.)
• Waga i wymiary
• Tagi i kolekcje
• Informacje o dostawcy

Etapy procesu

1. Utwórz lub zaktualizuj produkt na swojej platformie handlowej
2. AdlerDo przechwytuje i zapisuje dane produktu
3. Produkt zostaje automatycznie utworzony w Odoo

2 – Synchronizacja zamówień

Platforma handlowa → AdlerDo → Odoo

Co robi: Gdy klient składa zamówienie w Twoim sklepie na platformie handlowej, system automatycznie tworzy to samo zamówienie w Odoo wraz ze wszystkimi danymi klienta, zamówionymi pozycjami, adresem wysyłki i informacjami o płatności.

Jak to działa

Zamówienie na platformie handlowej → AdlerDo → Zamówienie w Odoo

Jakie informacje są przenoszone?

Informacje o kliencie

• Imię i nazwisko klienta
• Adres e-mail
• Numer telefonu
• Identyfikator klienta
• Uwagi klienta

Szczegóły zamówienia

• Numer zamówienia
• Pozycje zamówienia i ilości
• Numery SKU produktów
• Łączna kwota zamówienia
• Data i godzina zamówienia

Etapy procesu

1. Klient składa zamówienie na Twojej platformie handlowej
2. AdlerDo przechwytuje i przetwarza zamówienie
3. Zamówienie zostaje automatycznie utworzone w Odoo

3 – Aktualizacja stanów magazynowych

Odoo → AdlerDo → Platforma handlowa

Co robi: Gdy stany magazynowe zmieniają się w Odoo (w wyniku sprzedaży, zakupów lub korekt), system automatycznie aktualizuje ilości stanu magazynowego produktów na Twojej platformie handlowej.

Jak to działa

Stan magazynowy w Odoo → AdlerDo → Produkt na platformie handlowej

Jakie informacje są przenoszone?

Informacje o stanie magazynowym

• Dostępna ilość
• Zarezerwowany stan magazynowy
• SKU produktu
• Lokalizacja magazynowa
• Śledzenie magazynu

Aktualizacje stanów magazynowych

• Aktualizacja ilości na Twojej platformie handlowej
• Wyświetlanie jako "In Stock"
• Wyświetlanie jako "Out of Stock"
• Śledzenie statusu stanu magazynowego
• Obsługa wielu lokalizacji

Funkcje inteligentne

• Bufor zapasu bezpieczeństwa
• Zapobieganie sprzedaży ponad stan
• Aktualizacje w czasie rzeczywistym
• Automatyczne obliczenia
• Alerty o niskim stanie magazynowym

Etapy procesu

1. Zmiana stanu magazynowego w Odoo
2. AdlerDo zapisuje i oblicza nową ilość
3. Stan magazynowy na platformie handlowej zostaje automatycznie zaktualizowany

Podsumowanie

Te trzy funkcje współpracują ze sobą, tworząc kompletny system automatyzacji. Twoje produkty i stany magazynowe przepływają z platformy handlowej do Odoo, zamówienia przepływają z platformy handlowej do Odoo, a aktualizacje stanów magazynowych przepływają z Odoo z powrotem na Twoją platformę handlową. Wszystko dzieje się automatycznie, bez żadnej pracy ręcznej!

Dlaczego to pomaga

• Oszczędność czasu: Koniec z ręcznym wprowadzaniem danych i kopiowaniem informacji między systemami
• Mniej błędów: Automatyczna synchronizacja oznacza brak błędów ludzkich i pomyłek
• Dane w czasie rzeczywistym: Zawsze dokładne i aktualne informacje we wszystkich platformach
• Szybszy rozwój: Obsługa większej liczby zamówień i produktów bez dodatkowej pracy

System integracji z platformami handlowymi zasilany przez AdlerDo

Automatyczna synchronizacja między platformą handlową a Odoo

© 2024 AdlerDo Integration Platform

Środowisko testowe AdlerDoo i Odoo

Ten przewodnik pokazuje, jak połączyć konto Amazon Seller Central. Informacje specyficzne dla klienta, takie jak adresy URL serwerów, nazwy użytkowników, adresy e-mail czy nazwy firm, zostały celowo ukryte na zrzutach ekranu.

Ważne: Zawsze korzystaj z danych logowania przesłanych Ci osobno i w bezpieczny sposób. Nie przesyłaj haseł ani kodów 2FA zwykłą pocztą e-mail.

Część A – Łączenie konta Amazon w AdlerDoo

Wymagania

• Dostęp przez pulpit zdalny do udostępnionej maszyny wirtualnej
• Nazwa użytkownika i hasło AdlerDoo
• Dane logowania do Amazon Seller Central
• Dostęp do uwierzytelniania dwuskładnikowego / OTP Amazon, jeśli jest wymagane

Krok 1: Wyszukaj Podłączanie pulpitu zdalnego

Otwórz wyszukiwarkę systemu Windows i wpisz "Remote Desktop Connection". Następnie uruchom aplikację.

Krok 2: Otwórz pulpit zdalny i wprowadź dane dostępowe

W polu "Computer" wprowadź adres URL maszyny wirtualnej, który został Ci przesłany osobno. Następnie wprowadź nazwę użytkownika. Potem kliknij "Connect".

Krok 3: Wprowadź hasło

Wprowadź hasło do maszyny wirtualnej i potwierdź przyciskiem "OK". Maszyna wirtualna zostanie następnie otwarta.

Krok 4: Otwórz program AdlerDoo

Na pulpicie maszyny wirtualnej kliknij skrót do programu AdlerDoo. Nie otwieraj tutaj przeglądarki; uruchom aplikację AdlerDoo.

Krok 5: Zaloguj się do AdlerDoo

Zaloguj się przy użyciu danych dostępowych AdlerDoo, które zostały Ci przesłane osobno.

Krok 6: Otwórz Apps Management

Po zalogowaniu otwórz sekcję "Integrations" z menu po lewej stronie, a następnie otwórz "Apps Management".

Krok 7: Utwórz konto Amazon

W sekcji "Management Amazon Account" kliknij "Create Amazon Account".

Krok 8: Zaloguj się do Amazon Seller Central

Przeglądarka otworzy stronę logowania Amazon. Wprowadź dane logowania do Amazon Seller Central i potwierdź uwierzytelnianie dwuskładnikowe, jeśli jest wymagane.

Krok 9: Nadaj uprawnienia

Postępuj zgodnie z instrukcjami Amazon i nadaj żądane uprawnienia. Po pomyślnej autoryzacji zostaniesz przekierowany lub otrzymasz komunikat o powodzeniu.

Krok 10: Sprawdź połączenie

Następnie sprawdź w AdlerDoo, czy konto Amazon jest wyświetlane jako połączone. Jeśli połączenie nie jest wyświetlane, odśwież widok lub poinformuj wsparcie techniczne.

Część B – Łączenie konta Amazon w środowisku testowym Odoo

W tej sekcji opisano, jak połączyć Amazon bezpośrednio w środowisku testowym Odoo. Środowisko testowe Odoo jest zwykle już otwarte w przeglądarce na maszynie wirtualnej.

Krok 1: Otwórz środowisko testowe Odoo

Otwórz przeglądarkę na maszynie wirtualnej. Środowisko testowe Odoo powinno być już otwarte. Jeśli nie, użyj adresu URL środowiska testowego Odoo, który został Ci udostępniony osobno.

Krok 2: Otwórz Sales

W Odoo kliknij moduł "Sales".

Krok 3: Otwórz Configuration i Accounts

W module Sales otwórz menu "Configuration" u góry i wybierz "Accounts" w sekcji "Amazon".

Krok 4: Utwórz nowe konto Amazon

Kliknij "New", aby utworzyć nowe konto Amazon w Odoo.

Krok 5: Wybierz platformę Amazon

W polu "Home Marketplace" wybierz właściwą platformę Amazon, na przykład "Amazon.de" dla Niemiec.

Krok 6: Rozpocznij połączenie

Kliknij "Connect" lub "Continue", aby rozpocząć połączenie z Amazon.

Krok 7: Zaloguj się do Amazon i zezwól na uprawnienia

Zaloguj się na konto Amazon Seller Central i potwierdź żądane uprawnienia. Jeśli Amazon poprosi o kod OTP lub 2FA, wprowadź go.

Krok 8: Sprawdź powodzenie

Po autoryzacji powrócisz do Odoo. Sprawdź, czy konto Amazon zostało utworzone i czy status połączenia jest prawidłowy.

Uwagi na wypadek problemów

• Jeśli Amazon poprosi o kod OTP, kod musi zostać podany przez właściciela konta.
• Jeśli logowanie do Amazon się nie powiedzie, najpierw sprawdź nazwę użytkownika, hasło i 2FA.
• Jeśli połączenie nie jest widoczne po nadaniu uprawnień, odśwież stronę i sprawdź ponownie.
• Zawsze używaj właściwej platformy, na przykład Amazon.de dla Niemiec.
• Dane dostępowe należy udostępniać wyłącznie za pośrednictwem bezpiecznego kanału.

Przewodnik krok po kroku z wykorzystaniem pulpitu zdalnego i Apps Management w AdlerDoo

Ten przewodnik wyjaśnia, jak połączyć konto sprzedawcy eBay z AdlerDoo. Wszystkie zrzuty ekranu są zanonimizowane i nie zawierają danych dostępowych specyficznych dla klienta.

Zanim zaczniesz

• Korzystaj wyłącznie z maszyny wirtualnej i danych logowania AdlerDoo udostępnionych za pośrednictwem bezpiecznego linku dostępowego.
• Miej dostęp do konta sprzedawcy eBay, które ma zostać połączone.
• Nie udostępniaj danych dostępowych osobom trzecim.
• Jeśli pojawi się błąd, zrób zrzut ekranu i prześlij go do nas e-mailem.

Krok 1 – Otwórz Podłączanie pulpitu zdalnego

Na komputerze z systemem Windows otwórz menu Start, wyszukaj Remote Desktop Connection i otwórz aplikację.

Krok 2 – Wprowadź dane maszyny wirtualnej

W razie potrzeby kliknij Show Options. Wprowadź adres komputera zdalnego i nazwę użytkownika z bezpiecznego linku dostępowego, a następnie kliknij Connect.

Krok 3 – Wprowadź hasło maszyny wirtualnej

Wprowadź hasło z bezpiecznego linku dostępowego i potwierdź przyciskiem OK. Upewnij się, że używasz właściwych danych logowania do maszyny wirtualnej.

Krok 4 – Otwórz AdlerDoo na maszynie wirtualnej

Po otwarciu sesji pulpitu zdalnego uruchom AdlerDoo na maszynie wirtualnej.

Krok 5 – Zaloguj się do AdlerDoo

Zaloguj się do AdlerDoo przy użyciu nazwy użytkownika i hasła udostępnionych za pośrednictwem bezpiecznego linku dostępowego.

Krok 6 – Otwórz Apps Management

W AdlerDoo przejdź do Integrations, a następnie otwórz Apps Management z menu po lewej stronie.

Krok 7 – Utwórz połączenie z eBay

Przewiń do Management eBay Account i kliknij Create eBay Account.

Krok 8 – Zaloguj się do eBay i zatwierdź połączenie

Zaloguj się na konto sprzedawcy eBay, które ma zostać połączone. Postępuj zgodnie z krokami autoryzacji eBay, aż połączenie zostanie ukończone i nastąpi przekierowanie z powrotem do AdlerDoo.

Przegląd

Ta dokumentacja opisuje, jak zarejestrować i skonfigurować publiczną aplikację Shopify (Shopify Public App) w Shopify Dev Dashboard oraz zintegrować ją z AdlerDo V6.1 w celu instalacji OAuth. Proces ten generuje Client ID i Client Secret, których AdlerDo używa do uwierzytelniania względem każdego sklepu Shopify instalującego aplikację.

Kontekst architektury

AdlerDo udostępnia /api/shopify/install jako punkt wejścia OAuth. Aplikacja w Dev Dashboard przekierowuje każde żądanie instalacji do tego punktu końcowego, który przeprowadza wymianę kodu OAuth, zapisuje token dostępu w bazie danych tenanta i rejestruje wymagane webhooki za pomocą zadań w tle Hangfire.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

• Masz dostęp do organizacji Shopify TecSee GmbH z uprawnieniami do zarządzania aplikacjami
• Middleware AdlerDo jest wdrożone i osiągalne przez HTTPS na publicznym hoście skonfigurowanym dla docelowego środowiska
• Punkty końcowe /api/shopify/install oraz /api/shopify/callback są osiągalne i zwracają prawidłowe odpowiedzi
• Dostępny jest sklep deweloperski do testów end-to-end przed przeniesieniem danych uwierzytelniających do środowiska produkcyjnego
• Lista zakresów (scopes) OAuth wymaganych przez AdlerDo została sfinalizowana i zapisana w konfiguracji

Krok 1 — Otwórz stronę App Development

Zaloguj się do organizacji Shopify i przejdź do Settings → Apps and sales channels → App development. Kliknij przycisk "Build apps in Dev Dashboard".

Ważne: NIE używaj przycisku "Create an app" w panelu Legacy custom apps. Starsze aplikacje niestandardowe (legacy custom apps) przestaną działać dla nowych sprzedawców od 1 stycznia 2026 r.

Krok 2 — Utwórz nową aplikację w Dev Dashboard

Dev Dashboard otwiera się pod adresem dev.shopify.com/dashboard/{organizationId}/apps. Kliknij przycisk "Create app" w prawym górnym rogu listy aplikacji.

Krok 3 — Wybierz ścieżkę tworzenia i ustaw nazwę aplikacji

Dostępne są dwie ścieżki tworzenia:

• Start with Shopify CLI — tworzy lokalnie szkielet projektu Node/Remix. AdlerDo nie potrzebuje tej ścieżki.
• Start from Dev Dashboard — rejestruje metadane aplikacji bezpośrednio w panelu i natychmiast generuje Client ID i Secret. Użyj tej ścieżki dla AdlerDo.

Wprowadź nazwę aplikacji (na przykład: AdlerDo) i kliknij Create.

Konwencja nazewnictwa

Użyj stabilnej nazwy widocznej dla klienta, wyświetlanej na ekranie zgody podczas instalacji. Dla TecSee dodaj prefiks dla każdego środowiska, jeśli to konieczne: AdlerDo (Production), AdlerDo Staging, AdlerDo Dev.

Krok 4 — Skonfiguruj adresy URL, wersję webhooków i zakresy

Po utworzeniu aplikacja otwiera się na karcie Versions z nową wersją roboczą. To tutaj definiowane są adres URL instalacji, wersja API webhooków oraz zakresy.

6.1 App URL

Ustaw App URL na publiczny punkt końcowy instalacji AdlerDo:

https://whlvm133440.wawihost.de/api/shopify/install

Jest to adres URL, na który Shopify przekierowuje, gdy sprzedawca instaluje aplikację. ShopifyInstallController w AdlerDo odczytuje parametry zapytania shop i hmac, weryfikuje HMAC i przekierowuje na stronę przyznania zgody OAuth Shopify.

6.2 Embed app in Shopify admin

Pozostaw zaznaczone pole wyboru "Embed app in Shopify admin". AdlerDo udostępnia osadzony interfejs administracyjny wewnątrz ramki administracyjnej Shopify przy użyciu App Bridge.

6.3 Preferences URL

Opcjonalne. Pozostaw puste, chyba że aplikacja udostępnia oddzielną stronę ustawień poza osadzonym środowiskiem.

6.4 Wersja API webhooków

Jawnie przypnij wersję API webhooków. W przykładzie pokazano 2026-04, czyli wersję, którą AdlerDo obecnie wykorzystuje. Zmiana tej wartości wymaga przeglądu mapowania każdego ładunku (payload) webhooka.

6.5 Zakresy dostępu

Kliknij "Select scopes" i zaznacz zakresy wymagane przez AdlerDo. Ogranicz listę do minimum, którego AdlerDo faktycznie używa — sprzedawcy widzą pełną listę na ekranie zgody podczas instalacji.

Dokładnie ta sama lista musi również zostać zapisana w konfiguracji AdlerDo (appsettings.Shopify.json → Shopify:Scopes), ponieważ kontroler instalacji przekazuje ją jako parametr zapytania scope. Niezgodność wymusi ponowne instalacje.

Zakresy opcjonalne a wymagane

Zakresy opcjonalne mogą być żądane w czasie działania po instalacji. AdlerDo traktuje wszystkie wymienione zakresy jako wymagane podczas początkowej instalacji, dlatego pozostaw blok Optional scopes pusty.

6.6 Redirect URLs

Dodaj adres URL przekierowania OAuth — publiczny adres URL wywołania zwrotnego (callback) OAuth AdlerDo:

https://whlvm133440.wawihost.de/api/shopify/callback

Dodaj po jednym adresie URL przekierowania na każde środowisko. Shopify odrzuca wywołanie zwrotne OAuth, jeśli adres URL podany w parametrze redirect_uri nie znajduje się na tej białej liście.

Krok 5 — Opublikuj wersję

Po zapisaniu wszystkich pól kliknij Release na dole strony wersji.

• Version name — czytelna dla człowieka etykieta. Konwencja TecSee: alderdoo-{n}, gdzie n to automatycznie zwiększany numer wydania
• Version message — krótki dziennik zmian (np. "added read_locales scope", "bumped webhooks API to 2026-04")

Kliknij Release. Nowa wersja natychmiast staje się aktywna (Active) i zastępuje poprzednią aktywną wersję dla wszystkich nowych instalacji.

Zmiany zakresów po wydaniu

Dodanie nowego zakresu do wydanej wersji NIE nadaje go automatycznie w już zainstalowanych sklepach. Właściciel sklepu musi zatwierdzić ponowną autoryzację. AdlerDo wykrywa rozbieżność zakresów przy każdym żądaniu i w razie potrzeby uruchamia przekierowanie do ponownej instalacji.

Krok 6 — Zweryfikuj aktywną wersję

Otwórz kartę Versions z paska bocznego po lewej. Ostatnio wydana wersja jest oznaczona zieloną plakietką "Active". Wszystkie poprzednie wersje pozostają widoczne do celów audytowych.

Z tego widoku możesz kliknąć dowolną wersję historyczną, aby sprawdzić jej konfigurację, co jest przydatne podczas debugowania instalacji w starszym sklepie.

Krok 7 — Pobierz Client ID i Secret

Otwórz kartę Settings z paska bocznego po lewej. Blok Credentials u góry udostępnia Client ID i Secret.

9.1 Client ID

Publiczny identyfikator. Można go bezpiecznie umieścić w konfiguracji. Skopiuj go ikoną schowka i wklej do konfiguracji AdlerDo.

9.2 Client Secret

Wrażliwy. Traktuj jak dane uwierzytelniające. Sekret jest wyświetlany tylko raz, przy pierwszym wygenerowaniu; później pokazywana jest wyłącznie forma zamaskowana. Użyj ikony oka, aby jednorazowo go ujawnić w celu skopiowania, a następnie zapisz go standardową ścieżką przechowywania sekretów AdlerDo.

W AdlerDo sekrety integracji z platformami handlowymi są zapisywane w bazie danych tenanta z szyfrowaniem AES-256 za pośrednictwem MarketplaceCredentialEncryptor.

9.3 Rotacja sekretu

Kliknij Rotate, aby wygenerować nowy sekret. Poprzedni sekret jest natychmiast unieważniany. Skoordynuj rotację z wdrożeniem nowego sekretu do AdlerDo.

9.4 Adres e-mail kontaktowy API

Ustaw go na monitorowaną skrzynkę pocztową (obecnie dev@tecsee.de). Shopify wysyła na ten adres powiadomienia o wycofaniu API oraz zalecenia dotyczące bezpieczeństwa.

Podłączanie danych uwierzytelniających do AdlerDo

Gdy masz już Client ID i Secret, dodaj dane uwierzytelniające do konfiguracji AdlerDo.

10.1 Konfiguracja

Dodaj następujący blok do konfiguracji specyficznej dla środowiska:

"Shopify": {
  "ClientId": "1d15c8413f636e7cfda6f4402d9ef552",
  "ClientSecret": "<from Settings page>",
  "Scopes": "read_products,write_products,read_orders,write_orders,…",
  "WebhooksApiVersion": "2026-04",
  "InstallRedirectUrl": "https://whlvm133440.wawihost.de/api/shopify/callback"
}

10.2 Przebieg instalacji

Kompletny uścisk dłoni (handshake) instalacji end-to-end wygląda następująco:

1. Sprzedawca klika link instalacyjny → Shopify przekierowuje na App URL z parametrami zapytania shop i hmac
2. AdlerDo /api/shopify/install weryfikuje HMAC względem Client Secret i przekierowuje na https://{shop}/admin/oauth/authorize ze skonfigurowaną listą zakresów i wygenerowanym nonce'em stanu (state)
3. Sprzedawca zatwierdza zakresy na ekranie zgody Shopify
4. Shopify przekierowuje na /api/shopify/callback z parametrami code, hmac i state
5. AdlerDo weryfikuje HMAC oraz nonce stanu, a następnie wysyła metodą POST code + Client ID + Client Secret na https://{shop}/admin/oauth/access_token, aby otrzymać token dostępu offline
6. Token jest zapisywany z szyfrowaniem AES-256 przypisanym do tenanta; rejestrowane są subskrypcje webhooków oraz cykliczne zadania synchronizacji Hangfire
7. AdlerDo przekierowuje sprzedawcę na osadzony adres URL administracji

10.3 Weryfikacja instalacji

Po uścisku dłoni (handshake):

• Potwierdź, że w bazie danych tenanta istnieje nowa encja ShopifyConnection z niepustym EncryptedAccessToken oraz przyznaną listą zakresów
• Potwierdź, że cykliczne zadania (SyncShopifyOrdersV2026, SyncShopifyProductsV2026) są zarejestrowane w Hangfire pod nowym identyfikatorem tenanta
• Wyzwól testowy webhook z panelu administracyjnego Shopify i potwierdź, że handler AdlerDo przetwarza go bez błędów HMAC

Załącznik A — Typowe zakresy używane przez AdlerDo

Załącznik B — Rozwiązywanie problemów

Przekierowanie instalacji zwraca 401 / Invalid HMAC

Przyczyna: Client Secret w konfiguracji AdlerDo nie zgadza się z sekretem w Settings albo sekret został poddany rotacji bez ponownego wdrożenia.

Działanie: Skopiuj sekret ze strony Settings w Dev Dashboard i wdróż ponownie.

Wywołanie zwrotne OAuth zwraca 'redirect_uri is not whitelisted'

Przyczyna: Adres URL wywołania zwrotnego nie znajduje się w polu Redirect URLs aktywnej wersji.

Działanie: Otwórz aktywną wersję, dodaj adres URL, opublikuj nową wersję i ponów instalację.

Sklep się instaluje, ale nie pojawiają się zadania Hangfire

Przyczyna: Wymiana kodu OAuth powiodła się, ale zainicjowanie po instalacji (bootstrap) nie powiodło się (np. provisioning tenanta).

Działanie: Przejrzyj logi AdlerDo w okolicy znacznika czasu instalacji; ShopifyInstallController emituje log poziomu Information dla każdego etapu oraz log poziomu Error z krokiem, który się nie powiódł.

Dostarczanie webhooków kończy się błędami HMAC

Przyczyna: AdlerDo obliczył HMAC webhooka na podstawie sparsowanego ładunku zamiast surowego ciała (raw body).

Działanie: Potwierdź, że middleware żądań buforuje surowe ciało żądania przed model bindingiem dla tras /api/shopify/webhooks/*.

Sprzedawca zgłasza brakujące dane po dodaniu zakresu

Przyczyna: Sklep został zainstalowany względem starszej wersji, która nie zawierała tego zakresu.

Działanie: Wyzwól przekierowanie do ponownej instalacji — AdlerDo wykrywa rozbieżność zakresów w ShopifyConnectionMiddleware i przekierowuje do punktu końcowego instalacji, gdzie sprzedawca zatwierdza nowy zakres.

Opublikowano 20 lutego 2026 r.
Zaktualizowano 23 lutego 2026 r.

Połączenie z Kaufland Global Marketplace API

Ten przewodnik wyjaśnia, jak połączyć AdlerDo z Kaufland Global Marketplace API. Po połączeniu AdlerDo może synchronizować produkty, stany magazynowe, zamówienia oraz informacje o wysyłce między Twoim systemem ERP (takim jak Odoo) a Kaufland.

Przegląd

Dzięki połączeniu AdlerDo z Kaufland za pośrednictwem oficjalnego API Twój system zyskuje możliwość:

• Synchronizowania ofert produktów z Twojego ERP do Kaufland
• Utrzymywania aktualnych poziomów zapasów we wszystkich systemach
• Automatycznego importowania zamówień z Kaufland
• Odsyłania potwierdzeń wysyłki i danych śledzenia z powrotem do Kaufland

Ta integracja zapewnia stabilny, zautomatyzowany przepływ danych i ogranicza pracę ręczną.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

• Masz aktywne konto sprzedawcy Kaufland
• Masz dostęp do Kaufland Seller Portal
• Masz uprawnienia do zarządzania danymi uwierzytelniającymi API na koncie sprzedawcy

Kroki uzyskiwania danych uwierzytelniających Kaufland API

Aby połączyć AdlerDo z Kaufland, najpierw musisz uzyskać dane uwierzytelniające API z Kaufland Seller Portal.

Krok 1: Przejdź do ustawień API

Otwórz w przeglądarce poniższy link:

https://sellerportal.kaufland.de/settings/api

W menu po lewej stronie przejdź do:

Settings → Shop Settings → API

Krok 2: Wyświetl swoje aktualne klucze API

W sekcji Current API key zobaczysz:

• Client key (Client ID) — zamaskowany ze względów bezpieczeństwa
• Secret key (Client Secret) — zamaskowany ze względów bezpieczeństwa

Te wartości są ukryte i nie można ich ponownie ujawnić ze względów bezpieczeństwa.

Krok 3: Wygeneruj nowe klucze API (jeśli to konieczne)

Jeśli nie masz ważnych danych uwierzytelniających lub potrzebujesz nowej pary, kliknij:

Generate new API keys

Ważne: Po wygenerowaniu nowych kluczy:

• Stary Client ID i Client Secret natychmiast tracą ważność
• Każda istniejąca integracja korzystająca ze starych kluczy przestanie działać
• Musisz zaktualizować AdlerDo o nowe dane uwierzytelniające

Krok 4: Zapisz swoje nowe dane uwierzytelniające

Po wygenerowaniu nowych kluczy:

• Skopiuj Client ID
• Skopiuj Client Secret
• Bezpiecznie przechowaj obie wartości

Nie będzie można ich ponownie pobrać po opuszczeniu strony.

Łączenie Kaufland z AdlerDo

Po uzyskaniu danych uwierzytelniających API możesz połączyć Kaufland w AdlerDo.

Krok 1: Wybierz typ konta

Z menu rozwijanego obok Select wybierz: Kaufland

Krok 2: Wprowadź dane konta

Wypełnij następujące pola:

Account Name

Wprowadź wyróżniającą nazwę tego połączenia, na przykład "My Kaufland Store" lub "Kaufland DE Account"

Client ID

Wprowadź Client ID uzyskany z konta Kaufland

Client Secret

Wprowadź Client Secret uzyskany z konta Kaufland

Krok 3: Zapisz i połącz konto

Po wypełnieniu wszystkich wymaganych pól kliknij przycisk Add New Account (zielony).

AdlerDo spróbuje nawiązać połączenie z Kaufland Global Marketplace API przy użyciu podanych danych uwierzytelniających.

Krok 4: Zweryfikuj połączone konta

Gdy połączenie się powiedzie:

• Twoje konto Kaufland pojawi się na liście Connected Accounts po lewej stronie
• Status konta potwierdzi, że AdlerDo jest pomyślnie połączone z Kaufland

W tym momencie Twój system jest gotowy do synchronizacji danych.

Co dzieje się po połączeniu

Po połączeniu Kaufland z AdlerDo:

• Można włączyć synchronizację produktów i stanów magazynowych
• Zamówienia złożone w Kaufland są automatycznie importowane do AdlerDo
• Zamówienia są przekazywane do Twojego ERP w celu przetworzenia
• Potwierdzenia wysyłki i numery śledzenia mogą być odsyłane z powrotem do Kaufland

Cała synchronizacja przebiega zgodnie ze standardowym cyklem pełnej synchronizacji AdlerDo (AdlerDo Complete Sync Cycle).

Typowe uwagi i najlepsze praktyki

Po połączeniu Kaufland z AdlerDo:

• Zawsze utrzymuj spójność numerów SKU między swoim ERP a Kaufland
• Jeśli synchronizacja się nie powiedzie, sprawdź, czy klucze API nie zostały ponownie wygenerowane
• Używaj bezpiecznego przechowywania dla danych uwierzytelniających API
• Połącz konto ponownie natychmiast po zmianie kluczy API

Ten przewodnik wyjaśnia, jak połączyć Twój sklep PrestaShop z AdlerDo przy użyciu interfejsu Accounts Integration. Po połączeniu AdlerDo może synchronizować produkty, stany magazynowe, zamówienia i inne dane między sklepem PrestaShop a Twoim systemem ERP.

Przegląd integracji z PrestaShop

Dzięki połączeniu PrestaShop z AdlerDo możesz usprawnić swoje operacje e-commerce i zapewnić bezproblemowy przepływ danych.

Kluczowe korzyści obejmują:

• Automatyczną synchronizację ofert produktów i aktualizacji
• Utrzymywanie dokładnych poziomów zapasów we wszystkich systemach
• Importowanie zamówień z PrestaShop do AdlerDo i Twojego ERP
• Bezpieczne zarządzanie wieloma kontami PrestaShop z jednego interfejsu

Ta integracja zapewnia niezawodny i bezpieczny przepływ danych przy minimalnej interwencji ręcznej.

• Synchronizacja stanów magazynowych
• Import zamówień
• Zarządzanie wieloma sklepami

Dostęp do Accounts Integration

Kartę Accounts Integration można otworzyć z menu bocznego, wybierając Accounts.

Krok 1: Wybierz typ konta

U góry strony użyj menu rozwijanego Select, aby wybrać typ konta do połączenia lub zarządzania, np.:

• PrestaShop (wybrane w przykładzie)

Krok 2: Akcje konta

Add New Account

• Kliknij zielony przycisk, aby dodać nowe konto PrestaShop do AdlerDo.

Delete Account

• Kliknij czerwony przycisk, aby usunąć aktualnie wybrane konto.

⚠️ Usunięcie konta natychmiast zatrzymuje synchronizację dla tego połączenia.

Krok 3: Ustawienia konta

Sekcja Account Settings umożliwia utworzenie lub edycję połączenia z kontem PrestaShop.

Opis pól:

1. Account Name

Wewnętrzna nazwa w AdlerDo pozwalająca rozróżnić wiele kont PrestaShop. Przykład:

"PrestaShop – Main Store"

2. Base URL

Główny adres URL witryny Twojego sklepu PrestaShop. Przykład:

https://yourshopdomain.com

3. Token

Token API używany do bezpiecznego uwierzytelniania między AdlerDo a PrestaShop

Krok 4: Połączone konta

Panel Connected Accounts znajduje się po lewej stronie strony. Stąd możesz:

• Wybrać konto, aby edytować jego ustawienia
• Usunąć konto, jeśli nie jest już potrzebne

Jeśli żadne konta nie są połączone, lista będzie pusta.

Krok 5: Uzyskaj Base URL i token API z PrestaShop

Base URL

Publiczny adres URL Twojego sklepu PrestaShop. Przykład:

https://yourshopdomain.com

Token API:

Wykonaj następujące kroki:

1. Zaloguj się do zaplecza PrestaShop (Back Office).
2. Z paska bocznego przejdź do Advanced Parameters → Webservice (API)
3. Jeśli funkcja Webservice nie jest włączona, włącz ją, wybierając Enable PrestaShop Webservice
4. Aby utworzyć nowy klucz API:
   • Kliknij Add new webservice key lub ikonę plus (+)
   • Pojawi się strona tworzenia nowego klucza
   • Kliknij Generate, aby utworzyć losowy klucz (to jest Token)
5. Skopiuj wygenerowany klucz i przechowuj go bezpiecznie
6. Przypisz niezbędne uprawnienia wymagane przez AdlerDo (odczyt/zapis w zależności od potrzeb)
7. Kliknij Save, aby aktywować klucz

⚠️ Ważne: Przechowuj token API w bezpieczny sposób. Jeśli token zostanie ponownie wygenerowany, musisz natychmiast zaktualizować go w AdlerDo.

Łączenie PlentyMarkets z AdlerDoo

Połącz swoje konto PlentyMarkets (lub PlentyONE) z AdlerDoo w czterech prostych krokach. Po połączeniu AdlerDoo automatycznie synchronizuje Twoje produkty, kategorie, atrybuty, zamówienia i adresy klientów między PlentyMarkets a Odoo.

Zanim zaczniesz

• Aktywne konto PlentyMarkets lub PlentyONE z dostępem do REST API.
• Twój Base URL (na przykład: https://your-shop.plentymarkets-cloud01.com).
• Nazwa użytkownika i hasło użytkownika z uprawnieniami do REST API.

Wskazówka: Utwórz dedykowanego użytkownika API w PlentyMarkets na potrzeby tej integracji. Jest to bezpieczniejsze niż korzystanie z konta administratora, a dostęp możesz w każdej chwili odebrać bez wpływu na innych użytkowników.

Połącz Plenty w czterech krokach

KROK 1: Otwórz Marketplace Accounts

Na pasku bocznym AdlerDoo przejdź do Settings → Integrations → Marketplace Accounts.

KROK 2: Wybierz Plenty

Z menu rozwijanego Select Marketplace u góry strony wybierz Plenty.

KROK 3: Kliknij "Add New Account"

Kliknij zielony przycisk Add New Account w prawym górnym rogu strony.

KROK 4: Wprowadź dane uwierzytelniające i zapisz

Wypełnij poniższe cztery pola swoimi danymi uwierzytelniającymi PlentyMarkets, a następnie kliknij Save. AdlerDoo dokona uwierzytelnienia, automatycznie zapisze token dostępu i token odświeżania, a Twoje konto zostanie połączone.

Wskazówka: AdlerDoo odświeża token dostępu w tle, zanim wygaśnie — nigdy nie musisz zarządzać tokenami ręcznie.

Zweryfikuj połączenie

Po połączeniu AdlerDoo zaczyna automatycznie synchronizować dane w tle. Skorzystaj z poniższych ekranów, aby potwierdzić, że produkty, zamówienia, kategorie, atrybuty i klienci zostali pobrani z Twojego sklepu PlentyMarkets.

1. Sprawdź status synchronizacji

Otwórz Settings → Integrations → Connection Sync. Plenty powinno pojawić się na liście z zielonym wskaźnikiem Running.

2. Przeglądaj zsynchronizowane produkty

Otwórz Main → Products i filtruj według Plenty, aby zobaczyć wszystkie produkty zsynchronizowane z Twojego sklepu, wraz z ich numerami SKU, cenami i identyfikatorami (GTIN, MPN, ASIN, UPC).

3. Sprawdź warianty produktów

Kliknij Variants w dowolnym wierszu produktu, aby otworzyć okno szczegółów wariantu. Każdy wariant przedstawia swój SKU, kod kreskowy, cenę, ilość i wymiary — wszystko, co zostało przeniesione z PlentyMarkets.

4. Przeglądaj zsynchronizowane zamówienia

Otwórz Main → Orders i filtruj według Plenty, aby zobaczyć wszystkie zamówienia pobrane z PlentyMarkets, w tym status, metodę płatności i czas realizacji.

5. Sprawdź szczegóły zamówienia

Kliknij Details w dowolnym wierszu zamówienia, aby otworzyć okno szczegółów zamówienia z pozycjami, ilościami, cenami, VAT i sumami. Użyj kart Gift i Custom w prawym górnym rogu okna, aby wyświetlić opcje prezentów i dane personalizacji.

6. Przejrzyj zsynchronizowane kategorie

Otwórz Main → Categories, aby zobaczyć pełne drzewo kategorii zaimportowane z PlentyMarkets — tę samą hierarchię, której używasz do organizowania produktów w swoim sklepie.

7. Przejrzyj zsynchronizowane atrybuty

Otwórz Main → Attributes, aby wyświetlić wszystkie atrybuty produktów (rozmiar, kolor, materiał, marka, producent, grupa wiekowa, wzór, płeć itd.) używane do opisywania wariantów.

8. Przejrzyj zsynchronizowanych klientów

Otwórz Main → Customers, aby zobaczyć klientów pobranych z PlentyMarkets. Każdy wpis ma numer klienta z prefiksem PLENTY, który łączy go ze źródłem. Kliknij View Address w dowolnym wierszu, aby sprawdzić zapisane adresy dostawy i rozliczeniowe.

Co jest synchronizowane automatycznie

Po początkowym połączeniu AdlerDoo utrzymuje synchronizację następujących elementów między PlentyMarkets a Odoo — bez żadnego działania ręcznego:

• Produkty — w tym warianty, ceny sprzedaży, stany magazynowe i wartości atrybutów.
• Kategorie — pełne drzewo i hierarchia kategorii.
• Atrybuty — rozmiar, kolor, materiał i inne atrybuty wariantów.
• Zamówienia — tworzone w Odoo jako zamówienia sprzedaży.
• Adresy klientów — powiązane z odpowiednimi zamówieniami i kontaktami.

Usuwanie połączonego konta

Aby odłączyć konto Plenty: wybierz je z listy Connected Accounts po lewej stronie, a następnie kliknij czerwony przycisk Delete Account w prawym górnym rogu.

Potrzebujesz pomocy?

W przypadku jakichkolwiek problemów lub pytań dotyczących integracji skontaktuj się z zespołem wsparcia AdlerDoo.

Przechodzenie do strony integracji

Z paska bocznego po lewej stronie:

Accounts → menu boczne

(Zaznaczone czerwoną ramką na obrazie)

Wybór systemu integracji

U góry strony znajduje się menu rozwijane: Select

Wybierz JTL z listy dostępnych systemów.

Ustawienia konta (konfiguracja konta JTL)

Po wybraniu JTL pojawią się trzy ważne pola, które należy wypełnić

1. Account Name

Nazwa konta, którą chcesz wyświetlać w systemie.

Pomaga to w łatwym identyfikowaniu konta w przyszłości.

2. Client ID

Unikalny identyfikator integracji JTL.

Tę wartość uzyskasz z panelu sterowania JTL.

3. Client Secret

Tajny klucz konta.

Należy go przechowywać bezpiecznie i nigdy nie udostępniać, aby zapewnić bezpieczeństwo.

Klucz ten służy do uwierzytelniania i łączenia obu systemów ze sobą.

Dostępne operacje

Zielony przycisk w prawym górnym rogu.

Dodaje nowe konto JTL po wypełnieniu wymaganych informacji.

Usuwanie konta

Czerwony przycisk w prawym górnym rogu.

Usuwa wybrane konto z listy połączonych kont.

Połączone konta

Ta sekcja wyświetla wcześniej połączone konta (jeśli istnieją).

Ułatwia to wybranie konta w celu przeglądu, edycji lub usunięcia.

Kroki pobierania danych integracyjnych z JTL (Client ID i Client Secret)

1. Zaloguj się do panelu sterowania JTL

Otwórz przeglądarkę internetową, przejdź na stronę JTL i zaloguj się przy użyciu danych logowania do swojego konta.

2. Przejdź do ustawień konta lub ustawień ogólnych

W głównym panelu sterowania poszukaj opcji takiej jak Settings lub Configuration i kliknij ją.

3. Znajdź sekcję API, Integrations lub Apps

Na stronie ustawień znajdź sekcję integracji zewnętrznych, zwykle oznaczoną jako:

• API Access
• Integrations
• Apps lub Developer Apps

4. Utwórz nową aplikację lub wygeneruj nowe klucze API

Kliknij przycisk, aby utworzyć nową aplikację lub wygenerować dane uwierzytelniające API.

Możesz zostać poproszony o podanie:

• Nazwy aplikacji
• Opisu
• Callback URL (jeśli jest wymagany)

5. Uzyskaj Client ID i Client Secret

Po utworzeniu zobaczysz:

• Client ID: Unikalny numer lub tekst reprezentujący aplikację.
• Client Secret: Tajny klucz powiązany z Client ID.

Skopiuj i bezpiecznie przechowaj obie wartości.

6. Wprowadź dane na stronie integracji swojego systemu

1. Przejdź do strony Accounts Integration w swoim systemie.
2. Wybierz JTL z dostępnych systemów.
3. Wprowadź Client ID i Client Secret w odpowiednich polach.
4. Wprowadź Account Name w celu łatwej identyfikacji.

Ta sekcja ułatwia połączenie Twojego systemu z kontem MediaMarkt Marketplace w celu umożliwienia synchronizacji produktów, zamówień, zarządzania stanami magazynowymi oraz powiązanych operacji integracyjnych.

Lokalizacja w systemie

Dostęp do tej funkcji uzyskasz przez:

pasek boczny → Accounts → Accounts Integration

Następnie wybierz MediaMarkt z menu rozwijanego Select.

Ustawienia konta

Po prawej stronie wypełnij następujące pola, aby dodać konto MediaMarkt:

Przyciski sterujące

• Add New Account: Zielony przycisk do zapisania nowego konta MediaMarkt po wprowadzeniu wymaganych danych.

• Delete Account: Usuwa wybrane konto z listy kont.

Połączone konta

Po lewej stronie wyświetlane są wszystkie wcześniej dodane konta MediaMarkt. Wybierz dowolne konto do edycji lub usunięcia.

Ogólne kroki uzyskiwania danych integracyjnych

1. Zaloguj się do MediaMarkt Seller Dashboard (zaplecze Mirakl)

   • Otwórz przeglądarkę i przejdź do: https://mediamarktsaturn.mirakl.net/login

2. Zaloguj się przy użyciu danych logowania do konta sprzedawcy

   • Wprowadź nazwę użytkownika i hasło

3. Przejdź do Account Settings lub My Profile

   • Poszukaj sekcji API lub API Keys

4. Utwórz nowy klucz API lub skopiuj istniejący

   • Kliknij Generate API Key, jeśli go nie masz
   • Skopiuj istniejący klucz, jeśli jest dostępny

5. Zanotuj Base URL dla platformy MediaMarkt

   • Base URL to zazwyczaj punkt końcowy Mirakl API: https://mediamarktsaturn.mirakl.net/api

6. Użyj Base URL i klucza API (Token) w swoim systemie

   • Przejdź do Accounts Integration w swoim systemie
   • Wybierz MediaMarkt z menu rozwijanego
   • Wprowadź odpowiednią Account Name
   • Wprowadź Base URL
   • Wprowadź skopiowany API Key (Token)

7. Zapisz dane i aktywuj integrację

   • Kliknij Add New Account, aby zakończyć konfigurację
   • Twój system może teraz pobierać zamówienia, aktualizować produkty i wykonywać zadania integracyjne

Funkcja Accounts Integration umożliwia połączenie Twojego konta Galaxus z systemem, pozwalając na zarządzanie danymi, pobieranie zamówień i automatyczne aktualizowanie informacji poprzez wprowadzenie danych uwierzytelniających integracji konta.

Kroki integracji

1. Przejdź do sekcji Accounts Integration: Z paska bocznego wybierz Accounts.
2. Wybierz Galaxus z menu rozwijanego: W menu rozwijanym Select wybierz Galaxus.

Wypełnij dane konta

• Account Name: Wprowadź nazwę konta, która będzie identyfikowana w systemie (np. My Galaxus Account).
• Client ID: Wprowadź identyfikator klienta swojego konta Galaxus.
• Client Secret: Wprowadź client secret powiązany z Twoim kontem Galaxus.

Zapisz konto

Po wprowadzeniu danych kliknij przycisk Save lub Confirm Add (w zależności od interfejsu systemu).

• Zielony przycisk używany do dodawania nowego konta

Usuwanie konta

1. Wybierz konto z pola Connected Accounts.
2. Kliknij przycisk Delete Account.
3. Potwierdź usunięcie.

Połączone konta

Po lewej stronie pojawia się pole wyświetlające wszystkie konta Galaxus, które zostały wcześniej połączone z systemem. Po wybraniu dowolnego konta z listy jego szczegóły zostaną wyświetlone w sekcji Account Settings.

Dane uwierzytelniające Galaxus API – jak uzyskać klucze integracyjne

1. Zaloguj się do swojego konta Galaxus

1. Otwórz stronę Galaxus.
2. Zaloguj się na konto, które chcesz połączyć z systemem.
3. Przejdź do strony API Settings.

Po zalogowaniu:

Z menu głównego przejdź do: Settings → Developer Settings → API Keys / Integrations

2. Utwórz nowy klucz API

Jeśli nie masz jeszcze istniejącego klucza:

1. Kliknij przycisk: Create API Key or Generate Credentials
2. Pojawi się formularz zawierający:
   • App Name / Integration Name → Wprowadź identyfikator, taki jak:
     • TecSee Integration
     • Store Sync
   • Permissions → Wybierz uprawnienia, których potrzebuje Twój system (np. Products – Orders – Inventory).
3. Kliknij Save / Generate

Łączenie Odoo przez Accounts Integration

Strona Accounts Integration umożliwia połączenie AdlerDo z jednym lub większą liczbą kont Odoo oraz zarządzanie nimi za pośrednictwem prostego, przejrzystego i bezpiecznego interfejsu. Po połączeniu AdlerDo może komunikować się bezpośrednio z Twoim systemem Odoo, aby synchronizować produkty, stany magazynowe, zamówienia i dane operacyjne.

Przegląd integracji z Odoo

Połączenie Odoo z AdlerDo centralizuje operacje platform handlowych i sklepów wewnątrz Odoo.

Kluczowe korzyści:

• Centralizacja danych platform handlowych i sklepów wewnątrz Odoo
• Automatyzacja synchronizacji produktów, stanów magazynowych i zamówień
• Zarządzanie wieloma instancjami Odoo z jednego interfejsu
• Ograniczenie operacji ręcznych i błędów integracji

Ta integracja zapewnia stabilny i skalowalny przepływ danych przy minimalnej interwencji ręcznej.

• Centralizacja danych
• Automatyczna synchronizacja
• Kontrola wielu instancji

Dostęp do strony Accounts Integration

Z menu na pasku bocznym po lewej stronie wybierz Accounts

Pojawi się ekran Integration Accounts Management, wyświetlający wszystkie połączenia kont i ustawienia.

Wybór systemu do połączenia

W górnej sekcji strony znajdziesz pole rozwijane oznaczone:

Select

U góry użyj pola rozwijanego oznaczonego Select, aby wybrać system. Wybierz Odoo, aby rozpocząć konfigurację.

Zarządzanie kontami

Add New Account

• Służy do dodawania nowego konta Odoo.
• Po wypełnieniu wszystkich wymaganych pól kliknij Add New Account, aby zapisać połączenie.
• Konto pojawi się w sekcji Connected Accounts po lewej stronie.

Delete Account

• Służy do usunięcia aktualnie wybranego konta Odoo.
• Po usunięciu synchronizacja dla tego konta zostanie natychmiast zatrzymana.

⚠️ Usunięcie konta nie wpływa na dane wewnątrz Odoo, a jedynie na połączenie.

Ustawienia konta (Odoo)

Podczas dodawania lub edycji konta pojawiają się następujące pola:

Opis pól

a. URL

Adres URL logowania do Twojej instancji Odoo. Przykład:

https://yourcompany.odoo.com

b. Account Name

Wewnętrzna nazwa identyfikująca konto Odoo. Przykład:

"Odoo – Main ERP"

c. Database Name

Nazwa bazy danych Odoo, z którą chcesz się połączyć. Jest ona wymagana do uwierzytelniania i dostępu do danych.

d. User Name

Nazwa użytkownika lub adres e-mail użytkownika Odoo z wystarczającymi uprawnieniami

e. Password

Hasło powiązane z wybranym kontem użytkownika Odoo.

🔒 Te informacje są obsługiwane w bezpieczny sposób i używane wyłącznie do uwierzytelniania.

Zarządzanie połączonymi kontami

Connected Accounts

Sekcja Connected Accounts wyświetla wszystkie wcześniej dodane konta Odoo. Stąd możesz:

• Wybrać konto, aby edytować jego ustawienia
• Usunąć konto, jeśli nie jest już potrzebne

Ułatwia to zarządzanie wieloma bazami danych lub środowiskami Odoo (np. produkcyjnym i testowym).

Kroki pobierania danych integracyjnych z Odoo

Uzyskaj URL

Skopiuj adres URL logowania do swojego systemu Odoo. Przykład:

https://yourcompany.odoo.com

Uzyskaj Database Name

• Znajdź nazwę bazy danych na stronie wyboru bazy danych
• Lub poproś o nią administratora Twojego systemu Odoo

Uzyskaj User Name

Użyj nazwy użytkownika lub adresu e-mail użytkownika Odoo z uprawnieniami dostępu do API.

Uzyskaj Password

Użyj hasła powiązanego z wybranym kontem użytkownika Odoo.

Wprowadź i zapisz dane

1. Wprowadź wszystkie wymagane informacje na stronie Accounts Integration
2. Sprawdź poprawność danych
3. Kliknij Add New Account, aby zapisać połączenie

Po zapisaniu konto Odoo pojawi się w sekcji Connected Accounts i będzie gotowe do synchronizacji.

Najlepsze praktyki

• Używaj dedykowanego użytkownika Odoo do integracji
• Przypisuj tylko wymagane uprawnienia ze względów bezpieczeństwa
• Używaj przejrzystych nazw kont dla wielu baz danych
• Zaktualizuj dane uwierzytelniające natychmiast po ich zmianie w Odoo

Wskazówka dotycząca bezpieczeństwa i konserwacji: Ograniczanie uprawnień i korzystanie z dedykowanych użytkowników integracji zmniejsza ryzyko nieautoryzowanego dostępu i zapobiega przypadkowym zakłóceniom.

Czym jest integracja z DATEV?

Ta integracja umożliwia automatyczne wysyłanie faktur z Odoo do Twojego systemu księgowego DATEV. Zamiast ręcznie przesyłać faktury, system pobiera je z Odoo, konwertuje do formatu DATEV i przesyła automatycznie.

Krok 1: Połącz swoje konto DATEV

Przed wysłaniem faktur musisz połączyć swoje konto DATEV.

1. Wywołaj punkt końcowy logowania, aby uzyskać link logowania do DATEV
2. Otwórz link w przeglądarce
3. Zaloguj się przy użyciu swoich danych uwierzytelniających DATEV
4. Po pomyślnym zalogowaniu zobaczysz stronę "Authentication Successful!"
5. Twoje konto DATEV jest teraz połączone

Krok 2: Zweryfikuj swoje konto

Sprawdź, czy Twoje konto DATEV jest połączone.

Wysyłanie faktur do DATEV

Wysyłanie według zakresu dat

• Wyślij wszystkie faktury z danego zakresu dat
• Pobierz faktury jako xml lub pdf do folderu w celu ręcznego przesłania do DATEV

Sprawdzanie statusu faktury

Wyświetl wszystkie faktury (z podziałem na strony)

Znaczenie statusów faktur

Obsługa nieudanych faktur

Nieudane faktury są automatycznie ponawiane maksymalnie 3 razy. Jeśli faktura nadal się nie powiedzie, może być wymagana interwencja ręczna.

Odświeżanie tokenu DATEV

Twój token dostępu DATEV wygasa okresowo. System obsługuje to automatycznie podczas przetwarzania w tle. Aby odświeżyć ręcznie:

Ważne: Jeśli odświeżenie tokenu nie powiedzie się z powodu błędu uwierzytelniania, może być konieczne ponowne połączenie konta DATEV poprzez powtórzenie Kroku 1.

Szybki przewodnik

• Get Invoice XML Preview – Zwraca słownik odwzorowujący ID faktury na zakodowany w Base64 kod XML.
• Fetch PDFs for Saved Invoices – Jeśli faktury zapisano wyłącznie z metadanymi (bez PDF), pobierz ich pliki PDF

Scenariusz przesyłania w tle

Metadane faktur są zapisywane w bazie danych AdlerDo, a następnie automatycznie przesyłane do DATEV w tle.