A Számlázz.hu mellett Billingóval is működik a számlázás. A logika ugyanaz: a bizonylat a te Billingo-fiókodban jön létre, a számlakibocsátó te vagy, a NAV-adatszolgáltatást is a Billingo intézi. A Munkalapozó csak elküldi az adatokat.
A Billingónál az API használatához külön kiegészítő csomag kell („API + Tömeges számlagenerálás"), díjbekérőhöz és e-számlához pedig legalább Basic előfizetés. Ezt a Billingónál kell megrendelned — ha a kulcs jónak tűnik, de a próba mégis elutasítást hoz, jellemzően ez hiányzik.
Előbb tesztelni akarsz? Hozz létre teszt profilt
A Billingónak nincs olyan „tesztüzem" kapcsolója, mint a Számlázz.hu-nak: az éles fiókban kiállított számla valódi számla. Van viszont külön teszt profil, és bekötés előtt érdemes azzal próbálni.
- A Billingóban kattints a profilválasztóra a neved mellett.
- Válaszd az Új vállalkozás létrehozása lehetőséget.
- Kapcsold be a Teszt profil (Fejlesztői teszt profil) üzemmódot.
- Töltsd ki az adatokat, és kattints a Létrehozás gombra.
- A teszt profilban kiállított bizonylatokra TESZT felirat kerül.
- A teszt profilt később nem lehet élessé alakítani — csak tesztelésre való.
- A partnereket és a termékeket külön fel kell vinni benne.
- Az API-kulcs a kiválasztott profilhoz tartozik: ha teszt profillal dolgozol, ott generálj kulcsot.
1. Nyisd meg az API kulcsok lapot
A Billingóban kattints a fejlécben a fogaskerékre, majd a bal oldali listában: Integrációk → API kulcsok. Jobb felül ott az Új API kulcs gomb.
2. Generálj kulcsot — V3, „olvasás, írás"
Az űrlapon két dolgot kell eltalálni:
- API verzió: V3. A Munkalapozó a Billingo v3 API-jával dolgozik — a V2-es kulccsal nem fog működni.
- API hatásköre: „Olvasás, írás". Csak olvasással a próba még lefut, de számlát kiállítani nem tudunk.
Az API neve bármi lehet — ez látszik majd a Billingóban annál, amit az API csinál. Írd be például, hogy „Munkalapozó". A Hozzátartozó összekötés mezőt hagyd üresen.
Mentés után a kulcs bekerül a listába. Magát a kulcsot a Billingo nem írja ki a táblázatban — az Api oszlopban lévő másolás ikonnal teszed a vágólapra.
Ha teszt profilban dolgozol, a Billingo egy piros sávval figyelmeztet a lap tetején, hogy csak teszt számlák készülnek. Ez a te jelzésed arról, hogy még nem élesben számlázol.
3. Illeszd be a Munkalapozóba, és teszteld
- A Munkalapozóban: Személyre szabás → Számlázás.
- Válaszd a Billingo szolgáltatót.
- Illeszd be a kulcsot a Billingo API-kulcs mezőbe.
- Kattints a Kapcsolat tesztelése gombra.
A próba nem állít ki bizonylatot: csak lekéri a fiókod számlatömbjeit. A válaszban meg is jelennek, azonosítóval együtt.
4. Válaszd ki a számlatömböt
A Billingónál a bizonylat mindig egy számlatömbbe kerül, ezért a kulcs mellé a számlatömb azonosítója is kell. A próba után a listában kattints arra a tömbre, amelyikkel számlázni szeretnél — az azonosító magától bekerül a mezőbe. Ha csak egy tömböd van, ki sem kell választanod, kitöltjük.
Rossz számlatömb esetén a számlák egy másik sorszám-tartományba kerülnek, mint amit a könyvelésed vár. Ha bizonytalan vagy, a Billingóban nézd meg a tömb nevét és előtagját — a listában mindkettő ott van.
5. Mentés
Kattints a Beállítások mentése gombra. Itt is előbb a próba, utána a mentés: új kulcs csak sikeres kapcsolat után menthető el, így egy elgépelt kulcs nem tud bekerülni a rendszerbe úgy, hogy csak az első számlázásnál derülne ki a hiba.
A kulcsot titkosítva tároljuk, és a felületen soha többé nem jelenik meg. A mezőt üresen hagyva a mentett kulcs érintetlen marad — cserélni új érték beírásával, törölni a mellette lévő jelölővel tudsz.
Amiben a Billingo más, mint a Számlázz.hu
- A vevő külön adat a Billingóban: első számlázáskor létrehozzuk partnerként, utána az azonosítóját újrahasznosítjuk, hogy ne szemeteljük tele a fiókodat.
- A PDF nem azonnal készül el: a Billingo pár másodpercig dolgozik rajta, ezért a letöltés néha egy pillanatot vár.
- Időtúllépés után a Billingónál nem tudunk automatikusan visszakérdezni, hogy elkészült-e a bizonylat. Ilyenkor a Munkalapozó „Ellenőrzendő" állapotba teszi, és megkér, hogy nézd meg a Billingo felületén — új számlát addig nem enged kiállítani, nehogy dupla számla készüljön.
Biztonság
- A kulcs jelszó értékű: aki ismeri, számlát tud kiállítani a nevedben. Ne küldd el e-mailben, és ne oszd meg senkivel.
- Ha kiszivárgott: a Billingóban töröld a kulcsot, generálj újat, és mentsd el a Munkalapozóban is.
- Ha másik rendszered is használ Billingo-kulcsot, a Munkalapozónak generálj külön kulcsot.