A különböző alkalmazások, integrációk térnyerésével egyre fontosabb szerepet tölt be egy webshop rendszernél az API interfész, hiszen ezen keresztül lehet külső programokkal elérni a webáruházak beállításait és az ott kezelt adatokat. Emiatt folyamatosan fejlesztjük és bővítjük mi is az Unas API végpontokat, hogy minél több funkció legyen használható ebből az irányból is. Ismerd meg te is a nyáron bevezetett új lehetőségeket! A hozzájuk tartozó adatszerkezeteket, a kérések és válaszok struktúráját az API dokumentációban találod.
get/setSticker
Nagy népszerűségnek örvend a matrica funkciónk, mellyel a termékeket tudod különböző módon megjelölni. Elkészültek a kapcsolódó API végpontok is: a getSticker használatával az áruházban már meglévő matricák és azok adatai kérhetőek le, míg a setSticker végpont segítségével új matrica hozható létre vagy meglévő módosítható, esetleg törölhető. A végpontok ugyanazt a funkcionalitást biztosítják, amit az adminisztrációs felületen keresztül is elérhetsz. A matricák termékekhez rendelése és lekérdezése továbbra is a setProduct és a getProduct végpontokon történik.
get/setSetting
Sok fejlesztőtől kaptunk korábban olyan jellegű kérést, mely szerint nem konkrét entitást (terméket, vásárlót, rendelést stb.) szeretne kezelni API-n keresztül, hanem a webáruházi működést, beállítást is vagy éppen a jogi dokumentumokat töltené fel ilyen módszerrel. Így alakítottuk ki a getSetting illetve a setSetting végpontokat, melyek inkább gyűjtő szerepet töltenek be, változó adatszerkezettel. Segítségükkel első körben az alábbiak érhetőek el:
- ÁFA kulcsok
- általános szerződési feltételek
- adatkezelési tájékoztató
- elállási nyilatkozat
- akadálymentességi nyilatkozat
- vásárlási tudnivalók
- devizanemek
get/setProductService
A termékekhez további plusz szolgáltatások köthetőek, így egyszerűen lehet értékesíteni pl. a díszcsomagolást, plusz garanciát, beüzemelési költséget a termékek mellé. Ugyancsak ezzel a funkcióval lehet a két éve bevezetett üveg visszaváltási rendszert (betétdíj, DRS), valamint a kötelező MPL szállításhoz esetlegesen kötődő felárat is megoldani. Mivel a szolgáltatások a termékek és így a velük való kereskedés szerves részét képezik, így szükségesnek láttuk, hogy API-ra is kivezessük ezeket. Így született meg a getProductService illetve setProductService végpont ezek menedzselésére. A matricákhoz hasonlóan itt is a termékekhez kapcsolódás a setProduct és a getProduct használatával oldható meg.
get/setGift és get/setBogo
Az egyik legnépszerűbb marketing funkció az ajándéktermék lehetősége, amikor bizonyos termékekhez vagy kosárértékhez köthető ajándék, így ösztönözve a vásárlót nagyobb kosárérték elérésére. Hasonló, de némileg különböző funkció a köznyelvben csak "1-et fizet, 2-őt vihet" lehetősége, azaz amikor gyakorlatilag mennyiségi kedvezményt alkalmazol a termékek értékesítése során, de a kedvezményre jogosító termékeknek nem kell azonosnak lenniük, illetve a kedvezmény mértéke is külön beállítható. Bár hasonló a két funkció és az adatok megadása, a könnyebb átláthatóság miatt ketté bontottuk API szempontjából is őket, így külön kezelhetőek az ajándéktermékek a get/setGift végpontokon és külön használhatóak a get/setBogo végpontok a mennyiségfüggő akciók kezelésére.