PrestaShop a eFakturuj: z objednávky koncept faktúry bez prepisovania
Yiresse Abia
CTO · eFakturuj
Objednávka príde do PrestaShopu. Namiesto prepisovania zákazníka, položiek, dopravy, sadzieb DPH a splatnosti do fakturačného systému z nej eFakturuj pripraví koncept faktúry automaticky.
To je výsledok nového prepojenia PrestaShop → eFakturuj, ktoré sme dokončili a overili na reálnej inštalácii PrestaShopu 8.1. V prvej fáze ho otvárame slovenským e-shopom v pilotnej prevádzke.
Čo prepojenie vyrieši
Prepojenie je určené e-shopom, ktoré cez PrestaShop predávajú aj firmám a dnes prepisujú objednávky do fakturácie ručne.
- Z objednávky vznikne koncept faktúry, keď objednávka vstúpi do stavu, ktorý ste si zvolili, napríklad Payment accepted alebo Delivered.
- Z dobropisu v PrestaShope vznikne prepojený dobropis v eFakturuj, aj pri čiastočnom vrátení. Prepojenie prevezme presné rozpisy položiek, dopravy a sadzieb DPH.
- Úhrada sa zaznamená pri objednávke, ktorú PrestaShop označí za zaplatenú. Túto voľbu môžete vypnúť.
- Tá istá objednávka nevytvorí dve faktúry. Každá udalosť má vlastný identifikátor a nezmenené údaje sa preskočia.
Výsledkom nie je ďalší zoznam, z ktorého treba údaje ručne kopírovať. Výsledkom je pripravený doklad, pri ktorom riešite už iba kontrolu.
Ako funguje celý tok objednávky
- Zákazník dokončí objednávku v e-shope.
- Modul eFakturuj ju zachytí cez oficiálne PrestaShop hooky a uloží jej zašifrovanú kópiu do vlastnej fronty v databáze e-shopu. Pokladňa počas objednávky nikam neposiela dáta a na nič nečaká.
- Do eFakturuj sa objednávka odošle až vtedy, keď vstúpi do stavu, ktorý ste zvolili.
- Naplánovaný cron doručí čakajúce udalosti podpísaným kanálom. Odporúčaná frekvencia je každú minútu; modul ukazuje, kedy naposledy prebehol.
- eFakturuj vytvorí koncept faktúry so zákazníkom, položkami, dopravou, cenami, sadzbami DPH, menou a dátumami.
- Koncept skontrolujete, potvrdíte a odošlete cez eFakturuj.
Práve preto, že modul počas objednávky iba zapisuje lokálne, výpadok eFakturuj nevie zdržať ani pokaziť nákup. Objednávky prebehnú normálne a fronta sa doručí, keď je spojenie znova dostupné.
Neskoršie zmeny objednávky, zmeny položiek, platby aj dobropisy sa sledujú ďalej, ale iba pri objednávkach, ktoré prepojenie už raz zachytilo.
Vlastný prehľad dokladov priamo v PrestaShope
V administrácii pribudne sekcia Objednávky → eFakturuj invoices. Je to lokálny prehľad výsledkov synchronizácie, takže jeho otvorenie nikam neposiela dáta ani nerozšifrováva údaje o zákazníkoch.
- počty faktúr, dobropisov, spracovávaných udalostí a problémov na jednom mieste;
- vyhľadávanie podľa čísla faktúry, referencie objednávky alebo jej ID;
- filter na faktúry a dobropisy;
- odkaz späť na objednávku v PrestaShope a tlačidlá Open a PDF pri každom doklade;
- stav synchronizácie, tlačidlo Run synchronization now a posledných 50 riadkov aktivity.
Pri každej objednávke navyše uvidíte kartu eFakturuj invoices priamo v detaile objednávky. Obsahuje jej doklady, posledný stav synchronizácie a tlačidlo Send/update in eFakturuj pre prípad, keď chcete objednávku odoslať mimo automatického pravidla.
Prístup do prehľadu aj k akciám sa riadi oprávneniami PrestaShopu. Pre profily, ktoré majú vidieť iba objednávky, viete zobrazenie a úpravy nastaviť samostatne.
Nastavenie krok za krokom
1. V eFakturuj nainštalujte aplikáciu PrestaShop
V eFakturuj otvorte sekciu aplikácií a nainštalujte PrestaShop pre firmu, pod ktorú má e-shop fakturovať. Zobrazí sa jednorazový párovací kód. Platí 15 minút a po jednom úspešnom použití prestane fungovať.
2. Nahrajte modul do PrestaShopu
V administrácii otvorte Modules → Module Manager → Upload a module, nahrajte archív efakturujprestashop, aktivujte modul a otvorte Configure.
3. Spárujte e-shop s eFakturuj
Do konfigurácie vložíte verejnú adresu API eFakturuj a párovací kód. Modul si po spárovaní uloží vlastný podpisový kľúč zašifrovaný; heslo do eFakturuj ani do administrácie e-shopu nikam nezadávate.
4. Vyberte stavy objednávok
V časti Automatic invoice policy označíte stavy, pri ktorých sa má objednávka odoslať. Predvolene nie je zvolený žiadny stav, takže modul po inštalácii sám neodošle nič, kým sa nerozhodnete.
Odporúčame stav, pri ktorom už poznáte konečné položky, dopravu, zľavy a fakturačné údaje. Koncept tak nevznikne príliš skoro.
5. Naplánujte cron
Modul vygeneruje chránenú adresu pre pravidelnú synchronizáciu a zobrazí ju iba raz. Skopírujte ju hneď a naplánujte volanie každú minútu. Ak sa adresa stratí, token jednoducho otočíte a naplánujete nový.
6. Overte prvú objednávku
Otvorte Objednávky → eFakturuj invoices, spustite Run synchronization now a skontrolujte, že sa zaznamenal beh. Potom presuňte skúšobnú objednávku do zvoleného stavu. V eFakturuj sa objaví koncept, na ktorom skontrolujete najmä:
- obchodné meno, IČO, DIČ a IČ DPH odberateľa;
- položky, množstvá, jednotkové ceny a zľavy;
- dopravu a ostatné poplatky;
- sadzby a sumy DPH;
- menu, dátumy, splatnosť a celkovú sumu.
Čo sa stane pri zmene, chybe alebo opakovaní
Objednávka sa nezmenila: prepojenie ju rozpozná a neurobí nič. Nevznikne duplikát ani vtedy, keď tú istú zmenu ohlási viacero hookov naraz.
Objednávka ešte nemá zvolený stav: zostane bez dokladu. Spracuje sa až po prechode do stavu, ktorý ste nastavili.
Objednávka sa zmení, kým je faktúra ešte koncept: koncept sa aktualizuje podľa aktuálnych údajov.
Objednávka sa zmení až po tom, čo faktúra opustila stav konceptu: doklad sa automaticky neprepíše. Prepojenie ho označí na kontrolu, pretože oprava už vystavenej faktúry patrí do opravného dokladu.
Objednávku stornujete: ak je k nej stále iba koncept bez zaznamenanej úhrady, eFakturuj ho zruší. Ak už faktúra alebo úhrada existuje, dostanete upozornenie namiesto tichej zmeny.
Vrátenie tovaru nesedí: ak sa množstvá, sumy alebo rozpis DPH nedajú jednoznačne priradiť, prepojenie radšej označí doklad na kontrolu, než by vystavilo dobropis, ktorý by ste museli opravovať v účtovníctve.
Doručenie zlyhá: v prehľade máte dve akcie s odlišným významom. Retry delivery pošle znova presne tie isté údaje, keď išlo iba o výpadok spojenia. Send latest data načíta objednávku nanovo a vytvorí novú udalosť, keď sa zdrojové údaje medzitým zmenili. Pôvodný záznam zostáva v histórii.
Bez API kľúča a bez hesla
Do e-shopu sa inštaluje jeden modul, ale prepojenie nepotrebuje ani heslo do administrácie PrestaShopu, ani Webservice API kľúč.
Spárovanie prebehne jednorazovým kódom a od tej chvíle obe strany komunikujú podpísanými správami. Kým doklad čaká na odoslanie, leží vo vašej databáze zašifrovaný (AES-256-GCM). Do prehľadu aktivity ani do logov sa nedostane obsah faktúr; zobrazujú sa iba identifikátory a bezpečné zhrnutia.
Odkazy Open a PDF nie sú prístupové linky. Sú to bežné adresy v eFakturuj, ktoré vyžadujú vlastné prihlásenie čitateľa, takže samotné oprávnenie v PrestaShope prístup k účtovným dokladom nedáva.
Prepojenie viete kedykoľvek zrušiť. Odpojenie zmaže lokálny podpisový kľúč a frontu v e-shope, ale doklady, ktoré už v eFakturuj vznikli, zostávajú v účtovníctve nedotknuté.
Čo pilotná verzia zatiaľ nerobí
Aby bolo očakávanie jasné ešte pred zapojením:
- faktúry sa neodosielajú automaticky; vznikajú ako koncepty na kontrolu;
- prepojenie zatiaľ nerozlišuje firemné a spotrebiteľské objednávky, spracuje každú objednávku, ktorá vstúpi do zvoleného stavu; ak potrebujete spracovať iba objednávky s IČO, napíšte nám to pred zapojením;
- z dobropisu vznikne opravný doklad, ale vrátená platba sa automaticky nezaznamenáva, pretože dobropis v e-shope ešte nie je dôkazom o vrátení peňazí;
- podporovaný je jeden e-shop na jednu inštaláciu; režim multistore podporovaný nie je;
- modul deklaruje PrestaShop 8.1 až 9.x, overený je zatiaľ na PrestaShope 8.1;
- odkazy Open a PDF otvoria doklad až po prihlásení do eFakturuj; oprávnenie v PrestaShope samo o sebe prístup k dokladom nedáva;
- modul počas pilotu distribuujeme priamo, nie cez PrestaShop Addons.
PrestaShop je v tomto modeli zdroj objednávky. eFakturuj je miesto, kde vzniká, kontroluje sa a odosiela faktúra.
Prečo vytvárame najskôr koncept
Plne automatické odoslanie znie pohodlne, ale pri nesprávnej adrese, IČO, sadzbe DPH alebo poslednej zmene objednávky môže pohodlie rýchlo vytvoriť účtovný problém.
Prvá verzia prepojenia preto oddeľuje dve veci:
- prepisovanie údajov automatizujeme;
- rozhodnutie odoslať faktúru zostáva na vás.
Kontrolujete už pripravený doklad, nie prázdny formulár. Je to podstatne menej práce, ale stále máte posledné slovo.
Prečo to riešiť pred rokom 2027
Podľa aktuálneho FAQ Finančnej správy sa má od 1. januára 2027 v prvej fáze povinnosť vyhotovovať eFaktúry vzťahovať na slovenských platiteľov DPH pri tuzemských transakciách. Elektronická faktúra musí umožňovať automatizované spracovanie a byť v štruktúre podľa normy EN 16931, napríklad UBL XML. Samotné PDF takúto štruktúrovanú eFaktúru nenahrádza.
Pre e-shop na PrestaShope to znamená, že pri objednávkach slovenských firiem nestačí vyriešiť iba vzhľad PDF. Treba vyriešiť aj to, ako sa údaje z objednávky dostanú do systému, ktorý vie vytvoriť a doručiť štruktúrovanú elektronickú faktúru bez ručného prepisovania.
eFakturuj je zároveň Peppol Access Point aj Service Provider, takže faktúra vytvorená z vašej objednávky sa na doručenie neodovzdáva ďalšej tretej strane. Prepojenie uzatvára cestu od objednávky do siete v jednej línii.
Koľko to stojí
Modul je zadarmo v rámci zákazníckeho programu eFakturuj. Neplatíte za integráciu, za počet objednávok ani za prepojenie.
eFakturuj Solo je zadarmo do 50 faktúr mesačne, takže menší e-shop môže celé riešenie prevádzkovať bez nákladov.
Nastavenie prejdeme s vami. Počas pilotnej prevádzky spolu overíme inštaláciu modulu, spárovanie, výber stavov, cron aj prvý koncept faktúry.
Najčastejšie otázky
Spomalí modul pokladňu?
Nie. Modul počas objednávky nekomunikuje s eFakturuj. Ukladá iba zašifrovanú kópiu objednávky do vlastnej fronty a odosielanie prebehne na pozadí.
Potrebujem API kľúč alebo prístup do administrácie?
Nie. Stačí jednorazový párovací kód. Webservice API kľúč ani heslo do administrácie prepojenie nepoužíva.
Funguje to na PrestaShope 9?
Modul deklaruje kompatibilitu s verziami 8.1 až 9.x. Kompletné overenie na reálnom e-shope máme zatiaľ na PrestaShope 8.1, preto do pilotu prijímame najskôr osmičkové inštalácie.
Mám multistore, dá sa to?
Zatiaľ nie. Modul sa v režime multistore zámerne neinštaluje, aby sa nemohli pomiešať nastavenia a doklady medzi e-shopmi.
Čo sa stane s dokladmi, ak prepojenie zruším?
Faktúry a dobropisy zostanú v eFakturuj. Odpojenie zmaže iba lokálne prihlasovacie údaje a frontu v e-shope.
Je prepojenie už verejne dostupné?
Momentálne ho otvárame pre prvé pilotné nasadenia. Nastavenie s vami prejdeme a overíme na prvej reálnej objednávke.
Zapojte svoj PrestaShop e-shop do pilotu
Prevádzkujete slovenský e-shop na PrestaShope a predávate firmám? Napíšte nám správu s textom PRESTASHOP. Spoločne overíme verziu e-shopu, nainštalujeme modul, nastavíme stavy objednávok a prejdeme prvý koncept faktúry.