Plugin SuperFaktura je najkomplexnejší z podporovaných účtovných pluginov — cez API vie vystaviť faktúru, zálohovú faktúru aj dobropis a voliteľne úplne prevziať fakturáciu namiesto Ecommio.
Kde to nájdete
Systém > Pluginy > Superfaktura na /admin/plugins/superfaktura/settings, po aktivácii pluginu v /admin/plugins.
Nastavenie pripojenia
| Pole | Povinné | Význam |
|---|---|---|
| Sandbox režim | Nie | Použije testovacie prostredie sandbox.superfaktura.sk namiesto ostrého |
| API Email | Nie | E-mail účtu SuperFaktura |
| API Key | Áno | API kľúč z SuperFaktura, sekcia Nástroje > API |
| Company ID | Nie | ID firmy v SuperFaktúre, ak ich máte v účte viac |
| Jazyk faktúr | Nie (predvolene slovenčina) | Slovenčina, čeština, angličtina, nemčina alebo maďarčina |
Po vyplnení API Email a API Key môžete pripojenie overiť priamo v nastavení pluginu ešte pred uložením — overenie vráti čitateľnú chybu, ak sú prihlasovacie údaje nesprávne.
Kedy sa čo vystavuje
Vystavenie faktúry, zálohovej faktúry a dobropisu v SuperFaktúre sa spúšťa udalosťami objednávky (napríklad vytvorenie, spracovanie, zaplatenie, dokončenie alebo refundácia) — presné naviazanie nastavíte v pluginových nastaveniach. Ďalšie voľby v nastavení určujú spôsob platby, či ste platca DPH, automatické odoslanie faktúry zákazníkovi a automatické označenie ako zaplatenej pri prijatí platby v Ecommio.
SuperFaktura ako primárny systém fakturácie
Zapnutím voľby primárna fakturácia sa vlastné vystavovanie faktúr v Ecommio pre tieto objednávky úplne vypne. Faktúru, jej číslo aj stav potom nájdete v SuperFaktúre, nie v Predaj > Faktúry.
Pozor: Ak zapnete primárnu fakturáciu, doklady zo SuperFaktúry nájdete v jej vlastnej administrácii — Ecommio ich do svojho zoznamu faktúr nekopíruje.
Časté problémy
Overenie pripojenia hlási „Nesprávne prihlasovacie údaje". Skontrolujte API Email a API Key priamo v SuperFaktúre, sekcia Nástroje > API, a či nemáte omylom zapnutý sandbox režim s ostrými údajmi (alebo naopak).
Faktúra sa v SuperFaktúre nevytvorila, hoci objednávka prešla očakávanou udalosťou. Skontrolujte log aplikácie na chyby volania SuperFaktura API — časté sú aj chýbajúci e-mail zákazníka (faktúra sa v takom prípade vytvorí, ale automaticky sa neodošle) alebo dočasná nedostupnosť SuperFaktura API, keď sa odoslanie zopakuje samo.
Po zapnutí primárnej fakturácie sa v Ecommio prestali objavovať faktúry. Očakávané správanie — s primárnou fakturáciou Ecommio vlastné faktúry pre tieto objednávky nevytvára vôbec.
Dobropis sa nevystavil pri refundácii. Skontrolujte, či je udalosť pre dobropis v nastavení pluginu naviazaná na správny stav objednávky (napríklad refundáciu), a prihlasovacie údaje k API.