Inštalácia a prvé spustenie

Celé prvé nastavenie trvá približne 10 minút. Odporúčame ho spraviť najprv v testovacom prostredí a do ostrej prevádzky prejsť až po vyskúšaní.

Pripravte si z portálu digitálneho poštára:

• Client ID,
• API kľúč (začína vpt_…). Zobrazí sa len raz pri vytvorení, preto si ho uložte.

1. Stiahnite modul vo svojom zákazníckom účte v časti Môj účet → Moje moduly. Licenčný súbor je už v balíku.
2. V administrácii PrestaShopu otvorte Moduly → Správca modulov a kliknite na Nahrať modul.
3. Vyberte stiahnutý súbor ZIP. Po nahratí modul nainštalujte.
4. Pri module kliknite na Konfigurovať.

Licenčný súbor license.lic je súčasťou balíka, takže sa licencia nahrá sama.

Otvorte Konfigurovať pri module. Modul vás povedie záložkami 1. Pripojenie → 2. Firma → 3. Platby → 4. Odosielanie.

1. Na záložke 1. Pripojenie vyberte poskytovateľa a prostredie Testovacie, zadajte Client ID a API kľúč.
2. Kliknite na Uložiť a otestovať pripojenie. Modul overí prístup a automaticky načíta údaje firmy (meno, IČO, DIČ, IČ DPH, sídlo a Peppol ID) z portálu poskytovateľa. Prázdne polia doplní z kontaktov obchodu.
3. Na záložke 3. Platby vyplňte IBAN.
4. Na záložke 4. Odosielanie zvoľte, kedy sa má faktúra odosielať (odporúčame zapnúť Odoslať pri vystavení faktúry).
5. Hore v paneli Stav nastavenia skontrolujte, že pri všetkých bodoch je zelená značka. Červená značka ukazuje, čo ešte chýba. Kliknutím na ňu sa otvorí príslušná záložka.

Podrobný popis všetkých polí nájdete v kapitole Nastavenie.

Všeobecný postup, ako cron nastaviť, nájdete v návode Ako nastaviť cron.

Cron je pravidelne spúšťaná úloha na serveri. Modul ho potrebuje na:

• opakovanie neúspešných pokusov,
• zisťovanie, či bol doklad doručený a nahlásený Finančnej správe,
• odosielanie oneskorených dokladov.

Adresu cronu nájdete v nastaveniach modulu v paneli hore. Pridajte ju do plánovača úloh (cron) u svojho hostingu, ideálne každých 5 až 10 minút:

*/10 * * * * curl -s "https://vas-shop.sk/module/mv_peppol/cron?token=..." >/dev/null

Skutočnú adresu aj s tokenom si skopírujte z nastavení modulu. Pod ňou vidíte aj čas posledného behu. Ak je tam „Cron zatiaľ nebežal“, cron ešte nie je nastavený správne.

Kým je prostredie Testovacie, doklady neodchádzajú skutočným odberateľom. Vyskúšajte aspoň:

• bežnú objednávku firmy (s DIČ),
• objednávku so zľavou,
• objednávku s dopravou zdarma,
• objednávku zaplatenú kartou,
• dobropis.

Pri každej použite v detaile objednávky tlačidlo Náhľad XML a v detaile dokladu Validovať u poskytovateľa. Ak všetko prejde, môžete prepnúť na ostrú prevádzku.

1. V záložke 1. Pripojenie zmeňte Prostredie na Ostrá prevádzka.
2. Zadajte ostré Client ID a API kľúč (testovacie a ostré údaje sú rozdielne).
3. Kliknite na Uložiť a otestovať pripojenie.
4. Ak sa zobrazí upozornenie, že firma nie je registrovaná v sieti Peppol, dokončite výber poskytovateľa na portáli Finančnej správy. Pozri Riešenie problémov.

Licencia modulu je časovo neobmedzená a platí pre jednu zaplatenú doménu, jej subdomény a lokálne kópie. Cena zahŕňa 12 mesiacov aktualizácií a podpory, ktoré sa dajú predĺžiť.

• Stav licencie vidíte v poslednom paneli Licencia v nastaveniach modulu. Tam môžete nahrať aj nový súbor .lic.
• Bez platnej licencie modul nefunguje. Nastavenia ukážu len panel Licencia.
• Presun na inú doménu: modul ešte 14 dní funguje s upozornením, potom sa vypne. Doménu zmeníte v zákazníckom účte (Môj účet → Moje moduly).
• Po skončení 12 mesiacov aktualizácií modul ďalej funguje, len nedostávate nové verzie.
• Multistore je podporovaný, ak všetky obchody bežia na licencovanej doméne alebo jej subdoménach (napr. eshop.sk a velkoobchod.eshop.sk).
• Modul raz denne (pri otvorení nastavení) overí licenciu a zistí nové verzie. Posiela len číslo licencie, domény a verzie modulu, PrestaShopu a PHP.

Bez platnej licencie modul neodosiela, ale doklady sa nestratia: ostanú vo fronte a odošlú sa po nahratí platnej licencie.

Ak je dostupná nová verzia a máte platné aktualizácie, zobrazí sa v paneli Licencia (posledný panel v nastaveniach modulu) tlačidlo Aktualizovať na X.Y.Z.

1. Kliknite na tlačidlo a počkajte. Nezatvárajte stránku, trvá to najviac pár minút.
2. Modul stiahne novú verziu z moduly.webvision.sk, skontroluje ju a nainštaluje.
3. Pôvodná verzia sa uloží ako záloha. Ak aktualizácia zlyhá, vráti sa sama.

Čo je v novej verzii, ukáže rozbaľovací zoznam Čo je nové v tom istom paneli.

• Hlavné verzie (napr. z 1.x na 2.0) môžu meniť správanie alebo nastavenia. Pred aktualizáciou si prečítajte zmeny, odkaz je pri tlačidle.
• Ak má viac modulov WEB Vision novú verziu, tlačidlo Aktualizovať všetky moduly WEB Vision ich aktualizuje naraz.
• Ak aktualizácie už neprebiehajú (skončilo 12 mesiacov), modul ďalej funguje. Novú verziu si stiahnete po predĺžení v zákazníckom účte.
• Vrátenie verzie: tlačidlo Vrátiť verziu nájdete v paneli Licencia v časti Podrobnosti.
• Prehľad dostupných aktualizácií nájdete na stránke Aktualizácie modulov.