Návod k instalaci a použití modulu Vytvořil:
Obsah Návod k instalaci a použití modulu... - 1 - Podpora... - 2 - Důležité informace... - 3 - Návod k instalaci a použití modulu... - 3-1. Zřízení podnikatelského účtu na Aukro.cz... - 3 - a) Založení podnikatelského účtu... - 3 - b) Převod účtu na podnikatelský... - 3-2. Získání WebAPI klíče... - 4-3. Instalace modulu... - 5-4. Nastavení modulu... - 5-1. Nastavení modulu... - 5-2. Nastavení dopravy a platby... - 9-3. Nastavení prodejního formuláře... - 10-5. Mapování kategorií... - 11-6. Mapování atributů... - 11-7. Hromadné vystavení zboží... - 12-8. Fronta... - 13-9. Nabídky... - 15-10. Nákupy... - 16-11. Zákazníci... - 16-12. Nedokončené nákupy... - 17-13. Šablony... - 17 - Podpora V případě dotazů či problémů nás neváhejte kontaktovat na e-mailu support@webnaut.cz nebo telefonu +420 223 005 512. - 2 -
Důležité informace Pro správnou funkčnost modulu je nutné, aby na serveru kde je e-shop hostován, bylo toto PHP rozšíření (modul dostupnost rozšíření kontroluje a upozorní vás v případě potřeby ho přidat): 1. SOAP (http://php.net/manual/en/book.soap.php) 2. OpenSSL (http://php.net/manual/en/book.openssl.php) Dále je potřeba mít na serveru povolené allow_url_fopen (http://php.net/manual/en/filesystem.configuration.php). Návod k instalaci a použití modulu 1. Zřízení podnikatelského účtu na Aukro.cz a) Založení podnikatelského účtu Předtím než budete moci začít používat náš aukro konektor, je nutné si na Aukro.cz zřídit podnikatelský účet. Do registračního formuláře zadávejte pouze informace o společnosti, veškeré vámi zadávané informace musí být dohledatelné v živnostenském rejstříku (správnost dat je ověřována zaměstnanci Aukro.cz). Pro plnou aktivaci účtu je potřeba aktivační kód, který vám přijde poštou do 10 dní. b) Převod účtu na podnikatelský Pokud již máte soukromý účet na Aukro.cz je možné jej nechat převést na podnikatelský účet. Žádost o převod najdete po přihlášení na Aukro > Moje Aukro > Prodávám > Můj účet Nastavení: Moje údaje. V záložce Osobní údaje naleznete formulář pro změnu na podnikatelský učet. - 3 -
2. Získání WebAPI klíče Před samotným nastavením modulu je potřeba získat WebAPI klíč od Aukra. Postupujte přesně podle těchto pokynů: 1. Přejdete na http://api.aukro.cz/jak-funguje-webapi/chci-webapi-klic/. 2. Zvolte kategorii Další služby a předmět WebAPI 3. Klikněte na tlačítko formulář 4. Zažádejte si o zaslání WebAPI klíče. Do obsahu zprávy stačí napsat žádost (např: Dobrý den, prosím o zaslání WebAPI klíče. Používám aukro konektor od společnosti WebNaut s.r.o.. Webová adresa našeho e-shopu je.) 5. Žádost odešlete, WebAPI klíč vám přijde do 48 hodin. - 4 -
3. Instalace modulu Aukro konektor pro PrestaShop se instaluje standardním způsobem v sekci Moduly administračního rozhraní vašeho e-shopu. 1. Klikněte na Přidat nový modul. 2. Vyberte soubor aukroconnector.zip dodaný s tímto dokumentem. 3. Klikněte na Nahrát tento modul. 4. V seznamu dostupných modulů najděte Aukro konektor a kliněte na tlačítko Nainstalovat 5. Nyní je modul nainstalovaný a v hlavním menu administrace je přidaná nová položka Aukro. 4. Nastavení modulu 1. Nastavení modulu Aukro > Nastavení modulu Zde provedete základní nastavení modulu. Přístup k WebAPI Aukro > Nastavení modulu Přístup k WebAPI 1. Uživatelské jméno Zadejte vaše přihlašovací jméno na Aukro.cz 2. Heslo Zadejte vaše heslo na Aukro.cz 3. WebAPI klíč Zadejte klíč, který jste získali v kroku 2 Získání WebAPI klíče. 4. ID země Zadejte ID země (56 Česká republika). 5. Uložte nastavení. - 5 -
Nastavení skladu Aukro > Nastavení modulu Nastavení skladu 1. Kontrolovat skladové zásoby Chcete-li vystavovat pouze zboží, které máte momentálně skladem, vyberte Ano. Pokud se sníží skladové množství, nebo zboží na skladě dojde, budou nabídky automaticky upraveny nebo zrušeny. 2. Pouze aktivní produkty - Pokud vyberete "Ano", bude možné vystavit jen zboží, které je aktivní, a při deaktivaci zboží budou zrušeny příslušné nabídky. 3. Výchozí počet položek [%]-Zde můžete nastavit výchozí počet položek nových nabídek v závislosti na stavu skladu. 4. Maximální počet položek [ks]- Zde můžete nastavit maximální počet položek vystavených v nabídce. Pokud bude pole prázdné, počet položek nebude omezen. 5. Uložte nastavení. Nastavení obrázků Aukro > Nastavení modulu Nastavení obrázků 1. Velikost náhledů Zde zvolte velikost náhledů obrázků zobrazených v administraci modulu při vytváření nabídky. - 6 -
2. Velikost na Aukru Zde zvolte skutečnou velikost obrázků odesílaných na Aukro.cz. 3. Výchozí obrázky Zde vyberte, jaké obrázky produktů budou automaticky přikládány k nabídkám na Aukru. 4. Uložte nastavení. Pokud chcete velikost obrázků, která v možnostech není, přidáte si ji v Konfigurace > Obrázky. Nastavení automatického obnovení Aukro > Nastavení modulu Nastavení automatického obnovení 1. Výchozí automatické obnovení Vyberte výchozí způsob obnovení nabídek. Můžete znovu vystavit stejnou nabídku, neprodané položky z předchozí nabídky, zvolit možnost vystavení podle stavu skladu, případně nabídky neobnovovat vůbec. 2. Výchozí prodleva obnovení (h) Pokud jste si v předchozím kroku vybrali některou z možností automatického obnovení nabídek, máte zde možnost nastavit si časovou prodlevu mezi vypršením nabídky a jejím znovu vystavením. 3. Uložte nastavení. Nastavení objednávek Aukro > Nastavení modulu Nastavení objednávek 1. Vytváření objednávek - Zde nastavte, zda chcete vytvářet objednávky ručně, nebo automaticky při zpracování nákupů z Aukra. 2. Uložte nastavení. Pokud si nastavíte ruční vytváření objednávek, je nutné objednávky vytvořit v Aukro > Nákupy Zobrazit detail nákupu Propojení s PrestaShopem - 7 -
Nastavení fronty Aukro > Nastavení modulu Nastavení fronty 1. Počet nabídek v dávce Zde zadejte, kolik nabídek ve frontě bude odesláno na Aukro.cz při jednom spuštění CRON skriptu (0 = všechny nabídky). Doporučený počet je okolo 50ti nabídek v dávce. 2. Odeslat pouze zkontrolované nabídky - Pokud vyberete "Ano", budete muset nabídky před automatickým odesláním pomocí CRON skriptu nejdřív ručně zkontrolovat ve frontě (Aukro > Fronta). 3. Počet nabídek v dávce pro automatické vystavování Zde zadejte, kolik produktů bude přidáno do fronty v jedné dávce při automatickém vystavování zboží. 4. Uložte nastavení. Různé Aukro > Nastavení modulu Různé 1. Koeficient ceny Pokud chcete mít jinou cenu na Aukro.cz než v eshohu, nastavte koeficient. Modul umožňuje automatické zvýšení nebo snížení ceny produktů při vystavení na Aukru oproti cenám zadaným v PrestaShopu. Tato úprava ceny je zadána koeficientem v procentech (př.: Koeficient ceny = 110% - cena na Aukru bude o 10% vyšší než cena v PrestaShopu). 2. Povolit AukroShop Zde můžete povolit vystavování předmětů do Aukro Shopu. 3. WYSIWYG editor - Zde můžete zakázat WYSIWYG editor u vystavování nabídek. 4. Zkrátit název nabídky Vyberte, zda chcete zkracovat názvy produktů. Názvy nabídek na Aukru mohou být max. 50 znaků dlouhé. 5. Uložte nastavení. - 8 -
Cron Aukro > Nastavení modulu Cron Pro správný chod modulu je důležité nastavit si automatické spouštění skriptů uvedených v této části, ty zajišťují aktualizaci dat dostupných na API aukra. 1. Cron je potřeba nastavit v administraci hostingu. Pokud si jej neumíte nastavit sami, požádejte vašeho správce hostingu. Načítání kategorií je doporučeno alespoň 1x za 24 hodin. Načítání prodejního formuláře Načítání prodejního formuláře je doporučeno alespoň 1x za 24 hodin. Stahování nákupů Stahování shopů je doporučeno 1x za 5 minut. Obnovení nabídek Obnovování nabídek je doporučeno 1x za 5 minut. Zpracování fronty nabídek Zpracování fronty nabídek je doporučeno 1x za 5 minut. Automatické vystavení produktů Automatické vystavení produktů je doporučeno 1x za 5 minut. 2. Načtěte z aukra seznam kategorií tlačítkem Načíst kategorie. 3. Načtěte z aukra prodejní formulář tlačítkem Načíst prodejní formulář. 2. Nastavení dopravy a platby Aukro > Nastavení dopravy a platby Nastavení dopravců Aukro > Nastavení dopravy a platby Nastavení dopravců V této části nastavení je potřeba spárovat dopravce, které je možné v rámci aukro.cz nabídnout s dopravci v e-shopu. Zároveň je potřeba nastavit pro jednotlivé dopravce ceny, které se budou přenášet na aukro. 1. Pokud nevidíte přehled dopravců poskytovaný aukrem, klikněte na tlačítko Načíst dopravce. 2. K příslušným způsobům dopravy na aukru vyberte dopravce v PrestaShopu. V případě, že daný způsob dopravy nenabízíte, zanechte v kolonce Dopravce v PrestaShopu vybráno n/a. Pokud nemáte dopravce v nabídce, je možné jej přidat v Přeprava > Dopravci. 3. Zadejte ceny za dopravu, které se budou zobrazovat zákazníkům na Aukro.cz. 4. Uložte nastavení. - 9 -
Nastavení platebních modulů Aukro > Nastavení dopravy a platby Nastavení platebních modulů Stejně jako u dopravců je potřeba napárovat platební metody aukra na dostupné platby v rámci e- shopu. 1. K příslušným způsobům platby na aukru vyberte platební modul v PrestaShopu. 2. Uložte nastavení. 3. Nastavení prodejního formuláře Aukro > Nastavení prodejního formuláře 1. Délka trvání Zde nastavíte délku trvání aukce na 3, 5, 7, 10 nebo 30 dní. 2. Země Zadejte zemi, ze které předmět prodáváte. 3. Region Zvolte region, ze kterého prodáváte. 4. Město Zadejte město, ze kterého prodáváte. 5. Doprava Zvolte, kdo hradí za dopravu 6. Dodatečné podmínky dopravy Vyberte "Ostatní", pokud chcete vložit více informací k dopravě. Pokud souhlasíte se zasíláním zboží do zahraničí, potvrďte tuto možnost. 7. Způsob platby Zde zvolte způsob platby. Vybete "Ostatní", pokud chcete vložit více informací k platbě. 8. Informace o dopravě a platbě Zde můžete vložit více informaví o dopravě či platbě. Pro vložení informací, je potřeba mít zatrženou volbu "Ostatní" v dodatečných podmínkách dopravy nebo u způsobu platby (6. a 7.). 9. Množstevní jednotka Zde si zvolíte množstevní jednotku vystavovaných produktů. 10. PSČ Zadejte PSČ místa, ze kterého prodáváte. 11. Bankovní účet 1a 2 Zde zadejte číslo bankovního účtu. - 10 -
12. Bezplatné možnosti přepravy Zde vyberte, zda umožňujete i bezplatnou dopravu. 13. Uložte nastavení. 5. Mapování kategorií Aukro > Mapování kategorií 1. Klikněte na "Přidat mapování" 2. Vyberte kategorii v PrestaShopu. 3. Ke kategorii přiřaďte odpovídající kategorii na aukru. 4. Přidělte kategorii prioritu. Prioritu nastavte jako nezáporné celé číslo. V případě, že budete vystavovat produkty, u kterých by zařazení do kategorie nebylo jednoznačné (například je máte v e-shopu zařazeny ve více kategoriích), bude produkt automaticky zařazen do kategorie s vyšší prioritou. 5. Uložte mapování. 6. Mapování atributů Aukro > Mapování atributů Modul umožňuje namapovat příslušné atributy, vlastnosti, výrobce či statické hodnoty z PrestaShopu a atributy na Aukro.cz. 1. Klikněte na "Přidat mapování" 2. Vyberte položku prodejního formuláře. 3. Zvolte typ mapování. 4. K položkám prodejního formuláře přiřaďte příslušné atributy. 5. Zvolte způsob vyplnění položky. 6. Uložte mapování. 7. Pokud jste zvolili způsob vyplnění položky pomocí mapování, namapujte atributy. 8. Uložte mapování. - 11 -
7. Hromadné vystavení zboží Aukro > Hromadné vystavení zboží 1. Vyberte kategorii, ze které chcete vystavovat, pomocí filtru. Pokud nezvolíte konkrétní kategorii, můžete rovnou vybírat ze všech produktů. 2. Vyberte produkty, které chcete vystavit na aukro. Výběr můžete provést následujícím způsobem: a. Klikněte na akci "Přidat do fronty" ( ). b. Vyberte jednotlivé produkty pomocí zaškrtávacích políček a potvrďte tlačítkem "Přidat vybrané produkty do fronty". c. Pomocí zaškrtávacího políčka v hlavičce tabulky můžete vybrat všechny produkty najednou. 3. Pro dokončení vystavení přejděte do fronty (Aukro > Fronta). - 12 -
8. Fronta Aukro > Fronta V této části se zobrazují veškeré nabídky čekající na vystavení na aukro. Zde je možné nabídky před vystavením zkontrolovat, upravit, rovnou vystavit na aukro nebo odstranit. Nabídky z fronty je možné odesílat manuálně nebo automaticky. Nastavení fronty je možné upravit v Aukro > Nastavení modulu Nastavení fronty. Pro správný chod fronty je rovněž velmi důležité mít nastavený Cron v administraci hostingu (nastaví váš správce hostingu) Aukro > Nastavení Cron. Zkontrolovat nabídku a) Nabídku zkontrolujete kliknutím na akci "Zkontrolovat nabídku" ( ). Dojde k automatické kontrole všech údajů v nabídce přes aukro.cz a je dopočítán poplatek aukru. b) Můžete zkontrolovat i více nabídek najednou. Označte nabídky pomocí zaškrtávacích políček a klikněte na tlačítko "Zkontrolovat vybrané nabídky". Vystavit nabídku a) Pokud máte v Aukro > Nastavení modulu Nastavení fronty u položky "Odeslat pouze zkontrolované nabídky" vybráno "Ne", budou se vám nabídky z fronty odesílat na Aukro.cz automaticky. Objednávky budou odesílány na Aukro.cz ve vámi nastaveném počtu nabídek v dávce (Aukro > Nastavení modulu Nastavení fronty) vždy ve vámi stanoveném intervalu (Aukro > Nastavení modulu Cron). b) Pokud máte v Aukro > Nastavení modulu Nastavení fronty u položky "Odeslat pouze zkontrolované nabídky" vybráno "Ano", budou se nabídky z fronty odesílány na Aukro.cz až po manuálním schválení. Nabídku zkontrolujete kliknutím na "Zkontrolovat nabídku" ( ). - 13 -
Objednávky budou odesílány na Aukro.cz ve vámi nastaveném počtu nabídek v dávce (Aukro > Nastavení modulu Nastavení fronty) vždy ve vámi stanoveném intervalu (Aukro > Nastavení modulu Cron). c) Produkt můžete vystavit také rovnou kliknutím na "Vystavit nabídku" ( ). d) Můžete vystavit i více nabídek najednou. Označte nabídky pomocí zaškrtávacích políček a klikněte na tlačítko "Odeslat vybrané nabídky na Aukro". Upravit nabídku 1. Pokud chcete nabídku před odesláním na Aukro.cz ještě upravit klikněte na akci "Upravit nabídku" ( ). 2. Vybrané zboží - Zde se dočtete informace o vybraném zboží. 3. Množství Zde nastavte počet položek, které prodáváte. Pokud necháváte nabídku po jejím vypršení automaticky obnovovat, nastavte počet položek po obnovení. 4. Základní údaje Pokud potřebujete, zde můžete upravit základní údaje o produktu jako název, začátek aukce, dobu trvání aukce, cenu, místo ze kterého prodáváte, informace o dopravě a platbě. Máte možnost zde nastavit také nadstandardní volby pro zviditelnění vaší nabídky. Přidejte popis a základní informace o produktu. 5. Automatické obnovení Zde nastavte, zda chcete obnovit vystavení předmětu po vypršení nabídky a časovou prodlevu pro vystavování. 6. Obrázky Vyberte obrázky, které chcete vystavit. 7. Údaje o dopravě Zde můžete upravit údaje o dopravě. Pokud chcete přidat daší způsob dopravy, je nutné si jej nejprve přidat v Aukro > Nastavení dopravy a platby > Nastavení dopravců. 8. Nastavení atributů Nastavte atributy produktu. 9. Odeslat na Aukro Nabídku můžete rovnou vystavit, uložit a zkontrolovat nebo uložit a vrátit se zpět na seznam bez kontroly. Odstranit nabídku a) Pokud chcete nabídku odstranit, klikněte na akci "Odstranit" ( ). b) Můžete odstranit i více nabídek najednou. Označte nabídky pomocí zaškrtávacích políček a klikněte na tlačítko "Zrušit vybrané nabídky". - 14 -
9. Nabídky Aukro > Nabídky V této části se zobrazují veškeré vaše nabídky, které aukro eviduje. Stejně jako u běžných objednávek se nabídky rozdělují dle svého stavu. Stav určuje podbarvení dané nabídky. Nabídky můžete filtrovat podle stavu. V detailu každé z nabídek najdete kromě informace o zakoupení také odkaz na vystavený předmět přímo na stránkách aukra. Je zde rovněž možné měnit počet vystavených produktů, nebo celou nabídku zrušit. Zrušit vystavenou nabídku a) Pokud chcete nabídku odstranit, klikněte na akci "Zrušit nabídku" ( ). Odstranění potvrďte. b) Vyberte produkt pomocí zaškrtávacího políčka. Potvrďte zrušení nabídek. Zobrazit detail nabídky 1. Detail nabídky zobrazíte kliknutím na akci "Zobrazit detail nabídky" ( ). 2. Základní informace - V detailu kromě základních informací naleznete také odkaz na předmět vystavený na Aukro.cz. Pokud chcete zobrazit nabídku, klikněte na odkaz. 3. Akce Pokud produkt zatím nebyl prodán, můžete nabídku zrušit, nebo změnit počet vystaveních kusů. Pokud byl produkt prodán, můžete jej znovu vystavit. 4. Zakoupení předmětu V tabulce naleznete informace o detailu objednávky a o zákaznících. Pokud chcete zobrazit detailní informace o zákaznících nebo transakcích, klikněte na odkaz. Informace najdete také v Aukro > Zákazníci nebo Aukro > Nákupy. - 15 -
10. Nákupy Aukro > Nákupy Jakmile některý zákazník provede nákup na aukro.cz, tak se tento nákup zobrazí v této části. Pokud nemáte nastavené automatické vytváření objednávek, tak si je můžete vytvářet právě v této agendě u každého nákupu. Zobrazit detail nákupu 1. Detail nabídky zobrazíte kliknutím na akci "Zobrazit detail nákupu" ( ). 2. Informace o nákupu V detailu naleznete informace o nákupu, jako jsou datum a čas zakoupení, informace i zákazníkovi a o způsobu dopravy a platby a o ceně. Pokud chcete zobrazit informace o zákazníkovi, klikněte na odkaz. Informace o zákaznících najdete také v Aukro > Zákazníci. Informace o nákupu můžete také upravit kliknutím na tlačítko akci "Upravit údaje". 3. Doručovací adresa 4. Seznam zakoupených předmětů Zde naleznete informace o předmětech zakoupených zákazníkem. Chcete-li zobrazit informace o prodaných předmětech, klikněte na Odkaz nabídky. Informace o nabídce naleznete také v Aukro > Nabídky. 5. Propojení s PrestaShopem Objednávku v PrestaShopu vytvoříte kliknutím na "Vytvořit objednávku". 11. Zákazníci Aukro > Zákazníci Společně s nákupy se do e-shopu synchronizují data o zákazníkovi. Ty se evidují v rámci této agendy, kde si můžete prohlédnout informace stejně, jako to poskytuje Aukro.cz. Zobrazit detail zákazníka 1. Detail zákazníka zobrazíte kliknutím na akci "Zobrazit detail zákazníka" ( ) nebo na ID zákazníka. 2. Informace o zákazníkovi Zde naleznete informace o zákazníkovi. 3. Nákupy na Aukru zde naleznete informace o nákupech uskutečněných zákazníkem. Klikněte na ID nákupu pro zobrazení objednávky. - 16 -
12. Nedokončené nákupy Aukro > Nedokončené nákupy V této části se zobrazují nákupy, které nebyly dokončené, protože u nich chybí informace o platbě, nebo případně i další údaje, bez kterých není možné objednávku dokončit. U těchto objednávek je potřeba kontaktovat zákazníka a údaje doplnit. Zobrazit detail nabídky 1. Detail nabídky zobrazíte kliknutím na akci "Zobrazit detail nabídky" ( ) nebo na ID nabídky. 2. Základní informace - V detailu kromě základních informací naleznete také odkaz na předmět vystavený na Aukro.cz. Pokud chcete zobrazit nabídku, klikněte na odkaz. 3. Akce Pokud produkt zatím nebyl prodán, můžete nabídku zrušit, nebo změnit počet vystaveních kusů. Pokud byl produkt prodán, můžete jej znovu vystavit. 4. Zakoupení předmětu V tabulce naleznete informace o detailu objednávky a o zákaznících. Pokud chcete zobrazit detailní informace o zákaznících nebo transakcích, klikněte na odkaz. Informace najdete také v Aukro > Zákazníci nebo Aukro > Nákupy. Dokončit nákup manuálně 1. Nákup dokončete kliknutím na akci "Dokončit nákup manuálně" ( ). 2. Upravte údaje potřebné k úspěšnému dokončení objednávky. Můžete upravovat údaje o dopravě a platbě, doručovací adresu, nebo informace o výdejním místě. 3. Potvrďte úpravu kliknutím na tlačítko "Upravit". 13. Šablony Aukro > Šablony V této části modulu naleznete šablony pro všechny kategorie. V případě, že pro danou kategorii nemáte šablonu nastavenou, zobrazí se u vystaveného produktu pouze popis. Přidání nové šablony 1. Šablonu přidáte kliknutím na "Přidat šablonu" ( ). 2. Vyberte kategorii v PrestaShopu pro kterou chcete šablonu nastavit. 3. Zadejte název šablony. 4. V poli "Šablona" si nastavte, jak chcete, aby nová šablona vypadala. Jednoduché šablony nastavíte pomocí nastavení vzhledu písma a odstavce. V případě, že se šablona nezobrazuje správně, nebo chcete-li přidat složitější nastavení, je třeba upravit HTML zdroj ( ). - 17 -
{$name} {$description} {$description_short} {$images} {$images_all} {$images_cover} {$features} {$attributes} Název Popis Krátký popis Výpis obrázků (pouze od atributu, pokud existuje) Výpis obrázků všechny Hlavní obrázek Výpis vlastností Výpis atributů - 18 -