A Számla Agent kulcs (API kulcs) egy egyedi, 42 karakteres azonosító, amellyel webáruházad vagy más külső rendszered (üzleti alkalmazás, ügyviteli szoftver) biztonságosan kapcsolódik a Számlázz.hu fiókodhoz, és automatikusan bizonylatot állíthat ki. A kulcs a felhasználónév/jelszó párost váltja ki: új integrációhoz már ezt ajánljuk, de a korábban felhasználónévvel/jelszóval létrehozott integrációk továbbra is működnek. Ha fejlesztő vagy, nézd meg a Számla Agent fejlesztői dokumentációt is.
Hol találod, és hogyan generálhatsz új kulcsot?
- Lépj be a Számlázz.hu fiókodba, és kattints a bal felső sarokban lévő számla ikonra, így a Vezérlőpultra jutsz.
- Görgess az oldal aljára, a felhasználók alatti Számla Agent kulcsok blokkhoz.
- Kattints a blokk jobb oldalán található kulcs ikonra. Az új kulcs azonnal elkészül, és rögtön használható.
- A kulcs melletti másolás ikonnal egy kattintással vágólapra másolhatod, és beillesztheted a webáruház modul megfelelő mezőjébe.
Kulcsot csak fiókgazda vagy adminisztrátor jogosultságú felhasználó tud generálni és törölni. Ha nem látod a Számla Agent kulcsok blokkot, kérd meg a fiókgazdát.
Mire figyelj a kulcs használatakor?
- Egy számlázási fiókban egyszerre legfeljebb 17 kulcs lehet.
- Minden kulcs azonos jogosultságú: nincs kulcsonkénti korlátozás, mindegyik ugyanazokat a műveleteket engedi.
- A kulcs csak ahhoz a számlázási fiókhoz ad hozzáférést, amelyikben generáltad. Ha több számlázási fiókod van, mindegyikhez külön kulcs kell.
- A kulcs nem jár le: addig érvényes, amíg nem törlöd.
- A kulccsal nem lehet a Számlázz.hu weboldalára bejelentkezni, kizárólag a rendszerek közötti kommunikációra (API) szolgál.
A kulcs kis- és nagybetű érzékeny (case sensitive), és a rendszer csak kisbetűs formában fogadja el. Javasoljuk, hogy mindig másolással vidd át a kulcsot, ne gépeld be, és figyelj arra is, hogy ne kerüljön elé vagy mögé szóköz.
Ha régebbi webáruház modult használsz, amelyben nincs külön API kulcs mező, a kulcsot a felhasználónév és a jelszó mezőbe is beillesztheted (mindkét mezőbe ugyanazt a kulcsot).
Hogyan törölhetsz kulcsot, és mi történik ilyenkor?
A Vezérlőpult / Számla Agent kulcsok blokkban kattints a kulcs sorának végén a Törlöm linkre, majd erősítsd meg a törlést.
A törlés azonnal érvénybe lép: a kulcsot használó webáruházban vagy külső rendszerben az automatikus számlakibocsátás leáll. Ha új kulcsot generálsz helyette, a külső rendszerben is cseréld le.
Kezeld a kulcsot jelszóként: ne oszd meg nyilvánosan, és ne add ki illetékteleneknek. Ha a kulcs kiszivárgott, töröld, generálj újat, és frissítsd a külső rendszerben.
A Számlázz.hu-val integrált, a fiókoddal összekapcsolt rendszerek az összekapcsoláskor automatikusan létrehozhatnak saját kulcsot a fiókodban. Ezek a listában csillagozva, az adott rendszer nevével jelennek meg, és nem másolhatók ki, mert kizárólag az adott rendszer használja őket. Ha ilyen kulcsot törölsz, az adott rendszerrel megszakad a számlázási kapcsolat.
Mennyibe kerül a Számla Agent kulcs (API kulcs) használata?
Az éles (nem teszt) számlázási fiók kulcsának külső rendszerben (webshop, weboldal, egyéb üzleti alkalmazás) történő megadása lehetőséget ad a külső rendszernek, hogy bizonylatkészítési kérést küldjön a Számlázz.hu felé, amely alapján díjbekérő, számla vagy szállítólevél készülhet a fiókodban. A külső rendszerből történő automatikus számlázás díjköteles szolgáltatás, már egyetlen bizonylat után is fizetned kell. A díjazásról a Számla Agent (automatikus számlázás) költsége cikkben olvashatsz részletesen.
