Leírás
A Webáruház interfész (NetGo) modul lehetővé teszi a sERPa és a NetGo típusú webáruházak összekapcsolását.
Az interfész képes a webáruház működéséhez szükséges információkat továbbítani a webáruház felé (pl. termék, árak, készlet, számlák) és ugyanígy fogadni tudja a webáruházból jövő adatokat (pl. rendelés, rendelésen szereplő ügyfél).
Az interfész a NetGo-tól különböző webáruházak összekapcsolására is használható, azonban ilyen esetben a webáruház illesztése a meglevő NetGo interfészhez minden esetben a webáruházfejlesztő feladata.
Technikai információk
A sERPa <-> NetGo kapcsolat az alábbiak szerint működik:
•Az XML kódolása: "UTF-8"
•Content-Type: application/xml
•Method: POST
•Nincs semmilyen paraméter. A request body részében van az xml.
•Az adatok küldéséhez használandó XML-elek sémája a linken letölthető.
•A működéshez be kell állítani IIS-t(webszervert) (Itt történik a kommunikáció a sERPa és a webáruház motorja között, beállítása kötelező a helyes működéshez.)
Több webáruház egy adatbázisban - URL azonosítás
URL azonosítás segítségével, egy meglévő sERPa adatbázisból több webáruházat lehet párhuzamosan használni. Ha a kapott xml-ben szerepel URL tag és az megegyezik a Webáruház paraméter funkció Általános fülén előzetesen megadott URL mezővel, akkor beazonosítható a webáruház. A működéshez szükséges tölteni az Általános fülön található Hash kód mezőt is, ami a paraméter azonosítás alapja. Például a beérkező rendelés esetén, a program megnézi melyik webáruház paraméterhez tartozik és az alapján generál ügyfelet, webshop code-ot stb. A megadott Hash kód a létrehozott xml-ek token mezőjébe kerül. Az url tag-et a fejléc adatokban kell elhelyezni.
XML felépítése URL azonosítás esetén:
<serpa>
<head> ; fejléc adatok
<url></url> ; URL azonosítás
<token></token> ; token azonosító (Paraméterben a Hash kód kerül ide.)
<type>product</type> ; adat típusa, (2)
<time>2016-07-28-13:57</time> ; küldés időpontja, dátum, óra, perc
</head>
<content>
; adat
</content>
</serpa>
Az adatok átküldése nem azonnali, hanem egy queue kerülnek, itt feldolgozásra kerülnek(pár másodperc) és innen kerül kiküldésre max 500 csomagot küld ki egyszerre egyforma típusút, utána lesz egy 1 másodperc szünet és utána új küldés, ugyancsak max 500-t.
XML szerkezet
Minden xml be van csomagolva:
<serpa>
<head> ; fejléc adatok
<token></token> ; token azonosító (Paraméterben a Hash kód kerül ide.)
<type>product</type> ; adat típusa, (2)
<time>2016-07-28-13:57</time> ; küldés időpontja, dátum, óra, perc
</head>
<content>
; adat
</content>
</serpa>
A rendelés küldés https://cegem.hu:4848/Webshop/Api/Netgo/Order ahol a Webshop az Alkalmazaskönyvtár. (amely mappámban van a restapi.asp, amiből az url rewrite api-t csinál.)
Ajánlat esetén offer kell megadni küldéskor.
(1) Content node
Az adatok content node-ban érkeznek.
(2) Lehetséges típusok
product |
|
categories |
|
pricelist |
|
stock |
|
customer |
|
order, offer |
|
|
|
|
|
|
|
|
(3) Törlés
Törlés esetén a típust, és adat azonosító kell átküldeni.
<type>delete</type>
<category_id>145</category_id>
