Plugin Expando Marketplace Connector for WooCommerce propojí váš WooCommerce e-shop s marketplaces přes Expando: Alza, Kaufland a Amazon. Je to jeden plugin pro všechny marketplaces. Které z nich máte zapnuté, určuje váš tarif v Expandu, a každý má v nastavení vlastní sekci.
Plugin posílá Expandu vaše produkty, sklad a ceny, stahuje objednávky z marketplaces do WooCommerce a vrací jim číslo zásilky. Sám plugin s marketplaces nekomunikuje, to dělá Expando.
Co budete potřebovat
WordPress 6.5 nebo novější, WooCommerce 9.2 nebo novější, PHP 7.4 nebo novější.
Účet v EXPANDO APP.
Prodejní účet na každém marketplace, kde chcete prodávat (Alza Trade, Kaufland, Amazon Seller Central).
Předpoklad pro Alzu: účet dodavatele v Alza Trade. Alza vás musí nejdřív schválit jako dodavatele (jak se stát dodavatelem Alzy).
U každého produktu kód produktu (SKU) a EAN. Pro Alzu navíc nákupní cenu bez DPH, nebo násobek ceny (kapitola 6a).
Kolik to stojí: plugin je zdarma. Expando je placená služba, do první objednávky na každém marketplace zdarma. Ceník je v kapitole 9.
1. Instalace
Ve WordPressu otevřete Pluginy → Instalace pluginů a vyhledejte „Expando Marketplace Connector“.
Klikněte na Instalovat a pak Aktivovat. WooCommerce musí být aktivní.
Nastavení najdete ve WooCommerce → Nastavení → Expando (v menu také WooCommerce → Expando).
Plugin ve vyhledávání nenajdete? Nahrajte ho ze zipu: Pluginy → Instalace pluginů → Nahrát plugin, vyberte soubor expando-marketplace-connector-for-woocommerce.zip (pošle vám ho podpora Expanda), klikněte na Instalovat a pak Aktivovat.
Dokud nekliknete na Připojit, plugin nikam nic neposílá.
2. Přehled: Začínáme
První obrazovka nastavení je Začínáme: seznam kroků s fajfkami. Ukazuje skutečný stav vašeho e-shopu a u každého nehotového kroku odkaz Nastavit, který vás zavede na správné místo:
Krok | Kdy je hotový |
|---|---|
Připojte obchod k Expandu | plugin je připojený |
Zvolte, odkud se berou EAN vašich produktů | je vybraný zdroj EAN |
Nastavte cenu posílanou na marketplace … | u každého zapnutého marketplace je nastavená cena |
Produktový feed vytvořen | v seznamu produktů pro Expando (feedu) je aspoň jeden produkt |
Feed převzalo Expando | Expando má feed zaregistrovaný, načetlo z něj produkty a feed si stáhlo (samotné stažení nestačí) |
Přihlašovací údaje / účet v EXPANDO APP (za každý marketplace) | odkaz do EXPANDO APP (z WordPressu to ověřit nejde) |
Přepočet ceny nastavený v EXPANDO APP pro … | jen když má Kaufland nebo Amazon jinou měnu než e-shop; odkaz do EXPANDO APP |
Importována první objednávka z marketplacu | do WooCommerce přišla první objednávka z marketplace |
U každého kroku je odkaz Jak?, který otevře příslušnou kapitolu tohoto návodu. Tlačítko Otevřít průvodce nastavením nad seznamem znovu spustí průvodce (kapitola 2a).
2a. Průvodce nastavením
Hned po prvním úspěšném připojení (kapitola 3) vás plugin místo seznamu kroků provede třemi kroky:
Odkud se berou EAN vašich produktů? Plugin sám najde pole, ve kterém má EAN nejvíc produktů: pole WooCommerce „GTIN, UPC, EAN nebo ISBN“, nebo jiné pole produktu (např. z pluginu EAN for WooCommerce). Pod volbou je náhled prvních tří produktů: EAN, cena a sklad, nebo důvod, proč produkt chybí. Klikněte na Uložit a pokračovat.
Jaká cena půjde na který marketplace? U každého marketplace z vašeho tarifu: pro Alzu nákupní cena bez DPH (z pole produktu, nebo běžná cena bez DPH × násobek ceny), pro Kaufland a Amazon vaše prodejní cena s DPH. Má-li marketplace jinou měnu než e-shop, uvidíte varování: přepočet ceny nastavte v EXPANDO APP.
Dokončete nastavení v portálech marketplaců a v EXPANDO APP: postup pro každý zapnutý marketplace (např. Alza Trade: přepnout skladový systém na EXPANDO a klíče vložit do EXPANDO APP) a tlačítko Otevřít EXPANDO APP. Klikněte na Dokončit; zbývající kroky ukáže Začínáme.
Tlačítko Přeskočit a zobrazit všechna nastavení průvodce zavře; nic se neztratí, všechno jde nastavit i v sekcích. Znovu ho otevřete tlačítkem Otevřít průvodce nastavením v Začínáme. Opětovné připojení (Odpojit a Připojit) průvodce samo neotevře.
3. Připojení k Expandu (sekce Připojení)
V EXPANDO APP otevřete Nastavení API a zkopírujte přístupový klíč vaší firmy (API token).
V sekci Připojení klíč vložte a klikněte na Připojit.
Plugin klíč ověří. Když je v pořádku, uloží ho (šifrovaně) a ukáže Připojeno a seznam zapnutých marketplaces. Když ne, nic se neuloží a uvidíte proč (klíč neplatí / Expando není dostupné).
Klíč se po uložení už nikde nezobrazuje. Chcete-li ho změnit, klikněte na Odpojit a připojte se znovu.
Pokud plugin nabídne Zabezpečit připojení, jde o doporučení, ne o chybu: jedním kliknutím přepnete na klíč, který funguje jen pro tento obchod. Nic jiného se nezmění.
4. Produkty a feed (sekce Produkty a feed)
EAN: v části Odkud brát údaje o produktech je předvybrané pole, kde má EAN nejvíc produktů, a řádek Pokrytí EAN („EAN má X z Y produktů“) s odkazem na produkty bez EAN. Chcete-li jiné pole, zvolte ho a klikněte na Uložit. Cena se nastavuje zvlášť pro každý marketplace v jeho sekci (kapitola 6).
Feed (seznam produktů pro Expando): plugin z vašich produktů vytvoří seznam, který si Expando zhruba každé 3 hodiny stáhne. Expandu ho předáte jednou: v sekci Produkty a feed zkopírujte adresu feedu, uživatele a heslo (tlačítkem Kopírovat) a pošlete je podpoře Expanda, která feed zaregistruje. Údaje nikomu jinému nedávejte. Při odpojení a novém připojení zůstávají stejné.
Hotovo je, když v Začínáme svítí Feed převzalo Expando; řádek Naposledy přečteno Expandem ukazuje, kdy si Expando feed naposledy stáhlo. Obchod připojený jedním kliknutím (až bude k dispozici) zaregistruje feed sám a údaje schová pod Zobrazit pro podporu; podporu pak potřebujete jen tehdy, když plugin napíše, že registrace byla odmítnuta.
Pod tím je Náhled: přesně to, co pošleme za první produkty (EAN, ceny, sklad).
Proč některý produkt chybí? V řádku Vynecháno z feedu je počet vynechaných produktů a důvod:
Důvod | Co udělat |
|---|---|
Chybí kód produktu (SKU) | Doplňte SKU (u varianty vlastní, ne stejné jako rodič). |
Chybí EAN | Doplňte EAN do zvoleného pole. |
EAN není platný 8, 12 nebo 13místný kód | Opravte EAN (kontrolní číslice musí sedět). |
Chybí cena pro zapnutý marketplace | Nastavte cenu v sekci daného marketplace. |
Plugin nikdy nezveřejní prázdný feed ani feed, ve kterém najednou zmizí víc než polovina produktů: to by na marketplaces vynulovalo sklad. Pokud jste produkty odebrali schválně, klikněte na Vytvořit znovu.
5. Přihlašovací údaje k marketplaces
Údaje k marketplaces se zadávají v EXPANDO APP, nikdy ve WordPressu. Nejdřív v EXPANDO APP zkontrolujte, že se produkty z feedu načetly správně (EAN, cena, sklad).
6. Sekce jednotlivých marketplaces
Každý marketplace, který je ve vašem tarifu, má vlastní sekci. Nahoře je přepínač Posílat produkty na marketplace … a importovat z něj objednávky, kterým marketplace vypnete, aniž byste přišli o nastavení. Marketplace, který v Expandu ještě nemáte připojený, ukazuje Nepřipojeno.
6a. Alza
Předpoklad: účet dodavatele v Alza Trade. Ještě nejste dodavatelem Alzy? Jak se jím stát. Pak tři kroky mimo WordPress (stejný seznam najdete i nahoře v sekci Alza v pluginu):
V EXPANDO APP zkontrolujte, že produkty z e-shopu dorazily se správným EAN, cenou a skladem.
V Alza Trade otevřete Nastavení logistiky → API a komunikace a přepněte skladový systém na EXPANDO. Teprve potom Alza ukáže Supplier ID, Branch ID a Secret Key.
Tyto tři údaje vložte v EXPANDO APP do Prodejní kanály → Alza → Připojit, nikdy ve WordPressu. Pozor na mezery na začátku a konci klíče. Sekce Alza v pluginu pak ukáže svůj přepínač.
Nastavení v sekci Alza:
Nákupní cena: Alza potřebuje vaši nákupní cenu bez DPH (ne maloobchodní cenu). Zvolte pole produktu s nákupní cenou bez DPH, nebo běžnou cenu bez DPH × Násobek ceny. Dokud nezvolíte, na Alzu nejde žádný produkt. Akční ceny se neposílají, prodejní ceny a akce si na Alze nastavuje Alza. Příklad: hrnek prodáváte za 249 Kč s 21 % DPH, tj. 205,79 Kč bez DPH. S násobkem 0,80 pošleme Alze jako nákupní cenu 164,63 Kč bez DPH. Násobek je podíl z vaší ceny bez DPH, který chcete od Alzy dostat (0,80 = 80 %).
Výchozí dopravce a Hmotnost balíku: použijí se u zásilky, když dopravce nebo váhu nejde zjistit jinak.
Štítek Alzy: u objednávek, které vozí dopravce Alzy (Alza si zásilku vyzvedne sama), je na objednávce box Štítek Alza s tlačítky Stáhnout štítek Alza a Seznam balíků pro řidiče Alzy (svozový list). Předání zásilky potvrďte v EXPANDO APP.
6b. Kaufland
Sekce Kaufland nemá žádná nastavení ceny: na Kaufland jde vaše prodejní cena ve WooCommerce včetně DPH.
Plugin cenu nepřepočítává do jiné měny. Prodáváte-li v zemi Kauflandu s jinou měnou, než má e-shop (např. e-shop v CZK a kaufland.de v EUR), nastavte v EXPANDO APP přepočet ceny. Začínáme vám takový Kaufland vypíše.
V EXPANDO APP zadejte Client key a Secret key z Kaufland Seller Portalu a nastavte dopravní šablonu (shipping template). Bez ní Kaufland nabídky odmítne.
Objednávky mají původ Kaufland (Expando). Číslo zásilky jde na Kaufland s kódem dopravce; dopravce, kterého Kaufland nezná, jde jako „Other“ s jeho názvem.
6c. Amazon
Na Amazon jde vaše prodejní cena ve WooCommerce včetně DPH. Plugin ji nepřepočítává do jiné měny: pro Amazon s jinou měnou, než má e-shop, nastavte v EXPANDO APP přepočet ceny (Začínáme ho připomene).
Volitelně v sekci Amazon: Doba zpracování (dny) (0–30 dní do předání dopravci) a Šablona dopravy (název šablony z Amazon Seller Central). Prázdné = platí nastavení v Seller Central.
V EXPANDO APP autorizujte Expando v Amazon Seller Central, zapněte marketplaces, na kterých prodáváte, a zapněte vystavování nových produktů.
Do WooCommerce se stahují jen objednávky, které posíláte vy (FBM). Objednávky, které Amazon posílá ze svého skladu (FBA), se nestahují: zboží už z vašeho skladu odešlo. Objednávka ve stavu Pending počká, než Amazon pošle adresu.
Objednávky mají původ Amazon (Expando), platba „Zaplaceno na Amazonu“.
7. Objednávky a odeslání zásilek
Objednávky z marketplaces se do WooCommerce stahují každých 5 minut jako běžné objednávky. U objednávky je číslo objednávky z marketplace a jako původ (Origin) je uvedeno např. Alza (Expando). Sklad odečte WooCommerce jako obvykle. V sekci Objednávky vidíte poslední běh a tlačítko Importovat teď.
Zákazníkům marketplaces WooCommerce neposílá e-maily, s kupujícími komunikuje marketplace.
Odeslání: když objednávku označíte Dokončeno, plugin pošle číslo zásilky a dopravce přes Expando na marketplace. Automatické odesílání je ve výchozím stavu vypnuté: zapněte ho v sekci Odeslání zásilek, nebo u objednávky použijte akci Odeslat expedici na marketplace ….
Číslo zásilky plugin hledá v boxu Expedice Expando u objednávky, pak v polích produktu z nastavení (např.
_dpd_tracking_number=DPD), pak v Zásilkovně, PPL CZ a WooCommerce Shipment Tracking.Odesílají se jen objednávky, které doručujete sami. Objednávky, které vozí dopravce Alzy, potvrďte v EXPANDO APP; objednávky Amazon FBA plugin vůbec nestahuje.
Zrušení objednávky ve WooCommerce ji na marketplace nezruší. Rušte v EXPANDO APP; zrušení se pak propíše do WooCommerce.
U každé objednávky je poznámka, jestli a kdy zásilka odešla, nebo proč ne.
8. Váš tarif (sekce Tarif)
Plugin je zdarma a nic v něm není uzamčené. V sekci Tarif vidíte svůj tarif v Expandu a čerpání v aktuálním období (objednávky a produkty). Údaje se načítají živě z Expanda, plugin je nepočítá sám. Za co a kolik se platí, popisuje kapitola 9.
9. Kolik to stojí
Plugin je zdarma. Platíte za službu Expanda, a to až od první objednávky z daného marketplace. Dokud z marketplace nepřijde první objednávka, za něj neplatíte nic. Bezplatný tarif s limitem objednávek není. Všechny ceny jsou bez DPH.
Měsíční poplatek za každý marketplace (období 30 dní). Úroveň se určuje zvlášť pro každý marketplace (např. Amazon.de a Amazon.es zvlášť) podle počtu objednávek z něj a počtu produktů, které na něj posíláte. Platí ta vyšší z obou:
Úroveň | Objednávky za 30 dní | Produkty | Poplatek za 30 dní |
|---|---|---|---|
Start | 0–199 | do 5 000 | 990 Kč |
Growth | 200–1 999 | do 20 000 | 1 990 Kč |
Scale | 2 000–10 000 | do 100 000 | 5 490 Kč |
Enterprise | nad 10 000 | nad 100 000 | individuálně |
Úroveň si nevybíráte, řídí se skutečným využitím v daném období. Poplatek se platí v každém období od první objednávky, i když v něm žádná objednávka nepřijde.
Sleva za více marketplaces stejného typu (Amazon, Kaufland; Alza je samostatný typ): nejdražší marketplace daného typu platí plnou cenu (100 %), druhý 70 %, třetí a každý další 30 %.
Ceny pro Kaufland a Amazon jsou předběžné a mohou se změnit; aktuální ceník najdete vždy v této kapitole.
Poplatek z obratu se počítá ze součtu obratu bez DPH ze všech marketplaces (Alza, Amazon, Kaufland) za období, po pásmech:
Část obratu za 30 dní | Sazba |
|---|---|
do 100 000 Kč | 0 % |
100 000 – 1 000 000 Kč | 0,99 % |
1 000 000 – 3 000 000 Kč | 0,49 % |
nad 3 000 000 Kč | 0,29 % |
Každá sazba platí jen pro část obratu ve svém pásmu. Obrat v jiné měně se přepočítá kurzem ČNB.
Příklady: Amazon.de, 50 objednávek, obrat 80 000 Kč: 990 Kč. Amazon.de a Amazon.es, obrat 150 000 Kč: 990 + 693 + 495 = 2 178 Kč. Alza (Growth) a Kaufland.cz (Start), obrat 700 000 Kč: 1 990 + 990 + 5 940 = 8 920 Kč.
10. Časté dotazy
Na kterých marketplaces můžu prodávat? Na Alze, Kauflandu a Amazonu. Každý má v nastavení svou sekci; marketplace, který v Expandu ještě nemáte připojený, ukazuje „Nepřipojeno“.
Musím mít smlouvu s Alzou? Ano: potřebujete schválený účet dodavatele v Alza Trade (kapitola 6a).
Posílá plugin na Alzu akční ceny? Ne. Posílá nákupní cenu bez DPH; prodejní cenu a akce si určuje Alza.
Napsal mi plugin „Expando tento přístupový klíč nepřijalo“. Klíč je špatně zkopírovaný nebo už neplatí. Zkopírujte ho znovu z EXPANDO APP → Nastavení API.
Objednávka z marketplace se ve WooCommerce neobjevila. Počkejte 5 minut, nebo v sekci Objednávky klikněte na Importovat teď. Zkontrolujte, že je plugin připojený (Připojeno) a že je daný marketplace v sekci zapnutý. Pokud ani pak ne, napište podpoře číslo objednávky z marketplace (plugin potřebuje plánované úlohy WordPressu; podpora vám pomůže je zkontrolovat).
Mám zapnutý Kaufland/Amazon, ale ceny tam nesedí. Plugin posílá cenu z WooCommerce včetně DPH bez přepočtu měny. Pro marketplace s jinou měnou nastavte přepočet ceny v EXPANDO APP (Začínáme ukazuje, kterých marketplaces se to týká).
Produkt není na marketplace. Podívejte se do sekce Produkty a feed, řádek „Vynecháno z feedu“, a do náhledu. Nejčastěji chybí EAN nebo cena pro daný marketplace. Feed se čte zhruba každé 3 hodiny.
Kde jsou logy? WooCommerce → Stav → Logy, zdroj expando-mc. Logy nikdy neobsahují přístupový klíč ani údaje kupujících.
Jak plugin odinstaluji? Deaktivujte a smažte ho v Pluginech. Smažou se nastavení, přístupový klíč a uložený feed; objednávky ve WooCommerce zůstanou.
Kontakt na podporu: help@expan.do
