UNAS integráció: rendelések, készlet és számlázás automatikusan
Az UNAS saját, XML-alapú API-t kínál: a rendelések, termékek, készletek, vevők és szállítási módok programból kezelhetők. A számlázás, a raktár és a futárszolgálat így automatikusan követheti a webshopot — kézi exportálás és importálás nélkül.
Mit lehet automatizálni egy UNAS-integrációval?
- A számlázható rendelések lekérdezése, automatikus számla Számlázz.hu vagy Billingo rendszerben, majd a rendelés megjelölése számlázottként.
- Készlet és ár szinkronja a raktár- vagy ügyviteli rendszerből.
- Azonnali indulás új rendelésnél, webhookkal (VIP csomagban): komissiózás, futárcímke.
- Nyomkövetési adatok visszaírása a rendelésbe — 2025 novembere óta külső rendszer is beállíthat címkét és nyomkövetési linket.
- Vevők és vevőcsoportok szinkronja a CRM-mel.
Így működik az UNAS-integráció
01Hogyan kapcsolódunk?
Az UNAS API XML-üzenetekkel dolgozik, HTTPS-en. Az azonosítás az adminfelületen (Beállítások › Külső kapcsolatok › API kapcsolat) létrehozott API-kulccsal történik, amelyhez kiválasztható, mely funkciókat használhatja. A kulccsal kért token 2 óráig érvényes; új integrációban felhasználónév-jelszó nem használható.
Az API a PREMIUM és a VIP csomagban érhető el; a webhookokat adó automata folyamatokhoz VIP csomag kell.
02Webhookok és automata folyamatok
VIP csomagban az UNAS esemény alapján hívja a rendszerünket — például rendelés beérkezésekor, állapotváltozáskor vagy törléskor. A hívás hitelességét HMAC-aláírás igazolja, amit minden esetben ellenőrzünk. Az „azonnali” itt az eseményt követő 5 percen belüli hívást jelenti; a számlázáshoz és a szállításhoz ez bőven elég.
03Korlátok
Az UNAS szigorú hívásszám-korlátokat alkalmaz, ezért a szinkront ütemezzük és kötegeljük:
- IP-címenként óránként 2000 hívás PREMIUM, 6000 hívás VIP csomagban;
- 20 sikertelen hívás után az adott IP-cím 1 órára kitiltódik a webshopból;
- éjfél körül karbantartás lehet — erre az időszakra nem ütemezünk feladatot.
Amit leggyakrabban építünk
- 01
Számlázó a rendelésekből
A számlázó lekéri a számlázható rendeléseket, kiállítja a számlát, és visszajelöli a rendelést — a NAV-jelentéssel együtt, kézi exportálás nélkül.
- 02
Raktár → webshopkészlet
A raktár- vagy ügyviteli rendszer készletadatai ütemezetten, kötegelve frissülnek az UNAS-ban.
- 03
Rendelés → futárcímke → nyomkövetés
Az új rendelésből futárcímke készül, a nyomkövetési link pedig visszakerül a rendeléshez. Lásd: futárszolgálat-integráció.
Amire egy UNAS-integrációnál figyelünk
- 01
Üres mező = törlés
Az UNAS-nál a kihagyott XML-mező változatlanul hagyja az értéket, az üresen elküldött viszont törli. Egy rosszul összerakott frissítés így csendben adatot törölhet.
- 02
Az első hibánál megáll
Egy kérés elemeit az UNAS sorban dolgozza fel, és az első hibás elemnél megáll — a későbbiek feldolgozatlanok maradnak. Az eredményt ezért elemenként ellenőrizzük.
- 03
Lekérdezés mellékhatással
A rendelések lekérdezésekor egy beállítás a rendeléseket automatikusan számlázottnak jelölheti. Ezt tudatosan kezeljük, hogy egy próbalekérdezés ne jelöljön meg éles rendeléseket.
- 04
Kitiltás hibás hívásoknál
Sok egymás utáni hibás hívás az IP-cím ideiglenes kitiltásával jár, ezért hiba esetén nem ismétlünk vakon.
Gyakori kérdések
Melyik UNAS-csomagban érhető el az API?
Valós idejű az UNAS webhookja?
Kiválthatja az API a kézi exportot és importot?
Kapcsolódó integrációk
Források
- UNAS tudástár — API
- UNAS API — azonosítás
- UNAS API — limitációk
- UNAS API — megrendelések lekérése
- UNAS API — automata folyamatok
- UNAS API — webhook-ellenőrzés
- UNAS — API-fejlesztések
Utolsó szakmai ellenőrzés: 2026. október 4.
UNAS-integráció: kérj ajánlatot
Írd meg, milyen rendszereket használsz és mit szeretnél automatizálni — egy rövid, ingyenes egyeztetés után írásos, tételes ajánlatot adunk.