Tento systém vytváří kompletní obousměrnou synchronizaci mezi Odoo ERP a několika tržišti (eBay, Amazon, Shopify atd.) prostřednictvím AdlerDo. Produkty putují z Odoo na tržiště, aktualizace skladových zásob se synchronizují a objednávky automaticky putují zpět do Odoo.

Architektura systému

Odoo ERP (hlavní zdroj dat) → AdlerDo (integrační centrum) → tržiště (eBay, Amazon, Shopify atd.)

Kompletní integrační cyklus

• Produkty z Odoo: Všechny produkty jsou načteny z Odoo ERP a uloženy v databázi AdlerDo. To zahrnuje detaily produktů, SKU, popisy, ceny a specifikace.
• Aktualizace zásob na tržiště: Skladové množství je načteno z Odoo a automaticky nahráno na všechna připojená tržiště (eBay, Amazon, Shopify atd.), aby zůstaly zásoby synchronizované.
• Objednávky z tržišť: Zákaznické objednávky jsou zachyceny ze všech tržišť a uloženy v AdlerDo, poté jsou automaticky odeslány do Odoo k vyřízení a zpracování.
• Produkty odeslané do Odoo: Aktualizace produktů a nové produkty z AdlerDo jsou odeslány zpět do Odoo, čímž se dokončuje celý synchronizační cyklus.

Čtyři hlavní kroky synchronizace

Krok 1: Produkty z Odoo do AdlerDo

Co provádí: Systém načte všechny produkty z vašeho systému Odoo ERP a uloží je do databáze AdlerDo. Tím vznikne synchronizovaný katalog produktů, který lze distribuovat na více tržišť.

Jaké informace se přenášejí?

1. Informace o produktu

• Název a nadpis produktu
• Popis produktu
• SKU (skladová jednotka)
• Čárový kód / EAN
• Kategorie produktu

2. Ceny a náklady

• Prodejní cena
• Nákladová cena
• Katalogová cena
• Měna
• Daňové informace

3. Detaily produktu

• Obrázky produktu
• Varianty produktu
• Hmotnost a rozměry
• Atributy a specifikace
• Typ produktu

Krok 2: Aktualizace zásob na tržiště

Co provádí: Systém načte aktuální skladové množství z Odoo a automaticky aktualizuje všechna připojená tržiště (eBay, Amazon, Shopify atd.), aby zůstaly zásoby synchronizované v reálném čase.

Jaké informace se přenášejí?

1. Informace o zásobách

• Dostupné množství
• Rezervované zásoby
• Mapování SKU produktu
• Umístění zásob
• Informace o skladu

2. Aktualizace tržišť

• Aktualizace zásob na eBay
• Zásoby Amazon FBA/FBM
• Úrovně zásob na Shopify
• Zásoby na dalších tržištích
• Podpora více umístění

3. Chytré funkce

• Rezerva bezpečnostních zásob
• Prevence přeprodání
• Synchronizace v reálném čase
• Automatické výpočty
• Upozornění na nízké zásoby

Krok 3: Objednávky z tržišť do Odoo

Co provádí: Systém zachytí všechny zákaznické objednávky z připojených tržišť, uloží je v AdlerDo a automaticky vytvoří odpovídající prodejní objednávky v Odoo k vyřízení.

Jaké informace se přenášejí?

1. Informace o objednávce

• Číslo a ID objednávky
• Datum a čas objednávky
• Položky a množství objednávky
• SKU produktů
• Celková částka objednávky

2. Detaily zákazníka

• Jméno zákazníka
• E-mailová adresa
• Telefonní číslo
• Dodací adresa
• Fakturační adresa

3. Další data

• Způsob platby
• Způsob dopravy
• Poznámky k objednávce
• Zdrojové tržiště
• Informace o sledování zásilky

Krok 4: Produkty odeslané do Odoo

Co provádí: Aktualizace produktů, nové produkty a informace o produktech uložené v AdlerDo jsou odeslány zpět do Odoo, aby zůstala hlavní databáze synchronizovaná a byl dokončen integrační cyklus.

Jaké informace se přenášejí?

1. Aktualizace produktů

• Aktualizované detaily produktu
• Úpravy cen
• Změny popisů
• Aktualizace atributů
• Aktualizace obrázků

2. Nové produkty

• Vytvoření nových produktů v Odoo
• Varianty produktu
• Kategorie produktů
• Počáteční úrovně zásob
• Cenové informace

3. Funkce synchronizace

• Prevence duplicit
• Řešení konfliktů
• Validace dat
• Zpracování chyb
• Auditní protokolování

Shrnutí kompletního cyklu

Tento kompletní synchronizační cyklus zajišťuje plynulý tok dat ve všech směrech. Produkty putují z Odoo na tržiště, zásoby jsou průběžně synchronizovány, objednávky putují zpět do Odoo a aktualizace produktů cyklus dokončují. Vše probíhá automaticky a vytváří jednotný ekosystém napříč všemi vašimi prodejními kanály!

Proč je tento kompletní cyklus důležitý

1. Plná automatizace Kompletní obousměrná synchronizace eliminuje veškeré ruční zadávání dat

2. Jednotný zdroj pravdy Odoo zůstává hlavní databází pro všechny informace o produktech

3. Synchronizace v reálném čase Všechny změny se okamžitě šíří napříč všemi platformami

4. Snadné škálování Přidávejte další tržiště bez dodatečné složitosti

AdlerDo

Stáhnout zde

Systémové požadavky

• RAM: 4 GB nebo více
• CPU: 2 virtuální jádra nebo více
• Úložiště: 40 GB SSD nebo více

Krok 1: ASP.NET Core 8.0

Odkaz ke stažení

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

Struktura projektu / soubory aplikace

• Backendový modul – s názvem: marketplace_api
• Frontendový modul – s názvem: coresystem_wbf

Krok 2: Instalace AdlerDo

• Nejprve nainstalujte Marketplace Setup Api

Zaškrtněte políčko pro souhlas s licencemi a poté klikněte na Install. Poté počkejte na dokončení instalace.

• Po dokončení instalace stiskněte Finish.

Je nezbytné se po instalaci ujistit, že služba běží na pozadí.

Krok 3: Otevřete aplikaci AdlerDo

• Instalace je dokončena. Nyní můžete zadat své uživatelské jméno a heslo.

Dokumentace k nastavení integrace tržišť

Integrace účtů (Připojte a spravujte své účty tržišť a ERP pro bezproblémový vícekanálový prodej)

Integrace AdlerDo:

• Připojte účty tržišť (Kaufland, Shopify, PrestaShop, JTL atd.)
• Automaticky synchronizujte produkty, zásoby a objednávky
• Poskytněte centralizovanou správu všech prodejních kanálů z jednoho místa
• Ušetřete čas a snižte počet ručních chyb

Kroky integrace

Krok 1: Přístup na stránku účtů

• V levém bočním menu klikněte na „ Účty ".
• Otevře se stránka „ Integrace účtů ".

Krok 2: Vyberte typ účtu / tržiště

Z rozbalovací nabídky „ Vybrat " zvolte platformu, kterou chcete integrovat, z dostupných tržišť.

Krok 3: Zadání přihlašovacích údajů

Budete muset zadat následující informace (mohou se mírně lišit v závislosti na platformě)

Krok 4: Přidání nového účtu

• Na stránce Integrace účtů klikněte na tlačítko „ Přidat nový účet " (zelené tlačítko v pravém horním rohu stránky).
• Zobrazí se vyskakovací okno nebo nová stránka pro zadání údajů o účtu.

Smazání účtu

Tato funkce vám umožňuje odpojit váš účet tržiště.

Po přihlášení k vašemu účtu se zobrazí stránka Adlerdo.

Co je správa produktů?

Toto rozhraní je vaším řídicím centrem pro správu katalogu produktů a zásob v systému Adlerdo. Umožňuje vám přidávat, upravovat, importovat a exportovat produkty a poté je odesílat přímo na online tržiště připojená k vašemu účtu.

1- Vyhledávací pole

Vyhledejte konkrétní produkt pomocí jeho názvu, SKU nebo jakékoli jiné informace.

2- Sekce výběru tržiště a účtu

• Vybrat tržiště: Rozbalovací nabídka pro výběr online tržiště, na kterém chcete pracovat (například Amazon, Shopify, eBay atd.).
• Vybrat účet: Rozbalovací nabídka pro výběr účtu propojeného s tímto tržištěm (užitečné, pokud máte na stejném tržišti více účtů).
• Tlačítko Odeslat na tržiště: Po výběru tržiště a účtu klikněte na toto tlačítko pro odeslání vybraných produktů na zvolené tržiště.

3- Hlavní akční tlačítka

• Přidat: Ruční přidání nového produktu
• Upravit: Úprava detailů vybraných produktů (musí být vybrán alespoň jeden produkt).
• Dynamický import produktu: Dynamický import produktů z externího zdroje (např. souboru Excel nebo API).
• Dynamický import varianty: Dynamický import variant produktu (jako je velikost, barva atd.).
• Export: Export aktuálního seznamu produktů do souboru (Excel nebo CSV) pro externí použití nebo zálohu

4- Popis sloupců tabulky produktů

• Název: Název produktu (např. „Desk Combination", „headcall")
• SKU: Jedinečný identifikátor produktu (skladová jednotka) — vyžadován pro synchronizaci
• Cena: Cena produktu (při úpravě se automaticky aktualizuje na tržištích).
• GTIN / MPN / ASIN / UPC: Globální klasifikační kódy produktu (důležité pro tržiště jako Amazon a eBay).
• TaricCoc: Evropský celní kód (pokud je relevantní — důležitý pro mezinárodní přepravu).
• OriginCountry: Země původu — vyžadována některými tržišti
• Varianty: Zelené tlačítko u každého produktu pro zobrazení nebo správu jeho variant (např. barvy, velikosti…).
• Galerie: Zelené tlačítko pro zobrazení nebo přidání obrázků produktu (typicky pro zobrazení na tržišti).

Systém poskytuje výkonné nástroje dynamického importu a exportu, které vám umožňují spravovat data produktů s maximální flexibilitou. Tyto funkce podporují snadný import a export informací o produktech na jakékoli tržiště a z něj.

Dynamický import produktu

Funkce Dynamický import produktu vám umožňuje nahrát data produktů z libovolného formátu nebo struktury souboru, aniž byste potřebovali předdefinovanou šablonu.

Klíčové schopnosti

• Podporuje libovolné uspořádání listu nebo pořadí sloupců (Excel, CSV atd.).
• Automaticky rozpoznává a mapuje vaše sloupce na pole systému.
• Umožňuje importovat rozsáhlé katalogy produktů během několika sekund.
• Vhodné pro synchronizaci dat od dodavatelů nebo z externích systémů.

Jak používat Dynamický import produktu

Krok 1 — Otevřete stránku importu

Přejděte na:

Produkty → Import → Dynamický import produktu

Krok 2 — Nahrajte svůj soubor

• Klikněte na import excel fill
• Vyberte svůj soubor (Excel / CSV / libovolný formát)

Systém podporuje libovolnou strukturu sloupců — není třeba nic přeuspořádávat.

Krok 3 — Automatické mapování sloupců

Po nahrání:

• Systém automaticky rozpozná názvy sloupců
• Namapuje každý sloupec na správné pole (Název, SKU, Cena, GTIN atd.)

Pokud si systém není jistý některým sloupcem, požádá vás o ruční výběr správného pole.

Krok 4 — Zkontrolujte a potvrďte

Zkontrolujte náhled mapování:

• Ujistěte se, že sloupce jsou správně přiřazeny
• V případě potřeby proveďte úpravy

Poté klikněte na Potvrdit.

Krok 5 — Nahrání

• Stiskněte nahrát.
• Vaše produkty budou okamžitě vytvořeny nebo aktualizovány.

Ideální pro dodavatelské listy, vlastní formáty nebo exporty z tržišť.

Stáhnout šablonu importu

Když kliknete na zelené tlačítko Stáhnout šablonu importu → systém okamžitě stáhne připravený soubor Excel s názvem Product_Import_Template.xlsx

Kam chcete importované produkty publikovat?

Po importu produktů (ať už ze souboru Excel nebo prostřednictvím dynamického importu) je tato sekce zodpovědná za rozhodnutí, přesně na která tržiště a prodejní účty budou produkty automaticky publikovány ihned po dokončení importu. Pokud zde není vybráno žádné tržiště ani účet → produkty budou přidány pouze do vašeho katalogu a NEBUDOU publikovány na žádné tržiště.

Podrobné pokyny krok za krokem

Krok 1

• Akce: Z první rozbalovací nabídky „Vybrat tržiště" zvolte požadované tržiště.
• Očekávaný výsledek: Druhá rozbalovací nabídka „Vybrat účet" se aktualizuje a zobrazí pouze účty propojené s tímto tržištěm.

Krok 2

• Akce: Z druhé rozbalovací nabídky zvolte konkrétní prodejní účet, na který chcete publikovat.

Krok 3

• Akce: Klikněte na oranžové tlačítko Přidat do seznamu.
• Očekávaný výsledek: Tržiště + účet se zobrazí v tabulce níže.

Krok 4

• Akce: Opakujte kroky 1–3 pro přidání dalších tržišť/účtů (pokud chcete publikovat na více míst).
• Očekávaný výsledek: Každé nové přidání = importované produkty budou automaticky publikovány i na tento účet.

Krok 5

• Akce: Chcete-li odebrat tržiště/účet ze seznamu → klikněte na Smazat v tabulce.
• Očekávaný výsledek: Toto tržiště/účet již nebude importované produkty přijímat.

Krok 6

• Akce: Po dokončení → klikněte na Nahrát vybrané nebo Import ve spodní části.
• Očekávaný výsledek: Produkty jsou importovány + okamžitě publikovány na každé tržiště a účet uvedený v tabulce.

Důležitá poznámka

Pokud tabulku ponecháte prázdnou (nepřidáte žádné tržiště ani účet), produkty budou uloženy pouze ve vašem systému a nebudou publikovány na žádné tržiště, dokud je později ručně nepřidáte ze stránky jednotlivého produktu.

Dynamický import varianty

Funkce Dynamický import varianty umožňuje uživatelům nahrát data variant produktů z libovolného formátu nebo struktury souboru — bez potřeby předdefinované šablony.

Tento nástroj je navržen tak, aby zjednodušil import katalogů bohatých na varianty.

Klíčové funkce

• Není vyžadována pevná šablona
• Automaticky rozpoznává a mapuje sloupce souboru
• Chytrý systém propojuje varianty s jejich nadřazenými produkty
• Podporuje neomezené atributy variant
• Ideální pro dodavatele, exporty z tržišť nebo externí systémy

Jak to funguje

Nejprve: Nahrajte svůj soubor

1. Přejděte na: Produkty → Import → Dynamický import varianty
2. Klikněte na Nahrát soubor vybrat

Systém přijímá libovolnou strukturu — sloupce mohou být v libovolném pořadí.

Za druhé: Automatické rozpoznání sloupců

Po nahrání:

• Systém prohledá list
• Rozpozná relevantní sloupce (SKU, Nadřazené SKU, Velikost, Barva, Cena atd.)
• Automaticky navrhne mapování polí

Pokud je některý sloupec nejasný, systém zobrazí rozbalovací nabídku, abyste mohli ručně zvolit správné pole.

Komponenta Atributy produktu

Tato komponenta umožňuje uživateli přiřadit produktu atributy výběrem názvu atributu a odpovídající hodnoty a jejich následným přidáním do seznamu.

Účel komponenty

1. Sekce Atributy produktu umožňuje uživateli: Vybrat název atributu, Vybrat hodnotu atributu související s tímto názvem.
2. Přidat vybranou dvojici do seznamu atributů
3. Spravovat (upravovat/mazat) položky atributů v tabulce

Tím je zajištěno, že každý produkt může mít jednu nebo více dvojic atribut/hodnota, které popisují jeho varianty.

Tlačítko Stáhnout varianty

Tlačítko Stáhnout varianty umožňuje uživateli stáhnout připravený soubor Excel obsahující šablonu určenou pro zadávání dat variant produktu.

Tato šablona pomáhá uživateli připravit data ve správném formátu před jejich nahráním do systému.

Tlačítko Export

Tlačítko Export umožňuje uživatelům stáhnout všechny produkty aktuálně zobrazené na obrazovce Správa produktů — nebo pouze vybrané produkty — v přehledném a strukturovaném souboru Excel.

Tento soubor je generován okamžitě a obsahuje kompletní data produktů přesně tak, jak jsou zobrazena v tabulce produktů systému.

Když uživatel klikne na Export, systém:

Shromáždí buď:

• Pouze vybrané produkty (pokud uživatel zaškrtl konkrétní řádky).
• Vygeneruje soubor Excel obsahující strukturované informace o produktech.
• Okamžitě stáhne soubor do zařízení uživatele.

Formát exportovaného souboru

Exportovaný soubor Excel obsahuje všechna standardní pole produktu, jako například:

• Název produktu
• SKU
• Cena
• GTIN
• MPN
• ASIN
• UPC
• Kód Taric
• Země původu
• Varianty (jsou-li k dispozici)
• Jakékoli další vlastní atributy zobrazené v tabulce

Soubor používá stejnou strukturu a sloupce jako váš seznam produktů uvnitř systému, čímž zajišťuje:

• Snadnou úpravu
• Snadný opětovný import pomocí dynamického importu
• Kompatibilitu se všemi připojenými tržišti

Stránka Přidat nový produkt vám umožňuje snadno přidávat a spravovat produkty napříč různými tržišti. Zadáním základních detailů produktu a výběrem svých účtů tržišť můžete rychle vystavit a aktualizovat produkty na více platformách z jednoho místa. Tato funkce zajišťuje bezproblémové nahrávání produktů, správu variant a synchronizaci v reálném čase s vašimi účty tržišť.

1- Klikněte na zelené tlačítko + Přidat v levém horním rohu lišty hlavních akcí

2- Otevře se formulář pro vytvoření produktu

3- Účty tržišť při vytváření produktu

Účty tržišť

Krok 1:

Z rozbalovací nabídky „Vybrat tržiště" zvolte požadované tržiště (např. Amazon)

Krok 2:

Rozbalovací nabídka „Vybrat účet" se automaticky obnoví a zobrazí pouze účty propojené s vybraným tržištěm

Krok 3:

Z rozbalovací nabídky „Vybrat účet" zvolte konkrétní prodejní účet, který chcete použít

Krok 4:

Tržiště i účet jsou nyní vybrány

Krok 5:

Klikněte na oranžové tlačítko Přidat do seznamu

Krok 6:

V tabulce „Vybrané účty tržišť" se okamžitě objeví nový řádek

4- Použití krok za krokem (Jak přidat nové varianty a přidat atribut)

Krok 1:

Klikněte na + Nová varianta (zelené tlačítko nahoře)

Krok 2:

Vyplňte název varianty

Krok 3:

Zadejte jedinečné SKU

Krok 4:

Nastavte cenu a dostupné množství pro tuto variantu

Krok 5:

Klikněte na + Přidat atribut → Vyberte typ atributu

Krok 6:

Klikněte na Uložit produkt

Průvodce správou kategorií

Sekce Správa kategorií vám umožňuje organizovat produkty ve vašem obchodě vytvářením, úpravou a mazáním kategorií.

Přístup na stránku Správa kategorií

V levém bočním panelu klikněte na Kategorie, jak je znázorněno na obrázku.

Budete přesměrováni na stránku Správa kategorií, která obsahuje:

1. Tlačítko Přidat pro vytvoření nové kategorie
2. Tlačítko Upravit pro úpravu vybrané kategorie
3. Tlačítko Smazat pro odebrání vybrané kategorie
4. Tabulku zobrazující názvy stávajících kategorií

Krok 1: Přidání nové kategorie (Přidat kategorii)

1. Klikněte na tlačítko Přidat (zelené tlačítko).
2. Zobrazí se formulář umožňující zadat detaily kategorie:
   Název: název kategorie
3. Po zadání informací klikněte na Uložit.
4. Nová kategorie se okamžitě objeví v tabulce.

Krok 2: Úprava kategorie (Upravit kategorii)

Z tabulky kategorií vyberte kategorii, kterou chcete upravit (kliknutím na ni).

1. Klikněte na tlačítko Upravit (oranžové tlačítko).
2. Zobrazí se formulář s aktuálními detaily kategorie.
3. Proveďte potřebné změny.
4. Klikněte na Uložit pro uložení úprav.

Krok 3: Smazání kategorie (Smazat kategorii)

Z tabulky kategorií vyberte kategorii, kterou chcete smazat.

1. Klikněte na tlačítko Smazat (červené tlačítko).
2. Zobrazí se upozornění s potvrzením smazání.
3. Klikněte na Potvrdit pro dokončení procesu.
4. Kategorie bude odebrána ze seznamu.

Sledujte a spravujte zákaznické objednávky.

Stránka Správa objednávek vám umožňuje zobrazit všechny zákaznické objednávky, zkontrolovat stav platby, zobrazit časy vytvoření a odeslání a otevřít detaily každé objednávky.

Z bočního panelu vlevo:

Kliknutím na Objednávky přejdete na stránku Objednávky.

Vyhledávání objednávek

• Použijte vyhledávací pole v horní části stránky pro vyhledávání podle čísla objednávky.
• Zadejte číslo objednávky a poté klikněte na tlačítko vyhledávání (🔍).
• Systém zobrazí pouze objednávky, které odpovídají hledanému výrazu.

Obnovení dat

• Klikněte na tlačítko Obnovit umístěné v pravém horním rohu stránky.
• Toto tlačítko načte nejnovější data objednávek ze serveru.

Tabulka objednávek

Tabulka zobrazuje všechny objednávky s následujícími sloupci:

1- Číslo objednávky

Zobrazuje jedinečné číslo objednávky (např. #1057).

2- Stav

Zobrazuje stav objednávky (např. Zaplaceno).

3- Způsob platby

Udává způsob platby použitý zákazníkem (např. Kreditní karta).

4- Čas vytvoření

Zobrazuje datum a čas vytvoření objednávky.

5- Čas odeslání

Zobrazuje čas odeslání objednávky (je-li k dispozici).

6- Detaily objednávky

Každý řádek obsahuje tlačítko Detaily. Kliknutím na něj můžete zobrazit úplné detaily objednávky.

Správa zákazníků

Sekce Správa zákazníků vám umožňuje spravovat informace o zákaznících a vztahy s nimi organizovaným a snadným způsobem.

V levém bočním panelu klikněte na Zákazníci, jak je naznačeno červenou šipkou na obrázku.

Budete přesměrováni na stránku Správa zákazníků, která obsahuje:

• Vyhledávací pole pro nalezení zákazníků podle jména nebo čísla
• Tlačítka Přidat, Upravit a Smazat pro správu informací o zákaznících
• Tabulku zobrazující aktuální zákazníky s jejich jmény a čísly spolu s tlačítkem pro zobrazení adresy každého zákazníka

Krok 1: Přidání nového zákazníka (Přidat zákazníka)

1. Klikněte na tlačítko Přidat (zelené tlačítko).
2. Zobrazí se okno nebo formulář pro zadání údajů zákazníka:
   • Jméno zákazníka: jméno zákazníka
   • Číslo zákazníka: číslo zákazníka
   • Další informace požadované systémem (např. adresa, e-mail, telefon…)
3. Po zadání údajů klikněte na Uložit pro přidání zákazníka.
4. Nový zákazník se objeví v tabulce zákazníků.

Krok 2: Úprava informací o zákazníkovi (Upravit zákazníka)

1. Z tabulky zákazníků vyberte zákazníka, jehož informace chcete upravit (kliknutím na jeho jméno).
2. Klikněte na tlačítko Upravit (oranžové tlačítko).
3. Zobrazí se okno s informacemi o zákazníkovi.
4. Proveďte potřebné změny.
5. Klikněte na Uložit pro uložení úprav.

Krok 3: Smazání zákazníka (Smazat zákazníka)

1. Z tabulky vyberte zákazníka, kterého chcete smazat.
2. Klikněte na tlačítko Smazat (červené tlačítko).
3. Zobrazí se okno s potvrzením smazání.
4. Klikněte na Potvrdit pro dokončení smazání.
5. Zákazník bude odebrán ze seznamu.

Modul Správa záznamů protokolu umožňuje správcům systému sledovat aktivitu systému a řešit problémy prostřednictvím kontroly podrobných záznamů protokolu.

Přístup na stránku Systémový protokol

Na stránku systémového protokolu se dostanete z bočního panelu:

Boční panel → Záznamy protokolu

(Zvýrazněno v červeném rámečku na obrázku)

Tabulka záznamů protokolu

Tabulka zobrazuje všechny záznamy systémového protokolu s následujícími sloupci:

• Zpráva protokolu:

  • Text nebo typ zaznamenané události (např. Varianty produktu).
  • Představuje typ aktivity nebo položku související se záznamem protokolu.

• Časové razítko:

  • Datum a čas, kdy byla událost zaznamenána.
  • Zobrazuje přesné načasování (např. 11/19/2025 1:10:40 PM).

• Název akce:

  • Typ akce provedené v systému (např. Upraveno označuje, že něco bylo upraveno).

• Uživatel:

  • Jméno uživatele nebo správce, který akci provedl.

Záložka Uživatelé slouží ke správě uživatelů systému přidáváním nových uživatelů, úpravou informací stávajících uživatelů nebo jejich mazáním.

Přístup k záložce Uživatelé

Chcete-li začít spravovat uživatele, vyberte z bočního panelu Uživatelé. Otevře se stránka Uživatelé, kde jsou vypsáni všichni uživatelé systému.

V horní části stránky jsou tři tlačítka pro správu dat uživatelů:

Přidání nového uživatele

Klikněte na tlačítko Přidat uživatele v horní části stránky. Otevře se okno s poli k vyplnění, včetně:

• Zobrazované jméno
• Uživatelské jméno
• E-mail
• Telefonní číslo
• Heslo

Po vyplnění polí klikněte na Uložit pro přidání nového uživatele do systému.

Úprava stávajícího uživatele

Z tabulky vyberte uživatele, kterého chcete upravit, a klikněte na Upravit uživatele. Aktualizujte potřebné informace a poté klikněte na Uložit změny pro použití aktualizací.

Smazání uživatele

Chcete-li smazat uživatele, vyberte jej z tabulky a klikněte na Smazat uživatele. Potvrďte smazání pro trvalé odstranění účtu.

Tipy pro správu uživatelů

• Před uložením změn vždy dvakrát zkontrolujte informace o uživateli.
• Používejte silná a bezpečná hesla pro všechny účty.
• Pravidelně kontrolujte a odstraňujte neaktivní nebo nepotřebné uživatele, aby byl systém přehledný.

Tato stránka je věnována správě zásilek zákaznických objednávek, sledování jejich stavu, identifikaci přepravní společnosti a zobrazení dat souvisejících s každou zásilkou.

Krok 1: Přístup na stránku Zásilky

V levém bočním panelu se posuňte dolů, dokud nenajdete „Doprava".

Klikněte na ni a otevře se stránka Správa zásilek, jak je znázorněno na obrázku.

Stav dopravy – Jak jej používat krok za krokem

Nejprve: Kde se v systému zobrazují stavy zásilek

Stavy zásilek se zobrazují na stránce Správa zásilek na následujícím místě:

Z levého menu:

• Posuňte se dolů, dokud nenajdete Doprava
• Klikněte na ni

Otevře se stránka Správa zásilek.

V horní části stránky najdete sekci nazvanou Filtry.

Uvnitř filtrů je rozbalovací nabídka s názvem: Stav dopravy

Když kliknete na rozbalovací nabídku, objeví se následující stavy:

• Čekající – Klikněte na tento stav pro zobrazení zásilek, které se stále připravují.
• Dokončeno – Klikněte na tento stav pro zobrazení zásilek, které byly doručeny nebo dokončeny.
• Zrušeno – Klikněte na tento stav pro zobrazení zásilek, které byly zrušeny.

Krok 2: Klikněte na tlačítko Filtrovat

Po výběru stavu klikněte na zelené tlačítko Filtrovat.

Krok 3: Zobrazte výsledky

Tabulka níže se aktualizuje a zobrazí pouze zásilky, které odpovídají vybranému stavu.

Kde se zobrazuje seznam přepravců

Na stránce Správa zásilek, nad tabulkou zásilek, najdete sekci Filtry.

V rámci filtrů je rozbalovací nabídka s názvem Přepravce.

Funkce seznamu přepravců

Slouží k výběru přepravní společnosti, jejíž zásilky chcete zobrazit.

Jak používat seznam přepravců

Klikněte na rozbalovací nabídku vedle Přepravce.

Uvidíte seznam dostupných přepravních společností, jako například:

• Vše (pro zobrazení všech společností)
• DHL Internetmarke
• DB Schenker Land
• DB Schenker Air
• DB Schenker Ocean FCL
• DB Schenker Ocean LCL

Vyberte přepravní společnost, jejíž zásilky chcete zobrazit.

Filtrování zásilek podle přepravce

Po výběru přepravní společnosti klikněte na zelené tlačítko Filtrovat vedle rozbalovacích nabídek.

Tabulka zásilek se aktualizuje a zobrazí pouze zásilky používající vybranou přepravní společnost.

Důležité poznámky

• Výběr možnosti Vše v rozbalovací nabídce zobrazí zásilky od všech přepravních společností bez filtrování.
• Tato funkce vám pomáhá rychle a snadno se zaměřit na zásilky konkrétní společnosti.

Tabulka informací o zásilkách

Pod filtry najdete tabulku obsahující informace o zásilkách, která zahrnuje následující sloupce:

Toto rozhraní vám umožňuje spravovat a propojovat účty různých přepravních společností v rámci systému, jako jsou DHL a DB Schenker. Jeho prostřednictvím můžete přidávat nové účty, upravovat je, mazat je nebo dobíjet zůstatek přepravní peněženky přiřazené k účtu.

1. Přístup na stránku Účty přepravců

V levém bočním panelu:

Vyberte Účty přepravců (zvýrazněno červeně na obrázku).

Poté uvidíte seznam dostupných přepravců pod položkou Připojené účty.

2. Dostupní přepravci

V příkladu se objevují následující:

• DHL Internetmarke (zvýrazněno červeně)
• DB Schenker

Když kliknete na kteréhokoli přepravce, zobrazí se jeho nastavení správy.

3. Stránka správy účtu DHL

Při výběru DHL Internetmarke se zobrazí stránka správy účtu DHL, která obsahuje:

• Přidat účet (zelené) – Přidání nového účtu DHL do systému
• Upravit účet (žluté) – Úprava stávajícího účtu
• Smazat (červené) – Smazání účtu ze systému
• Dobít peněženku účtu (oranžové) – Dobití zůstatku peněženky účtu DHL

4. Tabulka účtů

Pod tlačítky se objeví tabulka obsahující registrované účty DHL.

Dostupné sloupce:

• Username: Uživatelské jméno účtu DHL
• Create Shipping List: Udává, zda lze pro tento účet vytvořit přepravní seznam
• DPI: Požadované rozlišení přepravního štítku
• Voucher Layout: Rozvržení přepravního štítku/dokladu

V současné době je tabulka prázdná, protože zatím nebyl přidán žádný účet.

Přehled pracovního postupu

➤ Přidání nového účtu:

Když kliknete na tlačítko Přidat účet v rozhraní správy účtu DHL, objeví se nové okno umožňující zadat informace o novém účtu DHL spolu s nastaveními souvisejícími s tiskem a přepravou.

Popis klíčových polí

• Email a Password: Základní přihlašovací údaje k účtu. Musí být zadány přesně, aby se systém mohl připojit k účtu DHL.
• Create Shipping List: Určuje, kolik přepravních seznamů bude vytvořeno, což je užitečné při více zásilkách.
• DPI: Rozlišení tisku, které určuje kvalitu a ostrost štítků.
• Voucher Layout: Návrh nebo šablona přepravního štítku, který bude vytištěn.
• Page Format, Width, Height, Page Type, Orientation: Podrobná nastavení pro řízení velikosti a rozvržení tiskové stránky.
• Space X, Space Y: Rozestupy mezi štítky na stránce.
• Count X, Count Y: Počet štítků vodorovně a svisle.
• Margin Top, Margin Left: Nastavuje horní a levý okraj stránky pro řízení pozice tisku.

Jak používat

1. Otevřete okno Přidat nový účet DHL kliknutím na tlačítko Přidat účet.
2. Vyplňte základní pole (Email a Password).
3. Upravte nastavení tisku podle svých potřeb (DPI, Voucher Layout, velikost stránky, okraje atd.).
4. Klikněte na Uložit nebo Potvrdit (tlačítko není na obrázku zobrazeno, ale obvykle se nachází ve spodní části formuláře) pro uložení nového účtu.
5. Po uložení se nový účet objeví v seznamu účtů DHL v hlavním okně.

➤ Úprava účtu:

1. Vyberte účet z tabulky
2. Klikněte na Upravit účet
3. Upravte požadované informace
4. Klikněte na Uložit

➤ Smazání účtu:

1. Vyberte účet z tabulky
2. Klikněte na Smazat

➤ Dobití zůstatku účtu:

1. Klikněte na Dobít peněženku účtu
2. Zadejte částku dobití
3. Potvrďte transakci

Kroky pro vytvoření účtu DHL (účet, který poskytuje Email + Password)

Krok 1 — Přejděte na oficiální web DHL

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

Krok 2 — Klikněte na Sign Up / Register

Najdete tlačítko jako například:

• Register
• Create Account
• Nebo Business Login → Register

Krok 3 — Vyberte typ účtu

DHL nabízí dva typy účtů:

1. Personal Account (nevhodný pro integraci přes API)
2. Business Account (vyžadován pro integraci se systémem)

Měli byste vybrat: Business Account

Krok 4 — Zadejte požadované informace

Budete požádáni o poskytnutí:

• Email
• Create a Password
• Company Information
• Mobile Number
• Your Address

Krok 5 — Aktivujte účet

DHL vám zašle e-mail pro potvrzení vašeho účtu.

Krok 6 — Přihlaste se pomocí nového účtu

Po aktivaci se můžete přihlásit do portálu DHL.

Systém DB Schenker poskytuje přepravní služby a umožňuje uživatelům přidávat a spravovat přepravní účty DB Schenker pro usnadnění jejich přepravních operací.

Přístup k sekci přepravních účtů

V levém bočním menu klikněte na Carrier Accounts. Otevře se stránka Carrier Accounts Integration.

Přístup k účtu DB Schenker

Mezi propojenými účty vyhledejte DB Schenker. Kliknutím na něj otevřete stránku pro správu účtu.

Funkce přidání účtu

Funkce "Add Account" umožňuje přidat nový účet DB Schenker pro efektivní správu vašich přepravních operací.

Kroky pro přidání nového účtu

• Přístup ke stránce správy účtů: V bočním menu vyberte Carrier Accounts.
• Klikněte na Add Account: V horní části stránky Správa účtu DB Schenker klikněte na zelené tlačítko Add Account.

• Vyplňte informace o účtu:
  • Access Key: Povinné pole poskytnuté společností DB Schenker
  • Measurement Type: Metrický nebo imperiální
  • Unit of Measurement: Kilogramy, metry, krychlové metry, kusy

Přidání způsobu přepravy

Klikněte na Add Method a vyberte způsob přepravy:

• Námořní přeprava
• Letecká přeprava
• Pozemní přeprava

Kliknutím na Save Changes potvrďte, nebo na Cancel akci zrušte.

Úprava účtu

Po přidání klikněte na oranžové tlačítko Edit Account vedle účtu DB Schenker a aktualizujte údaje.

Smazání účtu

Klikněte na Delete Account a potvrďte trvalé odstranění účtu a všech souvisejících dat.

Kde se účty zobrazují

Účty se zobrazují v tabulce správy účtů DB Schenker, která obsahuje:

• ID účtu
• Access Key
• Typ měření
• Měrnou jednotku
• Počet metod
• Akce

Tabulka je aktuálně prázdná, protože zatím nebyly přidány žádné účty.

Bezproblémové propojení mezi vaším marketplace, AdlerDo a Odoo

Vítejte ve vaší integraci marketplace

Tento systém automaticky propojuje váš obchod na marketplace se systémem Odoo ERP prostřednictvím AdlerDo. Produkty, objednávky a skladové zásoby se synchronizují automaticky, což vám šetří čas a snižuje počet chyb.

Architektura systému

Marketplace: Váš online obchod → AdlerDo: Integrační platforma → Odoo: ERP systém

Tři hlavní funkce

1-Synchronizace produktů

Marketplace → AdlerDo → Odoo

Co dělá: Když vytvoříte nebo aktualizujete produkt ve svém marketplace, systém automaticky vytvoří nebo aktualizuje stejný produkt v Odoo se všemi jeho podrobnostmi, jako jsou název, popis, cena, SKU, obrázky a varianty.

Jak to funguje

Produkt na marketplace → AdlerDo → Produkt v Odoo

Jaké informace se přenášejí?

Základní informace

• Název a titulek produktu
• Popis produktu
• SKU (Stock Keeping Unit)
• Čárový kód / UPC
• Typ a kategorie produktu

Ceny a finanční údaje

• Prodejní cena
• Srovnávací cena
• Náklady na položku
• Daňové informace
• Měna

Podrobnosti o produktu

• Obrázky produktu
• Varianty produktu (velikost, barva atd.)
• Hmotnost a rozměry
• Štítky a kolekce
• Informace o dodavateli

Kroky procesu

1. Vytvořte nebo aktualizujte produkt ve svém marketplace
2. AdlerDo zachytí a uloží data produktu
3. Produkt se automaticky vytvoří v Odoo

2- Synchronizace objednávek

Marketplace → AdlerDo → Odoo

Co dělá: Když zákazník zadá objednávku ve vašem obchodě na marketplace, systém automaticky vytvoří stejnou objednávku v Odoo se všemi údaji o zákazníkovi, objednanými položkami, dodací adresou a platebními informacemi.

Jak to funguje

Objednávka na marketplace → AdlerDo → Objednávka v Odoo

Jaké informace se přenášejí?

Informace o zákazníkovi

• Jméno zákazníka
• E-mailová adresa
• Telefonní číslo
• ID zákazníka
• Poznámky zákazníka

Podrobnosti objednávky

• Číslo objednávky
• Položky objednávky a množství
• SKU produktů
• Celková částka objednávky
• Datum a čas objednávky

Kroky procesu

1. Zákazník zadá objednávku ve vašem marketplace
2. AdlerDo zachytí a zpracuje objednávku
3. Objednávka se automaticky vytvoří v Odoo

3- Aktualizace skladových zásob

Odoo → AdlerDo → Marketplace

Co dělá: Když se ve vašem Odoo změní skladové zásoby (v důsledku prodejů, nákupů nebo úprav), systém automaticky aktualizuje množství zásob u vašich produktů na marketplace.

Jak to funguje

Sklad v Odoo → AdlerDo → Produkt na marketplace

Jaké informace se přenášejí?

Informace o skladu

• Dostupné množství
• Rezervované zásoby
• SKU produktu
• Umístění skladu
• Sledování skladu

Aktualizace skladových zásob

• Aktualizace množství ve vašem marketplace
• Zobrazení jako "Skladem"
• Zobrazení jako "Není skladem"
• Sledování stavu zásob
• Podpora více umístění

Chytré funkce

• Bezpečnostní zásoba
• Zabránění přeprodeji
• Aktualizace v reálném čase
• Automatické výpočty
• Upozornění na nízké zásoby

Kroky procesu

1. Změna zásob v Odoo
2. AdlerDo uloží a vypočítá nové množství
3. Skladové zásoby na marketplace se automaticky aktualizují

Shrnutí

Tyto tři funkce spolupracují a vytvářejí kompletní automatizační systém. Vaše produkty a zásoby proudí z vašeho marketplace do Odoo, vaše objednávky proudí z vašeho marketplace do Odoo a aktualizace skladových zásob proudí z Odoo zpět do vašeho marketplace. Vše probíhá automaticky bez jakékoli manuální práce!

Proč vám to pomáhá

• Úspora času: Žádné další ruční zadávání dat ani kopírování informací mezi systémy
• Snížení počtu chyb: Automatická synchronizace znamená žádné lidské chyby ani omyly
• Data v reálném čase: Vždy máte přesné a aktuální informace napříč všemi platformami
• Rychlejší růst: Zvládněte více objednávek a produktů bez práce navíc

Integrační systém marketplace poháněný AdlerDo

Automatická synchronizace mezi marketplace a Odoo

© 2024 AdlerDo Integration Platform

Testovací prostředí AdlerDoo a Odoo

Tento návod vám ukáže, jak připojit váš účet Amazon Seller Central. Informace specifické pro zákazníka, jako jsou adresy URL serverů, uživatelská jména, e-mailové adresy nebo názvy společností, byly na snímcích obrazovky záměrně skryty.

Důležité: Vždy používejte přihlašovací údaje, které vám byly zaslány samostatně a zabezpečeně. Neposílejte prosím hesla ani kódy 2FA běžným e-mailem.

Část A – Připojení Amazonu v AdlerDoo

Požadavky

• Přístup ke vzdálené ploše poskytnutého virtuálního počítače
• Uživatelské jméno a heslo AdlerDoo
• Přihlašovací údaje k Amazon Seller Central
• Přístup k dvoufaktorovému ověření / OTP Amazonu, pokud je vyžadováno

Krok 1: Vyhledejte Připojení ke vzdálené ploše

Otevřete vyhledávání Windows a vyhledejte "Připojení ke vzdálené ploše". Poté aplikaci spusťte.

Krok 2: Otevřete Vzdálenou plochu a zadejte přístupové údaje

Do pole "Počítač" zadejte adresu URL virtuálního počítače, která vám byla zaslána samostatně. Poté zadejte uživatelské jméno. Následně klikněte na "Připojit".

Krok 3: Zadejte heslo

Zadejte heslo k virtuálnímu počítači a potvrďte tlačítkem "OK". Virtuální počítač se poté otevře.

Krok 4: Otevřete program AdlerDoo

Na ploše virtuálního počítače klikněte na zástupce programu AdlerDoo. Neotevírejte zde prosím prohlížeč; otevřete aplikaci AdlerDoo.

Krok 5: Přihlaste se do AdlerDoo

Přihlaste se pomocí přístupových údajů AdlerDoo, které vám byly zaslány samostatně.

Krok 6: Otevřete Apps Management

Po přihlášení otevřete v levém menu sekci "Integrations" a poté otevřete "Apps Management".

Krok 7: Vytvořte účet Amazon

V sekci "Management Amazon Account" klikněte na "Create Amazon Account".

Krok 8: Přihlaste se do Amazon Seller Central

Prohlížeč otevře přihlašovací stránku Amazonu. Zadejte přihlašovací údaje k Amazon Seller Central a v případě potřeby potvrďte dvoufaktorové ověření.

Krok 9: Udělte oprávnění

Postupujte podle pokynů Amazonu a udělte požadovaná oprávnění. Po úspěšné autorizaci budete přesměrováni nebo obdržíte zprávu o úspěchu.

Krok 10: Zkontrolujte připojení

Poté v AdlerDoo zkontrolujte, zda se účet Amazon zobrazuje jako připojený. Pokud se připojení nezobrazuje, obnovte zobrazení nebo informujte podporu.

Část B – Připojení Amazonu v testovacím prostředí Odoo

Tato část popisuje, jak připojit Amazon přímo v testovacím prostředí Odoo. Testovací prostředí Odoo je obvykle již otevřené v prohlížeči uvnitř virtuálního počítače.

Krok 1: Otevřete testovací prostředí Odoo

Otevřete prohlížeč uvnitř virtuálního počítače. Testovací prostředí Odoo by již mělo být otevřené. Pokud není, použijte testovací adresu URL Odoo, která vám byla poskytnuta samostatně.

Krok 2: Otevřete Sales

V Odoo klikněte na modul "Sales".

Krok 3: Otevřete Configuration a Accounts

V Sales otevřete nahoře menu "Configuration" a vyberte "Accounts" pod položkou "Amazon".

Krok 4: Vytvořte nový účet Amazon

Kliknutím na "New" vytvoříte nový účet Amazon v Odoo.

Krok 5: Vyberte marketplace Amazon

V poli "Home Marketplace" vyberte správný marketplace Amazon, například "Amazon.de" pro Německo.

Krok 6: Spusťte připojení

Kliknutím na "Connect" nebo "Continue" spustíte připojení k Amazonu.

Krok 7: Přihlaste se k Amazonu a povolte oprávnění

Přihlaste se pomocí účtu Amazon Seller Central a potvrďte požadovaná oprávnění. Pokud Amazon požádá o kód OTP nebo 2FA, zadejte jej.

Krok 8: Zkontrolujte úspěch

Po autorizaci se vrátíte do Odoo. Zkontrolujte, zda byl účet Amazon vytvořen a zda je stav připojení správný.

Poznámky pro případ problémů

• Pokud Amazon požádá o kód OTP, musí kód poskytnout majitel účtu.
• Pokud se přihlášení k Amazonu nezdaří, zkontrolujte prosím nejprve uživatelské jméno, heslo a 2FA.
• Pokud po udělení oprávnění není připojení viditelné, obnovte stránku a zkontrolujte znovu.
• Vždy používejte správný marketplace, například Amazon.de pro Německo.
• Přístupové údaje by měly být sdíleny pouze zabezpečeným kanálem.

Podrobný návod s využitím Vzdálené plochy a Apps Management v AdlerDoo

Tento návod vysvětluje, jak připojit prodejní účet eBay k AdlerDoo. Všechny snímky obrazovky jsou anonymizovány a nezobrazují přístupové údaje specifické pro zákazníka.

Než začnete

• Používejte pouze virtuální počítač a přihlašovací údaje AdlerDoo poskytnuté prostřednictvím zabezpečeného přístupového odkazu.
• Mějte přístup k prodejnímu účtu eBay, který má být připojen.
• Nesdílejte přístupové údaje s třetími stranami.
• Pokud se objeví chyba, pořiďte snímek obrazovky a zašlete nám jej e-mailem.

Krok 1 – Otevřete Připojení ke vzdálené ploše

Na svém počítači se systémem Windows otevřete nabídku Start, vyhledejte Připojení ke vzdálené ploše a otevřete aplikaci.

Krok 2 – Zadejte údaje virtuálního počítače

V případě potřeby klikněte na Zobrazit možnosti. Zadejte adresu vzdáleného počítače a uživatelské jméno ze zabezpečeného přístupového odkazu a poté klikněte na Připojit.

Krok 3 – Zadejte heslo virtuálního počítače

Zadejte heslo ze zabezpečeného přístupového odkazu a potvrďte tlačítkem OK. Ujistěte se prosím, že používáte správné přihlašovací údaje pro virtuální počítač.

Krok 4 – Otevřete AdlerDoo na virtuálním počítači

Po otevření relace vzdálené plochy spusťte na virtuálním počítači AdlerDoo.

Krok 5 – Přihlaste se do AdlerDoo

Přihlaste se do AdlerDoo pomocí uživatelského jména a hesla poskytnutých prostřednictvím zabezpečeného přístupového odkazu.

Krok 6 – Otevřete Apps Management

V AdlerDoo přejděte na Integrations a poté otevřete Apps Management v levém menu.

Krok 7 – Vytvořte připojení eBay

Přejděte na Management eBay Account a klikněte na Create eBay Account.

Krok 8 – Přihlaste se k eBay a schvalte připojení

Přihlaste se pomocí prodejního účtu eBay, který má být připojen. Postupujte podle autorizačních kroků eBay, dokud nebude připojení dokončeno a nebudete přesměrováni zpět do AdlerDoo.

Přehled

Tato dokumentace popisuje, jak zaregistrovat a nakonfigurovat Shopify Public App v Shopify Dev Dashboard a integrovat jej do AdlerDo V6.1 pro instalaci přes OAuth. Tímto procesem vznikne Client ID a Client Secret, které AdlerDo používá k autentizaci vůči každému obchodu Shopify, který aplikaci instaluje.

Kontext architektury

AdlerDo zpřístupňuje /api/shopify/install jako vstupní bod OAuth. Aplikace v Dev Dashboard přesměrovává každý požadavek na instalaci na tento koncový bod, který provede výměnu kódu OAuth, uloží přístupový token do databáze tenanta a zaregistruje potřebné webhooky prostřednictvím úloh na pozadí Hangfire.

Předpoklady

Před zahájením se ujistěte, že:

• Máte přístup k organizaci Shopify společnosti TecSee GmbH s oprávněním spravovat aplikace
• AdlerDo middleware je nasazen a dostupný přes HTTPS na veřejném hostiteli nakonfigurovaném pro cílové prostředí
• Koncové body /api/shopify/install a /api/shopify/callback jsou dostupné a vracejí platné odpovědi
• Je k dispozici vývojový obchod pro komplexní testování před přesunem přihlašovacích údajů do produkce
• Seznam OAuth scopes vyžadovaných AdlerDo byl dokončen a uložen v konfiguraci

Krok 1 — Otevřete stránku vývoje aplikací

Přihlaste se do organizace Shopify a přejděte na Settings → Apps and sales channels → App development. Klikněte na tlačítko "Build apps in Dev Dashboard".

Důležité: NEPOUŽÍVEJTE tlačítko "Create an app" v panelu Legacy custom apps. Starší vlastní aplikace (Legacy custom apps) přestanou pro nové obchodníky fungovat 1. ledna 2026.

Krok 2 — Vytvořte novou aplikaci v Dev Dashboard

Dev Dashboard se otevře na adrese dev.shopify.com/dashboard/{organizationId}/apps. Klikněte na tlačítko "Create app" v pravém horním rohu seznamu aplikací.

Krok 3 — Zvolte způsob vytvoření a nastavte název aplikace

Nabízejí se dva způsoby vytvoření:

• Start with Shopify CLI — lokálně vytvoří projekt Node/Remix. AdlerDo tento způsob nepotřebuje.
• Start from Dev Dashboard — zaregistruje metadata aplikace přímo v dashboardu a okamžitě vytvoří Client ID a Secret. Pro AdlerDo použijte tento způsob.

Zadejte název aplikace (například: AdlerDo) a klikněte na Create.

Konvence pojmenování

Použijte stabilní název viditelný pro zákazníky, který se zobrazuje na obrazovce souhlasu s instalací. Pro TecSee v případě potřeby přidejte předponu podle prostředí: AdlerDo (Production), AdlerDo Staging, AdlerDo Dev.

Krok 4 — Nakonfigurujte URL, verzi webhooků a scopes

Po vytvoření se aplikace otevře na kartě Versions s novou konceptovou verzí. Zde se definuje instalační URL, verze API webhooků a scopes.

6.1 App URL

Nastavte App URL na veřejný instalační koncový bod AdlerDo:

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

Na tuto URL Shopify přesměrovává, když obchodník aplikaci instaluje. ShopifyInstallController v AdlerDo načte parametry dotazu shop a hmac, ověří HMAC a přesměruje na stránku udělení OAuth v Shopify.

6.2 Vložení aplikace do administrace Shopify

Ponechte zaškrtávací políčko "Embed app in Shopify admin" povolené. AdlerDo poskytuje vloženou administrátorskou UI uvnitř rámce administrace Shopify pomocí App Bridge.

6.3 Preferences URL

Volitelné. Ponechte prázdné, pokud aplikace nezpřístupňuje samostatnou stránku nastavení mimo vložené prostředí.

6.4 Verze API webhooků

Explicitně zafixujte verzi API webhooků. Příklad ukazuje 2026-04, což je verze, kterou AdlerDo aktuálně používá. Zvýšení této hodnoty vyžaduje kontrolu mapování obsahu každého webhooku.

6.5 Access scopes

Klikněte na "Select scopes" a zaškrtněte scopes, které AdlerDo vyžaduje. Seznam udržujte na minimu, které AdlerDo skutečně používá — obchodníci vidí celý seznam na obrazovce souhlasu s instalací.

Přesně stejný seznam musí být uložen také v konfiguraci AdlerDo (appsettings.Shopify.json → Shopify:Scopes), protože instalační controller jej předává jako parametr dotazu scope. Nesoulad vynutí opětovné instalace.

Volitelné vs. povinné scopes

Volitelné scopes lze vyžádat za běhu po instalaci. AdlerDo považuje všechny uvedené scopes za povinné během počáteční instalace, proto ponechte blok Optional scopes prázdný.

6.6 Redirect URLs

Přidejte OAuth redirect URL — veřejnou URL zpětného volání OAuth AdlerDo:

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

Pro každé prostředí přidejte jednu redirect URL. Shopify odmítne zpětné volání OAuth, pokud URL uvedená v parametru redirect_uri není na tomto whitelistu.

Krok 5 — Vydejte verzi

Po uložení všech polí klikněte na Release ve spodní části stránky verze.

• Version name — čitelný název. Konvence TecSee: alderdoo-{n}, kde n je automaticky se zvyšující číslo vydání
• Version message — krátký changelog (např. "added read_locales scope", "bumped webhooks API to 2026-04")

Klikněte na Release. Nová verze se okamžitě stane aktivní a nahradí předchozí aktivní verzi pro všechny nové instalace.

Změny scopes po vydání

Přidání nového scope do vydané verze jej NEudělí automaticky u již nainstalovaných obchodů. Majitel obchodu musí schválit opětovnou autorizaci. AdlerDo při každém požadavku detekuje odchylku scopes a v případě potřeby spustí přesměrování na opětovnou instalaci.

Krok 6 — Ověřte aktivní verzi

Otevřete kartu Versions z levého bočního panelu. Naposledy vydaná verze je označena zeleným odznakem "Active". Všechny předchozí verze zůstávají viditelné pro účely auditu.

Z tohoto zobrazení můžete kliknout na jakoukoli historickou verzi a zkontrolovat její konfiguraci, což je užitečné při ladění instalace na starším obchodě.

Krok 7 — Získejte Client ID a Secret

Otevřete kartu Settings z levého bočního panelu. Blok Credentials v horní části zpřístupňuje Client ID a Secret.

9.1 Client ID

Veřejný identifikátor. Lze bezpečně uložit do konfigurace. Zkopírujte jej pomocí ikony schránky a vložte do konfigurace AdlerDo.

9.2 Client Secret

Citlivý údaj. Zacházejte s ním jako s přihlašovacím údajem. Secret se zobrazí pouze jednou při prvním vygenerování; poté se zobrazuje pouze v zamaskované podobě. Pomocí ikony oka jej jednorázově odhalte pro zkopírování a poté jej uložte prostřednictvím standardní cesty pro ukládání secretů v AdlerDo.

V AdlerDo jsou secrety pro integrace marketplace uloženy šifrované pomocí AES-256 v databázi tenanta prostřednictvím MarketplaceCredentialEncryptor.

9.3 Rotace secretu

Kliknutím na Rotate vygenerujete nový secret. Předchozí secret je okamžitě zneplatněn. Koordinujte rotaci s nasazením nového secretu do AdlerDo.

9.4 Kontaktní e-mail API

Nastavte jej na monitorovanou schránku (aktuálně dev@tecsee.de). Shopify na tuto adresu zasílá oznámení o ukončení podpory API a bezpečnostní upozornění.

Zapojení přihlašovacích údajů do AdlerDo

Jakmile máte Client ID a Secret k dispozici, přidejte přihlašovací údaje do konfigurace AdlerDo.

10.1 Konfigurace

Přidejte následující blok do konfigurace specifické pro dané prostředí:

"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 Průběh instalace

Komplexní instalační handshake je následující:

1. Obchodník klikne na instalační odkaz → Shopify přesměruje na App URL s parametry dotazu shop a hmac
2. AdlerDo /api/shopify/install ověří HMAC vůči Client Secret a přesměruje na https://{shop}/admin/oauth/authorize s nakonfigurovaným seznamem scopes a vygenerovaným state nonce
3. Obchodník schválí scopes na obrazovce souhlasu Shopify
4. Shopify přesměruje na /api/shopify/callback s parametry code, hmac a state
5. AdlerDo ověří HMAC a state nonce, poté odešle POST požadavek s code + Client ID + Client Secret na https://{shop}/admin/oauth/access_token pro získání offline přístupového tokenu
6. Token je uložen šifrovaný pomocí AES-256 vůči tenantovi; jsou zaregistrovány odběry webhooků a opakující se synchronizační úlohy Hangfire
7. AdlerDo přesměruje obchodníka na vloženou administrátorskou URL

10.3 Ověření instalace

Po handshaku:

• Potvrďte, že v databázi tenanta existuje nová entita ShopifyConnection s nenulovým EncryptedAccessToken a uděleným seznamem scopes
• Potvrďte, že opakující se úlohy (SyncShopifyOrdersV2026, SyncShopifyProductsV2026) jsou zaregistrovány v Hangfire pod novým identifikátorem tenanta
• Spusťte testovací webhook z administrace Shopify a potvrďte, že handler AdlerDo jej zpracuje bez chyb HMAC

Příloha A — Běžné scopes používané AdlerDo

Příloha B — Řešení problémů

Instalační přesměrování vrací 401 / Invalid HMAC

Příčina: Client Secret v konfiguraci AdlerDo neodpovídá secretu v Settings, nebo byl secret rotován bez opětovného nasazení.

Řešení: Zkopírujte secret ze stránky Settings v Dev Dashboard a znovu nasaďte.

Zpětné volání OAuth vrací 'redirect_uri is not whitelisted'

Příčina: URL zpětného volání není přítomna v poli Redirect URLs aktivní verze.

Řešení: Otevřete aktivní verzi, přidejte URL, vydejte novou verzi a zopakujte instalaci.

Obchod se nainstaluje, ale neobjeví se žádné úlohy Hangfire

Příčina: Výměna kódu OAuth proběhla úspěšně, ale poinstalační bootstrap selhal (např. zřizování tenanta).

Řešení: Zkontrolujte protokoly AdlerDo v okolí časového razítka instalace; ShopifyInstallController vydává informační protokol pro každou fázi a chybový protokol s problematickým krokem.

Doručování webhooků selhává s chybami HMAC

Příčina: AdlerDo vypočítal HMAC webhooku nad zpracovaným obsahem místo nad surovým tělem.

Řešení: Potvrďte, že middleware požadavku ukládá surové tělo požadavku do vyrovnávací paměti před vazbou modelu pro trasy /api/shopify/webhooks/*.

Obchodník hlásí chybějící data po přidání scope

Příčina: Obchod byl nainstalován proti starší verzi, která scope neobsahovala.

Řešení: Spusťte přesměrování na opětovnou instalaci — AdlerDo detekuje odchylku scopes v ShopifyConnectionMiddleware a přesměruje na instalační koncový bod, kde obchodník schválí nový scope.

Zveřejněno 20. února 2026
Aktualizováno 23. února 2026

Připojení API Kaufland Global Marketplace

Tento návod vysvětluje, jak propojit AdlerDo s API Kaufland Global Marketplace. Po připojení může AdlerDo synchronizovat produkty, skladové zásoby, objednávky a informace o zásilkách mezi vaším ERP (například Odoo) a Kauflandem.

Přehled

Propojením AdlerDo s Kauflandem prostřednictvím oficiálního API se váš systém stává schopným:

• Synchronizovat nabídky produktů z vašeho ERP do Kauflandu
• Udržovat úrovně zásob aktuální napříč systémy
• Automaticky importovat objednávky z Kauflandu
• Odesílat potvrzení zásilek a údaje o sledování zpět do Kauflandu

Tato integrace zajišťuje stabilní, automatizovaný tok dat a snižuje množství manuální práce.

Předpoklady

Před zahájením se ujistěte, že:

• Máte aktivní prodejní účet Kaufland
• Máte přístup k prodejnímu portálu Kaufland (Seller Portal)
• Máte oprávnění spravovat přihlašovací údaje API v prodejním účtu

Kroky k získání přihlašovacích údajů API Kaufland

Chcete-li propojit AdlerDo s Kauflandem, musíte nejprve získat přihlašovací údaje API z prodejního portálu Kaufland.

Krok 1: Přejděte do nastavení API

Otevřete v prohlížeči následující odkaz:

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

V levém menu přejděte na:

Settings → Shop Settings → API

Krok 2: Zobrazte své aktuální klíče API

V sekci Current API key uvidíte:

• Client key (Client ID) — z bezpečnostních důvodů zamaskovaný
• Secret key (Client Secret) — z bezpečnostních důvodů zamaskovaný

Tyto hodnoty jsou skryté a z bezpečnostních důvodů je nelze znovu zobrazit.

Krok 3: Vygenerujte nové klíče API (v případě potřeby)

Pokud nemáte platné přihlašovací údaje nebo potřebujete nový pár, klikněte na:

Generate new API keys

Důležité: Jakmile jsou vygenerovány nové klíče:

• Staré Client ID a Client Secret okamžitě přestanou platit
• Jakákoli existující integrace používající staré klíče přestane fungovat
• Musíte v AdlerDo aktualizovat nové přihlašovací údaje

Krok 4: Uložte své nové přihlašovací údaje

Po vygenerování nových klíčů:

• Zkopírujte Client ID
• Zkopírujte Client Secret
• Obě hodnoty bezpečně uložte

Po opuštění stránky je již nebudete moci znovu získat.

Připojení Kauflandu k AdlerDo

Po získání přihlašovacích údajů API můžete Kaufland připojit uvnitř AdlerDo.

Krok 1: Vyberte typ účtu

Z rozbalovacího menu vedle Select vyberte: Kaufland

Krok 2: Zadejte údaje účtu

Vyplňte následující pole:

Account Name

Zadejte výstižný název tohoto připojení, například "My Kaufland Store" nebo "Kaufland DE Account"

Client ID

Zadejte Client ID získané z vašeho účtu Kaufland

Client Secret

Zadejte Client Secret získaný z vašeho účtu Kaufland

Krok 3: Uložte a připojte účet

Po vyplnění všech povinných polí klikněte na tlačítko Add New Account (zelené).

AdlerDo se pokusí navázat spojení s API Kaufland Global Marketplace pomocí poskytnutých přihlašovacích údajů.

Krok 4: Ověřte připojené účty

Jakmile je připojení úspěšné:

• Váš účet Kaufland se objeví v seznamu Connected Accounts na levé straně
• Stav účtu potvrzuje, že je AdlerDo úspěšně připojeno ke Kauflandu

V tomto okamžiku je váš systém připraven synchronizovat data.

Co se stane po připojení

Po připojení Kauflandu k AdlerDo:

• Lze povolit synchronizaci produktů a zásob
• Objednávky zadané na Kauflandu se automaticky importují do AdlerDo
• Objednávky jsou předány vašemu ERP ke zpracování
• Potvrzení zásilek a sledovací čísla mohou být odeslána zpět do Kauflandu

Veškerá synchronizace probíhá podle standardního cyklu AdlerDo Complete Sync Cycle.

Běžné poznámky a osvědčené postupy

Po připojení Kauflandu k AdlerDo:

• Vždy udržujte SKU konzistentní mezi vaším ERP a Kauflandem
• Pokud synchronizace selže, zkontrolujte, zda nebyly klíče API znovu vygenerovány
• Pro přihlašovací údaje API používejte zabezpečené úložiště
• Po změně klíčů API účet okamžitě znovu připojte

Tento návod vysvětluje, jak připojit váš obchod PrestaShop k AdlerDo pomocí rozhraní Accounts Integration. Po připojení může AdlerDo synchronizovat produkty, skladové zásoby, objednávky a další data mezi vaším obchodem PrestaShop a vaším ERP systémem.

Přehled integrace PrestaShop

Propojením PrestaShop s AdlerDo můžete zefektivnit své e-commerce operace a zajistit bezproblémový tok dat.

Hlavní výhody zahrnují:

• Automatická synchronizace nabídek produktů a aktualizací
• Udržování přesných úrovní zásob napříč systémy
• Import objednávek PrestaShop do AdlerDo a vašeho ERP
• Bezpečná správa více účtů PrestaShop z jednoho rozhraní

Tato integrace zajišťuje spolehlivý a bezpečný tok dat s minimálním manuálním zásahem.

• Synchronizace zásob
• Import objednávek
• Správa více obchodů

Přístup k Accounts Integration

Kartu Accounts Integration lze otevřít z bočního menu výběrem položky Accounts.

Krok 1: Vyberte typ účtu

V horní části stránky použijte rozbalovací menu Select k výběru typu účtu, který chcete propojit nebo spravovat, např.:

• PrestaShop (v příkladu vybráno)

Krok 2: Akce s účtem

Add New Account

• Kliknutím na zelené tlačítko přidáte nový účet PrestaShop do AdlerDo.

Delete Account

• Kliknutím na červené tlačítko smažete aktuálně vybraný účet.

⚠️ Smazání účtu okamžitě zastaví synchronizaci pro dané připojení.

Krok 3: Nastavení účtu

Sekce Account Settings umožňuje vytvořit nebo upravit připojení účtu PrestaShop.

Popis polí:

1. Account Name

Interní název v AdlerDo pro rozlišení více účtů PrestaShop. Příklad:

"PrestaShop – Main Store"

2. Base URL

Hlavní webová adresa URL vašeho obchodu PrestaShop. Příklad:

https://yourshopdomain.com

3. Token

API token používaný pro zabezpečenou autentizaci mezi AdlerDo a PrestaShop

Krok 4: Připojené účty

Panel Connected Accounts se nachází na levé straně stránky. Odtud můžete:

• Vybrat účet a upravit jeho nastavení
• Smazat účet, pokud již není potřeba

Pokud nejsou připojeny žádné účty, seznam se zobrazí prázdný.

Krok 5: Získání Base URL a API tokenu z PrestaShop

Base URL

Veřejná URL vašeho obchodu PrestaShop. Příklad:

https://yourshopdomain.com

API Token:

Postupujte podle těchto kroků:

1. Přihlaste se do PrestaShop Back Office.
2. V bočním menu přejděte na Advanced Parameters → Webservice (API)
3. Pokud funkce Webservice není povolena, zapněte ji výběrem možnosti Enable PrestaShop Webservice
4. Chcete-li vytvořit nový klíč API:
   • Klikněte na Add new webservice key nebo na ikonu plus (+)
   • Zobrazí se stránka pro vytvoření nového klíče
   • Kliknutím na Generate vygenerujte náhodný klíč (toto je Token)
5. Zkopírujte vygenerovaný klíč a bezpečně jej uložte
6. Přiřaďte potřebná oprávnění vyžadovaná AdlerDo (čtení/zápis dle potřeby)
7. Kliknutím na Save klíč aktivujte

⚠️ Důležité: Udržujte svůj API token v bezpečí. Pokud je token znovu vygenerován, musíte jej okamžitě aktualizovat v AdlerDo.

Připojení PlentyMarkets k AdlerDoo

Propojte svůj účet PlentyMarkets (nebo PlentyONE) s AdlerDoo ve čtyřech jednoduchých krocích. Po připojení AdlerDoo automaticky synchronizuje vaše produkty, kategorie, atributy, objednávky a adresy zákazníků mezi PlentyMarkets a Odoo.

Než začnete

• Aktivní účet PlentyMarkets nebo PlentyONE s přístupem k REST API.
• Vaše Base URL (například: https://your-shop.plentymarkets-cloud01.com).
• Uživatelské jméno a heslo uživatele s oprávněními REST API.

Tip: Vytvořte pro tuto integraci vyhrazeného API uživatele v PlentyMarkets. Je to bezpečnější než použití vašeho administrátorského účtu a přístup můžete kdykoli odvolat, aniž by to ovlivnilo ostatní uživatele.

Připojení Plenty ve čtyřech krocích

KROK 1: Otevřete Marketplace Accounts

V bočním panelu AdlerDoo přejděte na Settings → Integrations → Marketplace Accounts.

KROK 2: Vyberte Plenty

Z rozbalovacího menu Select Marketplace v horní části stránky vyberte Plenty.

KROK 3: Klikněte na "Add New Account"

Klikněte na zelené tlačítko Add New Account v pravém horním rohu stránky.

KROK 4: Zadejte své přihlašovací údaje a uložte

Vyplňte čtyři pole níže svými přihlašovacími údaji PlentyMarkets a poté klikněte na Save. AdlerDoo provede autentizaci, automaticky uloží přístupový a obnovovací token a váš účet je připojen.

Tip: AdlerDoo obnovuje přístupový token na pozadí předtím, než vyprší — nikdy nemusíte spravovat tokeny ručně.

Ověřte připojení

Po připojení začne AdlerDoo automaticky synchronizovat data na pozadí. Pomocí níže uvedených obrazovek potvrďte, že produkty, objednávky, kategorie, atributy a zákazníci byli načteni z vašeho obchodu PlentyMarkets.

1. Zkontrolujte stav synchronizace

Otevřete Settings → Integrations → Connection Sync. Plenty by se měl objevit v seznamu se zeleným indikátorem Running.

2. Procházejte synchronizované produkty

Otevřete Main → Products a filtrujte podle Plenty, abyste viděli všechny produkty synchronizované z vašeho obchodu s jejich SKU, cenami a identifikátory (GTIN, MPN, ASIN, UPC).

3. Zkontrolujte varianty produktů

Klikněte na Variants v libovolném řádku produktu a otevřete okno s podrobnostmi varianty. Každá varianta zobrazuje své SKU, čárový kód, cenu, množství a rozměry — vše, co bylo přeneseno z PlentyMarkets.

4. Procházejte synchronizované objednávky

Otevřete Main → Orders a filtrujte podle Plenty, abyste viděli všechny objednávky načtené z PlentyMarkets, včetně stavu, způsobu platby a časových údajů.

5. Zkontrolujte podrobnosti objednávky

Klikněte na Details v libovolném řádku objednávky a otevřete okno s podrobnostmi objednávky s položkami, množstvími, cenami, DPH a součty. Pomocí karet Gift a Custom v pravém horním rohu vyskakovacího okna zobrazíte možnosti dárků a data přizpůsobení.

6. Zkontrolujte synchronizované kategorie

Otevřete Main → Categories, abyste viděli celý strom kategorií importovaný z PlentyMarkets — stejnou hierarchii, kterou používáte k organizaci produktů ve svém obchodě.

7. Zkontrolujte synchronizované atributy

Otevřete Main → Attributes, abyste zobrazili všechny atributy produktů (velikost, barva, materiál, značka, výrobce, věková skupina, vzor, pohlaví atd.) používané k popisu variací.

8. Zkontrolujte synchronizované zákazníky

Otevřete Main → Customers, abyste viděli zákazníky načtené z PlentyMarkets. Každý záznam má číslo zákazníka s předponou PLENTY, které jej propojuje zpět se zdrojem. Kliknutím na View Address v libovolném řádku zkontrolujete uložené dodací a fakturační adresy.

Co se synchronizuje automaticky

Po počátečním připojení udržuje AdlerDoo následující synchronizované mezi PlentyMarkets a Odoo — bez nutnosti manuálního zásahu:

• Produkty — včetně variací, prodejních cen, úrovní zásob a hodnot atributů.
• Kategorie — celý strom kategorií a hierarchie.
• Atributy — velikost, barva, materiál a další atributy variací.
• Objednávky — vytvořené v Odoo jako prodejní objednávky.
• Adresy zákazníků — propojené s odpovídajícími objednávkami a kontakty.

Odebrání připojeného účtu

Chcete-li odpojit účet Plenty: vyberte jej ze seznamu Connected Accounts vlevo a poté klikněte na červené tlačítko Delete Account v pravém horním rohu.

Potřebujete pomoc?

V případě jakýchkoli problémů nebo dotazů ohledně integrace kontaktujte prosím tým podpory AdlerDoo.

Přechod na stránku integrace

Z bočního panelu vlevo:

Accounts → Boční menu

(Znázorněno v červeném rámečku na obrázku)

Výběr integračního systému

V horní části stránky se nachází rozbalovací menu: Select

Ze seznamu dostupných systémů vyberte JTL.

Nastavení účtu (Konfigurace účtu JTL)

Po výběru JTL se objeví tři důležitá pole, která musí být vyplněna

1. Account Name

Název účtu, který chcete zobrazit uvnitř systému.

Toto vám pomůže účet v budoucnu snadno identifikovat.

2. Client ID

Jedinečný identifikátor pro integraci JTL.

Tuto hodnotu získáte ze svého ovládacího panelu JTL.

3. Client Secret

Tajný klíč pro účet.

Měl by být uchováván v bezpečí a nikdy nesdílen, aby byla zajištěna bezpečnost.

Tento klíč se používá k autentizaci a propojení obou systémů dohromady.

Dostupné operace

Zelené tlačítko vpravo nahoře.

Přidá nový účet JTL po vyplnění požadovaných informací.

Delete Account

Červené tlačítko vpravo nahoře.

Smaže vybraný účet ze seznamu propojených účtů.

Connected Accounts

Tato sekce zobrazuje dříve propojené účty (pokud existují).

Usnadňuje výběr účtu pro kontrolu, úpravu nebo smazání.

Kroky k získání integračních dat z JTL (Client ID & Client Secret)

1. Přihlaste se do ovládacího panelu JTL

Otevřete webový prohlížeč, přejděte na webové stránky JTL a přihlaste se pomocí přihlašovacích údajů svého účtu.

2. Přejděte do nastavení účtu nebo obecného nastavení

V hlavním ovládacím panelu vyhledejte možnost jako Settings nebo Configuration a klikněte na ni.

3. Vyhledejte sekci API, Integrations nebo Apps

V rámci stránky nastavení najděte sekci pro externí integrace, obvykle označenou jako:

• API Access
• Integrations
• Apps nebo Developer Apps

4. Vytvořte novou aplikaci nebo vygenerujte nové klíče API

Klikněte na tlačítko pro vytvoření nové aplikace nebo vygenerování přihlašovacích údajů API.

Možná budete muset zadat:

• Název aplikace
• Popis
• Callback URL (pokud je vyžadována)

5. Získejte Client ID a Client Secret

Po vytvoření uvidíte:

• Client ID: Jedinečné číslo nebo text představující aplikaci.
• Client Secret: Tajný klíč přidružený k Client ID.

Obojí zkopírujte a bezpečně uložte.

6. Zadejte data na stránce integrace ve vašem systému

1. Přejděte na stránku Accounts Integration ve vašem systému.
2. Ze seznamu dostupných systémů vyberte JTL.
3. Zadejte Client ID a Client Secret do odpovídajících polí.
4. Zadejte Account Name pro snadnou identifikaci.

Tato sekce usnadňuje propojení vašeho systému s vaším účtem MediaMarkt Marketplace a umožňuje synchronizaci produktů, objednávek, správu skladových zásob a související integrační operace.

Umístění v rámci systému

K této funkci se dostanete přes:

Boční panel → Accounts → Accounts Integration

Poté vyberte MediaMarkt z rozbalovacího menu Select.

Nastavení účtu

Na pravé straně vyplňte následující pole pro přidání účtu MediaMarkt:

Ovládací tlačítka

• Add New Account: Zelené tlačítko pro uložení nového účtu MediaMarkt po zadání požadovaných údajů.

• Delete Account: Odebere vybraný účet ze seznamu vašich účtů.

Připojené účty

Levá strana zobrazuje všechny dříve přidané účty MediaMarkt. Vyberte libovolný účet pro úpravu nebo smazání.

Obecné kroky k získání integračních dat

1. Přihlaste se do MediaMarkt Seller Dashboard (backend Mirakl)

   • Otevřete prohlížeč a přejděte na: https://mediamarktsaturn.mirakl.net/login

2. Přihlaste se pomocí přihlašovacích údajů svého prodejního účtu

   • Zadejte své uživatelské jméno a heslo

3. Přejděte do Account Settings nebo My Profile

   • Vyhledejte sekci API nebo API Keys

4. Vytvořte nový klíč API nebo zkopírujte existující

   • Klikněte na Generate API Key, pokud žádný nemáte
   • Zkopírujte existující klíč, pokud je k dispozici

5. Zaznamenejte si Base URL pro platformu MediaMarkt

   • Base URL je obvykle koncový bod API Mirakl: https://mediamarktsaturn.mirakl.net/api

6. Použijte Base URL a API Key (Token) ve svém systému

   • Přejděte na Accounts Integration ve svém systému
   • Vyberte MediaMarkt z rozbalovacího menu
   • Zadejte vhodný Account Name
   • Zadejte Base URL
   • Zadejte API Key (Token), který jste zkopírovali

7. Uložte data a aktivujte integraci

   • Kliknutím na Add New Account dokončíte nastavení
   • Váš systém nyní může načítat objednávky, aktualizovat produkty a provádět integrační úlohy

Funkce Accounts Integration vám umožňuje připojit váš účet Galaxus k systému, což vám umožňuje spravovat data, načítat objednávky a automaticky aktualizovat informace zadáním přihlašovacích údajů pro integraci účtu.

Kroky integrace

1. Přístup k sekci Accounts Integration: V bočním panelu vyberte Accounts.
2. Vyberte Galaxus z rozbalovacího menu: V rozbalovacím menu Select zvolte Galaxus.

Vyplňte údaje účtu

• Account Name: Zadejte název účtu, pod kterým bude v systému identifikován (např. My Galaxus Account).
• Client ID: Zadejte identifikátor klienta vašeho účtu Galaxus.
• Client Secret: Zadejte client secret přidružený k vašemu účtu Galaxus.

Uložte účet

Po zadání údajů klikněte na tlačítko Save nebo Confirm Add (v závislosti na rozhraní systému).

• Zelené tlačítko používané k přidání nového účtu

Smazání účtu

1. Vyberte účet z pole Connected Accounts.
2. Klikněte na tlačítko Delete Account.
3. Potvrďte smazání.

Připojené účty

Na levé straně se zobrazí pole se všemi účty Galaxus, které byly dříve propojeny se systémem. Když ze seznamu vyberete libovolný účet, jeho údaje se zobrazí v sekci Account Settings.

Přihlašovací údaje API Galaxus – Jak získat integrační klíče

1. Přihlaste se do svého účtu Galaxus

1. Otevřete webové stránky Galaxus.
2. Přihlaste se k účtu, který chcete připojit k systému.
3. Přejděte na stránku API Settings.

Po přihlášení:

Z hlavního menu přejděte na: Settings → Developer Settings → API Keys / Integrations

2. Vytvořte nový klíč API

Pokud ještě nemáte existující klíč:

1. Klikněte na tlačítko: Create API Key nebo Generate Credentials
2. Objeví se formulář obsahující:
   • App Name / Integration Name → Zadejte identifikátor, například:
     • TecSee Integration
     • Store Sync
   • Permissions → Vyberte oprávnění, která váš systém potřebuje (např. Products – Orders – Inventory).
3. Klikněte na Save / Generate

Připojení Odoo prostřednictvím Accounts Integration

Stránka Accounts Integration vám umožňuje propojit AdlerDo s jedním nebo více účty Odoo a spravovat je prostřednictvím jednoduchého, přehledného a bezpečného rozhraní. Po připojení může AdlerDo komunikovat přímo s vaším systémem Odoo za účelem synchronizace produktů, skladových zásob, objednávek a provozních dat.

Přehled integrace Odoo

Propojení Odoo s AdlerDo centralizuje operace marketplace a obchodu uvnitř Odoo.

Hlavní výhody:

• Centralizace dat marketplace a obchodu uvnitř Odoo
• Automatizace synchronizace produktů, zásob a objednávek
• Správa více instancí Odoo z jednoho rozhraní
• Snížení počtu manuálních operací a integračních chyb

Tato integrace zajišťuje stabilní a škálovatelný tok dat s minimálním manuálním zásahem.

• Centralizace dat
• Automatizovaná synchronizace
• Ovládání více instancí

Přístup ke stránce Accounts Integration

V levém bočním menu vyberte Accounts

Zobrazí se obrazovka Integration Accounts Management, která ukazuje všechna připojení účtů a nastavení.

Výběr systému k připojení

V horní části stránky najdete rozbalovací pole označené:

Select

Nahoře použijte rozbalovací pole označené Select k výběru systému. Vyberte Odoo a zahajte nastavení.

Správa účtů

Add New Account

• Používá se k přidání nového účtu Odoo.
• Po vyplnění všech povinných polí klikněte na Add New Account a uložte připojení.
• Účet se objeví pod Connected Accounts vlevo.

Delete Account

• Používá se ke smazání aktuálně vybraného účtu Odoo.
• Po smazání se synchronizace pro daný účet okamžitě zastaví.

⚠️ Smazání účtu neovlivní data uvnitř Odoo, pouze připojení.

Nastavení účtu (Odoo)

Při přidávání nebo úpravě účtu se objeví následující pole:

Popis polí

a. URL

Přihlašovací URL vaší instance Odoo. Příklad:

https://yourcompany.odoo.com

b. Account Name

Interní název pro identifikaci účtu Odoo. Příklad:

"Odoo – Main ERP"

c. Database Name

Název databáze Odoo, ke které se chcete připojit. Toto je vyžadováno pro autentizaci a přístup k datům.

d. User Name

Uživatelské jméno nebo e-mail uživatele Odoo s dostatečnými oprávněními

e. Password

Heslo přidružené k vybranému uživatelskému účtu Odoo.

🔒 Tyto informace jsou zpracovávány bezpečně a používají se pouze k autentizaci.

Správa připojených účtů

Connected Accounts

Sekce Connected Accounts zobrazuje všechny dříve přidané účty Odoo. Odtud můžete:

• Vybrat účet a upravit jeho nastavení
• Smazat účet, pokud již není potřeba

Toto usnadňuje správu více databází nebo prostředí Odoo (např. produkce a staging).

Kroky k získání integračních dat z Odoo

Získejte URL

Zkopírujte přihlašovací URL vašeho systému Odoo. Příklad:

https://yourcompany.odoo.com

Získejte Database Name

• Najděte název databáze na stránce výběru databáze
• Nebo si jej vyžádejte od správce vašeho systému Odoo

Získejte User Name

Použijte uživatelské jméno nebo e-mail uživatele Odoo s oprávněními pro přístup k API.

Získejte Password

Použijte heslo přidružené k vybranému uživatelskému účtu Odoo.

Zadejte a uložte data

1. Zadejte všechny požadované informace na stránce Accounts Integration
2. Zkontrolujte správnost údajů
3. Kliknutím na Add New Account uložte připojení

Po uložení se účet Odoo objeví pod Connected Accounts a bude připraven k synchronizaci.

Osvědčené postupy

• Používejte pro integrace vyhrazeného uživatele Odoo
• Z bezpečnostních důvodů přidělujte pouze potřebná oprávnění
• Používejte srozumitelné názvy účtů pro více databází
• Okamžitě aktualizujte přihlašovací údaje, pokud se v Odoo změní

Tip pro bezpečnost a údržbu: Omezení oprávnění a používání vyhrazených integračních uživatelů snižuje riziko neoprávněného přístupu a předchází náhodným výpadkům.

Co je integrace DATEV?

Tato integrace vám umožňuje automaticky odesílat faktury z Odoo do vašeho účetního systému DATEV. Namísto ručního nahrávání faktur je systém načte z Odoo, převede je do formátu DATEV a automaticky je nahraje.

Krok 1: Připojte svůj účet DATEV

Před odesíláním faktur musíte připojit svůj účet DATEV.

1. Zavolejte přihlašovací koncový bod pro získání přihlašovacího odkazu DATEV
2. Otevřete odkaz ve svém prohlížeči
3. Přihlaste se pomocí svých přihlašovacích údajů DATEV
4. Po úspěšném přihlášení uvidíte stránku "Authentication Successful!"
5. Váš účet DATEV je nyní připojen

Krok 2: Ověřte svůj účet

Zkontrolujte, zda je váš účet DATEV připojen.

Odesílání faktur do DATEV

Odeslání podle časového rozsahu

• Odešlete všechny faktury v rámci časového rozsahu
• Stáhněte faktury jako xml nebo pdf do složky pro ruční nahrání do Datev

Kontrola stavu faktury

Zobrazit všechny faktury (stránkované)

Významy stavů faktury

Řešení neúspěšných faktur

Neúspěšné faktury jsou automaticky opakovány až třikrát. Pokud faktura stále selhává, může být nutný ruční zásah.

Obnovení vašeho tokenu DATEV

Váš přístupový token DATEV pravidelně vyprší. Systém to automaticky řeší během zpracování na pozadí. Pro ruční obnovení:

Důležité: Pokud obnovení tokenu selže s chybou autentizace, možná budete muset znovu připojit svůj účet DATEV zopakováním kroku 1.

Rychlý přehled

• Get Invoice XML Preview – Vrací slovník ID faktury k XML kódovanému v Base64.
• Fetch PDFs for Saved Invoices – Pokud byly faktury uloženy pouze s metadaty (bez PDF), načtěte jejich PDF

Scénář nahrávání na pozadí

Metadata faktur jsou uložena v databázi AdlerDo a poté se automaticky nahrají do DATEV na pozadí.