UNAS integráció: rendelések, készlet és számlázás automatikusan
A rendelés már a webshopban van, de a számlázóba és a raktári táblába még kézzel kerül át? Az UNAS integrációnál ezeket az adatátadásokat rendezzük. A cél az, hogy legyen egyértelmű gazdája a készletnek, a számlázásnak és az elakadt rendeléseknek is.
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ó
01Először nézzük meg a meglévő összekötéseket
Ha az UNAS-ban elérhető kész kapcsolat lefedi a számlázót, a futárt és a megszokott működést, érdemes abból indulni. A csatlakozás neve mellett azt is ellenőrizni kell, mely állapotokat és adatokat kezeli. A beállítás után egy teljes rendelési menetet próbáljunk ki, ne csak a kapcsolat létrejöttét.
Egyedi API-fejlesztés akkor lehet indokolt, ha saját ügyviteli rendszer, több értékesítési csatorna vagy külön jóváhagyási folyamat vesz részt a munkában. A rendszerintegráció felmérésekor a kész megoldást és az egyedi fejlesztést ugyanahhoz a feladatlistához hasonlítjuk.
02Rendelés, számla, készlet: ki mit dönt el?
A rendelés beérkezése, fizetése, számlázása és kiszállítása külön esemény. Meg kell mondani, melyik indítja a következő lépést, hol történik az adatjavítás, és mi állítja le a munkát lemondáskor. A számlázási szabályokat szükség szerint a könyvelővel is egyeztetni kell.
Készletnél legyen kijelölt elsődleges rendszer és termékenként egyértelmű azonosító. Külön kell kezelni a foglalást, a tényleges készletmozgást és a visszárut. A frissítés üteme és az esetleges késés üzleti következménye is a tervezés része.
- Mikor foglal készletet egy rendelés?
- Melyik esemény után számlázható?
- Mi történik módosítás, részszállítás és visszáru esetén?
- Ki kap jelzést, ha az adatátadás elakad?
03Hogyan 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.
04Webhookok és automata folyamatok
VIP csomagban az UNAS esemény alapján hívhatja a rendszerünket. A webhook hitelességét a dokumentált aláírás alapján ellenőrizzük. A dokumentáció az eseményt követő 5 percen belüli hívással számol; hogy ez belefér-e a készlet- vagy rendelési folyamatba, azt az adott működéshez kell eldönteni.
05Korlá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;
- az egymást követő sikertelen hívások is korlátozottak; az első tiltás 1 óra lehet, ismételt limitsértésnél hosszabb;
- éjfél körül karbantartás lehet — erre az időszakra nem ütemezünk feladatot.
06Próbarendelés és ellenőrizhető átadás
A sikeres rendelés mellett a hibás címet, az ismételt eseményt, a készlethiányt és a megszakadt adatátadást is szerepeltessük a tesztben. Ne keletkezzen véletlen éles számla vagy fuvarmegrendelés: a próbák környezetét és hatásait előre egyeztetni kell.
Az átadáskor látszódjon, melyik rendelés meddig jutott, hol javítható az elakadás és ki felel érte. A havi kézi munka felméréséhez az integrációs kalkulátor adhat kiindulást. A fejlesztési feladatot a jelenlegi rendszerek, a havi rendelésszám és a kivételek alapján lehet pontosítani.
07Fejlesztőknek: UNAS API gyorsreferencia
A leggyakoribb technikai kérdések röviden, a UNAS hivatalos fejlesztői dokumentációja alapján (ellenőrizve: 2026. november 4.). A részletes végpontlistát és a mezőket a lenti forrásokban találod.
- Felület: XML kérés és válasz. Minden funkció POST-hívás a https://api.unas.eu/shop/{funkció} címre, TLS 1.2 vagy 1.3 kapcsolaton; hibánál 400-as válasz jön egyetlen Error elemmel.
- Csomag: az API a PREMIUM és a VIP csomagban érhető el.
- Azonosítás: az API-kulcsot az adminban hozzuk létre (Beállítások › Külső kapcsolatok › API kapcsolat), ott adható meg, mely végpontokat használhatja. A login hívás az ApiKey-jel tokent ad, amely 2 óráig érvényes és Bearer fejlécben megy — nem kell minden hívás előtt újra belépni.
- Korlátok: IP-címenként óránként 2000 (PREMIUM) vagy 6000 (VIP) hívás; végpontonként 20, a loginnál óránként 5 hibás hívás fér bele. Túllépéskor az IP az adott boltra 1 órára letiltódik, ismétlődéskor egyre hosszabb időre. Boltonként legfeljebb 5 párhuzamos kérés; éjfél körül ±10 perces karbantartás van.
- Rendeléslekérés: a getOrder egy rendelésre óránként 1000 (PREMIUM) vagy 3000 (VIP), sok rendelésre 30 vagy 90 hívást enged, és egy hívás legfeljebb 500 rendelést ad vissza.
- Adatszabályok: a kihagyott elem változatlan marad, az üres elem törli az értéket; a több elemet tartalmazó kérés az első hibánál megáll. A dátumszűrő ÉÉÉÉ.HH.NN formátumú, az időmezők Unix-időbélyegek.
- Webhook és teszt: az Automata folyamatok webhook-művelete (VIP csomag) JSON-t küld, amely base64 HMAC-SHA256 aláírással ellenőrizhető (X-Unas-Hmac fejléc). Külön tesztkörnyezetet a dokumentáció nem említ, ezért próbarendeléssel és tesztadatokkal dolgozunk.
Amit leggyakrabban építünk
- 01
Számlázó a rendelésekből
Az egyeztetett állapotú rendelésből indul a számlázás. A bizonylat azonosítója és a feldolgozás eredménye visszakövethető; a rendelést csak a meghatározott sikerfeltétel után jelöljük számlázottnak. Hibánál javítható tétel marad, nem észrevétlenül kihagyott rendelés.
- 02
Raktár → webshopkészlet
A kijelölt raktári rendszer adata frissíti az UNAS-készletet. A termékazonosítókat és a készletfoglalás szabályait egyeztetjük; lemondás és visszáru esetére is kell folyamat. Az átadáskor ellenőrizzük, hogy egy megismételt üzenet nem okoz kétszeres módosítást.
- 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
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.

