> For the complete documentation index, see [llms.txt](https://docs.packli.hu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.packli.hu/webshop-modulok-pluginok/unas.md).

# Unas

## UNAS integráció

A Packli az UNAS‑ban **beépített alkalmazásként** (embedded app) fut: az UNAS admin felületén belül, külön belépés nélkül kezeled a csomagfeladást.

### 1. Telepítés és összekapcsolás

1. Az UNAS adminban nyisd meg a **Külső kapcsolatok / Alkalmazások** menüt, és telepítsd a **Packli csomagszállítás** alkalmazást.
2. Nyisd meg az alkalmazást — az első megnyitáskor **kapcsold össze a Packli fiókoddal** (jelentkezz be a Packli fiókodba, vagy add meg a fiók adatait).
3. Sikeres összekapcsolás után három fület látsz: **Rendelések**, **Szállítási módok**, **Beállítások**.

> **Fontos:** az összekapcsoláshoz az UNAS API‑kulcsnak **olvasási és írási** (getOrder és setOrder) jogosultsággal is rendelkeznie kell. Az írási jog kell ahhoz, hogy a csomagszám és a címke visszakerüljön a rendelésre.

### 2. Beállítások

A **Beállítások** fülön add meg az alapokat:

* **Feladó raktár** — kötelező; innen veszi fel a futár a csomagokat.
* **Alapértelmezett Packli szolgáltatás** — ha egy rendelés szállítási módját nem sikerül párosítani, ez fut le tartalékként.
* **Alapértelmezett súly / méret** — ha a rendelésben nincs súly.
* **Csomagok bontása súlyhatáronként** — nagy súlynál automatikus dobozbontás.
* **Visszajelzés az UNAS felé** — kapcsold **be**, hogy a csomagszám, a nyomkövetési link és a **címke** visszaíródjon a rendelésre. (Alapból be van kapcsolva.)

#### Szállítási mód párosítás

A rendszer a rendelés UNAS szállítási módjának neve alapján ismeri fel a futárt. A **Szállítási módok** fülön kézzel is párosíthatsz: ha a szállítási mód neve tartalmaz egy megadott szövegrészt (pl. „GLS csomagpont"), a hozzárendelt Packli szolgáltatással készül a csomag.

### 3. Csomagpontok a pénztárban

Ha a vásárlóidnak csomagpontot / automatát kínálsz, a **Szállítási módok** fülön létrehozhatod a Packli szállítási módokat, és a rendszer feltölti hozzájuk az átvételi pontokat. Így a vásárló a pénztárban tud pontot választani.

### 4. Napi használat — rendelés feladása

A **Rendelések** fülön látod a beérkező rendeléseket.

1. Jelöld ki a feladandó rendelés(eke)t, majd kattints az **Átadás a Packlinak** gombra. Ekkor létrejön a Packli csomag (még címke nélkül). A súlyt, dobozszámot és a Packli szolgáltatást soronként módosíthatod.
2. Kattints a **Címke generálása** gombra — a futártól lekérjük a csomagszámot és a címkét. Ez pár másodpercet vesz igénybe.
3. A **Címke** linkről letöltheted a PDF‑et; a csomagszám és a címke a natív UNAS rendelés‑adatlapra is visszakerül.

Szűrhetsz **állapotra** és kereshetsz rendelésszámra / névre.

### 5. Hibaelhárítás

**„Nem adható fel" / nincs címke.** A leggyakoribb ok, hogy a rendelés **célországa nem támogatott** az adott szolgáltatással (pl. MPL házhozszállítás csak belföldre). Ilyenkor a rendszer nem hoz létre címkét, és a Rendelések listán a hiba oka is megjelenik. Válassz a célországhoz megfelelő szolgáltatást.

**A csomagszám / címke nem jelenik meg a rendelésen.** Ellenőrizd, hogy a **Visszajelzés az UNAS felé** be van‑e kapcsolva a Beállításokban, és hogy az UNAS API‑kulcsnak van‑e **setOrder** (írási) jogosultsága.

**A címke generálása után frissíteni kell az oldalt?** Nem — a rendszer automatikusan pollozza a generálás alatt lévő csomagokat, és frissíti az állapotukat.