=== Woo Billingo Plus === Contributors: passatgt Tags: billingo, woocommerce, szamlazo, magyar Requires at least: 5.1 Tested up to: 5.4 Stable tag: 2.2.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Nem hivatalos Billingo integráció WooCommerce-hez. == Description == > **PRO verzió** > A bővítménynek elérhető a PRO verziója 10.000 Ft-ért, amelyet itt vásárolhatsz meg: [https://szamlazz.visztpeter.me/billingo](https://szamlazz.visztpeter.me/billingo) > A licensz kulcs egy weboldalon aktiválható és 1 év emailes support is jár hozzá beállításhoz, testreszabáshoz, konfiguráláshoz. > A vásárlással támogathatod a fejlesztést akkor is, ha esetleg a PRO verzióban elérhető funkciókra nincs is szükséged. = Funkciók = * **Manuális számlakészítés** Minden rendelésnél a jobb oldalon megjelenik egy új gomb, rákattintáskor elküldi az adatokat a Billingonak és legenerálja a számlát. * **Automata számlakészítés** _PRO_ Lehetőség van a számlát automatikusan elkészíteni a rendelés státusza alapján * **Mennyiségi egység** A tételek mellett a mennyiségi egységet is feltüntetni a számlát, amelyet a beállításokban minden termékhez külön-külön meg tudod adni és megjegyzést is tudsz megadni a tételhez * **Számlaértesítő** _PRO_ Az ingyenes verzióban a Billingo küldi ki a számlaértesítőt a vásárlónak. A PRO verzióban be lehet linkelni a számlát a WooCommerce által küldött emailekbe, így nem fontos használni a Billingo számlaértesítőjét. Működik a WooCommerce Subscriptions bővítménnyel is. * **Nemzetközi számla** Ha külföldre értékesítesz például euróban, lehetőség van a számla nyelv átállítására és külön-külön beállíthatod minden pénznemhez a számlán lévő kerekítési módot. Kompatibilis WPML-el és Polylang-al is. * **Automata díjbekérő létrehozás** _PRO_ Ha a rendelés állapota átállítódik függőben lévőre, automatán legenerálja a díjbekérő számlát. Lehet kézzel egy-egy rendeléshez külön díjbekérőt is csinálni. * **Naplózás** Minden számlakészítésnél létrehoz egy megjegyzést a rendeléshoz, hogy mikor, milyen néven készült el a számla * **Sztornózás** A számla sztornózható a rendelés oldalon és a számlakészítés kikapcsolható 1-1 rendeléshez * **Adószám mező** A WooCommerce-ben alapértelmezetten nincs adószám mező. Ezzel az opcióval bekapcsolható, hogy a számlázási adatok között megjelenjen. Az adószámot a rendszer eltárolja, a vásárlónak küldött emailben és a rendelés adatai között is megjelenik. Lehetőség van arra, hogy csak 100.000 Ft áfatartalom felett látszódjon. * **Automata teljesítettnek jelölés** Beállítható, melyik fizetési módoknál jelölje meg a számlát teljesítettnek automatikusan * **És még sok más** Papír és elektronikus számla állítás, áfakulcs állítás, egyedi számla megjegyzések megadása, automata sztornózás(_PRO_), letölthető számlák a vásárló profiljában, hibás számlakészítésről e-mailes értesítő, kupon megjelenítése külön téteélként, stb... = Fontos kiemelni = * Ha korábban használtad a hivatalos bővítményt, migrálhatod a beállításokat és a korábban készült számlákat az új bővítménybe * Fizetési határidő és megjegyzés írható a számlákhoz * Kuponokkal is működik, a számlán negatív tételként vagy alapból csökkentett tétel árakkal fog megjelenni * Szállítást és egyéb díjakat is ráírja a számlára * A számlák elérhetők egyből a Rendelések oldalról is(táblázat utolsó oszlopa) = Használat = Részletes dokumentációt [itt](https://szamlazz.visztpeter.me/billingo-dokumentacio/) találsz. Telepítés után a WooCommerce / Beállítások oldalon meg kell adni a Billingo API beállításaiban lévő publikus és privát kulcsokat. Ha jók a kulcsok, megjelennek a számlakészítéssel kapcsolatos egyéb beállítások. A fizetési módokat és a számlatömböt kötelező kitölteni. Minden rendelésnél jobb oldalon megjelenik egy új doboz, ahol egy gombnyomással létre lehet hozni a számlát. Az Opciók gombbal felül lehet írni a beállításokban megadott értékeket 1-1 számlához. Ha az automata számlakészítés be van kapcsolva, akkor a rendelés lezárásakor(beállításokban megadható, hogy melyik rendelés státusznál) automatikusan létrehozza a számlát a rendszer. A számlakészítés kikapcsolható 1-1 rendelésnél az Opciók legördülőn belül. Az elkészült számla a rendelés aloldalán és a rendelés listában az utolsó oszlopban található PDF ikonra kattintva megnyitható. **FONTOS:** Mindenen esetben ellenőrizd le, hogy a számlakészítés megfelelő e és konzultálj a könyvelőddel, neki is megfelelnek e a generált számlák. Sajnos minden esetet nem tudok tesztelni, különböző áfakulcsok, termékvariációk, kuponok stb..., így mindenképp teszteld le éles használat előtt és ha valami gond van, jelezd felém és megpróbálom javítani. = Fejlesztőknek = A Billingo-nak küldött adatokat a számlakészítés előtt módosíthatod a következő filterekkel: `wc_billingo_plus_client`, `wc_billingo_plus_invoice`, `wc_billingo_plus_complete`. Az első paraméter a Billingonak küldött adat, a második pedig a rendelés($order). Minden esetben az éppen aktív téma functions.php fájlban történjen, hogy az esetleges plugin frissítés ne törölje ki a módosításokat! A bővítmény naplózza a számlakészítés során előforduló hibákat. Ha a fejlesztői mód be van kapcsolva, akkor Billingo felé küldött adatokat naplózni fogja. Mindkét napló elérhető a WooCommerce / Állapot / Naplók menüpontban(válaszd ki a 'wc_billingo_plus' kezdetű logfájlt). Lehetőség van sikeres és sikertelen számlakészítés után egyedi funckiók meghívására a bővítmény módosítása nélkül: = GDPR = A bővítmény HTTP hívásokkal kommunikál a Billingo [API rendszerével](https://billingo.readthedocs.io/). Az API hívások akkor futnak le, ha számla készül(pl rendelés létrehozásánál automatikus számlázás esetén, vagy manuális számlakészítéskor a Számlakészítés gombra nyomva). A Billingo egy külső szolgáltatás, saját [adatvédelmi nyilatkozattal](https://www.billingo.hu/adatkezelesi-tajekoztato) és [felhasználási feltételekkel](https://www.billingo.hu/felhasznalasi-feltetelek). This extension relies on making HTTP requests to the Billingo [API](https://billingo.readthedocs.io). API calls are made when an invoice is generated(for example on order creation in case of automatic invoicing, or when you press the create invoice button manually). Billingo is an external service and has it's own [Terms of Service](https://www.billingo.hu/felhasznalasi-feltetelek) and [Privacy Policy](https://www.billingo.hu/adatkezelesi-tajekoztato), which you can review at those links. == Installation == 1. Töltsd le a bővítményt 2. Wordpress-ben bővítmények / új hozzáadása menüben fel kell tölteni 3. WooCommerce / Integráció menüpontban találhatod a beállítások, itt legalább az authentikációs kulcsokat és a számlatömb azonosítót meg kell adni 4. Ha minden jól megy, működik == Frequently Asked Questions == = Mi a különbség a PRO verzió és az ingyenes között? = A PRO verzió néhány hasznos funckiót tud, amiről [itt](https://szamlazz.visztpeter.me/billingo) olvashatsz. De a legfontosabb az automata számlakészítés(díjbekérő és sztornó is). Továbbá 1 éves emailes support is jár hozzá. = Hogyan lehet tesztelni a számlakészítést? = A Billingo beállításaiban kapcsold be a Sandbox módot. Ilyenkor teszt számlákat fog létrehozni a rendszer. Fontos megjegyezni, hogy csak papíralapú számlát lehet készíteni Sandbox üzemmódban. = Valamiért nem megy a számlakészítés, mit csináljak? = Első körben nézd meg az Eszközök / Webhely egészség menüpontban, van e valami hibaüzenet a Billingo Plus bővítménnyel kapcsolatban. Ha manuális számlakészítéskor a hibaüzenetből nem derül ki, mi a gond, akkor nézd meg a WooCommerce / Állapot / Naplók menüpontban lévő hibanaplóban a teljes üzenetet. Ha ez sem segít, nyugodtan lépj kapcsolatba velem. == Screenshots == 1. Beállítások képernyő(WooCommerce / Beállítások / Integráció) 2. Számlakészítés doboz a rendelés oldalon == Changelog == = 2.2.2 = * Hibajavítás számla e-mail csatoláshoz = 2.2.1 = * Hibajavítás a 2.2-es verzióhoz = 2.2 = * Kikapcsolható az automata számlakészítés bizonyos fizetési módoknál * A megjegyzésnél az agent kulcs is kiválasztható feltételként * A tétel megjegyzésben nem szerepel az "Utánrendelve" leírás * A `wc_billingo_plus_settings_fields` filterrel lehet hozzáadni egyedi beállításokat * A számlakészítő doboz testreszabható a `wc_billingo_plus_metabox_generate_before`, `wc_billingo_plus_metabox_generate_after`, `wc_billingo_plus_metabox_generate_options_before` és `wc_billingo_plus_metabox_generate_options_after` action-ökkel * PRO verzióban kikapcsolható az automata számlakészítés(egy hiba miatt mindig ment teljesített státusszal) * Ha a cégnév N/A, akkor a nevet tünteti fel a számlán * Manuális számlakészítéskor kiválaszható a számla típusa(papír vagy elektronikus) * Kompatibilitás megjelölése legújabb WordPress-el = 2.1 = * Fontos változások az adószám mezővel kapcsolatban: 2020. július 1-től minden adatszolgáltatási kötelezettségben érintett(ha ad meg a vásárló cégnevet) számlán szerepeltetni kell az adószámot. A bővítmény úgy módosult, hogy az adószám mező csak akkor látszik, ha a vásárló ad meg cégnevet és Magyarország a számlázási ország. Ilyenkor kötelező kitölteni az adószám mezőt. Egyéb esetben az adószám mező nem látszik. = 2.0.3 = * Kompatibilitás megjelölése WooCommerce 4.0-val = 2.0.2 = * Manuális piszkozat készítés javítása = 2.0.1 = * Szövegek javítása a beállítások oldalon = 2.0 = * Új funkció: a számlához több megjegyzés is beállítható különböző feltételekhez szabva(fizetési mód, szállítási mód, céges rendelés, számla nyelve stb...) * Új funkció: beállítható több billingo fiók is, ha több fiókból számlázol(és fizetési, szállítási és egyéb alapján automatizálható, a `wc_billingo_plus_account_conditions` és `wc_billingo_plus_account_conditions_values` filterekkel pedig létrehozhatók egyedi feltételek is) * Új funckió: beállítható egy vagy több e-mail cím, amire csatolmányként továbbítja az elkészült PDF dokumentumokat(használható például nyomtatás vagy cloud tárhely automatizálásra) * Új funkció: a WooCommerce Webhookok között beállítható a számlakészítés is * Új funkció: gyűjtőszámla létrehozása: kijelölhetsz egyszerre több rendelést, összegyűjti az összes tételt és egy darab számlát készít belőlük * Új funkció: csoportos műveleteknél van lehetőség számlát és sztornó számlát készíteni * Fejlesztés: a szállítási módok beállításaiban is megadható egyedi számla tétel elnevezés * Fejlesztés: több státusz is kiválasztható automata számlakészítéshez és sztornózáshoz * Fejlesztés: Az adószámot eltárolja a felhasználó fiókjában(ha be volt lépve vásárlás közben, vagy éppen fiókot hoz létre) * Fejlesztés: manuális számlakészítéskor kiválasztható a számla nyelve * Fejlesztés: a Rendelések táblázatban egy új oszlopban jelennek meg a számlák(kikapcsolható) * Fejlesztés: év/hó mappákban tárolja a PDF fájlokat * Fejlesztés: beállítható, hogy az adószám mező hol jelenjen meg a pénztár oldalon * Fejlesztés: figyelmeztet, ha nincs áfakulcs beállítva a webshopban * Fejlesztés: új design a beállítások oldalon, hogy átláthatóbbak legyenek az opciók * Fejlesztés: apróbb design módosítások a számlakészítő dobozban a rendelés oldalon * Fejlesztés: a 2. címsort is feltüntetni a számlán * Hibajavítás: nem dob figyelmeztetést, ha ingyenes a szállítás az áfakulcs számolása közben * Hibajavítás: nem dob hibát, ha egy nem létező emailhez próbálja csatolni a számlát * Hibajavítás: alapértelmezett fizetési határidő érték javítása * Hibajavítás: PHP warning javítása admin üzenetek megjelenítésekor(hibás számlakészítéskor) * Hibajavítás: megadható 0 napos fizetési határidő is * Hibajavítás: nem mutat letöltési ikont a rendeléskezelőben, ha ki lett kapcsolva a számlakészítés az adott rendelésnél * Hibajavítás: ha a PDF letöltés be van kapcsolva, akkor a sztornó számlát is letölti * Fejlesztőknek: a WooCommerce rendelés REST API válaszában szerepelnek a számlák is * Fejlesztőknek: a wc_billingo_plus_invoice_line_item filterrel módosítható a számlán megjelenő tétel * Fejlesztőknek: a `wc_billingo_plus_should_generate_auto_invoice` filterrel kikapcsolható az automata számlakészítés bizonyos rendeléseknél(pl egyedi feltételekhez kötve) * Fejlesztőknek: a dokumentumok neve könnyen átírható(pl angolra) a `wc_billingo_plus_document_types` filterrel * Kompatibilitás megjelölése legújabb WP és WC verziókkal = 1.1.7.1 = * Egyedi tétel elnevezésénél előforduló hiba javítása = 1.1.7 = * Piszkozat készítési lehetőség * A megjegyzésben a tranzakció azonosító feltüntethető a {transaction_id} kóddal = 1.1.6.2 = * Hibajavítás számlatömbökkel kapcsolatban = 1.1.6.1 = * Hibajavítás az előző verzióhoz és 5.2.4-es WP kompatibilitás megjelölése = 1.1.6 = * A WooCommerce-ben a "Árak adóval kerülnek felvitelre?" beállítás szerint vagy a nettó, vagy a bruttó árat küldi át a számlakészítéshez. Ha bruttó árakat használsz, akkor így a bruttó végösszeg mindig kerek lesz. * WC 3.7.1 kompatibiliás megjelölés = 1.1.5 = * Ingyenes rendelésnél nem készít számlát(opcionálisan bekapcsolható) = 1.1.4 = * A számla megjegyzésben feltüntethető a rendelés száma az {order_number} kóddal. * Manuális számlakészítéskor a megjegyzésben megmarad a sortörés * Számlakészítés a háttérben funkció optimalizálása = 1.1.3 = * Kompatibilitás egyedi emailt létrehozós bővítményekkel = 1.1.2 = * Manuális teljesítettnek jelölés javítása * E-mailbe nem rak olyan számlákat, amik még nem készültek el = 1.1.1 = * Ha háttérben készülnek a számlák, a felső sávon mutatni fogja, hogy épp generálja a számlákat és jelzi, ha kész vannak = 1.1 = * Csoportos számla letöltés és nyomtatás: a rendeléseket kijelölve a csoportos műveletek legördülőben van ez a két opció * Számlaértesítő ki(nem)küldés hibajavítása * 0 Ft-os rendelésnél is működik a számlakészítés * Hibajavítás háttérben készülő számlák esetében(duplikálás elkerülésére) = 1.0.3 = * Régi Billingo adatok szinkronizálásának hibajavítása * WooCommerce Order Status Manager kompatibilitás = 1.0.2 = * Kuponkezeléssel kapcsolatos hibajavítás = 1.0.1 = * WC CRUD funkciók használata adatok mentésére/betöltésére * Szállítás adókulcs bugfix * HuCommerce és EU VAT Assistant kompatibilitás(adószám megjelenítés számlán) = 1.0 = * WordPress.org-ra feltöltött plugin első verziója