Készlet.app dokumentáció

Appearance

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ó.

Webhookok ​

A webhookokkal a Készlet.app automatikusan értesíti a külső rendszereidet (pl. webshopod), amikor változás történik – így nem kell folyamatosan lekérdezned az API-t.

A webhook üzenet csak azonosítót és eseménytípust tartalmaz (pl. „a 123-as termék módosult”), magát a friss adatot nem. Az értesítés után a külső rendszer a Külső API-ból kéri le a legfrissebb állapotot. Így soha nem kapsz elavult adatot.

Webhook végpont létrehozása ​

  1. Kattints az Új webhook végpont gombra.
  2. Add meg a Cél URL-t, ahová az értesítéseket küldjük.
  3. Válaszd ki, mely eseményekről kérsz értesítést (pl. termék létrehozás/módosítás/törlés, készletváltozás, partner, kategória, vevői rendelés).
  4. Mentés után megjelenik egy kulcs – ezt másold ki azonnal, mert később nem jelenik meg újra. Ezzel tudja a fogadó rendszer ellenőrizni, hogy az üzenet valóban tőlünk jött (aláírás-ellenőrzés).

Tesztelés és ellenőrzés ​

  • A Teszt esemény küldése gombbal egy próbaüzenetet küldhetsz a végpontra.
  • A Legutóbbi kézbesítések listában látod, hogy az értesítések megérkeztek-e (sikeres / sikertelen), és a sikerteleneket kézzel újraküldheted.
  • Ha egy értesítés nem kézbesíthető, a rendszer többször, növekvő időközönként automatikusan újrapróbálja.

Kulcs újragenerálása és törlés ​

  • Az Új kulcs gombbal új kulcsot generálhatsz (a régi azonnal érvénytelen lesz – ne felejtsd frissíteni a fogadó rendszerben).
  • A Törlés gombbal megszünteted a végpontot, onnantól nem küldünk rá értesítést.

Fontos

A webhook kulcs lehetővé teszi az üzenetek eredetének ellenőrzését. Kezeld bizalmasan, és ha kiszivárog, generálj újat.