A folyamat tesztelése
A teljes megbízotti folyamat - a csatlakozástól a számla- és nyugtakiállításig - élesítés előtt kockázat nélkül kipróbálható tesztfiókokkal. Ez az oldal összefoglalja:
- hogyan kapcsolható be a tesztüzem,
- a teljes tesztfolyamat lépésről lépésre,
- miben más a tesztüzem az éles működéshez képest,
- és mi történik élesítéskor.
Tesztüzem bekapcsolása
A Vezérlőpulton kattints a „Tesztüzem bekapcsolása" gombra. Ez #free csomagos fiókban érhető el, amelynek nincs éles számlája vagy nyugtája, és nincs kész NAV összekötése.
A teszt idejére a fiók ingyen a #profi funkciókészletet kapja - ezért a teszteléshez ne fizess elő; előfizetett fióknál a tesztüzem a felületen már nem kapcsolható be, csak az ügyfélszolgálat segítségével.
A tesztfiók létrehozásában és használatában a tudástár Teszt API hozzáférés cikke is végigvezet.
A teljes folyamat lépésről lépésre
1. Megbízotti tesztfiók regisztrálása
Regisztráld a cégedet a szamlazz.hu-n (a #free csomag elég, a teszteléshez ne fizess elő), majd még az első számla kiállítása előtt kapcsold tesztüzembe: a Vezérlőpult jobb oldalán, lefelé görgetve találod a „Tesztüzem bekapcsolása" gombot (a feltételeket lásd fentebb).
Regisztrálj mellé egy külön tesztfiókot. Minősített (NAV-összekötött) fióknál a fiókgazda belépett állapotban, a bal felső lenyíló menüből ugyanazzal az adószámmal is beregisztrálhatja a céget még egyszer, és az új, üres fiókot azonnal tesztüzembe kapcsolhatja; később a két fiók között is itt tudsz váltani.
2. A megbízói oldal előkészítése
- Felületi csatlakozásnál: a megbízói oldalra is tesztfiók kell - regisztráld ugyanígy (másik e-mail címmel), és kapcsold tesztüzembe.
- API-s csatlakozásnál: a megbízói oldalon nincs szükség felületi regisztrációra: a kívánt megbízói tesztfiókot maga az
action-agent_ceg_mbhívás hozza létre, és mivel tesztfiókból hívod, az új fiók automatikusan tesztfiók lesz.
3. A kapcsolat kialakítása
| Felületen | API-val | |
|---|---|---|
| Lépések | Hozd létre a dedikált felhasználót a megbízotti fiókban, küldd el a csatlakozási kérelmet, majd a megbízó fiókgazdájaként hagyd jóvá | Állítsd össze és küldd be az action-agent_ceg_mb kérést a tesztfiókból |
| Részletes leírás | Kapcsolat kialakítása a felületen | Kapcsolat kialakítása API-val |
Az action-agent_ceg_mb interfész engedélyét a tesztfiókra is kérned kell az ügyfélszolgálattól - az engedélyt a tesztüzem #profi funkciókészlete sem tartalmazza, enélkül a hívás 137-es hibával áll le.
4. Tesztbizonylatok kiállítása
Állíts ki tesztbizonylatokat a megbízó fiókjában, a felületen vagy Agenttel: Számlakiállítás megbízottként, Nyugtakiállítás megbízottként. A tesztbizonylatokról nem történik NAV adatszolgáltatás.
5. További műveletek kipróbálása (opcionális)
Például a számla sztornózása és PDF-jének lekérése, vagy a nyugta sztornója és e-mailben küldése. Ezek tesztüzemben is működnek, egy eltéréssel: a bizonylatküldő e-mailek nem a megadott címzetthez, hanem a tesztfiókban beállított e-mail címre érkeznek (lásd lentebb).
6. Élesítés
Ha minden működik, a megbízotti fiókodban zárd le a tesztüzemet (Vezérlőpult, „Tesztüzem vége"): a tesztbizonylatok törlődnek, a számlatömbök megmaradnak; részletek: Élesítés. Az API paramétereken nem kell változtatnod: az élesítés után ugyanazokkal a beállításokkal azonnal indulhat a valós számlázás.
Ha a megbízói tesztfiókot csak a teszteléshez hoztad létre, azt nem kell élesítened - ez a fiók eldobható. Ilyenkor a valódi megbízó éles fiókjával kell kialakítanod a kapcsolatot: ugyanazokat a lépéseket futtatod le élesben (csatlakozási kérelem a felületen vagy action-agent_ceg_mb hívás), mint a tesztben.
Miben más a tesztüzem?
A tesztelést úgy javasoljuk, hogy mindkét oldalon tesztfiók legyen - a fenti lépések is ezt követik. Ekkor:
- A megbízói tesztfiók NAV összekötés nélkül is számlázhat: a tesztszámlák minta jelölést kapnak, és nem történik utánuk NAV adatszolgáltatás.
- Az Agent csak XSD-valid XML-t fogad el, és számlakészítési darabszám-limit él: a limit túllépésekor a hívás 167-es hibával áll le, és csak néhány perc elteltével állítható ki újabb bizonylat.
- A bizonylatküldő e-mailek (számlaértesítő, nyugtaküldés stb.) tesztfiókból nem a hívásban megadott címzetthez mennek: mindegyik a kiállító tesztfiók cégadatainál beállított e-mail címre érkezik - így a valós partnereket nem éred el véletlenül tesztüzenetekkel, a leveleket pedig magadnál ellenőrizheted.
- A tesztbizonylatok nem generálnak megbízotti költséget: díj csak akkor keletkezik, ha a megbízott és a megbízó fiókja is éles. A költségviselésről bővebben: Költségviselés.
- Az
action-agent_ceg_mb-vel létrehozott megbízói fiók pontosan akkor lesz tesztfiók, ha a hívó megbízotti fiók tesztüzemben van (a cégneve „(agentceg teszt)" utótagot is kap); éles fiókból hívva a létrejövő megbízói fiók éles lesz. Lásd: Kapcsolat kialakítása API-val.
Élesítés
Élesítéskor (Vezérlőpult, „Tesztüzem vége") minden tesztbizonylat törlődik, a rögzített termékekkel és partnerekkel együtt, és a sorszámozás újraindul; a megbízotti kapcsolat és a számlatömbök (előtagok) megmaradnak.
Az élesítés egyirányú: éles bizonylattal rendelkező fiók nem állítható vissza tesztüzembe.