Popis
Prepojí obchod WooCommerce s Denárom, fakturáciou a párovaním úhrad z banky pre slovenský trh. Plugin nemá vlastnú fakturačnú logiku: číslovanie, DPH, PDF, QR platby PAY by square aj e-faktúry (Peppol, na Slovensku povinné od roku 2027) rieši Denár, obchod len posiela objednávky a prijíma webhooky.
- Bankový prevod: pri objednávke sa vystaví zálohová faktúra s PAY by square a číslom objednávky ako variabilným symbolom. Keď Denár spáruje platbu z banky, objednávka prejde do stavu Spracováva sa a zo zálohovej faktúry sa vystaví faktúra.
- Karta a platobné brány: faktúra sa hneď vystaví a označí ako uhradená.
- Dobierka: faktúra sa vystaví pri dokončení objednávky.
- Vrátenie peňazí: dobropis k faktúre na vrátené položky alebo vrátenú sumu.
- Zrušené objednávky: neuhradená zálohová faktúra sa stornuje.
- Kupóny sa stanú zľavou na doklade, doprava a poplatky sú položky; firemné údaje (IČO, DIČ, IČ DPH) sa čítajú z bežných polí
_billing_ic/_billing_dic/_billing_dic_dph; prenesenie daňovej povinnosti v EÚ a vývoz z firemného modulu px-shop-core. - Každý doklad sa porovná so sumou objednávky – doklad s inou sumou (zaokrúhlenie cien s DPH) ostane konceptom, namiesto aby sa vystavil s nesprávnou sumou.
- Obrazovka objednávky ukazuje doklady so stiahnutím PDF; „Znova odoslať do Denára“ po oprave skúsi znova.
- Beží na pozadí (Action Scheduler) s opakovaním – pokladňa na Denár nikdy nečaká.
- Funguje s HPOS aj s blokovou pokladňou.
Potrebujete účet v Denári s prístupom k API – plány Firma a Profi a bezplatné skúšobné obdobie. Registrácia na denar.sk.
Externé služby
Plugin sa pripája k API Denára (https://api.denar.sk/v1, prevádzkuje Pixeler s. r. o., Slovensko) – fakturačnej službe, v ktorej obchod vystavuje svoje doklady. Bez nej plugin nič nerobí.
- Keď administrátor klikne na „Overiť spojenie“, plugin pošle API kľúč a dostane názov a daňové identifikátory pripojenej organizácie.
- Keď sa má objednávka vyfakturovať, plugin pošle údaje objednávky potrebné na faktúru: číslo objednávky, položky, ceny, dane, dopravu, spôsob platby a fakturačné údaje zákazníka (meno, firma, IČO a IČ DPH, adresa, e-mail, telefón). Údaje samotného obchodu sa posielajú pod jeho API kľúčom.
- Denár posiela obchodu späť webhooky (doklad uhradený, stornovaný); obsahujú údaje dokladu, nie osobné údaje nad rámec toho, čo poslal obchod.
Kým administrátor nezadá API kľúč, nič sa neodosiela.
- Obchodné podmienky: https://denar.sk/obchodne-podmienky
- Ochrana osobných údajov: https://denar.sk/ochrana-osobnych-udajov
Inštalácia
- Nainštalujte a aktivujte plugin (WooCommerce musí byť aktívny).
- V Denári vytvorte API kľúč (Účet -> API kľúče) s oprávneniami doklady a partneri, čítanie aj zápis.
- Vložte ho do WooCommerce -> Nastavenia -> Denár a kliknite na Overiť spojenie.
- V Denári pridajte webhook (Účet -> Webhooky) na adresu zobrazenú v nastaveniach pluginu a jeho tajný kľúč vložte do pluginu.
Prístupové údaje možno zadať aj vo wp-config.php: DENAR_WC_API_KEY, DENAR_WC_WEBHOOK_SECRET, DENAR_WC_API_URL.
Časté otázky
-
Funguje plugin bez Denára?
-
Nie. Je to prepojenie – faktúry sa vystavujú v Denári.
-
Ako získam účet v Denári?
-
Zaregistrujte sa na denar.sk. Nový účet začína bezplatným skúšobným obdobím, ktoré API obsahuje; potom plugin potrebuje plán s prístupom k API (Firma alebo Profi).
-
Moje ceny sú s DPH. Bude faktúra sedieť s objednávkou?
-
Áno. Plugin posiela ceny s DPH a Denár z nich vypočíta základ dane, takže suma faktúry sa zhoduje so sumou objednávky na cent, vrátane kupónov.
-
Kam sa zapisujú chyby?
-
WooCommerce -> Stav -> Záznamy, zdroj „denar“. API kľúč sa nikdy nezapisuje do záznamov.
Recenzie
Pre tento plugin nie sú žiadne recenzie.
Prispievatelia a vývojári
“Denár pre WooCommerce” je softvér s otvoreným zdrojovým kódom. Do tohto pluginu prispeli nasledujúci ľudia.
Prispievatelia
„Denár pre WooCommerce“ bol preložený do 1 jazyka. Ďakujeme prekladateľom za ich príspevky.
Preložiť „Denár pre WooCommerce“ do vašho jazyka.
Máte záujem o vývoj?
Prehľadávajte zdrojový kód, preskúmajte SVN repozitár, alebo sa prihláste na odber vývojárskeho logu cez RSS.
Zoznam zmien
0.2.2
- Readme: registrácia v Denári je otvorená; ktoré plány obsahujú API.
0.2.1
- Každý PHP súbor odmietne priamy prístup.
- Readme: ako získať účet v Denári, ceny s DPH.
0.2.0
- Doklady k objednávkam: zálohová faktúra pri bankovom prevode, faktúra pri uhradenej objednávke (zo zálohovej, ak existuje), faktúra pri dokončení dobierky, dobropisy pri vrátení peňazí, storno neuhradených zálohových faktúr.
- Box v objednávke s dokladmi a stiahnutím PDF, akcia objednávky „Znova odoslať do Denára“.
- Obchody s cenami s DPH posielajú ceny s DPH (Denár prices_include_vat), takže suma dokladu je presne suma objednávky, vrátane kupónov.
- Kontrola súm – doklad, ktorý nesedí s objednávkou, ostane konceptom; opakovanie aktualizuje koncept podľa aktuálnej objednávky.
0.1.2
- Pripravené pre wordpress.org: samostatné zostavenie bez GitHub aktualizátora, sekcia Externé služby v readme.
- Názov pluginu späť na „Denár for WooCommerce“ (pravidlá ochranných známok); slovenský „Denár pre WooCommerce“ ide z prekladu.
0.1.1
- Ikona a banner v Nástenka -> Aktualizácie a v detaile pluginu.
- Slovenský názov pluginu: Denár pre WooCommerce.
- Otestované do WordPress 7.1.
0.1.0
- Kostra pluginu: nastavenia, overenie spojenia, endpoint pre webhooky s overením podpisu, aktualizácie z GitHub releasov.