Hitelesítés (API kulcs)
A Számla Agent kérések hitelesítést igényelnek. Használhatod az Agent kulcsot (ajánlott) vagy a felhasználónevet és jelszót.
Ajánlott: Agent kulcs
A felhasználónév és jelszó helyett Agent kulcs használatát javasoljuk. Az XML-ben a <szamlaagentkulcs> mezőt használd.
Az Agent kulcs generálásához a fiók tulajdonosának vagy adminisztrátorának be kell jelentkeznie a Számlázz.hu weboldalra, és le kell görgetnie a vezérlőpult aljára. Itt található a Számla Agent kulcsok szekció; a jobb oldali kulcs ikonra kattintva azonnal létrejön az új Agent kulcs.
Régi webáruház esetén, ahol a <szamlaagentkulcs> mezőt nem tudod használni, a <felhasznalo> és <jelszo> mezőkben is megadhatod a kulcsot (mindkét mezőbe ugyanazt a kulcsot írd).
Az Agent kulcsok nem járnak le; határozatlan ideig érvényesek, amíg manuálisan nem törlöd őket. Egy fiók összes Agent kulcsa azonos jogosultságokkal rendelkezik: kulcsonkénti scope vagy hozzáférés-korlátozás nincs. Egy fiókban legfeljebb 17 Agent kulcs hozható létre; a törlés azonnal érvényes.
A kulcs csak API hívásra használható, a Számlázz.hu weboldalra vele nem lehet belépni. Az Agent kulcsok kis- és nagybetű érzékenyek (case sensitive). A rendszer csak kisbetűs kulcsot fogad el; nagybetűvel a hitelesítés sikertelen lehet.
Az Agent kulcsot úgy kezeld, mint egy jelszót: ne tárold verziókezelőben, ne add meg nyilvánosan, és ne kerüljön kliensoldali kódba. Ha egy kulcs illetéktelen kézbe kerül, azonnal töröld, és generálj újat.
Alternatíva: felhasználó és jelszó
A Számla Agenthez érdemes egy dedikált felhasználót létrehozni számlázási joggal. Ennek a felhasználónak olyan e-mail címet érdemes beállítani, amit a hibaelhárításért felelős személyek elérnek, mert a hibaüzenetek erre a címre érkeznek.
Ez a felhasználó kizárólag egyetlen számlázási fiókhoz férhet hozzá. Ha több céghez is van hozzáférése, a rendszer nem tudja azonosítani, melyik fiók nevében érkezik a kérés, és hibát kapsz (164-es hibakód).
Következő lépések
- Munkameneti süti: a session cookie-k kezelése a kérésekben
- Kérések küldése: az XML kérések felépítése és elküldése
- Hibakezelés: hitelesítési és egyéb hibák kezelése