Az Online Fiszkális Kassza dokumentációja v1.0.0
Használati útmutató az Online Fiszkális Kasszához
NetRačuni Online Fiszkális Kassza kizárólag online áruházak számára készült (web shop-ok részére), csak V-PFR-t támogat, és internet kapcsolat nélkül nem ad ki számlát.
Mi az Online Fiszkális Kassza?
Az Online Fiszkális Kassza segítségével fiszkális számlákat tud létrehozni online felülelten keresztül. A Netračuni Online Fiszkális Kasszája az adóhivatal által elfogadott számlázó program (végzés száma: 000-092-00-00318/2023-0000).
Ha ön Webáruházat működtet/működtetne, akkor szüksége van/lesz olyan programra, amellyel fiszkális számlákat tud kiállítani és küldeni ügyfelei/vásárlói részére.
Ezt megteheti oly módon, hogy rendelkezik fizikai kassza készülékkel, amellyel fiszkális számlát tud nyomtatni, majd az eladott termékhez mellékelve postán eljuttatja vásárlójához.
Ha önnek kizárólag Webáruháza van és emellett nincs fizikai üzlethelyisége, ahová a vásárlói betérhetnek, hogy élőben vásároljanak, akkor önnek nem kell fizikai kassza készülékkel rendelkeznie. Ebben az esetben használhat Online Fiszkális Kassza programot, mint pl. A Netračuni Online Fiszkális Kasszája. Amennyiben van üzlethelyisége, egy fizikai kassza készülék kötelező, de emellett megengedett az Online Fiszkális Kassza használata is.
Amikor valaki vásárolt az ön Webáruházában, akkor ön a Netracuni Online Fiszkális Kasszáján keresztül kiállítja a fiszkális számlát. Ezután a Kassza programunk kommunikál az adóhivatallal, majd előállítja a számlát egy .pdf dokumentumban, és ezt ön elküldi vásárlójának e-mailen keresztül. Az ezen a módon előállított fiszkális számlát ki is nyomtathatja és a vásárolt termékkel együtt postai úton elküldheti vásárlójának.
Mi szükséges ahhoz, hogy használni tudjam a Netračuni Online Fiszkális Kasszáját?
Ahhoz, hogy használni tudja a Netračuni Online Fiszkális Kasszáját, be kell regisztrálnia a www.netracuni.com weboldalára.
Regisztráció alkalmával meg kell adnia vállalkozása-cége adatait és annak a személynek az adatait, aki majd kezeli a kasszát (Felhasználó adatai).
Ezeket az adatokat azért szükséges megadnia, mert a Fiszkális Kasszákat vállalkozások használhatják. Illetve, ha ön a vásárlónk lesz, akkor ezekre az adatokra szükségünk lesz ahhoz, hogy számlázni tudjunk önnek.
Ezen kívül, szüksége lesz az adóhivatal által kiadott Certificate-re és a PAK kódra.
Üzlethelyiség létrehozása az ePorezi portálon
Az elektronikus Certificate kérelmezéséhez szükséges, hogy legyen regisztrált üzlethelyisége az ePorezi portálon. Amennyiben még nincs regiszrált üzlethelyisége, kérvényezze a portálon az adóhivatal utasítása alapján.
Elektronikus Certificate az ePorezi portálon
Amennyiben még nem rendelkezik elektronikus Certificate-el, kérvényezze az Adóhivataltól. Csak Certificate-et kell kérvényeznie. Az okos kártya nem szükséges a NetRačuni rendszer használatához. Az utasítást ezen a linken keresztül tudja elérni.
Hogyan regisztrálja vállalkozását-cégét a Netračuni weboldalán?
A netracuni.com főoldalán a “Regisztráció” menüpontjára kattintva lehet regisztrálni. Ezt a menüpontot a jobb felső sarokban találja.
Mielőtt regisztrálna, kiválaszthatja, hogy szerb vagy magyar nyelven szeretné-e használni a Netračuni alkalmazást.
A nyelv választási lehetőség mellett levő “Bejelentkezés” menüpontot majd akkor tudja használni, ha megtörtént a sikeres regisztráció.
Kérem regisztrációt megelőzően tekintse át az oldalt, gondolja át, hogy önnek mely megoldás felelne meg a legjobban a Netračuni termékei közül.
A “Regisztráció”menüpontra kattintva egy formanyomtatvány jelenik meg. Ezt kérjük töltse ki. A következő adatok lesznek szükségesek:
Céges adatok:
| Adószám | - cége adószáma (PIB) |
| Nyilvántartási szám | - cége nyilvántartási száma (MATIČNI BROJ) |
| Cégnév | - cége hivatalosan bejegyzett neve |
| Város | - a város neve, ahol a cége bejegyzésre került |
| Irányítószám | - a város postai irányítószáma, ahol cége bejegyzésre került |
| Cím | - cége székhelyének bejegyzett címe |
| Telefonszám | - cége hivatalos telefonszáma |
Felhasználói adatok:
| Név | - regisztráló személy vezeték és utóneve |
| - regisztráló személy vagy cég e-mail címe | |
| Jelszó | - tetszőleges jelszó megadása, minimum 8 karakter kell hogy legyen, tartalmaznia kell kisbetűt, nagybetűt és számot |
| Jelszó megerősítése | - a megadott jelszó újra gépelése igazolás céljából |
| Elolvastam és Elfogadom a felhasználási feltételeket | - Szükséges elolvasni és kijelölni a feltételeket. |
Miután kitöltötte a formanyomtatványt, kattintson a “REGISZTRÁCIÓ” gombra. Ezzel a lépéssel elküldte a formanyomtatványt a Netračuni rendszerébe. Ezután, érkezni fog önnek egy e-mail, amely tartalmazza az e-mail címe visszaigazolási linkjét.
Amíg nem igazolja vissza e-mail címét, nem fogja tudni használni az Netračuni rendszerét!
Kattintson a visszaigazoló e-mailben lévő linkre, ezáltal a visszaigazolás megtörténik. Miután visszaigazolta e-mail címét, ellenőrizni fogjuk, hogy valós cégről van szó, szükség esetén felvesszük önnel a kapcsolatot. Amennyiben mindent rendben találunk aktiváljuk regisztrációját.
FIGYELEM, regisztrációja aktiválásához szükséges az is, hogy az adóhivataltól kapott Certificate-ot és PAK számot is felvigye a Netračuni rendszerébe. Ha a bal felső sarokban a cége neve mellett a sárga háromszög felkiáltójellell átvált zöld körre pipával, ekkor aktív a regisztrációja és a kassza használatra készen áll.
A cég általános információk sorában szintén megjelenik a pipa a zöld körben. Valmint mellette látható az időpont, amikor a jóváhagyás megtörtént.
A “0 számlát használt fel a rendelkezésre álló 10 számlából” azt jelenti, hogy kezdésre kap tőlünk 10 ingyenes számlát, amivel ki tudja próbálni a kasszát.
Hogyan adja hozzá az adóhivataltól kapott Certificate-jét az Online Fiszkális Kassza rendszeréhez?
Miután igazolta e-mail címét, a Netračuni rendszerének főoldalára jut. Itt kattintson a kék színű “Certificate feltöltése” gombra. Ezzel átjut arra az oldalra, ahol a Virtuális Certificate sorában megadja PAK azonosítóját és a Certificate filet, amit az adóhivataltól kapott. A “Válassza ki a certificate file-t” gombra kattintva keresse meg VSD Certificate fájlt (nochain.CERiKEY.pem végződésű fájl) és töltse fel, majd kattintson a mentés gombra, hogy elmentse a műveletet. Amennyiben a Certificate-je és PAK-ja megfelelő, a rendszer letölti az aktuális adókulcsokat az adóhivatal szerveréről és beállítja fiókját számlázásra. Amennyiben valami probléma történik, nem megfelelő fájlt vagy PAK-azonosítót adott meg, kérem javítsa ki a hibás adatokat, vagy töltse fel a megfelelő fájlt!
A navigációs útvonal: A bal felső sarokban kattintson a cége nevére, majd a legördülő menüből választja ki a Cég beállítások menüpontot.
A menüben a Virtuális certificate részben adja meg a PAK mezőben a PAK azonosítóját (az adóhivataltól kapott e-mailben megtalálja)
Mely menüpontokat találom a Netračuni rendszerében és azok hogyan működnek?
Miután a Certificate-t sikeresen hozzáadta a rendszerhez, és a cége regisztrációját aktiváltuk, a főmenüben a következő menüpontokat találja. “Főoldal”, “Számlák”, “Termékek”, “Netkassza”, “Webshop”(a Webshop csak akkor jelenik meg, ha a Netračuni oldalán vásárolt Webshop bérletet), “Cége adatai”, “Felhasználói adatai”.
Főoldal
A főoldal általános információkat tartalmaz.
Itt megtekintheti:
- mely fiszkális-számla csomagokat rendelte meg, eddig a Netračuni оldalán, de azok még nem lettek kifizetve és/vagy a kifizetés még nem lett evidentálva
- hány darab számla áll még a rendelkezésére, amit ki tud adni vásárlóinak
- hány darab számlát adott ki eddig vásárlóinak (felhasznált számlák darabszáma)
- hány darab számlát vásárolt meg eddig a Netračuni rendszeréből
- eddig megvásárolt számlacsomagok darabszámát
- az online fiszkális-számla csomagjai lejárati dátumát
- Valamint egy grafikont az utolsó két hét eladásairól és visszatérítéseiről vagyis, hogy hány darab eladási számlát és hány darab visszatérítési számlát adott ki meghatározott napokon
Amennyiben vásárolt bérelhető Webáruház csomagot, a Főoldalon az ezzel kapcsolatos információk is megjelennek. (Erről bővebben a bérelhető Webáruház használati útmutatójában olvashat)
- Webáruháza URL címe (internet címe)
-
- -Azaz, érkezett-e új megrendelése és melyek ezek
- -hány darab megrendelése van feldolgozás alatt és melyek ezek
- -és hány megrendelését szállította ki és melyek ezek
Webáruházában történt megrendeléseinek állapota.
Termékek
A kassza használatához nem szükséges termékeket feltölteni/létrehozni egy listában, de amennyiben nem szeretné minden vásárlás alkalmával újra begépelni a termékeket a kasszába, a “Termékek” menüpont alatt feltöltheti/létrehozhatja termékeit.
A Termékek menüpont négy almenüt tartalmaz: Termékek, Kategóriák, Mértékegységek és Adókulcsok
Termékek-almenü
A “Termékek” almenüre kattintva az eddig felvitt/létrehozott termékek listája jelenik meg táblázat formájában. Amennyiben ön még nem hozott létre terméket/ nem adott hozzá terméket a listához, az ön listája üres lesz.
A termék listában kereshet Terméknév, Bárkód és Egyéni kód alapján.
Amennyiben úgy dönt, hogy szeretné termékeit egy listában látni, a gyorsabb számlázás érdekében, kattintson az “Új termék létrehozása” gombra. Ezután a termékeinek adatait írja be a megfelelő mezőkbe.
A termék létrehozását a rendszerben a Termék Adatok megadásával kell kezdeni. Ezek a következők:
- Kategória - Ez a mező csak akkor látható, ha előzőleg már létrehozott valamilyen kategóriát a termékei részére. Ha csak a kasszát használja, akkor gondolja át, hogy szükséges-e termékeinek kategóriákat létrehoznia. Ha használja a bérelhető Webáruházat is és több terméke van, akkor ebben az esetben már előnyös a termékeket kategóriákba sorolni. Ha adott meg Kategóriákat, akkor az itt található legördülő menüből válassza ki, hogy az a termék amit most kíván létrehozni mely kategóriába tartozik. Amennyiben nem kívánja kategóriához rendelni az adott terméket, akkor ezt a mezőt hagyja ki. Ebben az esetben a Kérem válasszon szöveg lesz a Kategória mezőben.
- Terméknév - A létrehozandó termék elnevezése. Maximálisan 255 karakter hosszú szöveg lehet.
- Egységár - A termék egy egységnyi mértékegység ára ( pl.: egy darab termék ára, ha a termék mértékegysége Kom (darab), vagy egy kiló termék ára, vagy egy liter termék ára)
- Mértékegység - A termék mértékegysége, melyet a “Mértékegységek” menüpont alatt meghatározott.
- Bárkód - a termék bárkódja. Ha a létrehozni kívánt termék rendelkezik bárkóddal akkor ez 8-16 karakter hosszúságú. Ha a termék nem rendelkezik bárkóddal, vagy nem kívánja megadni, akkor ezt a mezőt ki lehet hagyni. Ha kihagyja, akkor a későbbiekben nem fog tudni keresni termékei között bárkód alapján és nem fogja tudni alkalmazni a bárkód szkenert.
- Egyéni kód - ebben a mezőben a létrehozni kívánt terméknek tetszőleges azonosító kódot határozhat meg. Ez alapján ön könnyebben tudja majd azonosítani termékét. Ezen kód megadása nem kötelező, de gyakran nagy segítséget jelent, ha például több hasonló nevű termékkel is rendelkezik.
- Leírás - a termék rövid leírása. A kassza esetében leginkább önnek, mint felhasználónak nyújt segítséget a termék könnyebb és biztosabb azonosításában. Webáruház esetén termékleírásként javasolt megfogalmazni. Nem kötelező megadni.
A termék létrehozásának második részében az adókulcsokat kell meghatározni:
- Adókulcsok - a létrehozni kívánt termékhez adókulcsot kell rendelni. Az itt megjelenő adókulcs táblázat elemei certificate-je hozzáadásakor lettek letöltve az adóhivatal rendszeréből. Minden termékhez KÖTELEZŐEN, hozzá kell rendelni legalább egy adókulcsot, amit a zöld színű plusz gombra kattintva végezhet el.
Miután kitöltötte a termékhez kapcsolódó adatokat, a “Mentés” gombra kattintva a termék bekerül a rendszerben létrehozott termékek listájába. A listához a “Vissza a listához” gombra kattintva juthat el, és ellenőrizheti, hogy valóban megjelent-e az előzőleg létrehozott termék.
Amennyiben folyamatosan szeretne több terméket létrehozni a kassza rendszerében, akkor a termék adatainak beírása után kattintson a “Mentés és új hozzáadása” gombra. Ezután a termék hozzáadódik a terméklistájához és új üres mezők jelennek meg, ahová beírhatja a második termék adatait is, és így tovább.
A terméklistában a kék ceruza ikonra kattintva megtekintheti a termék adatait és változtathat is rajtuk. A változtatás után kattintson a “Mentés” gombra. Ha szeretne törölni egy bizonyos terméket a listáról, akkor kattintson a piros szemeteskosár ikonra.
Amennyiben a Netračuni oldalán bérelt Webáruházat, a termék adatainak mentése után új lehetőségek jelennek meg a képernyőn: A terméket hozzáadhatja a Webáruházhoz, és itt töltheti fel a fényképeket is a termékről. (erről részletesebben a Bérelhető Webáruház használati utasításában olvashat)
CSV Letöltés
A “CSV Letöltése” gomb segítségével letöltheti a termékeit az adatbázisból csv formátumban. FIGYELEM a csv csak a termék legszükségesebb adatait tartalmazza!
CSV Feltöltés
Amennyiben rendelkezik megfelelő formátumú CSV fájlal a termékeiről, ezen gomb segítségével feltöltheti termékeit az adatbázisba.
Miután a gombra kattintott egy felugró ablak ad részletes információt a fájl szükséges felépítéséről és ad lehetőséget a fájl kiválasztására.
Termékek Feltöltése CSV fájl segítségével
- Figyelem! A fájl kell, hogy rendelkezzen fejléccel. A fejlécben a következő bejegyzések kötelezőek: name, barcode, custom_code, price, measurement_unit, labels
- A name rész (a termék neve) megadása kötelező!
- A barcode rész nem kötelező, de ha van akkor egyedinek kell, hogy legyen! Ha nincs akkor csak egy elválasztó karakter kell, hogy legyen a fájlban a helyén.
- A custom_code rész nem kötelező, de ha van akkor egyedinek kell, hogy legyen! Ha nincs akkor csak egy elválasztó karakter kell, hogy legyen a fájlban a helyén.
- A price rész (a termék ára) lehet megadva egész számban (ilyenkor a tizedes szám 100-szorosát kell megadni), vagy tizedesben, két tizedes pontossággal.
- A measurement_unit a termék mértékegysége, lehet pl: KG, KOM, L stb.
- A labels az adókulcsok betűjeleinek felsorolása, ha több mint egy adókulcs van lehet vesszővel (pl: A,N) vagy üreshellyel (pl: A N) elválasztva.
Ha a csv fájlban az értékek nem vesszővel vannak elválasztva a Separator mezőbe meg kell adni az elválasztó karaktert.
A “CSV Fájl Kiválasztása” gombra kattintva lehet kiválasztani a fájlt és feltölteni, ha a fájl formátuma megfelelő, a rendszer feltölti az adatokat, ha hiba történik jelzi azt.
Kategóriák-almenü
A termékeket kategóriákhoz lehet rendelni. A “Kategóriák” almenüre kattintva az eddig felvitt/létrehozott kategóriák listája jelenik meg táblázat formájában. Amennyiben ön még nem hozott létre kategóriát/nem adott hozzá kategóriát a listához, az ön listája üres lesz. A kassza használatához a Kategóriákat nem kötelező megadni, viszont ha használja a Netračuni bérelhető Webáruházát, akkor a termékek könnyebb csoportosítása érdekében javasolt.
Amennyiben úgy dönt, hogy a termékeit kategóriákba sorolja kattintson az “Új kategória létrehozása” gombra. Ezután adja meg a kategória nevét. A Leírás mezőbe pedig bővebb megfogalmazást adhat róla, de ezt ki is hagyhatja. Majd kattintson a “Mentés” gombra. Ezzel a művelettel az újonnan létrehozott kategória bekerült a Kategóriák listájába. A “Vissza a listához” gombra kattintva tekintheti meg.
A kategóriák listájában a kék ceruza ikonra kattintva megtekintheti a kategória adatait és most változtathat is rajtuk. A változtatás után kattintson a “Mentés” gombra. Ha szeretne törölni egy bizonyos kategóriát a listáról, akkor kattintson a piros szemeteskosár ikonra.
Mértékegységek-almenü
Termékeihez rendeljen hozzá megfelelő mértékegységeket. A “Mértékegységek” almenüre kattintva az eddig létrehozott mértékegységek listája jelenik meg táblázat formájában. A táblázatban mi már létrehoztunk önnek két mértékegységet, ezek a Komad (kom) és Kilogram (kg). Ön ezekhez hozzon létre újakat, termékei fajtájától függően.
FONTOS!!!Mielőtt egy terméket felvinne, szükséges, hogy a mértékegysége már létre legyen hozva. A mértékegységeket minden esetben Szerb nyelven kell megadni, mivel a rendszer ezen mértékegységeket használja számlázás alkalmával!
Új mértékegység létrehozásához, kattintson az “Új mértékegység létrehozása” gombra. Majd írja be a mezőkbe a következő adatokat:
- mértékegység rövidítése pl.: KG, M, L, T, KOM, stb.
- mértékegység neve pl.: kilogram, metar, litar, tona, komad stb.
-
- -lehet 0 (nulla) - ilyenkor csak egész számokban lehet megadni a termék mennyiségét, ez jellemző a darabszámú termékekre.
- -1, 2 vagy 3 tizedes pontosságú mértékegységek
mértékegység tizedes jegyei:
Miután meghatározta a fentieket kattintson a “Mentés” gombra. Ezzel létrehozta az új mértékegységet a kassza programjában illetve a listában. A “Vissza a listához” gombra kattintva megtekintheti.
Ha a mértékegységek listájában lévő elemeken változtatni szeretne, akkor kattintson a ceruza ikonra és a megjelenő mezőkben javítsa ki ami szükséges, majd a “Mentés” gombbal mentse le. Ha törölni szeretné a listában levő mértékegységet, akkor kattintson a piros szemeteskosár ikonra. FIGYELEM, olyan mértékegységet, amelyet már bármelyik termékhez kiválasztott, azt NEM SZABAD TÖRÖLNI!
Adókulcsok-almenü
A táblázatban azok az adókulcsok jelennek meg, amelyeket az adóhivatal szerveréről töltöttünk le.
Az Adókulcsok táblázat a láblécből is elérhető.
Net Kassza
Amennyiben Fiszkális számlát szeretne létrehozni és vásárlójának küldeni, kattintson a főmenüben a “Net Kassza” feliratra.
A Net Kassza négy részből épül fel:
- Fejléc
- Segédgombok és összefoglaló
- Termékek keresése és hozzáadása a számlához
- A számlán lévő termékek listája
Fejléc
A fejlécben nyomon tudja követni a következőket:
- Számla sorszáma: azt jelenti, hogy hanyadik fiszkális számlát hozza éppen létre a Netračuni rendszerében
- Fiszkális-számla csomag lejárati dátuma: azt jelenti, hogy azon dátumig tud létrehozni fiszkális számlákat a Netračuni rendszerében. (dátum csak abban az esetben jelenik itt meg, ha ön már vásárolt Fiszkális-számla csomagot).
- Felhasznált/Rendelkezésre álló számlák : Ennyi számlát állított ki és küldött el vásárlójának eddig/ Ennyi számla áll még a rendelkezésére vagyis még ennyi darab számlát tud kiállítani. Ha a rendelkezésre álló számlák száma közeledik a nullához, érdemes újabb Fiszkális-számla csomagot vásárolnia a Netračuni oldalán.
Segéd gombok és összefoglaló
A második rész hat funkció gombot és egy összefoglaló táblázatot tartalmaz
Vásárló azonosító
A “Vásárló azonosító” gomb egy felugró ablakot nyit ki, amely lehetővé teszi a vásárló azonosítójának megadását szükség esetén, például készpénzszámla (gotovinski račun) készítése esetén
A felső sorban a legördülő menüből ki kell választani az azonosítás módját (pl.: JMBG, PIB stb.), a mellette lévő mezőbe pedig be kell írni a konkrét azonosítót.
A második sorban a “Vásárló általános mező” -t csak kivételes esetekben kell megadni (például vaucher fizetés esetén) részletesen ezen mező használatáról kérem tájékozódjon az adóhivatal oldalán (a legtöbb esetben nem kell megadni).
Vásárlók
Amennyiben a legördülő menüből a PIB-et választotta ki, az ellenőrzés gombra kattintva ellenőrizheti, hogy az adott “Vásárló adó számhoz (PIB)“ tartozó vásárló cég létezik-e már a helyi adatbázisban vagy a nemzeti bank adatbázisában.
Amennyiben nem talál ilyet, létre tudja hozni azonnal a vásárló cég adatainak megadásával, a számla kiadás folyamatának megszakítása nélkül.
- Adószám - vásárló adószáma (PIB)
- Nyilvántartási szám - vásárló nyilvántartási száma (MATIČNI BROJ)
- Cégnév - vásárló hivatalosan bejegyzett neve
- Város - a város neve, ahol a vásárló bejegyzésre került
- Irányítószám - a város postai irányítószáma, ahol a vásárló bejegyzésre került
- Cím - vásárló székhelyének bejegyzett címe
A “Mentés” gombra kattintva az újonnan létrehozott vásárló bekerült a Vásárlók listájába. És folytathatja a számla kiadállítását tovább.
Referencia dokumentum
A “Referncia Dokumentum” gomb segítségével lehet hivatkozni másik számlákra. Ez a mező leginkább másolat, visszatérítés és előszámlából való számla készítés esetén szükséges. Ezen funkciókra segéd gombok vannak előlátva, amelyek kitöltik ezen mezőket. De ha szükséges valamilyen okból másik számlára hivatkozni, azt itt megteheti.
Referencia számla száma: az adóhivatal által visszaküldött számlaszám Referencia számla dátuma: az adóhivatal számla hitelesítésének ideje, FONTOS hogy a dátum és idő megfelelő formátumban legyen nn/hh/éééé HH:pp:ss:milis
A kereső segítségével meg lehet keresni a kívánt számlát, kiválasztva a program kitölti a megfelelő mezőket
Számla típusa
Amennyiben nem eladás számlát kíván létrehozni, itt kiválaszthatja a kívánt számla típusát. Lehetőség van Forgalom (eladás), Előszámla (eladás) és Gyakorló (eladás) számla kiválasztására. Lehetőség van visszatérítés és másolat készítésére is, de ezen számlákat a hozzá tartozó segédgombok segítségével tudja elkészíteni (erről részletesebben később írunk). A Forgalom típusú számlák a normál eladások.
Az Előszámlák ajánlat tipusú számlák.
A Gyakorló számlák csak gyakorlás céljából készítendők, nincs semmiféle törvényi értéke vagy adókötelezettsége!
Összefoglaló táblázat
Az összefoglaló táblázat a fentiekben megadott értékek összefoglalása:
- Számla típusa - a jelenleg folyamatban lévő számla típusa (forgalom, előszámla vagy gyakorló számla lehet)
- Vásárló azonosító - ha megadta a vásárlói azonosító számát, akkor az itt meg fog jelenni
- Vásárló általános mező - ha adott meg számot, akkor az itt meg fog jelenni
- Referencia számla száma - ha előzőleg adott meg számot, akkor az itt meg fog jelenni
- Referencia számla dátuma - ha adott meg dátumot, akkor az itt meg fog jelenni
Másolat készítése
Másolatot bármely számláról tud készíteni. Amikor a “Másolat készítése” gombra kattint egy felnyíló ablak részletes keresési lehetőséget nyújt az eddig kiadott számlák között.
Először válassza ki a számla típusát, amelyről másolatot kíván készíteni.
- ПП - Promet prodaja (Normál eladás) típusú számlák
- ПР - Promet refundacija (Normál refundáció) típusú számlák
- OП - Obuka prodaja (Gyakorló eladás) típusú számlák
- OP - Obuka refundacija (Gyakorló refundáció) típusú számlák
- PП - Preform prodaja (Eladás előszámla) típusú számlák
- PР - Preform refundacija (Előszámla refundáció) típusú számlák
A “Dátumtól” ”Dátumig” mezőkben meg tudja adni az időhatárt, amelyben a keresett számla ki lett adva. Ha nem tölti ki a dátum mezőket akkor a keresés a mai napon kiadott számlák között történik.
Ha kitölti a “Számla összege” mezőt, akkor olyan számlákat keres, mely összértéke megegyezik a beírt összeggel.
Ha tudja a számla számát ( az adóhivatal által visszaküldött számlaszámot) a “Számla száma” mezőbe beírhatja.
Miután meghatározta a keresés feltételeit a “Keresés” gombra kattintva indíthatja el a keresést a számlák között. A találatok a keresés rész alatt fognak megjelenni.
A találatok közül válassza ki a kívánt számlát a zsurnálra kattintva. Miután hozzáadta a számlát, a számla megjelenik az ablak felső részében, mellette a “Végrehajt” gombbal.
A “Végrehajt” gombra kattintva készíthet másolatot a kiválasztott számláról!
Miután a másolat elkészült, egy másik felnyíló ablakban megnézheti a számlát, vagy a számla alatti linkre kattintva letöltheti pdf formában.
Visszatérítés
Ha eladási számlát kíván visszatéríteni a “Visszatérítés” gomb segítségével megteheti. A gombra kattintva egy felugró ablak nyílik.
Az ablak tetején van egy “Gyakorlás” választási lehetőség, amit ha kiválaszt akkor tud gyakorló visszatérítés számlát készíteni. FIGYELEM gyakorló visszatérítést, csak gyakorló eladás számlából lehet készíteni.
A visszatéríteni kívánt számlát a Másolat készítésénél már ismertetett számlakereső segítségével tudja megkeresni. Az egyetlen jelentős különbség, hogy kevesebb számlatípus közül választhat (csak eladási számlákat lehet visszatéríteni).
Ha a keresett számla már vissza volt térítve, nem fog megjelenni a keresési találatok között, így nem lehet egy számlát többször visszatéríteni!
A keresés eredményéből a zsurnálra kattintva tudja kiválasztani a kívánt számlát. Miután hozzáadta a számlát, a számla megjelenik az ablak felső részében, mellette a vásárló azonosítója mezővel és a “Végrehajtás” gombbal.
Miután megadta a Vásárló azonosítóját (refundáció esetében kötelező megadni a vásárló azonosítóját) a “Végrehajtás” gombra kattintva tudja a refundációt elvégezni.
A refundált számla egy új felugró ablakban jelenik meg. A számla alatti linkre kattintva tudja letölteni vagy kinyomtatni a számlát.
FIGYELEM miután refundált egy számlát, szükséges, hogy készítsen egy másolatot a refundált számláról (arról amelyet az előző lépésben kapott meg), a másolatot a “Másolat készítése” gomb segítségével tudja létrehozni!
Előszámlából számlát
Amennyiben adott ki előszámlát, ezen funkció segítségével néhány kattintással eladási számlát készíthet belőle
A funkció hasonló számlakeresést használ, mint a fentebb említettek, a különbség csupán annyi, hogy nem lehet számla típust változtatni (csak előszámlát lehet keresni). Olyan előszámla, melyből már készült eladási számla, nem jelenik meg a keresés eredményei között. Igy egy előszámlából nem lehet több eladási számlát készíteni.
A számla kiválasztási és végrehajtási folyamata a másolat készítésével megegyezik.
Termék keresés és számlához adás
Ebben a mezőben megkeresheti azokat a termékeket, amelyeket a fiszkális számlán szeretne megjelentetni. Itt csak azon termékek közül kereshet, amelyek már megtalálhatóak a Netračuni rendszerében. Vagyis azok a termékek közül, amelyeket ön már a Termékek menüpont alatt létrehozott a rendszerben.
Termékeket kereshet: Egyéni kód alapján (ha a termék létrehozásakor egyéni kódot határozott meg a terméknek), Bárkód alapján (ha a termék létrehozásakor beírta a termék bárkódját), valamint a Termék neve alapján.
A “Termék keresése” mezőbe kezdje el begépelni a keresett termék megfelelő azonosítóját (attól függően, hogy mit állított be a fentebbi választások közül). A keresés eredménye a kereső mező mellett fog megjelenni.
Ha az első eredmény (vagy az egyetlen) a kívánt termék, az Enter gomb megnyomásával, vagy az egérrel való rákattintással lehet a számlához adni. Mielőtt a számlához adódna, egy felugró ablak rákérdez a mennyiségre. Ha az alapmennyiség megfelel, egy újabb Enter vagy a “Hozzáad” gombra kattintással lehet a terméket a számlához adni. Ha a felkínált mennyiség nem megfelelő, akkor írja át a megfelelő számra. A “Mégsem” gombbal lehet lemondani a termék hozzáadásáról.
Újabb termékeket a fenti módon lehet hozzáadni a számlához.
Az “Új termék hozzáadása a számlához” gomb segítségével lehet olyan termékeket vagy szolgáltatásokat a számlához adni, melyeket előzőleg nem hozott létre az adatbázisban/Netračuni rendszerében.
Miután a gombra kattintunk, egy felugró ablak nyílik.
Itt megadhatjuk a termék adatait és a mennyiséget. Miután kitöltöttük az adatokat a “Hozzáadás a számlához” gomb segítségével adjuk hozzá a számlához. Ennél a megoldásnál a termék továbbra sem lesz elmentve az adatbázisba, csak ezen egyszeri alkalommal lesz a számlához adva.
Amennyiben a “Mentés és hozzáadás a számlához” gombra kattintunk, a terméket egyidőben elmentjük az adatbázisba és a számlához is hozzáadjuk. Így legközelebb már rákereshet az új termékre, név vagy bárkód (ha megadta) alapján.
Az új termék számlához való adásához szükséges adatok:
- Termék neve - a termék elnevezése
- Termék egységára - a termék ára egy egységre
- Termék mértékegysége - a mértékegység amely a termékre vonatkozik
- Adókulcs - legalább egy adókulcsnak kell a termékhez tartoznia
- Bárkód - a termék bárkódja, nem kötelező
- Mennyiség - a kiválasztott mértékegység alapján mekkora mennyiséget kíván a számlához adni
Számlán lévő termékek listája
A kassza alsó részében található táblázatban vannak felsorolva a számlán lévő termékek.
A táblázat adatai:
- Sorszám - hanyadik termék a számlán
- Elnevezés - a termék neve
- Mennyiség - az adott termék mennyisége. A ceruza icon segítségével meg lehet változtatni a mennyiséget!
- Mértékegység - a termék mértékegysége
- Egységár - a termék egy egységnyi ára
- Összesen -a termék összértéke a számlán
- Törlés -a terméket a piros szemetesláda ikon segítségével törölheti a számláról
- A táblázat alatti Összesen -a számla összértéke minden rajta lévő terméket beleszámítva.
A “Fizetés” gombra kattintva lehet a számlát megfizettetni és ezzel lezárni. Amikor rákattintunk a “Fizetés” gombra egy felugró ablak nyílik meg, mely tartalmazza a megfizettetés fajtáit.
Miután kiválasztottuk a fizetés fajtáját a “Fizetés” gombra kattintva nyugtázhatjuk a számlát. A “Mégsem” gombbal zárhatjuk az ablakot és folytathatjuk a számlát szükség szerint.
A számla nyugtázását követően, a rendszer elküldi azt az adóhivatalnak hitelesítés céljából. Ez pár másodpercig eltart. Ha sikeresen lehitelesítették a számlát, a fizetés ablak lezárul és helyette egy új ablak nyílik, melyben megjelenik a fiszkális számla.
A számlát a “Számla letöltés pdf formátumba” gomb segítségével tudja letölteni vagy kinyomtatni. FIGYELEM az új felugró ablak csak a zsurnált tartalmazza, a teljes számlát pdf formában tekintheti meg.
A számla előzetest a “Bezár” gombbal tudja bezárni, és új számlát kezdhet!
Számlák
Amennyiben az eddig létrehozott számlákat szeretné áttekinteni, kattintson a “Számlák” fő menüpontra. A keresés mezőben kereshet számlaszám és összeg alapján. Az eddig létrehozott számlákat táblázatos formában láthatja. A táblázat első oszlopa a számlaszámot tartalmazza (az adóhivatal által küldött számlaszámot), majd a számla típusa és a számla összege következik. Az utolsó “Műveletek” oszlopban a számlát megtekintheti pdf formátumban, letöltheti merevlemezre valamint a nyílra kattintva minden részletét megtekintheti.
Számla részletes megtekintése
A részletes megtekintés megmutatja a számlán lévő termékeket és azok értékeit, a fiszkalizáció státuszát megtekintési lehetőséggel. Ha a számla nem volt visszatérítve, lehetőség van refundációra. Valamint megtekinthető a számla zsurnálja.
A “Jelentés” gomb segítségével lehet napi, vagy más kiválasztott időközi jelentést készíteni az üzlet forgalmáról.
A gomb egy felugró ablakot nyit meg, amely lehetőséget ad a dátumtól dátumig időhatár megadására. Amennyiben a mai napi jelentést szeretné megtekinteni, ezen mezőket nem szükséges állítani!
A “Jelentés” gombra kattintva készíthetjük el a jelentést
A jelentés pdf formában fog megjelenni és letölthető.
A jelentés tartalmazza
- Cég adatait a bal felső sarokban
- Jelentés neve a megadott dátumtól a megadott dátumig
- Ukupan izlazni promet táblázat a normál eladás termékeit sorolja fel, azok mennyiségét, átlag és össz értéket, majd összegzi az össz bevételt és a bevételre fizetett össz adót.
- Ha volt visszatérítés-refundáció, egy táblázat felsorolja a visszatérített termékeket, azok mennyiségét és értéket, majd összegzi a teljes visszatérítést és a visszatérített adót.
- Plaćanje po vrstama - ebben a táblázatban megtekintheti a bevételeket fizetési módok szerint. Ha volt visszatérítés, ugyanezt megtekintheti a visszatérítésre is.
- Pazar - kizárólag készpénzes forgalmat jelent és más fizetési módot nem tartalmaz. Vagyis, ha a fizetés kártyával,mobiltelefonnal vagy csekkel történt, akkor ezen összegeket a Pazar összege nem tartalmazza.
- Összegzés a bevételről, visszatérítésekről és az adóról.
Cégével kapcsolatos tudnivalók
Amennyiben ön már regisztrálta vállalkozását/cégét a Netračuni rendszerében, a főmenü jobb felső sarkában olvashatja az ön által megadott cég nevet.
Ezen legördülő menü Cég beállítások pontjára kattintva megtekintheti a cégéhez kapcsolódó információkat, amelyek a következők:
Cég általános információk: cége jóváhagyásának ideje a Netračuni rendszerében, a már felhasznált és az eddig összesen megvásárolt számlák száma, a megvásárolt Fiszkális-számla csomag felhasználási dátuma.
Virtuális Certificate: Az ön cége adminisztrátorának személye és e-mail címe a Netračuni rendszerében, a Certificate adatai és a PAK kódja. FIGYELEM amíg ezen rész nincs kitöltve nem használhatja a kasszát!
Cég adatok: Cége általános adatai, amit regisztrálás alkalmával megadott. Van lehetőség módosításra, de lehetséges újra igazolást okozhat!
Számla beállítások Az “új logó kiválasztása” gombra kattintva feltöltheti cége logo képét. A számla üzenete mezőben vásárlóinak üzenhet. Az itt beírt üzenet megjelenik minden kiadott számlán pl. Köszönjük a vásárlást!, Nismo u sistemu PDV-a, stb. Az üzenet hossza maximum 255 karakter lehet. Választhat számla sablont (csak a fiszkális számla, fiszkális számla + táblázatos áttekintéssel) A sablon alatti linken meg lehet tekinteni a sablon kinézetét.
FIGYELEM Amennyiben változatott valamit a már meglevő mezők tartalmán ne felejtse elmenteni a “Mentés” gomb segítségével. Minden részhez külön mentés gomb tartozik.
Vásárlók
A legördülő menü Vásárlók pontjára kattintva, kilistázva megtekintheti az eddig mentett vásárlókat, táblázat formájában, akiknek eddig kiállított számlát vagy bevitte őket későbbi számlakiállításra.
Amennyiben ön még nem hozott létre vásárlót/nem adott hozzá vásárlót a listához, az ön listája üres lesz. A kassza használatánál ellenőrizheti a vásárló adó száma (PIB) alapján, hogy létezik-e már az ön rendszerében az adott vásárló. Amennyiben nem létezett és a nemzeti bank oldalán sem találja meg a rendszer, akkor az adott vásárlót hozzá tudja adni a pertnerekhez.
Amennyiben még nem létező vásárlót szeretne létrehozni - a táblázat jobb felső sarka feletti “ÚJ VÁSÁRLÓ LÉTREHOZÁSA“ gombra kattintva teheti ezt meg.
Új vásárló létrehozását a rendszerben a Vásárló cég adatai megadásával kell kezdeni. Ezek a következők:
- Adószám - vásárló adószáma (PIB)
- Nyilvántartási szám - vásárló nyilvántartási száma (Matični broj)
- Cégnév - vásárló hivatalosan bejegyzett neve
- Város - a város neve, ahol a vásárló cég bejegyzésre került
- Irányítószám - a város postai irányítószáma, ahol a vásárló bejegyzésre került
- Cím - vásárló székhelyének bejegyzett címe
Majd kattintson a “Mentés” gombra. Ezzel a művelettel az újonnan létrehozott vásárló bekerült a Vásárlók listájába. A “Vissza a listához” gombra kattintva tekintheti meg. A vásárlók listájában a kék ceruza ikonra kattintva megtekintheti a vásárló adatait és változtathat is rajtuk. A változtatás után kattintson a “Mentés” gombra. Ha szeretne törölni egy bizonyos vásárlót a listáról, akkor kattintson a piros szemeteskosár ikonra. Törölni csak azokat a vásárló cégeket tudja akiknek még nem adott ki számlát.
Számlacsomagok
A legördülő menü Számlacsomagok pontjára kattintva, választhat és vásárolhat további Fiszkális-számla csomagot, illetve itt nyomon követheti, hogy eddig mely Fiszkális-számla csomagokat vásárolta meg, azok állapotát, a vásárlás időpontját és hogy az adott csomagot mely dátumig tudja felhasználni.
Amennyiben csomagot kíván vásárolni, kattintson a kiválasztott csomagon lévő “Vásárlás” gombra. Miután megerősítette vásárlási szándékát egy felnyíló ablak részletes információt ad a csomagról és a fizetési lehetőségről. Jelenleg Banki átutalás vagy IPS QR kódos fizetéssel lehet vásárolni!
Miután minden szükséges információt megtudott a “Bezár” gomb segítségével zárhatja be az ablakot.
A rendelések között ilyenkor megjelenik megrendelése. A sárga háromszög ikon felkiáltójellel azt jelöli, hogy befizetése még nem érkezett meg, vagy még nem evidentáltuk. Amikor megérkezik, a jel zöld karikában pipára vált, és ezután tudja majd használni a megvásárolt Fiszkális-számla csomagot.
A fizetési utasítás megtekintése linkre kattintva bármikor újra ellenőrizheti a fizetési információkat.
Felhasználóval kapcsolatos információk
A felhasználói beállítások a főmenü utolsó menüpontja. Amely vagy nevének kezdőbetűiből vagy a feltöltött “profil képből” áll. Ezen legördülő menü Felhasználó profilja pontjára kattintva megtekintheti a felhasználóhoz kapcsolódó információkat, amelyek a következők
Felhasználó adatok: mint felhasználó ide feltölthet egy profilképet, ami csak az ön oldalán lesz látható. A Név mező a regisztrációkor megadott nevet tartalmazza. Az e-mail cím a megadott és megerősített e-mail címe. FIGYELEM ha megváltoztatja e-mail címét, akkor azt újra igazolni kell! A nyelv legördülő menüből kiválaszthatja, hogy Szerb vagy Magyar nyelven kívánja használni az oldalt. Amennyiben változtatott valamit a mezőkben a “Mentés” gomb segítségével mentheti el a változásokat.
Jelszó változtatása: Ebben a részben változtathatja meg jelszavát. Az első mezőbe az aktuális jelszót kell beírni, a másodikba az újat és a harmadikba újra gépelni az új jelszavat. Majd a mentés gomb segítségével elmenteni. FIGYELEM ez a jelszóváltoztatás nem alkalmas elfelejtett jelszavak megváltoztatására. Az a bejelentkezésnél lévő “Elfelejtettem a jelszavam” linken keresztül lehetséges!
Kétszintű azonosítás (2FA): Amikor a kétszintű azonosítás aktív, egy biztonsági azonosító kódot kell beírni bejelentkezéskor. Ez a kód a telefonján levő Authenticator appban elérhető (pl. Google Authenticator).
Amikor aktivizálni kívánja, kattintson a “Bekapcsolás” gombra. Egy felugró ablak kérni fogja a jelszavát. A folytatáshoz írja be a jelszavát, majd kattintson a “Megerősítés” gombra.
A kétszintű azonosítás befejezéséhez olvassa be a QR kódot a telefonján lévő Authenticator appba, vagy használja a beállítási kódot, és az appból kapott egyszer használatos kódot írja be.
Ezek után mikor bejelentkezni kíván a rendszer kérni fogja, hogy írja be a kódot az Authenticator appból, miután megadta a jelszavát.
Fiók törlése: Fiókja törlésével törli minden adatát a Netračuni rendszeréből! FIGYELEM ha volt még aktív Fiszkális-számla csomagja vagy Webáruház-csomagja és ezek felhasználási ideje a Fiókja törlésének időpontjában még nem járt le, akkor ezek is törlődni fognak. Cégünk NEM téríti vissza, ha maradt még rendelkezésre álló számlája illetve ha a csomagok használati időpontja még nem járt le!
API integráció
Applikációnk lehetőséget nyújt külső webáruháznak a kasszához való csatlakozásra API-on keresztül. A csatlakozás kódolást igényel a webáruház oldalán, így csak akkor elérhető, ha hozzáférése van a webáruház forráskódjához!
Mielőtt a fejlesztést elkezdene, szükséges, hogy készítsen egy API tokent, melynek segítségével tud majd komunikálni az API-al.
A token készítése a következőképpen zajlik:
A menüpont kiválasztása után adjon nevet a tokenjának és kattintson a “Készítés” gombra. Egy felugró ablakon meg fog jelenni a token, ezt másolja ki és mentse el. FONTOS: ez a token az Ön biztonsága érdekében csak egyszer jelenik meg, és nincs lehetőség újra lekérni!
A tokenek kezelése részben megjelenik a token a megadott név alatt. Amennyiben nincs tovább szüksége rá, itt törölheti a tokent. Ha frissíteni kívánja a tokent, először törölje, majd készítsen újat.
FIGYELEM! Amennyiben olyan tokent töröl, amely a webáruházában használatban van, az API-t nem tudja tovább használni régi/törölt token segítségével. Ha új tokent készített, a webáruházban is ki kell cserélni az új tokenra!
WooCommerce plugin
A következő fejezetben részletes leírásra kerülnek a szükséges tudnivalók az WooCommerce plugin használatához.
Telepítés
A plugin telepítése zip fájl segítségével történik, részletes leírást a pluginok telepítéséről a WordPress dokumentációjában talál.
Beállítások
A plugin telepítése után nyissa ki a WooCommerce/Settings/NetRačuni beállítások oldalt és írja be (másolja) az API key mezőbe az API tokent. Válassza ki a szerver környezetet amelyiket használni szerené test server vagy live server.
A token sikeres mentése után (a Save changes gombra kattintva), megjelenik az alapértelmezett adókulcsok beállítására szolgáló mező. Ezt az adókulcsot akkor használjuk ha a terméknek nincs külön beállított adókulcsa. Ha az összes terméke ugyanazt az adókulcsot használja elegendő csak az alapértelmezett adókulcsot beállítani.
Ha a temékei küldönböző adókulcsba tartoznak, a termékek beállításánál a NetRačuni tabon beállíthatja az egyes termékek adókulcsait. A adóhivatal meghatározása szerint egy termékhez tartozhat több adókulcs is.
Számlázás
Miután befejezte a beállítás lépéseit a NetRačuni plugin készen áll a fiszkális számlák kiadására. A rendelés részleteinél megjelenik a NetRačuni gomb.
A NetRačuni gombra kattintva megjelenik a számlázásra szolgáló szekció. Itt beállíthatja, a fizetés módot és a vásárló azonosítóját. A vásárló azonosító nem kötelező, és általában készpénzszámla kiadásakor kell használni. Ebben az esetben válassza ki a PIB opciót és írja be a vásárló PIB számát az alsó mezőbe. A vásárló azonoítókról bővebb tájékoztatást az adóhivatal doumentációjában talál. A "Kreiraj račun" gombra kattintva a rendelés adatait elküldjük a NetRačuni rendszerébe és elkészül a fiszkális számla.
A sikeres számlázás után megjelenik a link amellyel letöltheti a fiszkális számlát.
A számla kiküldése a vásárlónak
Amennyiben a fiszkális számlát még az előtt elkészítette, hogy a rendelés a "Completed" fázisba kerülne, a fiszlális számlát automatikusan csatoljuk az e-mailhez amelyet a vásárló kap. Egyéb esetben, ha ez az e-mail ki van kapcsolva a WooCommerce beállításokban (WooCommerce/Settings/Email), vagy a fiszkális számlát az e-mail kiküldése után készítette el, a számlát töltse le a NetRačuni szekcióból és küldje el a vásárlónak elektronikus úton: e-mailben vagy más módon (viber, whatsapp, messenger, stb).
Előszámla, visszatérítés és egyéb funkciók
A WooCommerce plugin csak eladási számlát készít (Promet Prodaja). Amennyiben előszámlát szeretne kiadni, vagy számlát visszatéríteni, azt a NetRačuni felhasználói felületén teheti meg.
API integráció - technikai leírás
A következő fejezetben részletes leírásra kerülnek a szükséges tudnivalók az API használatához. Az integráció elvégzéséhez programozói szaktudás szükséges.
Authentikáció
Minden egyes request headerje kell, hogy tartalmazzon Autorization Bearer tokent.
headers: {"Authorization" : `Bearer ${tokenStr}`}
Ahol a tokenStr a token készítésénél generált tokent tartalmazza (a token mindig “net_racuni_” előtaggal kezdődik ).
Amennyiben van érvényes tokenja, az lehetővé teszi a kommunikációt az API-al.
Elérhető végpontok (endpoint)
Ping
Request típusa: GET
Cím: https://netracuni.com/api/ping
Request data: nincs
Használata:
Kapcsolat ellenőrzése a webáruház és az api között, valamint az API és a TaxCore VSDC (adóhivatal szervere) között.
Response:
Ha minden rendben van: ‘Ok’. Http response code: 200
Ha valami hiba történik: hiba üzenet. Http response code: 417, 401, 404
Az üzenetet az error.response.data.message (javascript) felépítésben tudja elérni.
Példa integráció javascript :
function ping() {
axios.get(webApiBaseUrl + 'ping', { headers: {"Authorization" : `Bearer ${tokenStr}`} })
.then((res) => {
console.log(res.data); //Ok
//Code
})
.catch((e) => {
console.log(e.response.data.
message); //Some error message
//Handle error
});
}
Lehetséges hibák, és a hozzátartozó üzenetek:
- Not found, code 404 - Az API url nem megfelelő, vagy a szerver nem elérhető
- Unauthorized, code 401 - A token nem megfelelő
- Company not found, code 417 - A cégének regisztrációja nem található adatbázisunkban
- Company name is not yet verified, code 417 - Cége még nem lett hitelesítve rendszerünkben
- Company name no uploaded certificate, code 417 - Még nincs beállítva fiókja a számlázásra
- Tax Core error message, code 417 - A TaxCore-tól (adóhivatal szerverétől) visszakapott hibaüzenet, álltalában hibás certificate vagy pak.
Tax labels
Request típusa: GET
Cím: https://netracuni.com/api/tax-labels
Request data: nincs
Használata:
Lekérhetők a jelenleg aktuális adókulcsok.
Példa integráció javascript :
function taxLabels() {
axios.get(webApiBaseUrl + 'tax-labels', { headers: {"Authorization" : `Bearer ${tokenStr}`} })
.then((res) => {
console.log(res.data); //Array of tax labels
//Code
})
.catch((e) => {
console.log(e.response.data.
message); //Some error message
//Handle error
});
}
Példa response:
(9) [{…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}]
0: {order_id: 1, name: 'ECAL', category_type: 0, label: 'F', rate: 11}
1: {order_id: 2, name: 'N-TAX', category_type: 0, label: 'N', rate: 0}
2: {order_id: 3, name: 'PBL', category_type: 2, label: 'P', rate: 0.5}
3: {order_id: 4, name: 'STT', category_type: 0, label: 'E', rate: 6}
4: {order_id: 5, name: 'TOTL', category_type: 1, label: 'T', rate: 2}
5: {order_id: 6, name: 'VAT', category_type: 0, label: 'A', rate: 10}
6: {order_id: 6, name: 'VAT', category_type: 0, label: 'B', rate: 0}
7: {order_id: 6, name: 'VAT', category_type: 0, label: 'Ж', rate: 19}
8: {order_id: 7, name: 'VAT-EXCL', category_type: 0, label: 'C', rate: 0}
length: 9
[[Prototype]]: Array(0)
Hiba esetén ugyanazon kódok és hibaüzenetek mint a ping-nél.
Create invoice
Request típusa: POST
Cím: https://netracuni.com/api/create-invoice
Request data: Invoice Request Object, részletesen “Számlázás az API-on keresztül” cím alatt
Használata:
Számlázási kérelem elküldése és fiszkalizáció. FIGYELEM! Az Api -on keresztül csak normál eladási számlákat lehet készíteni!
Példa integráció javascript :
let invoiceRequestData = {
items: [
{
name: 'Test Item',
taxLabels: ['A'],
unit : 'KOM',
quantity: 2,
price: 152.66,
}
]
};
function createInvoice() {
axios.post(webApiBaseUrl + 'create-invoice', invoiceRequestData, { headers: {"Authorization" : `Bearer ${tokenStr}`} })
.then((res) => {
console.log(res.data); //Object
//Code
})
.catch((e) => {
console.log(e.response.data.
message); //Some error message
//Handle error
});
}
Példa response:
{invoice: {…}, invoice_pdf:
'http://local.netracuni.com
/invoices/
9abb03e1-ed05-41f5-9d5d-5463c46444e3/api-pdf'}
invoice:
address: "Sterijina 29"
businessName: "Wdev"
district: "Суботица"
encryptedInternalData: "dH4Acjw+/AQq+uiWJhMaMms
6VUcYm/low6/oDyVda
O7IbXVllxzdyY
8iTzH4gqNa1Ar9XWE
SRcCD9XkD0/Poq
UnqsloOdKiD6FrtDZbXX2CJ/
lh8A54z4RVTtSHxvIRcNgEJr+
yXVfzs8zuzdKGStbv
KL/684b4lp+WV0SGrl
NZU/xUSGOTnd47iFC1o
YiXKA06y9tgsk+Zg7JM4KbQ5F3
G3ynFqSNMZMPV0J5ou
+nmLlFfsRZEo7+AJdAa
vBRZQ8KIbrFQ6bI9bnY
/nAy6G53fWW2G+VkcI2X5XNy
DM5o/kqQOGY4bPZwn/RgU
+j4uvHLGpF+WeO5Lrp/abR7Rm5w=="
invoiceCounter: "296/577ПП"
invoiceCounterExtension: "ПП"
invoiceNumber: "9HXKXWGN-Dt1Ov1o0-577"
journal: "============ ФИСКАЛНИ РАЧУН ============
\r\nRS111879701
\r\nWdev
\r\nWdev
\r\nSterijina 29
\r\nСуботица
\r\nКасир: 1
\r\nИД купца: 10:256985
\r\nОпционо поље купца: 20:1234569
\r\nЕСИР број: 1.00
\r\n-------------ПРОМЕТ ПРОДАЈА-------------
\r\nАртикли
\r\n======================= =================
\r\nНазив Цена Кол. Укупно
\r\nTest Item(A) /KOM (A)
\r\n 152,66 2 305,32
\r\n----------------------------------------
\r\nУкупан износ: 305,32
\r\nВаучер: 305,32
\r\n======================== ================
\r\nОзнака Име Стопа Порез
\r\nA VAT 10,00% 27,76
\r\n----------------------------------------
\r\nУкупан износ пореза: 27,76
\r\n========================= ===============
\r\nПФР време: 29.11.2023. 18:49:06
\r\nПФР број рачуна: 9HXKXWGN-Dt1Ov1o0-577
\r\nБројач рачуна: 296/577ПП
\r\n========================== ==============
\r\n======== КРАЈ ФИСКАЛНОГ РАЧУНА =========
\r\n"
locationName: "Wdev"
messages: "Success"
mrc: "99-3411-Dt1Ov1o0"
requestedBy: "9HXKXWGN"
sdcDateTime: "2023-11-29T18:49:06.9741829+01:00"
signature: "TkdS4Bqv9U2XN
sMk2G+d4nsG1jGz4
XFVbyESVvnkVeTFgFd8v
qzLSnWKMYPHrX7arMsID
rSDsmNzU21408zgT69iq
eE9Kz4GwjxuDlJWuDygXk
4Cn7WlCGqg5QPkuyEizXR
F8JWucK2ibbXywDB68w
7/ALK3p94mTzgGCpU0s3
crtoOPnp0+Tz00xDB4lzVj
Vej7FxObfdeFW4BoupTN
20eMA7jLxc9Mtex2xmD1
0PgfwOVVIdXAZVr3IQU+
tLc9kLCHC4JnRSwVUblBHCOh
ss05cXuiTQuAWqOOFme
i1yFjvyGq5Ca6k1bkx
HtUFEtB7WL7gEd1s7wg
7cvb1JvTCQ=="
signedBy: "Dt1Ov1o0"
taxGroupRevision: 8
taxItems: [{…}]
Az invoice_pd key alatt egy url található, ahol elérhető a számla pdf formátumban. Ez a számla a fiókjában beállított számla sablon szerint jelenik meg. Részletek a “Cégével kapcsolatos tudnivalók” fejezetben.
Az invoice key alatt az adóhivatal által visszaküldött eredeti számla response található.
Minden elkészített számlát a NetRačuni fiókjában a “Számlák” menüpont alatt megtalál!
Számlázás az API-on keresztül
Számlája elkészítéséhez a fentebbi beállításokon kívül a következő adatokat szükséges küldeni az API-nak.
A számla kérelem adatát json formában kell küldenie.
Példa a teljes adat struktúrára:
{
paymentType: 5,
buyerId: '10:256985',
buyerOpt: '20:1234569',
items: [
{
name: 'Test Item',
taxLabels: ['A'],
unit : 'KOM',
quantity: 2,
price: 152.66,
}
]
};
paymentType (integer, opcionális): A fizetés típusa,
Értéke: integer 0-6 között
A számok jelentése:
- 0 - más nem készpénzes fizetés
- 1 - készpénz
- 2 - kártyás fizetés
- 3 - Csek
- 4 - Banki átutalás
- 5 - Utalvány ( vaucser )
- 6 - Mobil utalás
Ezt a mezőt nem kötelező megadni, amennyiben a mező hiányzik a számla készpénzes fizetéssel lesz számlázva!
buyerId (string, opcionális): A vásárló azonosítása.
A mező nem kötelező, amennyiben megadja a megfelelő formátumban kell elküldeni.
A mező formátuma code:document number.
Részletesen a kódok jelentéséről kérem tájékozódjon az Adóhivatal oldalán.
buyerOpt (string, opcionális): Vásárló opcionális mező.
Rendszerünk ezt a mezőt kizárólag utalványos fizetés (5) esetén veszi figyelembe, akkor viszont kötelező megadni a buyerId -val együtt.
A mezőnek hasonló formátuma van mint a buyerId nak.
A részletekről az adóhivatal dokumentációjában tájékozódhat.
items (array of objects, kötelező): A számlázni kívánt termékek listája.
Formája array of objects. Akkor is array-ba kell tenni, ha csak egy termék van a listán!
Minden egyes termék kell, hogy tartalmazzon öt mezőt. Ezen mezők kötelezőek, amennyiben akármelyik hiányzik, vagy nincs megfelelő formátumban, a számlázás nem fog sikerülni!
A termék mezői a következők:
- name (string, kötelező): A termék neve , maximálisan 2030 karakter (nem kell, hogy tartalmazza az adókulcsokat és a mértékegységet, azt rendszerünk csatolja hozzá!). Formátuma string.
- taxLabels(array, kötelező): a termékhez tartozó adókulcsok betűkódjai. Mindig array formátumban kell, hogy legyen. Minden termékhez legalább egy adókulcs kell, hogy tartozzon!
- unit (string, kötelező): A termék mértékegységének rövidített formája, pl: Kg, Kom, L stb. Formátuma string és maximum 5 karakter hosszú lehet.
- quantity(integer/float/double, kötelező): A termék mennyisége, minimum 0.001 maximum 9999999999.999 lehet, vagy egész szám, ha olyan a mértékegység. Formátuma szám, integer vagy float/double
- price(float/double, kötelező): A termék egységára dinárban, két tizedes pontossággal (pl: 100.00, 568.89). A termék összértékét a rendszer számolja quantity * price.
FIGYELEM!!! Az adatban a tizedes elválasztására “.” (PONT)-ot KELL használni, és nem szabad, hogy legyen benne “,” (VESSZŐ)!
Hibaüzenetek:
A ping esetében leírt hibaüzenetek is megjelenhetnek, valamint a számlakérelem validációjának eredménye, ami pontosan definiálja a hibát és hogy mit kell javítani a következő kérelemnél
A validációs hibák:
name field is required!
name field must be a string!
name field too long, max field length is 2030!
taxLabels field is required!
taxLabels field must be an array!
invalid tax label
unit field is required!
unit field must be a string!
unit field too long, max field length is 5 (example unit: KOM, L, M)!
quantity field is required!
quantity field must be a number!
quantity is too small!
quantity is too big!
price field is required!
price field must be a number!
price must be greater then 0!
No item in request
Failed to generate invoice, please check your invoice request data
Your Invoice packet has been expired, please buy new invoice packet at
https://netracuni.com/orders/
packets/invoices
No more available invoice, please buy new invoice packet at
https://netracuni.com/orders/
packets/invoices
buyer id send in wrong format, format must be code:document number
paymentType must be an integer between 0-6. 0-Other, 1-Cash, 2-card, 3-check, 4-bank transfer, 5-voucher, 6-mobile money
voucher payment type require buyer opt to be set
buyer opt send in wrong format, format must be code:voucher number
Rendszerüzenetek
Bizonyos esetekben a menü alatt egy színes mező jelenik meg különböző üzenetekkel és esetleges funkció gombbal.
Ezen üzenetek színüktől függően fontosak lehetnek.
Piros: Valamely fontos beállítás nincs beállítva, hiányoznak szükséges adatok, vagy valami miatt nem működik a számlázás vagy a Webáruház (például lejárt a Fiszkális-számla csomagja vagy a Bérelhető webáruház csomagja, vagy elhasználta az összes rendelkezésére álló számlát).
Sárga: Olyan figyelmeztetések, melyeket javasolt időben megoldani, mielőtt még a működést akadályozná a probléma (például két hét van még a rendelkezésére álló csomag lejártáig, kevesebb mint 3 rendelkezésre álló számla, stb.)
Kék: Információ jellegű üzenetek, az esetek többségében nem igényelnek sürgős intézkedést.
Lábléc
A lábléc cégünk lógóját, a program adóhivatal által kiadott hitelesítési kódját, cégünk adatait valamint e-mail címünket tartalmazza amelyen kapcsolatba léphet velünk.
