Ugrás a tartalomra

3525 Miskolc, Bodótetői út 1. 3. em. 9.

2021 Lorz Kft.

Webshopmotorok

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.

Automatizálás

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.
Hogyan működik?

Í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.
Tipikus megoldások

Amit leggyakrabban építünk

  1. 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.

  2. 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.

  3. 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ó.

Buktatók

Amire egy UNAS-integrációnál figyelünk

  1. 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.

  2. 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.

  3. 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.

  4. 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?
Az UNAS tudástára szerint az API a PREMIUM és a VIP csomagban érhető el; a webhookokat adó automata folyamatokhoz VIP csomag kell.
Valós idejű az UNAS webhookja?
A dokumentáció az eseményt követő 5 percen belüli hívást ír le. A szükséges reakcióidőt a saját rendelési és készletkezelési folyamathoz kell meghatározni; ez nem késleltetés nélküli működési ígéret.
Kiválthatja az API a kézi exportot és importot?
Igen: a rendelések, termékek, készlet és vevők az API-n lekérdezhetők és frissíthetők, ütemezve vagy eseményre.

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.

Ajánlatot kérek