A Billingo integráció lehetővé teszi, hogy a Billingóban kiállított vevői bevételszámláid automatikusan megjelenjenek a QUiCK rendszerében. Az összekötés elvégzése után nincs szükség manuális adatrögzítésre: a rendszer a háttérben, rendszeres időközönként letölti az új számlákat. A számlákhoz tartozó fizetési státusz és – némi késéssel – a számlaképe is automatikusan szinkronizálódik.
Cél és kontextus
A Billingo integráció célja, hogy a Billingót használó vállalkozások bevétel számlái automatikusan megjelenjenek a QUiCK-ben, anélkül, hogy azokat kézzel kellene rögzíteni. A kapcsolat egyszer kerül beállításra, utána a QUiCK a háttérben, rendszeres időközönként lekéri a Billingóban kiállított legújabb számlákat.
Az integráció kizárólag kimenő (vevő) számlákra vonatkozik – azaz csak azokra, amelyeket te állítottál ki Billingóban a saját vevőidnek. Szállító (bejövő) számlák importálása ezzel az integrációval nem lehetséges.
Az eredmény: a Billingóban kiállított számlák megjelennek a QUiCK bevételei között, a fizetettségi státuszuk is követhető a QUiCK-ben.
Hol található?
A Billingo integráció a Cégbeállítások → Integrációk szekcióban érhető el. A beállítást csak a QUiCK-fiók tulajdonosa, vagy arra jogosult adminisztrátora végezheti el.
Előfeltételek
A cég QUiCK fiókja aktív előfizetéssel rendelkezik. Aktív a Billingo fiók, amelyhez API-hozzáférést tartalmazó csomag tartozik. Fiók-tulajdonosi szintű hozzáférés a Billingo fiókhoz az API-kulcsok generálásához. Fontos: a Billingo integráció nem aktiválható, ha a QUiCK-fiókban már aktív NAV Online Számla integráció van.
A működés (pontosan, lépésről lépésre)
A folyamat két részből áll: az egyszer elvégzendő összekötésből, és az azt követő, teljesen automatikus szinkronból.
1. Az összekötés beállítása (egyszeri lépések)
Lépj be a Billingo fiókodba, és navigálj az Összekötések menüpontba! Keresd meg a QUiCK kiegészítőt a listában, és nyisd meg az adatlapját! Az Összekötés fülön adj meg egy nevet az API-kulcsnak, majd kattints a Mentés gombra – Billingo automatikusan legenerálja a szükséges kulcsokat! A nyilvános kulcs a listában látható lesz. A privát kulcsot a pajzs ikonra kattintva, a felugró ablakból tudod kimásolni. Lépj vissza a QUiCK fiókodba: Cégbeállítások → Integrációk → Billingo! Illeszd be a nyilvános és a privát kulcsot a megfelelő mezőkbe, majd kattints a Mentés gombra! Az összekötés ezzel aktív. A rendszer rögzíti az összekötés dátumát – ettől a naptól fogva szinkronizálja a számlákat.
2. Automatikus szinkron (folyamatos, háttérben)
Az összekötés beállítása után a QUiCK automatikusan és rendszeresen lekéri a Billingóból az új és módosított számlákat. Ebben nincs teendőd – a folyamat a háttérben zajlik:
A rendszer 10–15 percenként ellenőrzi, keletkeztek-e új számlák, vagy került rögzítésre hozzájuk kifizetés a Billingóban. Csak az összekötés dátumától fogva kiállított számlák kerülnek szinkronizálásra; korábbi számlák nem jönnek be automatikusan, de az ügyfélszolgálat segítségével korábbi dátum is beállítható. A rendszer szűri a számlatípusokat: normál számla, előleg számla, végszámla, helyesbítő számla és sztornó számla is bekerülhet a szinkronizált adatok közé. Minden letöltött számla esetén a rendszer ellenőrzi, hogy az adott számla már szerepel-e a QUiCK-ben – ha igen, nem jön létre duplikált rekord. Ha egy korábban már szinkronizált számla módosult a Billingóban, az új verzió kerül feldolgozásra. A számla adataiból a rendszer rögzíti: a számlaszámot, a teljesítési és kiállítási dátumot, a vevő nevét és adatait (cím, adószám), a tételeket, összegeket (nettó, bruttó, ÁFA), a fizetési módot és a fizetettségi státuszt. A fizetési módot a rendszer automatikusan a QUiCK belső kategóriáira fordítja le: „átutalás", „előre utalás" → Átutalás „bankkártya", „PayPal", „Barion", „OTP Simple", „online bankkártya", „Szép kártya" és más online fizetési módok → Bankkártya „készpénz", „postai csekk", „kompenzáció", „barter" és hasonlók → Készpénz „utánvét", „pick pack pont" → Utánvétel A számla PDF-képének letöltése külön háttérfolyamatban történik – ez némi késéssel, de szintén automatikusan megtörténik, és a számlához csatolódik a QUiCK-ben. Mikor hasznos és kinek?
A Billingo integráció azoknak a vállalkozóknak és cégeknek hasznos, akik:
Billingóban állítják ki a vevő számláikat és ezeket nem szeretnék kézzel is rögzíteni a QUiCK-ben, egy helyen szeretnék látni a bevétel számláikat, azok fizetettségi állapotát és a pénzforgalmi hatásukat, automatizálni szeretnék a számlaadat-rögzítést a könyvelés-előkészítés, vagy a likviditástervezés érdekében. Az integráció nem helyettesíti a bejövő (szállító) számlák kezelését – azok rögzítéséhez más megoldás szükséges (pl. manuális feltöltés, e-mailes beküldés, böngésző bővítmény, vagy NAV Online Számla integráció).
Specialitások és limitációk
Csak a bevételszámlák szinkronizálódnak: A Billingo integráción keresztül kizárólag azok a számlák érkeznek be a QUiCK-be, amelyeket te állítottál ki Billingóban. Bejövő, szállító számlák ezzel az integrációval nem importálhatók. Az összekötés dátuma előtti számlák nem kerülnek be automatikusan: A QUiCK csak az összekötés létrehozásának napjától kezdve szinkronizálja a számlákat; korábbi, Billingóban kiállított számlák automatikusan nem töltődnek vissza. Hitelesítési hiba esetén az integráció automatikusan felfüggesztődik: Ha az API-kulcsok érvénytelenek lesznek (pl. törölték őket Billingóban), a QUiCK leállítja a szinkronizálást. Ilyen esetben a kapcsolatot manuálisan kell újra helyreállítani az új kulcsok beillesztésével a Cégbeállításokban. A szinkron nem valós idejű: Az adatok legkorábban 10–15 perccel a Billingóban elvégzett művelet után jelennek meg a QUiCK-ben. A PDF-kép letöltése késéssel érkezik: A számla alapadatai (összeg, partner, státusz) a szinkronnal együtt jelennek meg, a PDF-kép azonban egy külön háttérfolyamatban, némi késéssel töltődik le és csatolódik a számlához. Nem aktiválható NAV Online Számla integráció mellett: Ha a QUiCK-fiókban aktív NAV Online Számla integráció van, a Billingo integráció nem engedélyezhető, de fordítva igen. Átmeneti API-túlterhelés esetén a rendszer automatikusan megvárja a következő szinkron-kört, és nem vesznek el adatok. API-hozzáférést tartalmazó Billingo csomag szükséges: Nem minden Billingo előfizetés tartalmaz API-hozzáférést; az integráció enélkül nem működtethető.