Rozšíření a integrace

Tato kapitola pokrývá dostupné integrace s externími systémy — účetní software, fulfillment, marketplace platformy, velkoobchodní platformy, Instagram a synchronizaci skladu mezi obchody.

Nevidíte doplněk v menu?

Doplňky najdete v Systém › Dodatečná nastavení › Doplňky. Pokud tam některý chybí, zapněte ho v Systém › Funkce obchodu — vypnuté funkce jsou z bočního menu pouze skryté.

---

ERP: Kros

Cesta: Systém › Dodatečná nastavení › Doplňky › KROS Fakturace (/admin/addons/kros)

Kros je slovenský účetní a podnikový software. Integrace umožňuje synchronizaci faktur z Merzio do Kros (manuálně nebo automaticky, např. při zaplacení objednávky). Konfigurace vyžaduje API přihlašovací údaje.

INFO

Pokud položku KROS Fakturace v menu nevidíte, zapněte ji v Systém › Funkce obchodu.

---

ERP: Pohoda

Cesta: Systém › Dodatečná nastavení › Doplňky › POHODA (/admin/addons/pohoda)

Pohoda je dominantní účetní software na českém a slovenském trhu. Integrace vystavuje XML endpointy s objednávkami a fakturami, které si Pohoda pravidelně stahuje, a volitelně umožňuje import skladu z Pohody. Přihlašovací údaje (jméno a heslo) se vygenerují přímo v administraci; nastavit lze i filtr objednávek podle stavu (zaplacené / čekající / všechny) a označování již exportovaných objednávek.

INFO

Pokud položku POHODA v menu nevidíte, zapněte ji v Systém › Funkce obchodu.

---

Fulfillment: Depoto

Cesta: Systém › Dodatečná nastavení › Doplňky › Depoto Fulfillment (/admin/settings/depoto)

Depoto je fulfillment a skladový systém. Po zaplacení se objednávky automaticky odesílají do Depota k vyřízení. Integrace podporuje import nebo push katalogu (směr synchronizace: push / pull / import a poté push), mapování dopravních metod na dopravce Depota a synchronizaci sledovacích čísel zásilek. Konfigurace vyžaduje přihlašovací údaje k Depoto API.

---

Marketplace: BaseLinker

Cesta: Systém › Dodatečná nastavení › Doplňky › BaseLinker (/admin/settings/baselinker)

BaseLinker (Base.com) je platforma pro napojení marketplace kanálů (Allegro, Kaufland a další). Merzio v něm vystupuje jako obchod: BaseLinker si z něj čte katalog a objednávky a — podle toho, co mu povolíte — do něj posílá objednávky z tržišť, změny stavů, skladu a cen.

Připojení

1. V BaseLinkeru otevřete Integrace → Přidat integraci → Obchody → Jiný obchod. BaseLinker zobrazí komunikační heslo — zkopírujte jej.
2. V Merzio zapněte přepínač Zapnout integraci BaseLinker, heslo vložte do pole Heslo z BaseLinkeru a klikněte na Uložit heslo.
3. Zkopírujte URL konektoru z této stránky, vložte ji do formuláře v BaseLinkeru a tam klikněte na Uložit.

BaseLinker připojení po uložení neověřuje — integrace se aktivuje, jakmile na obchod poprvé zavolá (obvykle během několika minut). Pokud BaseLinker heslo výjimečně nevygeneroval, v části Pokročilé — vygenerovat heslo lokálně si ho vytvoříte v Merzio a ručně ho nastavíte v BaseLinkeru.

Oprávnění

Čtení (katalog, objednávky) je povoleno vždy. Každý zápis má vlastní přepínač:

Přepínač	Co povoluje	Výchozí
Povolit změny skladů z BaseLinkeru	BaseLinker mění skladové počty produktů	vypnuto
Povolit změny cen z BaseLinkeru	BaseLinker mění ceny produktů	vypnuto
Povolit přidávání produktů z BaseLinkeru	BaseLinker vytváří nové produkty v katalogu	vypnuto
Povolit přidávání kategorií z BaseLinkeru	BaseLinker vytváří nové kategorie	vypnuto
Povolit příjem objednávek z BaseLinkeru	Objednávky z tržišť (Allegro, eBay…) přicházejí do obchodu	zapnuto
Povolit aktualizace objednávek z BaseLinkeru	BaseLinker mění stav, označí zaplacení a doplní sledovací číslo — i u objednávek z vašeho obchodu, které si stáhl	zapnuto

Stavy objednávek

Stavy se nemapují v Merzio. Obchod má pro BaseLinker pevná ID stavů (tabulka ID stavů objednávek pro BaseLinker na stránce nastavení) a své stavy k nim přiřadíte v BaseLinkeru (Nastavení → Stavy objednávek → integrace obchodu):

ID	Stav v Merzio
1	Čekající
2	Zpracovává se
3	Odesláno
4	Připraveno k vyzvednutí
5	Na cestě
6	Doručeno
7	Dokončeno
8	Zrušeno
9	Vráceno

• Zaplacení není stav — BaseLinker ho posílá samostatně, nezávisle na stavu objednávky.
• Když stav změní BaseLinker, Merzio zákazníkovi neposílá e-mail o změně stavu — oznámení v takovém případě posílá BaseLinker.

Sklad a ceny

• Sémantika skladů určuje, jaké počty se hlásí do BaseLinkeru a jak se chápou počty, které posílá: Dostupné k prodeji (fyzický stav minus aktivní rezervace — to, co vidí zákazník) nebo Fyzický sklad (skutečný počet kusů).
• Pokud povolíte změny skladů, BaseLinker posílá do obchodu výsledné počty a stává se hlavním skladem. Nechte tehdy režim Dostupné k prodeji a zapnuté rezervace skladu (Katalog › Sklad › Nastavení skladu). Jinak může objednávka z obchodu odečíst zboží dvakrát — jednou v Merzio a jednou přes BaseLinker; stránka nastavení na to upozorní.
• Do BaseLinkeru se hlásí aktuální prodejní cena s DPH. Cena, kterou BaseLinker pošle do obchodu, nahradí běžnou cenu produktu a zruší jeho akční cenu.

---

B2B platforma: Datara

Cesta: Systém › Dodatečná nastavení › Datara Integrace (/admin/settings/datara)

Datara je velkoobchodní / B2B platforma. Integrace podporuje obousměrnou synchronizaci produktů a skladu.

Konfigurace zahrnuje:

• Základní URL a API přihlašovací údaje (vstupní i výstupní)
• Směr synchronizace: obousměrná, pouze odesílání (push) nebo pouze přijímání (pull)
• Co se synchronizuje: produkty, sklad, ceny
• Mapování výchozího skladu
• Mapování polí (propojuje Datara pole na Merzio produktová pole)
• Mapování skladů (propojuje Datara sklady na Merzio sklady)

Záznamy synchronizace se ukládají per-připojení pro audit.

---

Kódy produktů v exportech objednávek

Každá položka objednávky si při vytvoření uloží kód produktu (SKU). Díky tomu kód zůstane v exportech i po smazání varianty.

• XML feed objednávek obsahuje u každé položky prvky <sku> a <ean>.
• POHODA nyní v <inv:code> posílá kód konkrétní varianty (dříve se posílal kód nadřazeného produktu).

Starší objednávky kód uložený nemají — u nich se použije aktuální kód produktu/varianty jako dosud.

---

Instagram Feed

Cesta: Systém › Dodatečná nastavení › Doplňky › Instagram feed (/admin/addons/instagram-feed)

Integrace Instagram Feed propojí váš Instagram účet přes OAuth a zobrazí mřížku posledních příspěvků na frontendu e-shopu. OAuth callback je zpracován centrálně a přesměruje zpět na váš e-shop.

---

Moje objednávka

Cesta: Systém › Dodatečná nastavení › Doplňky › Moje objednávka (/admin/addons/order-lookup)

Stránka, na které zákazník zadá číslo objednávky a e-mail a uvidí stav, průběh a sledování zásilky — i bez účtu.

• Moje objednávka (stav objednávky bez přihlášení) — přepínač, kterým stránku zapnete. Dokud je vypnutá, zákazníkovi se na její adrese zobrazí chyba 404 (stránka nenalezena).
• Veřejná adresa stránky — ve výchozím stavu /moje-objednavka v českém obchodě (/moja-objednavka ve slovenském, /my-order v anglickém). Adresu zkopírujete tlačítkem Kopírovat nebo otevřete přes Otevřít v obchodě. Cestu změníte v SEO nastavení (pole Cesta ke stránce Moje objednávka).
• Odkaz v patě — tlačítko Přidat do paty přidá odkaz „Moje objednávka" do paty obchodu, aby zákazníci stránku našli. Pokud jste mezitím změnili cestu, zobrazí se tlačítko Opravit odkaz v patě.

Vyhledávání je chráněno proti hádání: z jednoho místa je povoleno nejvýše 5 pokusů za minutu.

---

Synchronizace skladu mezi obchody (Store Sync)

Cesta: Katalog › Sklad › Synchronizace více obchodů (/admin/store-sync)

Store Sync umožňuje dvěma nebo více Merzio e-shopům synchronizovat pohyby skladu v reálném čase.

Konfigurace

• Synchronizační skupiny: Pojmenované skupiny propojující více e-shopů
• Každý e-shop ve skupině určuje, který z jeho skladů se účastní
• Když nastane pohyb skladu v zúčastněném skladu, synchronizační služba odešle aktualizaci do všech ostatních e-shopů ve skupině
• Cílový e-shop aplikuje změnu skladu na odpovídající produkt/variantu (shoda podle SKU)

Synchronizační události a záznamy se uchovávají pro audit. Před aplikováním synchronizace proběhne kontrola konzistentnosti SKU.

Požadavky

• Oba e-shopy musí být na platformě Merzio
• Produkty musí mít konzistentní SKU napříč e-shopy — synchronizace páruje produkty právě podle SKU

---

Heureka: Měření konverzí a Ověřeno zákazníky

Cesta: Zapojení › Marketing › Měřicí kódy (/admin/tracking-codes)

K dispozici jsou dvě služby Heureky, každá se samostatnými klíči pro Heureka.cz a Heureka.sk (vyplňte jen portály, které používáte):

• Měření konverzí — říká Heurece, které návštěvy ze srovnávače skončily nákupem. Vložte API klíč z administrace Heureky (sekce Měření konverzí – nové) a zapněte přepínač. Měřicí skripty se načítají automaticky na detailu produktu a na potvrzení objednávky, a to pouze s marketingovým cookie souhlasem zákazníka.
• Ověřeno zákazníky — po každé objednávce Heureka zákazníkovi e-mailem zašle dotazník spokojenosti; z nasbíraných recenzí obchod získává certifikát. Vložte 32znakový tajný klíč ze sekce Ověřeno zákazníky administrace Heureky. Po zapnutí se v pokladně automaticky zobrazí checkbox, kterým může zákazník zaslání dotazníku odmítnout (GDPR); odmítnuté objednávky se Heurece nikdy nehlásí.

Jakmile vám Heureka certifikát udělí, můžete zapnout také widget certifikátu — žlutou plaketu „Ověřeno zákazníky" na okraji e-shopu. Používá třetí klíč, veřejný klíč widgetu (hodnota za setKey v kódu ikon certifikátu v administraci Heureky — nikoli tajný klíč), a k tomu volbu levého/pravého okraje a vzdálenosti od horního okraje, aby nekolidoval s cookie lištou. Zobrazuje se vždy jen jeden widget: portál podle jazyka e-shopu.

INFO

Identifikátory produktů hlášené Heurece odpovídají hodnotám ITEM_ID v produktovém feedu Heureky, takže se konverze a dotazníky správně spárují s vašimi nabídkami.

---

Google Customer Reviews (Recenze zákazníků Google)

Cesta: Zapojení › Marketing › Měřicí kódy (/admin/tracking-codes)

Stačí vložit ID účtu Google Merchant Center — všechny údaje o objednávce doplní Merzio automaticky. K dispozici jsou tři části:

• Dotazník po objednávce — na děkovací stránce se zákazníkovi zobrazí nabídka Googlu, zda chce po doručení vyplnit dotazník spokojenosti. Merzio předává Googlu číslo objednávky, e-mail, zemi doručení a předpokládané datum doručení.
• Hodnocení produktů — pokud to zapnete, odesílají se i EAN/GTIN kódy zakoupených produktů, takže se recenze přiřadí ke konkrétním produktům, nejen k obchodu.
• Widget hodnocení obchodu — plovoucí odznak s hvězdičkami na všech stránkách e-shopu.

Předpokládané datum doručení se bere z času doručení nastaveného u způsobu dopravy. Pro dopravy, které ho nemají vyplněné, se použije záložní počet dnů z nastavení.

Požadavky

• Účet v Google Merchant Center
• Odsouhlasené podmínky programu Google Customer Reviews — bez toho se dotazník nezobrazí
• Ověřená doména e-shopu a HTTPS
• Google Customer Reviews nefunguje přes Google Tag Manager. Pokud ho tam máte nasazený, odstraňte ho — jinak se dotazník zobrazí dvakrát.

INFO

EAN/GTIN kódy jsou stejné jako v Google Shopping feedu, takže se recenze spárují s vašimi nabídkami. Widget hodnocení zobrazí hvězdičky až po zhruba 100 recenzích z dané země za posledních 12 měsíců.

---

Produktové feedy

Produktové feedy umožňují distribuci vašeho katalogu do cenových srovnávačů a agregátorů (Google, Heureka, Zboží.cz, ChatGPT Shopping…). Více o vytvoření a nastavení najdete v sekci Produktové feedy.

---

Import produktů z jiné platformy

Pokud přecházíte na Merzio z jiné platformy, můžete svůj katalog naimportovat z jejího exportu. Kromě původního Shoptet importéru jsou nyní k dispozici i importy z Heureky a Upgates.

Cesta: Katalog › Produkty › Všechny produkty → tlačítko Importovat produkty (jednorázový import) nebo Katalog › Produkty › Automatické importy (opakovaný import z URL feedu).

Výběr platformy

Platforma se nerozpoznává automaticky — vybíráte ji ručně:

• Zdrojová platforma — Shoptet, Heureka nebo Upgates.
• Formát — formát vstupního souboru pro zvolenou platformu.
• Cílový jazyk (pouze Upgates) — Upgates export je vícejazyčný; tímto polem určíte, který jazyk se naimportuje.

Všechny tři platformy sdílejí stejný zpracovatelský řetězec jako Shoptet:

• stejná zaškrtávací pole řízení polí (sklad, sklad variant, doporučená cena, soubory médií atd.) — nezaškrtnuté pole import nikdy nepřepíše;
• stejnou synchronizační politiku (párovací klíč, politika pro existující i chybějící produkty);
• stejné plánování v Katalog › Produkty › Automatické importy;
• stejný jednorázový nahrávací tok na obrazovce importu produktů.

Jednorázový import

U Upgates a Heureky jde o nahrání souboru, který se spustí ihned a přeskočí krok mapování sloupců a náhledu. Nenabízí se ani vzorová šablona ke stažení — použijete vlastní export z původní platformy.

Upgates

Zpracovává produktový XML export z Upgates (<PRODUCTS><PRODUCT>). Export je vícejazyčný — polem Cílový jazyk určíte, který jazyk se importuje.

„XML export z Upgates. Vícejazyčný — jazyk se vybírá podle cílové lokalizace."

Importuje:

• název, popis a krátký popis
• SKU (CODE), EAN, externí ID
• značku (MANUFACTURER), dodavatele, měrnou jednotku, DPH
• finální cenu (PRICE_WITH_VAT), doporučenou cenu / RRP (PRICE_ORIGINAL) a nákupní cenu (PRICE_PURCHASE)
• hmotnost (v kg), zásoby a zásoby po skladech (STOCKS)
• dodací lhůtu dodavatele (z koncového čísla v AVAILABILITY)
• varianty (s vlastním skladem, cenou, parametry a obrázky)
• obrázky, parametry / atributy, kategorie (jen ploché názvy listů), štítky/příznaky, související a alternativní produkty
• a — jedinečně — produktové dokumenty / PDF soubory (FILES), které se přiloží, když je zapnuté pole soubory médií (media.files)

Co Upgates import nepodporuje

• Rozměry produktu (délka/šířka/výška) — Upgates je ve feedu neuvádí (<LENGTH> je limit množství na objednávku, nikoli rozměr).
• Hierarchii kategorií — importují se jen ploché kategorie na kořenové úrovni.
• Samostatné bloky slev/akcí — akce se odvozuje z rozdílu PRICE_ORIGINAL oproti PRICE_WITH_VAT.
• Limity množství na objednávku.
• Konfigurace, sety, dárky a příslušenství.

Prázdný tag = zachovat hodnotu

V nativním importu Upgates prázdný tag znamená „smazat". Merzio dělá opak — prázdný tag ponechá stávající hodnotu. Pod politikou aktualizace (update) je to správné chování: import vám nepřepíše ručně doplněné údaje prázdnou hodnotou z feedu.

Import z Heureky

Importuje z produktového XML feedu Heureky; varianty se seskupují podle ITEMGROUP_ID.

„XML feed Heureka. Neobsahuje sklad; varianty se seskupují podle ITEMGROUP_ID."

Bez skladových údajů

Feedy Heureky neobsahují stavy zásob, takže tento import žádný sklad nepřenáší. Ostatní standardní produktová pole, která feed obsahuje, se importují běžně.

Nezaměňovat s měřením konverzí Heureky

Toto je importní zdroj produktů. Nesouvisí s měřením konverzí, Ověřeno zákazníky ani widgetem certifikátu Heureky popsanými výše — to jsou marketingové sledovací funkce, nikoli import katalogu.

---

Platební brány

Přehled dostupných platebních bran a jejich konfigurace je popsána v sekci Objednávkový proces — Platební metody.

Dopravci

Integrované dopravce (Packeta, Slovenská pošta, GLS, PPL, DPD, SPS) nastavíte v Systém › Základní nastavení › Doprava. Více v sekci Objednávkový proces — Dopravní metody a v kapitole Doprava.

---

Budoucí rozšíření

Platforma Merzio je aktivně vyvíjena. Produktové feedy pro Heureka (SK/CZ), Zboží.cz a Google Merchant jsou již dostupné (viz Produktové feedy výše); plánovaná rozšíření zahrnují další marketingové integrace (např. Glami) a další rozšíření ekosystému. Sledujte aktuality v portálu.

---

Doplňky a rozšíření

Ecomail

Cesta: Systém › Dodatečná nastavení › Doplňky › Ecomail (/admin/addons/ecomail)

Integrace s e-mailovým marketingem Ecomail:

• API klíč a výchozí seznam — Autentifikace a seznam kontaktů, do kterého se kontakty přihlašují
• Sledovací kód (App ID) — Ecomail tracking na e-shopu (volitelně s Consent Mode v2)
• Souhlasná pole — Volitelné checkboxy v pokladně a v registračním dialogu, které zákazníka přihlásí do zvoleného seznamu (s volitelným tagem)
• Synchronizace kontaktů — Tlačítko pro manuální odeslání existujících zákazníků do Ecomailu

Zpět nahoru

Cesta: Systém › Dodatečná nastavení › Doplňky › Zpět nahoru (/admin/addons/back-to-top)

Tlačítko pro návrat na vrch stránky:

• Aktivní — Zobrazit tlačítko pro návrat na vrch stránky
• Pozice — Vlevo nebo vpravo dole
• Vzhled — Ikona, barvy pozadí/textu a orámování (šířka, barva, zaoblení)

Titulek záložky

Cesta: Systém › Dodatečná nastavení › Doplňky › Titulek záložky (/admin/addons/tab-title-marketing)

Marketingová zpráva v titulku prohlížeče:

• Aktivní — Zapnutí funkce
• Zpráva — Text, který se střídá s původním titulkem, když zákazník opustí záložku
• Interval — Jak často se text střídá (1–60 sekund, zadává se v milisekundách)

Nastavení vyhledávání

Cesta: Systém › Základní nastavení › Nastavení vyhledávání

Optimalizace vyhledávání v e-shopu:

• Váhy polí — Zvýšení váhy určitých polí (např. název, SKU) při vyhledávání
• Sekce výsledků — Které sekce (produkty, kategorie, značky, populární dotazy) se zobrazují a jejich nadpisy
• Limity — Počet výsledků na sekci v našeptávači
• Kurátorské výsledky — Ručně vybrané produkty, kategorie a značky
• Texty — Zástupný text vyhledávání a text alternativ při žádných výsledcích

Automatická pravidla

Cesta: Systém › Dodatečná nastavení › Doplňky › Automatická pravidla (/admin/addons/automatic-rules)

Automatické akce při registraci zákazníka:

• Přiřazení skupiny zákazníků — Při registraci automaticky zařadí zákazníka do zvolené skupiny (zvlášť pro firemní/B2B a soukromé zákazníky)
• Přidělení kupónu — Při registraci automaticky přidělí zákazníkovi zvolený kupón (s e-mailovou notifikací)