Billingo setup és API-key
API-key generálás, csatlakozás, document blokk és bank-számla
Billingo setup
A Billingo csatlakoztatása 5 perc, ha már van fiókod.
Előfeltételek
- Aktív Billingo-fiók (https://app.billingo.hu)
- API-key generálva
- Legalább 1 document blokk (számlatömb) a Billingo-ban
Lépés 1: API-key generálása
- Billingo-fiók → Beállítások → API kulcsok
- + Új API kulcs → név (pl. "Bookinda")
- Generálás → másold a kulcsot
A kulcs csak egyszer látszik. Mentsd biztonságos helyre.
Lépés 2: Csatlakozás Bookinda-felületen
- Bookinda → Connect → Billingo
- + Csatlakozás
- API-key beillesztés
- Kapcsolat-tesztelés → "Successful"
- Mentés → ACTIVE
A teszt-call ellenőrzi: API-key, organization-adat, document blokkok, bank-számlák.
Lépés 3: Document blokk
A számla-számozáshoz kötelező egy document blokk. A Billingo-ban létrehozott blokkok közül választasz.
Lépés 4: Bank-számla (opcionális)
Megjelenik a számlán: bank-név + számla-szám + IBAN.
Lépés 5: Auto-invoice toggle
ON: minden fully-PAID eladás után automatikusan számla. OFF: manuálisan generálsz az Eladások listán.
Ajánlott: ON.
Lépés 6: NAV Online Számla
Toggle a "Electronic Invoice (NAV)" mezőre. A NAV-szabály szerint 2021 óta kötelező.
További konfig
- Pénznem: HUF / EUR / USD (default HUF)
- Nyelv: HU / EN / DE (default HU)
- Fizetési-határidő: 0-90 nap (default 8)
- Áfa-kulcs: tenant-szintű (default 27%)
Disconnect
Connect → Billingo → Disconnect:
- Bookinda-Billingo kapcsolat megszűnik
- A meglévő számlák Billingo-ban maradnak
- Új API-key-vel reconnect bármikor
Mikor használd
Szcenárió 1, új salon Billingo-val Új Bookinda + új Billingo. 5 perc alatt csatlakozva.
Szcenárió 2, meglévő Billingo-felhasználó Cégadat már Billingo-ban. API-key generál. Bookinda-ban csatlakozik. Számlák a meglévő fiókba.
Szcenárió 3, kapcsolat-vita Számla nem érkezik. Csatlakozás-tesztelés → token revoked. Új API-key.
Tippek
- Az API-key generálás után azonnal mentsd, csak egyszer látszik.
- A document blokk kiválasztása kötelező, e nélkül nem megy ki számla.
- A NAV Online Számla flag bekapcsolva, jogi kötelezettség.
- A teszt-call sikeres válasz előtt ne mentsd.
- A reconnect új API-key-t igényel, ha a régit visszavontad.