Webáruház interfész (Shoprenter) 4.0.153.56774 sERPa verziótól
1. Paraméterezés, folyamat
A Shoprenter webáruházban a DRS visszaváltási díj kezelése attól függ, hogy az Általános paraméter funkció / Pénzügy, számvitel fülén, hogy áll a "Termék eladási ára tartalmazza a visszaváltási díjat" pipa.
HA IGAZ
Semmi nem változik a webáruház működésben. Mivel az italtermék ára tartalmazza a visszaváltási díjat is, ezért az italterméket önmagában elég felküldeni a webáruházba, a webáruház visszaváltási díjjal együtt fogja listázni és a kosárba tenni, majd a rendelésbe is azzal együtt kerül. A sERPa a rendelést úgy veszi fel, hogy a termék árában benne van a visszaváltási díj is, csak a vevőszámla készítésekor fogja azt ketté választani és külön tételben a számlára tenni.
HA HAMIS (ajánlott működés)
Ha az italtermék ára nem tartalmazza a visszaváltási díjat, akkor fontos, hogy azt külön, kiegészítő információként felküldjük a webáruházba.
Ilyenkor küldjük ki a Product Addon üzenetben a visszaváltási díj információt az italtermékhez kapcsolt DRS visszaváltási díj termékből, majd kapcsoljuk össze a visszaváltási díjat az italtermékkel a webáruház oldalán.
Amikor a termék a kosárba, majd a rendelésbe kerül, akkor a Shoprenter külön információként (OrderProductAddon) fogja a termék mellett elküldeni, hogy milyen visszaváltási díj tartozik hozzá. Azonban ezzel a rendelés feldolgozásakor a sERPa nem fog foglalkozni, nem tárolja el, hiszen a sERPa működése szerint a vevőrendelés lezárásakor automatikusan felvesszük a DRS-es italtermékekhez virtuális szolgáltatás tételként a visszaváltási díjat, így az a sERPában tárolt információk alapján rákerül a rendelésre.
Fontos, hogy a megfelelő működéshez a webáruház adminisztrációs felületén a visszaváltási díjakat nem szabad módosítani a termékeknél, csak sERPa oldalról.
2. Termék üzenet
1. Visszaváltási díj termék (Product Addon Resource):
A sERPa terméktörzsben visszaváltási díjként jelölt (Általános paraméterben megadott DRS visszaváltási díj termékkategóriába sorolt) termékeket átadjuk a Shoprenter felé.
Ehhez a sERPa a Shoprenter API Product Addon hívását használja.
A visszaváltási díjakat nem kell besorolni a webshop paraméterben megadott termékbesorolásba, anélkül is felküldjük azokat a webshopba. Webshoponként nem kezeljük külön a visszaváltási díjakat, mindegyik visszaváltási díjat mindegyik webshopba felküldjük. A rendszer nem figyeli azt sem, hogy a visszaváltási díj bármelyik, webshopba küldendő termékhez hozzá van-e kötve.
2. Visszaváltási díj termék kapcsolat kialakítása (Product Addon Product Relation Resource):
Miután átadtuk a visszaváltási díj termékeket, a hívás hozzákapcsolja azokat a már felküldött italtermékekhez, amelyekhez visszaváltási díjat kapcsoltunk.
Csak azon italtermékek esetén jön létre kapcsolat, amiket egyébként is felküldünk a webshopba.
3. Terméktörzs változás figyelése
Az interfész figyeli a Termék funkció / További adatok fülén található Göngyöleg termék / DRS visszaváltási díj táblázat változását. Ha hozzáadunk vagy leveszünk egy visszaváltási díj terméket, a változásról értesítést küldünk a webshop felé.
Más terméktörzs változás esetén (akár a visszaváltási díj termék, akár az italtermék változik), felküldjük a változásokat a webshopba és frissítjük az összekötést is.
Ha a visszaváltási díj termék ára, neve, áfája változik, annak frissítését is elküldjük a Shoprenternek.
4. Új Shoprenter webáruház induláskor visszaváltási díj termékek felküldése
A kezdeti adatküldést ezeknél az információknál is van lehetőség scripttel elindítani, ami felküldi az összes visszaváltási díj terméket (Product Addon) és utána a már felküldött italtermékekhez kapcsolatot alakít ki (Product Addon Product Relation).
(A @Init=2 miatt a parancs nem hajtjuk végre azonnal, hanem legeneráljuk a később futtatandó script sorokat minden érintett termékre.)
EXEC web.ShopRenter_ProductAddonRelation @Debug = 1, @Init = 2
5. sERPa oldali rendelésmódosítás miatti változások küldése a DRS visszaváltási díj tételekre
Lehetőség van a paraméterben beállítani, hogy rendelések sERPában történő módosítását kiküldjük-e a Shoprenter felé. Ehhez a paraméterben a Rendelések szinkronizálása mező értékét kell igazra állítani.
Ilyen esetben jelenleg azonban a DRS visszaváltási díjakat tartalmazó tételek változását nem küldjük ki a Shoprenternek, mert a webáruház nem rendeléstételként, hanem külön mezőben kezeli a visszaváltási díjakat. Ennek fejlesztése várhatóan a 4.0.158-as verzióban készül el. Erről a verziótájékoztatóban adunk majd információt.
Webáruház interfész (NetGo) 4.0.156.57701 sERPa verziótól
1. Paraméterezés
A NetGo webáruházban a DRS visszaváltási díj kezelése attól függ, hogy az Általános paraméter funkció / Pénzügy, számvitel fülén, hogy áll a "Termék eladási ára tartalmazza a visszaváltási díjat" pipa.
HA IGAZ
Semmi nem változik a webáruház működésben. Mivel az italtermék ára tartalmazza a visszaváltási díjat is, ezért az italterméket önmagában elég felküldeni a webáruházba, a webáruház visszaváltási díjjal együtt fogja listázni és a kosárba tenni, majd a rendelésbe is azzal együtt kerül. A sERPa a rendelést úgy veszi fel, hogy a termék árában benne van a visszaváltási díj is, csak a vevőszámla készítésekor fogja azt ketté választani és külön tételben a számlára tenni.
HA HAMIS (ajánlott működés)
Ha az italtermék ára nem tartalmazza a visszaváltási díjat, akkor fontos, hogy azt külön, kiegészítő információként felküldjük a webáruházba.
2. Visszaváltási díj termékek kiküldése a webshopba
A felhasználónak be kell sorolnia a visszaváltási díj termékeket a webáruházba kiküldendő termék besorolásba is, mert akkor fogjuk azt felküldeni a webáruház terméktörzsbe.
Mivel a webáruháznak meg kell oldania, hogy ezeket a visszaváltási díj termékeket (amelyek be vannak sorolva az Átalános paraméter DRS termékkategóriába) ne jelenítse meg eladható termékként, ezért a visszaváltási díj termékeknél egy <deposit_fee>1</deposit_fee> értéket is felküldünk a termék üzenetben.
3. Italtermékkel együtt kiküldjük a göngyöleg táblából a visszaváltási díj információkat
Annak érdekében, hogy a webáruház hozzá tudja kapcsolni az italtermékhez a visszaváltási díjakat, az italtermékkel együtt a hozzá tartozó visszaváltási díj információkat (göngyöleg termékeket) is felküldjük:
•a Termékek - Termektorzs.xml üzenetet kiegészítjük egy <deposit_fee_products> blokkal, ahol átadjuk a Termék / További adatok fül / Göngyöleg/DRS visszaváltási díj táblázatból az italtermékhez kapcsolódó visszaváltási díj termékek adatait:
•csak azon göngyöleg termékeket adjuk át, amelyek DRS visszaváltási díjnak minősülnek (be vannak sorolva az Átalános paraméter DRS termékkategóriába)
•ha több göngyöleg termék felel meg a feltételnek, több <item> blokkot adunk át
•mezők: göngyöleg termék ID, kódja, mennyiség, nettó és bruttó ár, áfakulcs (bővebben: Termékek - Termektorzs.xml)
A webáruház fejlesztőnek figyelni kell arra, hogy a quantity mezőben az egy egységnyi italtermékhez tartozó göngyöleg mennyiséget adjuk át. Tehát ha pl. egy darab 6-os zsugor ásványvíz italtermékről van szó, akkor ugyan a sERPában a terméktörzsben a göngyöleg táblázatban a felhasználó 0,166-os ad meg kapacitásként, de itt a quantity mezőben mi 6-ot fogunk átadni (mint az egy db értékesíthető termékhez tartozó göngyöleg mennyiség).
4. Terméktörzs változás figyelése
Az interfész figyeli a Termék funkció / További adatok fülén található Göngyöleg termék / DRS visszaváltási díj táblázat változását. Ha hozzáadunk vagy leveszünk egy visszaváltási díj terméket, módosítjuk a kapacitást, az érintett termékről értesítést küldünk a webshop felé (Termékek - Termektorzs.xml).
5. Vevőrendelés fogadása
Amikor a termék a kosárba, majd a rendelésbe kerül, akkor a webáruház külön tételként fogja a termék mellett elküldeni a visszaváltási díj terméket is az általa már ismert, hozzá tartozó termékkóddal.
A visszaváltási díj termék tételeket a rendelés feldolgozásakor a sERPa a termékkód alapján felismeri, és nem tárolja el, hiszen a sERPa működése szerint a vevőrendelés lezárásakor automatikusan felvesszük a DRS-es italtermékekhez virtuális szolgáltatás tételként a visszaváltási díjat, így az a sERPában tárolt információk alapján rákerül a rendelésre. Azonban ennek ellenére fontos, hogy a webáruház azt külön tételként beküldje nekünk, hisz így lesz azonos a rendelésérték mindkét oldalon.
Fontos, hogy a megfelelő működés érdekében a webáruház adminisztrációs felületén a visszaváltási díjakat nem szabad módosítani a termékeknél, csak sERPa oldalról.
További webáruház interfészek
Más korábbi, a sERPában még létező webáruház interfészhez nem készítünk fejlesztést a visszaváltási díjas termékek automatizált kezelésére. A vevőrendeléseken a visszaváltási díjas termékek fogadhatók.
