Integrációk

A Készlet.app több külső rendszerrel is összekapcsolható. Az integrációk beállításait itt kezelheted.

Hol találod?

Beállítások → Integrációk menüpont.

Számlázó integráció

A Készlet.app két számlázó rendszerrel is összeköttetésbe tud lépni: Számlázz.hu és Billingo. A kettő közül egyet tudsz elsődlegesként kiválasztani.

Szolgáltató kiválasztása

1. A Számlázó szolgáltató legördülő menüből válaszd ki a kívánt szolgáltatót.
2. Töltsd ki a kiválasztott szolgáltatóhoz tartozó API kulcsot.
3. Kattints a Mentés gombra.
4. A Kapcsolat tesztelése gombbal ellenőrizheted, hogy az API kulcs helyes-e.

Számlázz.hu beállítás

1. Lépj be a Számlázz.hu fiókodba.
2. Keresd meg az API kulcsot a Számlázz.hu beállításaiban.
3. Másold ki az API kulcsot.
4. A Készlet.app-ban a Számlázz.hu API kulcs mezőbe illeszd be.

Billingo beállítás

1. Lépj be a Billingo fiókodba.
2. Navigálj az API kulcsok menüpontra és hozz létre egy új kulcsot.
3. Másold ki az API kulcsot és illeszd be a Billingo API kulcs mezőbe.
4. A Billingo bizonylattömb azonosító mezőbe add meg a használni kívánt bizonylattömb azonosítóját (a Billingo felületen a Beállítások → Bizonylattömbök menüben található).

Hogyan működik?

Ha be van állítva a számlázó integráció, az értékesítési bizonylatok véglegesítésekor:

1. A rendszer automatikusan elküldi a számla adatait a kiválasztott számlázó rendszernek.
2. A számlázó rendszer létrehozza a számlát és generálja a PDF-et.
3. A rendszer visszakapja a külső számlaszámot és a PDF fájlt.
4. A külső számlaszám megjelenik a bizonylat adatlapján.
5. A PDF az adatlapról letölthető.

Támogatott bizonylattípusok

A számlázó integráció a következő típusokkal működik:

• Számla
• Díjbekérő
• Előlegszámla
• Sztornó számla
• Helyesbítő számla

WooCommerce webshop integráció

Ha WooCommerce alapú webshopod van, összeköttetést állíthatsz be a Készlet.app és a webshop között.

Beállítás

1. A Készlet.app-ban a WooCommerce összekötés résznél töltsd ki:
   • Webshop URL – A webshopod címe (pl. https://webshopom.hu).
   • API kulcs – A WooCommerce REST API kulcs (a WooCommerce admin felületen hozhatod létre a Beállítások → Speciális → REST API menüben).
   • API titkos kulcs – A REST API titkos kulcs.
2. Kattints a Kapcsolat tesztelése gombra a hitelesítő adatok ellenőrzéséhez.
3. Ha a teszt sikeres, kattints az Összekötés gombra.

Hogyan működik?

Az összekötés után:

• Kezdeti szinkronizálás – A rendszer letölti a webshopból az összes terméket, vevőt és rendelést.
• Folyamatos szinkronizálás – A WooCommerce webhook-okon keresztül automatikusan frissülnek az adatok, ha a webshopban változás történik:
  • Termék létrehozás, módosítás, törlés
  • Vevő létrehozás, módosítás, törlés
  • Rendelés létrehozás, módosítás, törlés

Leválasztás

Ha meg szeretnéd szüntetni az összekötést, kattints a Leválasztás gombra. Ekkor a rendszer eltávolítja a webhook-okat a WooCommerce-ből és letiltja a szinkronizálást.

Készlet.app API

Saját API kulcsokat hozhatsz létre, amelyekkel külső alkalmazásokból érheted el a Készlet.app adatait. Ez hasznos, ha:

• Egyedi szoftverrel szeretnéd szinkronizálni az adatokat
• Saját integrációt építenél
• Egy másik rendszerből szeretnéd elérni a Készlet.app-ot

API kulcs létrehozása

1. Kattints az Új API kulcs gombra.
2. A rendszer generál egy API kulcsot.
3. Másold ki azonnal, mert a kulcs később nem jelenik meg újra.

API kulcs törlése

A kulcs mellett a Törlés gombra kattintva visszavonhatod a hozzáférést.

Fontos

Az API kulcsok teljes hozzáférést biztosítanak a fiókod adataihoz. Csak megbízható alkalmazásokkal oszd meg, és ha egy kulcs kompromittálódik, azonnal töröld.

A részletes API dokumentáció a Külső API oldalon található.