skFaktura.sk for WooCommerce

skFaktura.sk for WooCommerce prepája e-shop s aplikáciou skFaktura.sk cez API. Pri zvolenom stave objednávky dokáže vytvoriť koncept alebo rovno vystaviť doklad a zákazníkovi zobrazí bezpečný odkaz na jeho online náhľad. Hlavné funkcie:

• Overenie API spojenia so skFaktura.sk.
• Pravidlá vystavovania podľa stavu objednávky a platobnej brány.
• Faktúry, zálohové faktúry, dobropisy, cenové ponuky a dodacie listy.
• Automatický dobropis pri úplnej alebo čiastočnej refundácii.
• Prenos položiek, dopravy, poplatkov, zliav, údajov zákazníka a čísla objednávky.
• Odkaz na sledovanie zásielky v e-maile dokončenej objednávky a v účte zákazníka.
• Mapovanie platobných brán na spôsoby platby v skFaktura.sk.
• Údaje dodávateľa, logo, pečiatka a vlastný text podľa platobnej metódy.
• Voliteľné zobrazenie referenčného kurzu ECB pri dokladoch mimo EUR.
• Bezpečné odkazy na doklady v e-mailoch, na ďakovacej stránke a v časti Môj účet.
• Živý náhľad farieb, rozmerov a zaoblenia tlačidiel s dokladmi.
• Obojsmerná synchronizácia skladového množstva podľa SKU v programe Pro.
• Jeden spoločný stav zásob pre viac e-shopov pri zachovaní ich názvov, cien a mien.
• Voliteľná aktualizácia bežnej ceny vo vybranom WooCommerce e-shope priamo z produktu v skFaktura.sk.
• Export produktov a variantov do CSV pripraveného na priamy import v skFaktura.sk.

Plugin vyžaduje aktívny WooCommerce a účet skFaktura.sk s API prístupom. English summary: Connect WooCommerce to skFaktura.sk, create documents automatically by order status and payment gateway, issue credit notes for refunds, and show styled secure document links to customers. PRO inventory synchronization can share one SKU stock balance across multiple WooCommerce stores while preserving localized product names, prices and currencies.

0.9.18

• Sledovanie sa vloží aj do upraveného zákazníckeho e-mailu odoslaného pri stave Vybavená, bez závislosti od jeho interného identifikátora.
• E-mail obsahuje výrazné tlačidlo aj samostatný klikateľný odkaz a údaje sú dostupné už počas callbacku, ktorý mení stav objednávky.
• Vzhľad sledovacieho tlačidla, jeho text, nadpis aj zobrazenie tlačidla alebo odkazu možno nastaviť samostatne; sledovanie v e-mailoch možno aj vypnúť.

0.9.17

• Odkaz na sledovanie sa spoľahlivo zobrazí v zákazníckom e-maile „Vybavená objednávka“ aj pri aktívnom kompatibilnom doplnku na sledovanie zásielok, bez zdvojenia už vykresleného odkazu.

0.9.16

• Odpojený e-shop si plugin zapamätá a zastaví opakovanú registráciu aj API prenosy objednávok.
• Dostupnosť opätovného pripojenia overuje najviac raz denne; po pripojení v skFaktura.sk je možné okamžité obnovenie tlačidlom Overiť spojenie.
• Pri ostatných chybách registrácie počká aspoň hodinu. Súbežné registrácie chráni spoločný zámok.
• Úspešné hlásenie e-shopu zároveň dokončí registráciu callbackov a zruší nadbytočný naplánovaný pokus.

0.9.15

• Pridáva podpísaný callback na uloženie dopravcu, sledovacieho čísla a odkazu k WooCommerce objednávke.
• Zobrazuje sledovanie v zákazníckom e-maile „Vybavená objednávka“ a v detaile objednávky v účte zákazníka.
• Voliteľne používa oficiálne rozšírenie WooCommerce Shipment Tracking, ak je v e-shope aktívne.

0.9.14

• Prenáša ID služby a kód partnerského výdajného miesta z oficiálneho pluginu Packeta pre doručenie na adresu aj partnerských dopravcov.
• Overená kompatibilita s WordPress 7.1.

0.9.13

• Prenáša spôsob dopravy a platby, telefón príjemcu, výslednú hmotnosť zásielky vrátane baliaceho materiálu a údaje výdajného miesta ako podklad na tvorbu prepravných štítkov.
• Spoľahlivo preberá ID výdajného miesta z oficiálneho pluginu Packeta a pri dobierke bez dátumu úhrady neposiela objednávku ako zaplatenú.
• Prenáša PUS ID a upravenú hmotnosť z pluginu DPD SK for WooCommerce 9.2.1 od Webikon s.r.o. pre tvorbu DPD štítkov v skFaktura.sk.

0.9.12

• Pridáva podpísaný callback na voliteľnú aktualizáciu bežnej ceny produktu alebo konkrétnej variácie.
• Rešpektuje menu obchodu a to, či WooCommerce zadáva ceny s DPH alebo bez DPH; akciovú cenu nemení.
• Po aktualizácii plugin automaticky zaregistruje podporu cenového callbacku pri najbližšom behu WordPress cron.

0.9.11

• Plugin načíta oprávnenia API kľúča a používa iba povolené časti integrácie.
• Bez oprávnenia na synchronizáciu objednávok sa obchod neregistruje, neposiela heartbeat ani objednávky a nezobrazí sa v sekcii E-shopy.
• Overenie pripojenia funguje aj pre kľúč určený iba na doklady, katalóg alebo sklad.

0.9.10

• Umožňuje z centrálneho prehľadu bezpečne označiť objednávku ako dokončenú z ľubovoľného aktuálneho stavu.
• Pred zmenou naďalej overí podpísaný príkaz aj to, že sa stav objednávky vo WooCommerce medzičasom nezmenil.

0.9.9

• Pridáva podpísanú spätnú zmenu stavu objednávky medzi stavmi Spracúva sa, Pozastavená a Dokončená.
• Callback odmietne nepovolený alebo medzičasom zmenený stav a následnú zmenu odošle späť do centrálneho prehľadu.

0.9.8

• Hodinový heartbeat udržiava v skFaktura.sk aktuálny stav pripojenia aj v e-shope bez nových objednávok.
• Centrálny prehľad spoľahlivo rozlíši aktívne, dlhšie neaktívne a chybové pripojenie.

0.9.7

• Časy objednávok sa prenášajú ako skutočné UTC okamihy, takže sa v skFaktura.sk neposúvajú o časové pásmo dvakrát.

0.9.6

• Registrácia e-shopu prijíma aj časové pásmo WordPressu vo formáte UTC offsetu, napríklad +02:00.
• Overenie spojenia rozlišuje neplatný API kľúč od chyby pri následnej registrácii e-shopu a zobrazí konkrétnu príčinu.

0.9.5

• Pripojený e-shop sa v skFaktura.sk zobrazí ihneď po úspešnom overení API spojenia.

0.9.4

• Synchronizácia WooCommerce objednávok do centrálnej sekcie E-shopy v skFaktura.sk.
• Bezpečné opakovanie synchronizácie po dočasnej chybe bez vytvárania duplicít.
• Prenos zákazníka, adries, položiek, súm, platieb, stavu vybavenia a prepojených dokladov.

0.9.3

• Pri firemnom odberateľovi prenáša meno a priezvisko z fakturačných údajov WooCommerce ako kontaktnú osobu.

0.9.2

• Automaticky opakuje vytvorenie dokladu po dočasnom výpadku API po 1, 5 a 15 minútach.
• Neopakuje požiadavky, ktoré zlyhali pre neplatné údaje alebo inú trvalú chybu HTTP 4xx.
• Zobrazuje čakajúce opakovanie alebo konečné zlyhanie priamo v stĺpci skFaktura v zozname objednávok.
• Zachováva ochranu pred duplicitnými dokladmi pomocou stabilnej externej referencie objednávky.

0.9.1

• Pridáva export produktov a variantov do CSV presne podľa štruktúry importu skFaktura.sk.
• Prenáša cenu, DPH, skladové údaje, EAN, kategóriu a značku bez volania API.
• Exportuje iba položky so SKU a funguje nezávisle od počtu, krajiny a meny e-shopov.

0.9.0

• Synchronizácia EAN/GTIN produktu do katalógu skFaktura.sk.
• Kompatibilita s rezervovaným a dostupným skladovým množstvom.

0.8.2

• Stops the hourly inventory task from sending every managed-stock product when nothing changed.
• Retries only products whose previous stock synchronization failed.
• Prevents duplicate stock requests for the same product and quantity within one WooCommerce process.
• Reduces API usage for stores with larger product catalogs.

0.8.1

• Adds bidirectional PRO inventory synchronization by SKU between skFaktura.sk and WooCommerce.
• Shares one central stock balance across multiple Slovak and Czech stores while preserving localized product names, prices and currencies.
• Adds signed stock callbacks, automatic hourly reconciliation and support for product variations.
• Updates publication metadata and restores compatibility with PHP 7.4.

0.7.4

• Adds reusable logo and stamp selection from the skFaktura.sk company image library without transferring image files for every order.
• Synchronizes current supplier details when creating a document while preserving the supplier snapshot in existing documents.
• Uses the exact outstanding document amount for automatic payments to handle one-cent VAT rounding differences.
• Improves the visual design and spacing of the plugin settings form.

0.7.3

• Transfers positive and negative WooCommerce fees to documents, including cash-on-delivery fees and order-total rounding adjustments.
• Preserves taxable fee VAT while treating fees created as non-taxable as 0% VAT.
• Adds configurable heading and introductory text above document buttons in customer e-mails.

0.7.2

• Adds product variation attributes and public order-item metadata to document line descriptions.
• Adds support for human-readable WooCommerce TM Extra Product Options values stored in _tmcartepo_data.
• Adds an opt-in setting for including the WooCommerce product short description on document lines; it is disabled by default.
• Preserves the original item descriptions when creating credit notes for refunds.

0.7.1

• Preserves the original VAT rates when WooCommerce refunds are entered only as an amount without selecting individual order items.
• Creates credit notes before WooCommerce builds full and partial refund emails, then adds the credit-note button to those customer emails.
• Adds the credit-note button to the standard admin cancelled-order email.
• Adds an HPOS-compatible skFaktura document column with clickable document icons to the WooCommerce orders list.

0.7.0

• Added quote and credit-note actions to order-status rules.
• Added idempotent credit notes for full and partial WooCommerce refunds.
• Added live button styling for customer e-mails, the order received page, and My Account.
• Added a Slovak repository description and usage guide.
• Clarified that the advance invoice must be marked paid in skFaktura.sk.

0.6.0

• Makes the optional follow-up e-mail after issuing a final invoice configurable and disabled by default.
• Ensures the optional follow-up e-mail uses UTF-8 compatible Slovak text.

0.5.9

• Shows automatic document rules only for payment methods currently enabled in WooCommerce.
• Adds the final invoice to the WooCommerce order and sends a follow-up customer e-mail after an advance invoice is settled.

0.5.8

• Added a document language setting (Slovak or Czech).
• Added an optional secure callback that changes a WooCommerce order to Processing when its advance invoice is marked paid in skFaktura.sk.

0.5.7

• Added support for the protected _billing_ic, _billing_dic, and _billing_dic_dph order fields used by WPify and other WooCommerce extensions.

0.5.6

• Removed the legacy universal payment-method rule; automatic document rules now apply only to active WooCommerce payment methods.
• Improved validation of saved document rules for active payment methods.

0.5.5

• Declared WooCommerce as the required WordPress plugin dependency.
• Updated internal class naming for WordPress.org compatibility.

0.5.3

• Improved Slovak document labels in customer-facing document buttons.

0.5.2

• Added an action that records the advance invoice payment and creates the settled final invoice.
• Grouped document actions in a clearer order.

0.5.1

• Prepared publication metadata and security checks for the WordPress Plugin Directory.
• Improved form input handling and output escaping.
• Updated the plugin folder and main file name to comply with WordPress naming requirements.

0.5.0

• Modernized the responsive plugin administration layout.
• Added publication files, license, and safe uninstall handling.