Prepojenie SuperFaktúry a WooCommerce

Podpora

Odpovede na otázky, ktoré nám používatelia pluginu posielajú najčastejšie. Ak tu odpoveď nenájdete, napíšte nám.

Kontakt

Napíšte na superfaktura@2day.sk. Pomôže nám, keď uvediete:

  • verziu pluginu, WordPressu a WooCommerce,
  • číslo objednávky a čo presne sa stalo,
  • čo je pri objednávke v API logu (WooCommerce → Nastavenia → SuperFaktúra → API log).

Otázky môžete klásť aj vo fóre na WordPress.org. S účtom, predplatným a dokladmi priamo v SuperFaktúre vám pomôže podpora SuperFaktúry.

Inštalácia a nastavenie

Koľko plugin stojí?

Plugin je zadarmo pod licenciou GPL. Potrebujete účet v SuperFaktúre, jej cenník nájdete na superfaktura.sk.

Čo potrebujem v SuperFaktúre?

API e-mail a API kľúč, ktoré nájdete v SuperFaktúre v časti Nástroje → API. Používateľ, ktorého údaje zadáte, musí mať v SuperFaktúre rolu Administrátor. API funguje len pri aktívnom predplatnom SuperFaktúry.

Zmení aktualizácia moje nastavenia?

Nie. Sprievodca nastavením sa ponúkne len po novej inštalácii, kým nie sú vyplnené API údaje. Na nastavenom e-shope ho spustíte sami v časti Nástroje.

Dá sa fakturovať aj v Česku alebo Rakúsku?

Áno. V nastaveniach vyberiete, či máte účet v SuperFaktúre na Slovensku, v Česku alebo v Rakúsku.

Kedy sa faktúra vystaví?

Keď objednávka prejde do stavu, ktorý nastavíte pri jej spôsobe platby v časti Vytvorenie faktúry. Rovnako sa nastavuje zálohová faktúra. Ak si nie ste istí, spustite sprievodcu nastavením v časti Nástroje. Pri každom spôsobe platby odporučí doklad aj stav.

Objednávky iba s virtuálnymi a stiahnuteľnými produktmi idú rovno do stavu Vybavená a stav Spracováva sa preskočia. Faktúra nastavená na stav Spracováva sa by im preto nevznikla. Zapnite Faktúra pre objednávky bez spracovania a takým objednávkam sa vystaví pri stave Vybavená.

Keď doklad nevznikne

Faktúra sa nevytvorila. Kde zistím prečo?

V API logu (WooCommerce → Nastavenia → SuperFaktúra → API log). Pri každom pokuse je odpoveď SuperFaktúry a pri častých chybách aj vysvetlenie, čo urobiť. O dokladoch, ktoré sa nepodarilo vytvoriť, vás plugin upozorní aj v administrácii.

Keď príčinu odstránite, chýbajúce faktúry vystavíte v zozname objednávok hromadnou akciou SuperFaktúra: vystaviť faktúry. Akcia je v ponuke, keď je v časti Vytvorenie faktúry zapnuté Manuálne vytvorenie faktúry.

V API logu je chyba 401 alebo neplatné prístupové údaje

Skontrolujte API email, API kľúč a Company ID v časti Autorizácia a použite tlačidlo Otestovať API pripojenie. Rovnaká chyba nastane, keď v SuperFaktúre skončilo predplatné alebo používateľ nemá rolu Administrátor.

V API logu je cURL error alebo timeout

Server e-shopu sa nepripojil k SuperFaktúre. Ak sa to opakuje, obráťte sa na poskytovateľa hostingu. Ak sa to stáva len občas, zapnite v časti Vytvorenie faktúry → Experimentálne funkcie nastavenie Zopakovať neúspešné API volania na vytvorenie dokumentu. Plugin potom skúsi doklad vytvoriť znova po 5 minútach, potom po ďalších 30 minútach a po ďalšej hodine. Platí to pre doklady, ktoré plugin vytvára automaticky.

Doklad s rovnakým číslom už existuje

Plugin posiela číslo, ktoré už v SuperFaktúre je. Najčastejšie to spôsobí vlastné číslovanie v plugine popri číslovaní v SuperFaktúre. Vypnite Vlastné číslovanie faktúry a v časti Faktúra zadajte ID číselníka pre faktúry a ID číselníka pre zálohové faktúry. Doklady potom čísluje SuperFaktúra.

K jednej objednávke vznikli dve faktúry

Niektoré platobné brány, napríklad GoPay, oznámia zaplatenie dvakrát v tej istej chvíli. Zapnite v časti Vytvorenie faktúry → Experimentálne funkcie nastavenie Zabrániť duplicite dokumentov. Nadbytočnú faktúru vymažte v SuperFaktúre a nechajte tú, na ktorú odkazuje objednávka.

Platby a párovanie

Platba je v SuperFaktúre spárovaná, ale objednávka stále čaká na platbu
  • V časti Integrácia skopírujte Callback URL a Secret Key a zadajte ich v SuperFaktúre v nastaveniach firmy pre automatické párovanie. Ak máte v SuperFaktúre viac firiem, zadajte ich pri tej, do ktorej plugin posiela doklady.
  • Pozrite sa do API logu. Pri každej oznámenej úhrade je záznam, a ak sa objednávka nezmenila, aj vysvetlenie.
  • Ak v API logu žiadny záznam nie je, oznámenie zo SuperFaktúry na e-shop neprišlo. Skontrolujte, či je v SuperFaktúre zadaná Callback URL presne tak, ako je v plugine. Ak áno, obráťte sa na podporu SuperFaktúry alebo na poskytovateľa hostingu.
  • Objednávka sa označí ako zaplatená len v stavoch z nastavenia Stavy objednávky pre automatické párovanie, predvolene Čaká na platbu.

Samotné spárovanie úhrady s faktúrou robí SuperFaktúra. Ak sa úhrada nespárovala, obráťte sa na jej podporu.

Faktúra vznikla ako uhradená, hoci zákazník ešte nezaplatil

Faktúra vznikne ako uhradená, keď je objednávka v stave z nastavenia Označiť faktúru ako uhradenú v týchto stavoch objednávky (predvolene Vybavená) alebo keď má spôsob platby v časti Vytvorenie faktúry zaškrtnuté Vytvoriť ako uhradenú. Ak to nechcete, odoberte stav z tohto nastavenia alebo zrušte zaškrtnutie pri spôsobe platby.

Zmizol odkaz Pregenerovať vystavené faktúry

Faktúra sa nedá pregenerovať, keď je objednávka v stave Vybavená. Pri inom spôsobe platby ako dobierka ani v stave Spracováva sa. Potrebnú úpravu urobte priamo v SuperFaktúre.

Pokladňa, DPH a OSS

V pokladni chýbajú polia IČO, DIČ a IČ DPH

Skontrolujte, či je v časti Integrácia zapnuté Pridať možnosť fakturácie na firmu. Polia sa zobrazia, keď zákazník zaškrtne Fakturovať na firmu.

V klasickej pokladni sú polia naviazané na pole Názov spoločnosti. Ak je toto pole v nastaveniach pokladne WooCommerce skryté, nezobrazia sa ani polia pluginu. Skryť ich môže aj téma alebo plugin na úpravu pokladne.

Firemné údaje z iného pluginu sa nedostanú na faktúru

Plugin berie IČO, DIČ a IČ DPH zo svojich polí v pokladni. Prevezme ich aj z pluginov Nastavenia SK/CZ pre WooCommerce a WPify Woo a IČ DPH aj z viacerých pluginov na DPH v EÚ. Ak ich zbiera iný plugin alebo téma, údaje na faktúru doplníte filtrom sf_client_data.

Na faktúre chýba DPH

Plugin preberá sadzby DPH z objednávky. Ak DPH chýba už v objednávke, skontrolujte nastavenia daní vo WooCommerce. Ak ju objednávka má a faktúra nie, skontrolujte v SuperFaktúre, či je firma nastavená ako platiteľ DPH.

Firme z inej krajiny EÚ sa neuplatní prenesenie daňovej povinnosti

V časti Integrácia zapnite Overiť platnosť IČ DPH a Odpočítať DPH pre firmy z EÚ s platným IČ DPH. DPH sa odpočíta, keď zákazník zaškrtne Fakturovať na firmu, jeho IČ DPH overí VIES (európsky systém na overenie IČ DPH) a fakturačná adresa je v inej krajine EÚ ako krajina obchodu. Keď VIES nie je dostupný, DPH sa neodpočíta. Či sa objednávka vtedy dá dokončiť, určíte v nastavení Keď sa IČ DPH nedá overiť.

Vo verziách pluginu pred 1.59.1 sa prenesenie daňovej povinnosti na faktúru nedostalo, keď nebolo zapnuté nastavenie Povoliť vlastné poznámky. Aktualizujte plugin.

Faktúra nemá príznak OSS

OSS (One Stop Shop, osobitná úprava DPH pri predaji súkromným osobám v iných krajinách EÚ) zapnete v časti Faktúra. Doklad sa vystaví v režime OSS, keď zákazník nemá IČ DPH a krajina zdanenia je iná krajina EÚ ako krajina obchodu. Pri zapnutom OSS vidíte v detaile objednávky pod fakturačnou adresou, či doklad bude v OSS a prečo.

Najčastejšou príčinou chýbajúceho OSS je nesprávna krajina obchodu vo WooCommerce → Nastavenia → Všeobecné. Sadzbu DPH určuje WooCommerce. Aby sa použila sadzba krajiny zákazníka, nastavte v nastaveniach daní „Počítať daň na základe“ na Dodacia adresa zákazníka alebo Fakturačná adresa zákazníka.

Zľava z kupónu má na faktúre inú sadzbu DPH

Pri nastavení Kupón v položkách na faktúre na hodnotu Spolu je zľava jeden riadok s najvyššou sadzbou DPH v objednávke. Ak máte v objednávkach viac sadzieb, zvoľte Po položkách. Zľava sa potom uvedie pri každej položke s jej sadzbou.

Ceny bez DPH majú na faktúre viac desatinných miest

SuperFaktúra dostane cenu bez DPH a sadzbu DPH. Cenu s DPH dopočíta sama. Aby sa cena s DPH zhodovala s objednávkou, cena bez DPH sa nezaokrúhľuje na dve miesta. Koľko desatinných miest sa zobrazí, určuje SuperFaktúra. Ak sa suma faktúry líši od objednávky o centy, skúste v časti Faktúra iný Spôsob zaokrúhľovania DPH.

E-maily a doklady

Faktúra chýba v e-maile zákazníkovi

V časti Integrácia → Emaily zapnite Odkaz na faktúru alebo PDF faktúry v prílohe. E-mail sa odošle pri zmene stavu objednávky. Ak faktúra vzniká až v neskoršom stave, v skoršom e-maile ešte nie je. Pri platbe kartou preto vystavte faktúru pri stave Spracováva sa.

Ako vytvoriť dobropis?

V detaile objednávky s faktúrou sa zobrazí odkaz Vytvoriť dobropis, keď je objednávka v stave Zrušené, Refundovaná alebo Neúspešná alebo keď je pri nej zaznamenané vrátenie peňazí. Pri vrátení peňazí zadajte sumy pri jednotlivých položkách, aby mal dobropis správne sadzby DPH.

Dá sa zmeniť vzhľad PDF faktúry?

PDF vytvára SuperFaktúra. Vzhľad, logo a pečiatku nastavíte v nej. Údaje na faktúre, napríklad splatnosť, poznámku alebo popis položiek, upravíte filtrami sf_invoice_data a sf_item_data.

Dá sa vystaviť faktúra v jazyku zákazníka?

Áno. V časti Faktúra nastavte Jazyk faktúry na Krajina zákazníka. Pre krajiny, ktorých jazyk SuperFaktúra nepodporuje, vyberte Náhradný jazyk faktúry.

Kompatibilita

Funguje s blokovou pokladňou a HPOS?

Áno. Plugin funguje s novým úložiskom objednávok WooCommerce (HPOS) aj s blokovou pokladňou a firemné údaje z nej prenáša na faktúru.

Funguje s WooCommerce Subscriptions?

Áno. Každá objednávka z obnovenia predplatného dostane vlastný doklad podľa rovnakých nastavení ako bežná objednávka.

Dá sa fakturovať do dvoch firiem v SuperFaktúre?

Nastavenia pluginu platia pre jednu firmu. Doklady niektorých objednávok pošlete do inej firmy filtrami, príklad aj s obmedzeniami nájdete na stránke Pre vývojárov.