Feed és API kapcsolatok
Tartalomjegyzék
Feed kapcsolatok
A termékek belistázására, illetve az ár- és készlet kezelésére lehetőség van feed kapcsolat kiépítésére. Több szolgáltatóval van kiépített kapcsolatunk, de egyedi, Pepita feed is létrehozható.
A termékek árát, készletét, leírást nem tudom se manuálisan, se exceles táblázattal szerkeszteni, kizárólag feedből. A szállítási költséget és időt tudjuk központilag is kezelni, illetve a feedben is adhatók át adatok. Részletes információkat a szállítási költségről az alábbi leírásunkban találsz: Szállítási költség meghatározása.
Kiépített kapcsolataink
Pepita feed
Pepita feed esetén az alábbi leírást kell figyelembe venni: https://pepita.hu/partners/xml-format
A feed esetében kötelező mezők az alábbiak:
- termék neve
- ID (cikkszám)
- GTIN (EAN kód vagy ISBN szám) (bizonyos kategóriák esetében)
- ár (bruttó értékesítési ár)
- pénznem
- készlet
- kategória
- termékleírás
- termékkép (URL)
Opcionálisan megadható elemek:
- elérhetőség
- gyártói cikkszám
- brand
- gyártó
- akciós ár
- szállítási idő (egyedi)
- szállítási költség (egyedi)
- garancia
- tulajdonság
- mellékletek (használati utasítás vagy biztonsági adatlap)
- youtube videó link
Variációs termékek esetében, a fentieken kívül a további adatok megadása is szükséges:
- főtermék
- variációs attribútum
Feed bekötésének lépései
Amennyiben feedet szeretnél bekötni, küldd el a dedikált kapcsolattartódnak vagy a [email protected] email címre a feed URL-t. Szükségünk lesz az alábbi információkra:
- vannak-e a feedben variációs termékek
- termék szintű szállítási költséget vegyen figyelembe a rendszer a feedből, vagy a központilag beállított értéket
- termék szintű szállítási időt vegyen figyelembe a rendszer a feedből, vagy a központilag beállított értéket
UNAS feed
Unas webáruház esetében a Beállítások / Külső kapcsolatok / Árösszehasonlító export, Feed menüponton keresztül válaszd a Pepita feedet.
Shoprenter feed
Shoprenter esetében a Marketing / Automatikus termékmegosztás menüpontban találhatók a feed-ek, ahol az emag feedet szükséges nekünk elküldeni.
EasySales feed
Easysales használata esetén az Integriációk / Piactér felületen kell megkeresni a Pepita HU piacteret, és a Csatlakozás gombbal, a szükséges beállítások elvégzése után létrejön a feed. Az „URL Feed”-re van szükség a termékek belistázásához.
WS feed
WordPresses webshop a WsFeed bővítményt ajánljuk. Amennyiben ezt használod, új feedet létrehozni a Beállítások / WsFeed Settings / Új feed fájl menüponton keresztül lehetséges. Két adatot szükséges megadni: a feed formátumát és egy tetszőleges szöveges leírást, ami segít a feed tartalmának beazonosításában. A feed mentését követően a Beállítások / WsFeed Settings / Feed lista felületen láthatóvá válik a feed fájl. Ez még nem használható, engedélyezni kell a Műveletek oszlopban elhelyezett zöld pipa ikonra kattintva.
Termékek belistázása
Az új termékeket a Pepita termékszerkesztő csapata dolgozza fel, a kategóriapárosítás és a szükséges mezők ellenőrzése után kerülnek elérhetővé az oldalon a termékek.
Amennyiben módosításra kerül egy termék elnevezése, leírása vagy képe, a rendszer automatikusan frissíti. A terméket manuálisan szerkeszteni nem tudod, a következő feed frissítés ezeket a módosításokat felülírná.
Ha problémát tapasztalsz a termékek frissítésével kapcsolatban, jelezd a dedikált kapcsolattartódnak vagy a [email protected] email címen.
Feed frissítése
A feedekből a készletet jellemzően óránként frissítjük (kivéve UNAS feedek esetében, 300 percenként, a korlátozott lehívási lehetőségek miatt). Ár és leírás frissítése naponta egyszer történik.
API kapcsolat
API kapcsolat kommunikáció iránya: Pepita → Partner áruház (push), azaz: A Pepitára történő rendelés érkezésekor a rendelés automatikusan továbbításra kerül a partner áruház által biztosított API végpontra. Ez a kommunikáció egyirányú, visszaszinkronizálásra jelenleg nincs lehetőség. Ez azt jelenti, hogy a rendeléseket manuálisan kell lezárni, de a saját rendszereteken belül tudjátok kezelni a rendeléseket, a számlát kiállítani, futárt rendelni, stb. Bizonyos szolgáltatókkal már van kiépített kapcsolatunk, de amennyiben igényled, saját API-t is fejleszthetsz.
Kiépített kapcsolataink
API beállításának lépései
Amennyiben szeretnéd beállítani rendeléstovábbításra az API kapcsolatot, küldd el nekünk a szükséges API kulcsokat. Mindenképp egyeztess a szolgáltatóddal a kapcsolat létrehozásának folyamatáról, amelyeket röviden az alábbiakban mutatunk be.
UNAS API beállítása
Ahhoz, hogy be tudjuk állítani az UNAS API-t, az UNAS felületén szükség van az API kulcsra. Ez a Beállítások –> Külső kapcsolatok –> API kapcsolat menüpont alatt hozható létre. Nekünk csak a ‘getOrder’ és ‘setOrder’ típusú végpontok szükségesek, így a hozzánk generált API kulcshoz ezt a kettőt kell bepipálni. Amint ez megvan, kiépítjük a rendelések automatikus beküldését az UNAS rendszerbe is.
A rendelések automatikus UNAS-ba küldéséhez az alábbiakra van még szükségünk:
- fizetési módok pontos megnevezése és azonosítója (előreutalás, utánvét, bankkártya)
- szállítási mód/módok pontos megnevezése és azonosítója
Ezekről egy-egy képernyőmentést is küldj részünkre az adott UNAS aloldalról, hogy elkerüljük az esetleges elírásokat. Ezekre azért van szükséges, hogy a nálunk alkalmazott fizetési és szállítási módokat meg tudjuk feleltetni az UNAS rendszerbe beküldött rendelési adatokkal.
Tharanis API
Amennyiben Tharanis ERP-t használsz, az alábbi útvonalon tudod létrehozni az API kapcsolatot: Törzsek / Értékesítés / Webáruházak. A felugró ablakban az „Új hozzáadása” funkcióval tudod létrehozni a Pepitás kapcsolatot.
EasySales API
Easysales használata esetén az Integriációk / Piactér felületen kell megkeresni a Pepita HU piacteret, ahonnan URL Comenzi-re van szükség az API kapcsolat létrejöttéhez.
Saját API fejlesztés
Amennyiben saját API kapcsolatot fejlesztenél, arra is van lehetőség, kattints IDE, és küldd el a dokumentációt a fejlesztődnek.
Bármilyen kérdés, kérés esetén kérjük, fordulj hozzánk bizalommal!
[email protected]
A Pepita Group csapata
