> 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/shopify.md).

# Shopify

## Shopify integráció

A Packli Shopify alkalmazása a Shopify adminba épül be: a rendelés‑adatlapon és a rendeléslistán kezeled a csomagfeladást, a pénztárban pedig a Packli szállítási módok és a csomagpont‑választó jelennek meg.

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

1. Telepítsd a **Packli** alkalmazást a Shopify App Store‑ból (vagy a kapott telepítő linkről).
2. A telepítés után **kapcsold össze a Packli fiókoddal** az alkalmazás megnyitásakor.
3. A telepítéskor a Shopify engedélyt kér a szükséges jogosultságokra (rendelések, szállítás). Fogadd el, hogy a Packli szállítási módokat és a címke‑visszaírást használni tudd.

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

Az alkalmazás **Beállítások** oldalán:

* **Feladó raktár** és alap paraméterek (súly, méret).
* **Szállítási mód párosítás** — ha a rendelés szállítási módjának neve tartalmaz egy megadott szövegrészt (pl. „GLS csomagpont"), a hozzárendelt Packli szolgáltatással készül a csomag. Szabályok nélkül a névből próbáljuk felismerni a futárt (GLS, DPD, Foxpost, MPL), egyébként az alapértelmezett szolgáltatás fut.

#### Pénztári szállítási módok

Ezek a Packli szállítási módok jelennek meg a **bolt pénztárában**, saját árukkal. Minden módnál beállítható:

* **Packli szolgáltatás** (házhoz / csomagpont / automata / postán maradó),
* **Árazási mód:** fix ár / súlytáblázat / API ár ± %,
* **Ingyenes X felett**, **súlyhatár**.

Csomagpontos szolgáltatásnál a vásárló a pénztárban **térképes csomagpont‑ választóból** választ átvételi pontot.

> **Megjegyzés:** a csomagpontos szállítási módokhoz a Shopify **Carrier Service** funkció szükséges (a Beállításokban a mentéskor a rendszer automatikusan regisztrálja).

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

**Egy rendelés (rendelés‑adatlap):**

1. A rendelés adatlapján megjelenik a **Packli** blokk.
2. Válaszd ki a **szállítási módot**, add meg a **súlyt** és a **dobozszámot**, majd **Feladás a Packlinak**.
3. **Címke generálása** — a futártól lekérjük a csomagszámot és a címkét.
4. A címkét a rendelés **Nyomtatás → Packli címke** menüjéből nyomtathatod.

**Több rendelés (rendeléslista):**

* Jelöld ki a rendeléseket, és a **More actions** menüből:
  * **Packli feladás (tömeges)** — csak feladás,
  * **Packli címke generálása (tömeges)** — feladás **és** címke generálás egyben. Pár másodperc múlva a **Print → Packli** menüből nyomtathatók.

> **Figyelem:** a Shopify beépített „Create shipping labels" gombja a Shopify saját címkéje, **nem** a Packli — a Packli címkéhez a fenti Packli funkciókat használd.

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

**Házhozszállításként kerül át egy csomagpontos rendelés.** A Packli a pénztárban választott csomagpontot automatikusan felismeri, és a csomagpontos szolgáltatással + a valódi címzettel (számlázási név/telefon) hozza létre a csomagot. Ha mégis házhozszállítást látsz, ellenőrizd, hogy a szállítási mód „Automatikus" beállításon áll‑e a Packli blokkban.

**Nem jön létre csomag a feladáskor.** Ellenőrizd, hogy a szállítási mód **Packli szolgáltatáshoz van‑e párosítva**, és hogy a **célország támogatott‑e** az adott szolgáltatással.

**A pénztárban nem jelenik meg a csomagpont‑választó / a Packli szállítási mód.** Ellenőrizd, hogy a **Pénztári szállítási módok** be vannak‑e kapcsolva a Beállításokban (és a mentéskor a Carrier Service regisztrálódott).