Dokumentáció / Woo Billingo Plus / Frissítés a 3.0-ás verzióra

Frissítés a 3.0-ás verzióra

A Billingo nemrég módosította az API-ját, ami ahhoz kell, hogy a webáruházad össze tudd kötni a Billingo rendszerével. Az új API-hoz egy új kulcsot kell generálnod és néhány beállítás is módosult. Ha korábban már használtad a bővítményem előző verzióját, akkor egy új API kulcsot kell generálnod és néhány beállítást is át kell nézned:

Új API kulcs készítése

Lépj be a Billingo oldalán az API / API V3 menüpontba. Kattints az új kulcs létrehozása gombra, adj meg egy nevet(bármi lehet) és válaszd ki, hogy a hatáskör „Olvasás, írás” legyen.

A generált API kulcsot kell kimásolnod és megadnod a WooCommerce / Beállítások / Integráció / Woo Billingo Plus menüpontban, itt:

Ha a több fiók opciót is használod, ne felejtsd el, hogy ott is le kell cserélned a régi publikus/privát kulcsot az új API kulcsra.

Bankszámlaszám és számlatömb kiválasztása

Az új API-val módosult a számlatömb azonosítód is, így azt újra ki kell választanod a listából. Kattints a frissítés gombra, ha esetleg nem látnád a számlatömbödet. Másik módosítás, hogy a bankszámlaszámodat is ki kell választanod. Itt is kattints a frissítés gombra, ha esetleg nem látnád az elérhető opciókat. Ha nem látszik egy sem, akkor a Billingo beállításaiban ellenőrizd, hogy létrehoztál e már egy bankszámlaszámot.

Mennyiségi egység

Az új API kapcsolaton keresztül készült számláknál kötelező megadni mennyiségi egységet a termékeknél. Ha korábban ez nem volt megadva, akkor automatikusan a „db” lesz a mennyiségi egység. A beállításokban ezt természetesen módosíthatod, illetve termék szinten is felülírhatod, ha szükséges.

Fizetési módok összepárosítása

Az új API-val együtt módosultak a Billingo-n elérhető fizetési módok azonosítói is. A frissítés után ezt a bővítményem megpróbálja automatikusan összehangolni, de azért érdemes ellenőrizni, hogy minden megfelelő e. Ezeket a beállításokat az Automatizálás szekcióban találod:

Működésbeli változások

A bővítményem rendelkezik egy olyan opcióval, hogy a generált PDF számlákat és dokumentumokat letölti a saját tárhelyedre is, így tudod csatolni a WooCommerce levelekhez is, illetve csoportosan tudod nyomtatni és letölteni őket a rendeléskezelőben. A régi API-val a PDF fájlok a számlakészítéssel együtt készültek el. A V3-as API-val viszont a fájlt csak pár másodperccel később lehet letölteni. Ez két dologban jelent változást:

  1. Manuális számlakészítéskor
    Ha manuálisan készítesz számlákat, akkor egy olyan üzenetet fogsz látni a számlakészítés után, hogy „A PDF letöltése folyamatban van”. Amint a PDF fájl is le lett töltve, automatikusan eltűnik az üzenet és a számlára kattintva már a PDF fájlhoz visz. Nem kell megvárni, amíg ez megtörténik, nyugodtan bezárhatod az oldalt, a háttérben történik minden. Amíg a fájl készül, addig a Billingo weboldalára visz a letöltési link.
    image-2
  2. PDF fájlok csatolása a WooCommerce e-mailekhez
    Ha automata számlakészítést használsz és a számlákat csatolni szeretnéd a WooCommerce e-mailekhez is, akkor a kiküldendő e-mailek automatikusan késleltetve lesznek addig, amíg a számla PDF fájlt le nem töltötte a rendszer a háttérben. Amint megvan a PDF fájl, elküldi az e-mailt. Ez a gyakorlatban annyit jelent, hogy például a rendelés lezárásakor a vásárló 5-10 másodperccel később fogja megkapni a visszaigazoló e-mailt.

Ez nagyon bonyolultnak hangzik, használhatom tovább a régi verziót?

Nem bonyolult annyira 🙂 De igen, használhatod továbbra is a meglévő verziót, illetve a wordpress.org-ről letöltheted a korábbi verziókat bármikor innen. Érdemes lesz viszont frissítened előbb-utóbb, mert az új funkciók már csak az új API-val lesznek elérhetők(például előlegszámla készítése, vagy a banki adatkapcsolat).