Kilépés

Billingo integráció

Mit kapsz ezzel a kapcsolattal?

Ha összekapcsolod a Flow-t a Billingo fiókoddal, a kiállított  vagy éppen befogadott számláid  valamint a nyugtáid automatikusan megjelennek a Flow pénzügyi kimutatásaiban.

Nem kell kézzel rögzíteni semmit — az adatok naponta, automatikusan frissülnek.

MIELŐTT ELKEZDED

✔ Aktív Billingo fiók (ellenőrizd, hogy az előfizetésed tartalmazza-e az API hozzáférést)
✔ Hozzáférés a Billingo fiók beállításaihoz (fiókgazda vagy megfelelő jogosultságú felhasználó)
✔ Aktív Flow előfizetés integrációs hozzáféréssel

A BEÁLLÍTÁS LÉPÉSEI

1. lépés – API kulcs generálása a Billingo-ban

Nyisd meg a Billingo fiókod, és navigálj ide:
Beállítások → API kezelés

Az API kezelés oldalon kattints az „Új API kulcs létrehozása” gombra.

A megjelenő ablakban add meg a következőket:

  • Név: írj be valami egyértelmű nevet, pl. „Silvermoon FLOW”
    (ez csak azonosításra való, bármi megfelel)
  • Hatáskör: válaszd az „Olvasás” lehetőséget
    (nem kell több jog — a Flow csak lekérdez, nem módosít)
  • Verzió: V3

Kattints a „Mentés” gombra. A rendszer megmutatja az API kulcsot.

! Fontos: az API kulcsot csak egyszer látod teljes egészében. Másold ki most, és tedd el biztonságos helyre — a Flow felületén is erre lesz szükséged a következő lépésben.

2. lépés — A kulcs megadása a Flow-ban

Nyisd meg a Flow-t, majd navigálj ide:
Karbantartás → Céges adatok (itt a link, hogy könnyebb legyen) → Integrációk → Új kapcsolat hozzáadása

A Rendszer legördülőből válaszd a Billingo lehetőséget.

Az megjelenő mezőbe illeszd be az előző lépésben kimásolt API kulcsot, majd kattints a „Kapcsolat mentése” gombra.

A Flow automatikusan ellenőrzi a kulcsot. Ha minden rendben, a kapcsolat „Aktív” státuszra vált, és az első szinkronizálás elindul a háttérben.

3. lépés — Az adatok megjelenése

Az első szinkronizálás során a Flow az összes érvényes számlát lekéri a Billingo fiókodból. Ez a számlavolumenen múlóan néhány perctől akár 15-20 percig is tarthat, ha sok régi számla van.

Ezután a rendszer naponta automatikusan frissít. Ha azonnali frissítésre van szükséged, az Integrációk oldalon a kapcsolat mellett található „Szinkronizálás most” gombbal bármikor elindíthatod manuálisan.

Mi érkezik át, és mi nem?

Ami átjön:
✔ Kimenő számlák (normál, előlegszámla, végszámla, sztornó)
✔ Fizetési státusz (rendezett / lejárt / nyitott)
✔ Devizás számlák 
✔ Bejövő számlák (ha megkapod a Billingon keresztül)

Ami nem jön át:
✗ Számlaképek, PDF-ek — csak az adatok érkeznek, dokumentumhoz a Billingot kell megnyitni

HA VALAMI NEM MŰKÖDIK

Az adatok nem jelennek meg, vagy a kapcsolat „Hibás” státuszban van?

A leggyakoribb okok:

1. Az API kulcs elgépelve vagy nem teljes
→ Bontsd a kapcsolatot, generálj új kulcsot a Billingóban, és add meg újra a Flow-ban.

2. Az API kulcshoz nem „Olvasás” hatáskör lett beállítva
→ Töröld a meglévő kulcsot a Billingóban, hozz létre újat V3 / Olvasás beállítással.

3. A Billingo fiókban nem te vagy a fiókgazda, és korlátozott a hozzáférésed
→ Kérd meg a fiókgazdát, hogy ő generálja a kulcsot, vagy adjon megfelelő jogosultságot.

4. A Flow előfizetésedben nem jól adtad meg az integrációs hozzáférést
→ Ellenőrizd az aktívan használt Billingo beállításokat, hogy pontosan egyezik-e azzal, amit a Billingo fiókban kaptál.

Ha a fentiek egyike sem oldja meg, keress minket a Flow ügyfélszolgálatán — a hibanapló alapján pontosan meg tudjuk mondani, mi történt.

BIZTONSÁG

A Flow és a Billingo közötti kapcsolat API kulcson alapul. Ez azt jelenti:

• A kulcs kizárólag a te Billingo fiókodhoz ad hozzáférést — más fiókba nem enged belépni.
• A kulcshoz csak „Olvasás” hatáskört állítottunk be — a Flow nem tud számlákat kiállítani, módosítani vagy törölni a nevedben.
• A Flow felületén a kulcs soha nem jelenik meg teljes egészében — csak az utolsó néhány karakter látható azonosítás céljából.
• Ha a kulcs esetleg kikerül (pl. megosztottad valakivel véletlenül): menj a Billingo API kezelés oldalára, töröld a „Silvermoon FLOW” kulcsot, generálj újat, és add meg a Flow-ban. Az adatok megmaradnak, csak az összeköttetés újul meg.
• A kapcsolatot bármikor bonthatod egy gombnyomással — a korábban beérkezett adatok a Flow-ban megmaradnak.