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.
A 4.0.158-as verziótól kezdve ha a Shoprenterből érkezett rendelésen DRS-köteles italtermék mennyisége módosul, akkor a hozzá kapcsolódó DRS visszaváltási díjról is küldünk rendelés módosítás üzenetet (orderProductAddon) a webáruház felé.
6. Ha már korábban a Shoprenterben kézzel felvettük a DRS termékeket
Ha már azelőtt felvettünk a Shoprenter admin felületén DRS adatokat, mielőtt a fentiek szerint a sERPa átszinkronizálta volna őket, akkor szükség van egy tárolt eljárás futtatására, hogy a szinkront kialakítsuk. A ShopRenter2sERPaDRSInit tárolt eljárás segít összekötni a webáruházban előre manuálisan felvett DRS addon tételeket a sERPából érkező visszaváltási díj termékekkel.
Az eljárás bemenő paramétere a Webáruház ID és az üzemmód, amelyek a következők:
•0: Listázás -> Cikkszám alapján listázza azokat a shoprenteres termékeket, ahol nem a sERPa által szerepelt Outer ID található. (Tehát azt nem a sERPából küldtük fel.)
•1: Felülírás -> A külső webáruházban módosítja a régi Outer ID-t a sERPa által generált Outer ID-ra.
•2: Szkript generálás -> Két ablakban kapunk szkriptet. Az SQL0 nevű táblában lévő kód futtatása minden alkalommal előzetesen kötelező, mert ott definiáljuk a cél áruház eléréséhez szükséges adatokat. A többi SQL kódsor közül lehet válogatni a futtatáskor, ha valaki nem akarja (akár egyszerre) kiküldeni az összes sort.
Ajánlott először 0 paraméterrel elindítani az eljárást, így kapunk egy listát, hogy a Shoprenterben milyen ID-val található a DRS visszaváltási díj elem és a sERPában milyen ID-val. Ha egyetértünk az eredménnyel és kevés az eltérés, akkor használhatjuk a 1 paramétert, de ha több száz, akkor a 2-es üzemmóddal generáljunk scriptet és azt részletekben futtassuk le.
EXEC WEB.ShopRenter2sERPaDRSInit
@WebaruhazPar_ID = 1,
@Init= 0
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.
