Az alábbi bejegyzés célja, hogy bevált módszerekkel és konkrét információkkal valamint technikákkal elősegíteni a SalesAutopilot integrálhatóságát különböző egyedi fejlesztésű, valamint olyan webshopokkal, amelyekkel a SalesAutopilotnak nincs saját integrációja. Tehát az alábbiakban bemutatjuk, hogy milyen lehetőségeid vannak a webshopod és a SalesAutopilot összekapcsolására, ha nincs hozzá alapértelmezetten elérhető SalesAutopilot integráció.

A bejegyzés első felefőként a SalesAutopilot fiók kezelőjének készült – annak a személynek, aki átgondolja és felépíti a SalesAutopilotban a szükséges üzleti logikát. A bejegyzés második fele a fejlesztőnek/programozónak készül, aki az egyedi webáruházat összekapcsolja a SalesAutopilottal, méghozzá a SalesAutopilot API segítségével.

Ha a webshop integráció témájában ez az első cikk, amit olvasol, akkor kérlek mindenképpen nézd meg az ebben a fejezetben lévő cikkek közül a jelen cikket megelőző cikkeket:

Mely webshop marketing lehetőségekhez milyen integrációs előfeltételek tartoznak?

Az előző bejegyzésben található táblázat logikai folytatásaként az alábbi táblázatban bemutatjuk, hogy mely webshop marketing lehetőségekhez milyen integrációs előfeltételek tartoznak. Ezen előfeltételek megismerése segíteni fog az integráció konkrét megvalósításának megtervezésében. Ezen webshop marketing lehetőségek az Automatizált Vevőgyár Webáruházaknak kiadványunkból ismerhetőek meg teljes terjedelmükben.

Az alábbi táblázatból – főleg a 3. oszlopból – az derül ki, hogy MIT akarunk elérni az integráció során az egyes webshop marketing megoldások megvalósíthatósága érdekében, az oldal további részében találod, hogy HOGYAN tudja ezt egy fejlesztő/programozó megvalósítani.

Webshop marketing megoldás	Milyen SalesAutopilot logika valósítja meg?	Előfeltétel
Rendelés visszaigazoló emailek	A megrendelés lista + az email + feliratkozáskori időzítés	Minden rendelés kerüljön be az adott megrendelés listába Kerüljön be a rendeléssel együtt a megrendelés állapota, hogy aszerint lehessen beállítani az emailt, hogy valaki már kifizette esetleg kártyával, vagy csak később fogja valamilyen formában kifizetni a rendelést. Technikai okokból be kell kerüljenek a megrendelés listába a rendelt termékek is.
Használatot segítő, döntés megerősítő automatikus emailek Használatra rákérdező, használatban támogató, problémakezelő automatikus emailek	Megrendelés lista + emailek + relatív időzítés az emailekhez, mely relatív időzítések a feliratkozás (azaz a vásárlás) dátumához képest valahány napra vannak beállítva.	Minden rendelés kerüljön be az adott megrendelés listába Kerüljön (frissüljön) be a megrendelés állapota, hogy csak azok kapjanak ilyen emaileket, akik már kifizették a megrendelésüket. Annak érdekében, hogy az adott emailek konkrét termékekről vagy legalább termékcsoportokról szóljanak, be kell kerüljenek a megrendelés listába a rendelt termékek.
Vevőelégedettség mérő automatikus emailek küldése	A megrendelés lista + az email(ek) + relatív időzítés az email(ek)hez Adatmódosító űrlap (elégedettség mérés), melynek linkje az email(ek)ben van elhelyezve	Minden rendelés kerüljön be az adott megrendelés listába Kerüljön (frissüljön) be a megrendelés állapota, hogy csak azok kapjanak ilyen emaileket, akik már kifizették a megrendelésüket. Abban az esetben, ha nem csak általános, a boltra vonatkozó vevőelégedettséget akarsz mérni, akkor be kell kerüljenek a megrendelés listába a rendelt termékek, valamint a termékcsoport, amibe a termék tartozik.
Termék vásárlási múlt alapján szegmentált hírlevelek és értékesítési kampányok küldése	Egy központi lista amire a hírlevelek és kampány emailek kerülnek majd kiküldésre + a hírlevél/kampány email(ek) + levelek abszolút időzítése termék feltétellel (vagy termék feltételt tartalmazó szegmenssel) beállítva	Minden rendelés kerüljön be az adott megrendelés listába Kerüljön (frissüljön) be a megrendelés állapota, hogy csak azok kapjanak ilyen emaileket, akik már kifizették a megrendelésüket. Kerüljenek be a megrendelés listába a rendelt termékek, valamint a termékcsoport, amibe a termék tartozik.

Adatok átadásának technikai előfeltételei

A fenti táblázatból kiderül, hogy mely webshop marketing megoldáshoz milyen logika mentén valósítható meg a SalesAutopilottal, valamint hogy milyen logikai előfeltételei vannak ezek megvalósításának. Az alábbiakban tovább részletezzük, hogy a fenti 3. oszlopban található lépéseknek milyen konkrét technikai előfeltételei vannak, azaz hogy mit kell létrehoznod a SalesAutopilot fiókodban még mielőtt átadod a fejlesztőnek az összekapcsolás feladatát.

Fenti táblázatban megfogalmazott előfeltétel (3. oszlop)	Technikai előfeltétel
Webshopban leadott megrendelések kerüljenek be egy SalesAutopilot listába	A megrendelés listának és egy technikai űrlapnak léteznie kell (a részleteket lásd a Tudásbázis ide tartozó előző bejegyzésében). Automatikusan történik: A SAPI-ban automatikusan létrejönnek a termékek és szállítási fiz. módok a rendelések beérkeztekor.
Megrendelés állapotváltozások, illetve Megrendelés alapadatainak módosításakor módosított adatok kerüljenek be (frissüljenek) a SalesAutopilot megrendelés listában	Szükség van egy az előző pontban említett listához tartozó adatmódosító űrlapra, amin keresztül frissül majd a megrendelés állapota (félbehagyott, megrendelve, fizetve, stb.).
Elhagyott kosár tartalmak egy másik megrendelés listába átadásra kerülnek	Létre kell hozni erre a célra egy külön megrendelés listát és egy technikai űrlapot.
Hírlevél feliratkozók átadásra kerülnek egy hírlevél listába	Email listának és egy hozzá tartozó feliratkozó űrlapnak léteznie kell.

Adatok átadása SalesAutopilotból a webshopnak

A fentiek alapján elő tudtad készíteni SalesAutopilot fiókodat a webáruházadból érkező adatok fogadására. Az alábbiakban átadhatod a stafétát fejlesztődnek/programozódnak, aki konkrétan elvégzi majd az összekapcsolást.

A SalesAutopilotban bizonyos eseményekhez (pl. feliratkozás űrlapon, adatmódosítás űrlapon, átkattintás emailből, leiratkozás stb.) esetén lehetőség van callback (külső művelet) beállítására, amely többféle formátumban tud adatot visszaadni a Webshopnak.

Technikai részletek

API használata

Az integráció elvégzése előtt érdemes előbb "kizoomolni", és általánosságban megismerni a SalesAutopilot API használatát.

A SalesAutopilot API használtával kapcsolatos Tudásbázis bejegyzések itt találhatóak.
Az eCommerce célú API metódusok teljes dokumentációját itt találod.

Adatok átadása az API segítségével

Először API kulcsot kell létrehozni a SalesAutopilotban.

A megrendelések a processWebshopOrder API végpont meghívásával rögzíthetők a SalesAutopilotban.

Általános adatok

Törzsben átadandó paraméterek	Leírás
`email`	Megrendelő email címe
`mssys_lastname`	Megrendelő vezetékneve
`mssys_firstname`	Megrendelő keresztneve
`mssys_company`	Megrendelő cégneve
`mssys_mobile`	Megrendelő mobiltelefonszáma
`mssys_phone`	Megrendelő telefonszáma
`shipping_method`	Szállítási mód elnevezése.
`payment_method`	Fizetési mód neve. A webáruház által használt rövid elnevezés is lehet.
`currency`	Megrendelés pénzneme. A pénznem hárombetűs kódját kell használnia, pl. HUF, EUR.
`netshippingcost`	Szállítási költség nettó összege.
`grossshippingcost`	Szállítási költség bruttó összege.
`order_id`	Rendelés azonosítója a webáruházban.
`mssys_lastname`	Megrendelő vezetékneve. Nem kötelező adat.
`mssys_postal_company`	Postázási cégnév
`mssys_postal_country`	Postázási cím ország
`mssys_postal_state`	Postázási cím állam
`mssys_postal_city`	Postázási cím város
`mssys_postal_address`	Postázási cím utca, házszám
`mssys_postal_zip`	Postázási cím irányítószám
`mssys_bill_company`	Számlázási cégnév
`mssys_bill_country`	Számlázási cím ország
`mssys_bill_state`	Számlázási cím állam
`mssys_bill_city`	Számlázási cím város
`mssys_bill_address`	Számlázási cím utca, házszám
`mssys_bill_zip`	Számlázási cím irányítószám
`mssys_coupon`	A megrendelő által felhasznált kuponkód (pl. MCV2014)
`mssys_coupon_discount_amount_netto`	Kupon kedvezmény nettó értéke.
`mssys_coupon_discount_amount_brutto`	Kupon kedvezmény bruttó értéke.
`mssys_vat_number`	Megrendelő magyar adószáma
`mssys_eu_tax`	Megrendelő EU adószáma
`mssys_comment`	Megrendeléshez írt megjegyzés
`mssys_webshop_status`	Megrendelés állapota
`mssys_integration_type`	Webshopmotor neve

Rendelt termékek. A products altömbben kell átadni. Az egyes elemek paraméterei a következők lehetnek:

Paraméterek	Leírás
`prod_id`	Termék azonosítója vagy cikkszáma a webáruházban.
`prod_name`	Termék neve.
`category_id`	Termék kategória azonosítója a webáruházban.
`category_name`	Termék kategória neve.
`categories`	Ha a termék több kategóriába is tartozik, akkor a categories tömb elemeinként kell átadni a category_id és category_name értékeket. Például: `,categories: [{"category_id":1232,"category_name":"Egyik kategória"},{"category_id":1234,"category_name":"Másik kategória"}]`
`prod_price`	Termék nettó egységára.
`tax`	Termékhez tartozó áfa kulcs százalékban.
`qty`	Rendelt mennyiség.
`image`	Termék képének URL-je (rendelt termékek táblázatban felhasználható)
`product_url`	Termék URL-je a webshopban (rendelt termékek táblázatban felhasználható)

Hogyan készülj fel egyedi fejlesztésű webshopod SalesAutopilot integrációjára?