# Rendelések és rendelési jegyzetek

> A rendelések és rendelési jegyzetek triggerszabályai, műveletei és keresései, valamint a leggyakoribb buktatók.

A rendelések a webáruház alapvető elemei: egy rendelési eseményt és annak szakaszait (fizetés, teljesítés, szállítás) képviselik.

## Két rendelés-trigger

A rendelés erőforrás kétféle triggerként érhető el:

- **Order**: minden rendeléshez külön Zapier-feladatot hoz létre.
- **Line Item in an Order**: minden megrendelt tételhez (termékhez) külön feladatot hoz létre. Ez jó megoldás, ha a tételek adatait külön-külön akarod a Zapierbe küldeni.

A kettő közül a trigger beállításakor választasz. Mindkettő ugyanazokat a triggerszabályokat támogatja, de az adatmezők kissé eltérnek. A rendelésekhez tartozik egy gyermek erőforrás is, a rendelési jegyzetek.

## Triggerszabályok

A triggerszabály azt határozza meg, melyik esemény küldje az adatokat a Zapnek.

> Ha a WooCommerce Subscriptions is használod, ezek a rendelés-szabályok az előfizetés-feliratkozási és megújítási rendelésekre is lefutnak. Ha egy másik Zapben előfizetés-triggert használsz, és ki akarod hagyni ezeket a rendeléseket a rendelés-Zapből, állítsd be így: 1. lépés: az **Order** trigger a kívánt szabállyal (például **Order paid**). 2. lépés: **Find Product** (a Product ID egyenlő az 1. lépés Line Items Product ID mezőjével). 3. lépés: **Filter**, ahol a 2. lépés **Type** mezője nem tartalmazza a `subscription` szöveget. 4. lépés: a kívánt művelet. Így a Zap csak nem előfizetéses termék vásárlásakor indul.

| Szabály | Mikor fut le |
|---|---|
| **Order created** | minden új rendelésnél, fizetettnél és fizetetlennél is. Ha csak fizetett rendelés kell, használd az **Order paid** szabályt. Az **Order updated** is lefut az első létrehozáskor |
| **Order deleted** | amikor a rendelés a kukába kerül. Csak ez a szabály fut le a kukázáskor (az **Order updated** és az **Order status changed** nem). A kukából való végleges törlés nem indít semmit. Csak a rendelés `ID`-ját küldi el |
| **Order paid** | online (azonnali) fizetésnél. Lásd lent |
| **Order restored** | amikor egy kukába tett rendelést visszaállítasz. Csak ez a szabály fut le |
| **Order status changed** | az állapotváltozásokra. Lásd lent |
| **Order updated** | meglévő rendelés frissítésekor vagy visszatérítésekor. Minden létrehozáskor is lefut, és az **Order status changed** mellett is, ha állapotváltozás történik |

A törlés típusú szabályoknál a WooCommerce korlátai miatt csak a törölt erőforrás azonosítója (`ID`) kerül a Zapierbe, más adatmező nem.

### Order paid

Ez a szabály az online (azonnali) fizetés rögzítésére való. A rendelés fizetett állapota nem kapcsolódik közvetlenül egy rendelési állapothoz. Gyakran a **Feldolgozás alatt** vagy **Teljesítve** állapot jelzi a fizetést, de ez nem mindig így van, mert az állapot a fizetési állapottól függetlenül is beállítható.

**Valós idejű fizetési módok** (Stripe, PayPal, a legtöbb bankkártyás átjáró): a WooCommerce automatikusan fizetettnek jelölheti a rendelést, és Feldolgozás alatt vagy Teljesítve állapotra állíthatja, de ez az átjáró támogatásától függ.

**Offline (halasztott) fizetési módok**: az **Order paid** szabály nem fut le átutalásnál (BACS), csekknél és utánvételnél. Ilyenkor két lehetőséged van:

- használd az **Order created** szabályt (fizetett és fizetetlen rendelésre is lefut);
- vagy egy **Order status changed** szabályt, például az **Order status changed to Processing** vagy az **Order status changed to Completed** szabályt.

### Order status changed

A rendelési állapotok a feldolgozás és teljesítés menetének fontos részei. A szabály szerint a (any status) változat minden állapotváltozáskor lefut, a rendelés létrehozását is beleértve. Ha csak egy adott állapotváltás érdekel, használj egy konkrét szabályt:

- Order status changed (any status)
- Order status changed to Cancelled
- Order status changed to Completed
- Order status changed to Failed
- Order status changed to On hold
- Order status changed to Processing
- Order status changed to Refunded

## Műveletek és keresések

A rendelési műveletek tételes (line item) mezői: a Kuponsorok, Díjsorok, Tételek, Metaadatok, Szállítási sorok és Visszatérítések. Ha ezekbe több értéket akarsz küldeni, tételes formátumban kell megadnod őket, amire a Formázó **Line Itemizer** átalakítása való (lásd [Műveletek és keresések](zapier-integracio-muveletek-es-keresesek/)).

### Create Order

Új rendelést hoz létre a WooCommerce-ben.

> Ha a WooCommerce kezeli a készletet, a Zapből létrehozott rendelés alapértelmezetten nem csökkenti a termékek készletét. Ha ezt kézzel akarod megoldani, a **Create Order** lépés után add hozzá: egy **Looping by Zapier** lépést, amely végigmegy a rendelés tételein, majd egy **Update Product Stock Quantity** lépést a **Reduce Stock Quantity By** beállítással az adott tétel mennyiségére.

### Update Order

Meglévő rendelést módosít. Mindig kötelező egy érvényes legfelső szintű azonosító (a rendelés azonosítója). A nem legfelső szintű azonosító nem kötelező, de ha üresen hagyod, a WooCommerce új bejegyzést hoz létre (például új metaadatot). Az azonosító kikereséséhez tegyél a lépés elé egy Find lépést.

> A WooCommerce 9.1 és újabb verzióiban, ha a Zapből a tételeket módosítod, a rendelés termékeinek készlete automatikusan frissül. A 9.0 és régebbi verziókban nem.

### Find Order

Megkeresi a rendelést. Ha nincs találat, opcionálisan létre is hozhat egyet. Ajánlott keresési mezők:

- **Search**: a számlázási címben, a szállítási címben, a számlázási vezetéknévben és a számlázási e-mail-címben keres a megadott szövegre.
- **Order ID**: a megadott (numerikus) rendelésazonosítóra keres.

## Rendelés-hozzárendelés (Order Attribution)

A WooCommerce 8.5 óta a bolt nyomon követheti, honnan érkeznek a rendelések. Ha ez be van kapcsolva, az adatok a rendelés metaadataiban vannak, és az **Order** Zapekben a következő mezőkön érhetők el: Meta Data Wc Order Attribution Device Type, Referrer, Session Count, Session Entry, Session Pages, Session Start Time, Source Type, User Agent és Utm Source. A **Line Item in an Order** Zapekben ugyanezek **Order Meta Data** előtaggal szerepelnek. Az adatok csak a bekapcsolás után létrehozott rendelésekhez érhetők el.

## Az adatmezők eltérhetnek a boltodban

A bővítmény a WooCommerce REST API-ját használja, ezért a mezők nevei, leírásai és értékei boltonként eltérhetnek. A boltod adatai, mezői és triggerszabályai függenek a WordPress és a WooCommerce verziójától és nyelvétől, az engedélyezett funkcióktól, az aktív bővítményektől és az esetleges egyéni kódoktól, amelyek módosítják a REST API működését.

## Rendelési jegyzetek

A rendelési jegyzetek az egyes rendelésekhez csatolt feljegyzések: belső megjegyzések (például állapotváltozások, teljesítési jegyzetek) vagy a vásárlónak szánt jegyzetek. A rendelés szerkesztésekor a jobb oldali jegyzetdobozban látod őket.

### Triggerszabályok

| Szabály | Mikor fut le |
|---|---|
| **Order Note created** | amikor jegyzetet adnak egy rendeléshez, a vásárlónak látható és a privát (csak adminisztrátoroknak szóló) jegyzeteknél is. Csak akkor fut le, ha a jegyzetet kifejezetten hozzáadják, a rendelés létrehozásakor nem |
| **Order Note deleted** | amikor egy rendelési jegyzetet törölnek. Csak az azonosítót (`ID`) küldi |

A WooCommerce nem teszi lehetővé a rendelési jegyzet módosítását, ezért Update művelet nincs.

### Műveletek

- **Create Order Note**: új jegyzetet hoz létre egy meglévő rendeléshez. Ha a **Customer Note** mező igaz (True), a jegyzetet e-mailben is megkapja a vásárló. Ha hamis (False), a jegyzet privát, és csak az adminisztrátorok látják.
- **Find Order Note**: megkeresi a meglévő jegyzetet, és ha nincs, opcionálisan létrehozhat egyet. Az első találatot adja vissza, a rendezést az **Order** és **Orderby** mezőkkel módosíthatod.

## Gyakori kérdések a rendelésekről

**Hogyan formázhatom a rendelés dátumát?** Alapértelmezetten a dátum egyetemes időbélyeg formátumú (ISO 8601). Ha más formátum kell, add hozzá a Zaphez a Zapier **Formatter** dátumformázó műveletét.

**Hogyan adhatom meg az adóosztályt?** Az alapértelmezett adóosztály angol neve „Standard”, további adóosztályokat pedig a WooCommerce adóbeállításai között, a **További adó osztályok** mezőben adhatsz hozzá (ez a fül akkor jelenik meg, ha az adókezelés be van kapcsolva). Amikor a termék- vagy rendelésadatok létrehozásakor, frissítésekor vagy keresésekor adóosztályt adsz meg, az osztály „slug” változatát kell használnod: kisbetűs név, szóközök helyett aláhúzással. Például a „Standard” `standard`, a „Reduced Rate” `reduced_rate` lesz.

**Sorszámozott rendelésszámok (Sequential Order Numbers Pro).** A trigger Zapekben a `number` mezőt használd, ne az `id` mezőt.