Webshop összekötése XML kimenet segítségével

Hogyan működik?

Amennyiben webáruházat üzemeltetsz, nagyszerű hírünk van számodra: ha készítesz (vagy készíttetsz a programozóddal) a webshopodhoz egy egyszerű XML kimenetet, annak segítségével elérhetővé teheted a teljes árukészleted az Alkupiacon. Ez a funkció csak a boltként regisztrált felhasználóink számára elérhető. Viszont ingyenes. :)

Ahhoz, hogy az Alkupiac fel tudja dolgozni a webshopod tartalmát, azt egy általunk olvasható formátumban kell elérhetővé tenned. Ez lesz az XML kimenet, ami strukturáltan tartalmazza a teljes árukészletedet és amit az Alkupiac rendszeres időközönként beolvas. Az XML kimenet elkészítéséhez programozás szükségeltetik - egy egyszeri munkával elkészítheti a webshopod programozója, többé nincs vele gond.

Kétféle XML kimenetet kell készítened a saját webshopodban: az egyik a teljes árukészletedet tartalmazza és csak egyszer dolgozzuk fel. Ha ez megtörtént és feltöltöttük az árukészletedet az Alkupiacra, akkor lehetőséged van azt folyamatosan frissíteni egy másik XML-lel, ami kizárólag a változásokat tartalmazza. Azért van szükség két külön XML-re, hogy ne terheljük a rendszert feleslegesen: ha van például ezer terméked, de naponta csak néhány új van (vagy néhány változik), akkor értelmetlen mind az ezret újra feltölteni.

Ezután nincs több dolgod: rendszerünk folyamatosan feltölti az árukészletedben történt változásokat is az Alkupiacra, fixáras termékként. Vásárlás esetén e-mailben megkapod a vásárló adatait (név és elérhetőségek), innentől neked kell vele rendezni az ügyletet.

Kérdés esetén írj a tech@alkupiac.hu címre.

Teljes árukészletet tartalmazó XML

Az alábbiakban bemutatjuk, hogyan kell felépülnie az XML-nek. Először is, íme egy példa:

<?xml version="1.0" encoding="UTF-8" ?>
    <termekek>
        <termek>
            <ID>342447-SJI</ID>
            <megnevezes>Teszt termék</megnevezes>
            <leiras>Ez itt a termék leírása.</leiras>
            <ar>4990</ar>
            <kategoria>1515</kategoria>
            <gyarto>Gyártó neve</gyarto>
            <cimkek>teszt</cimkek>
            <kiszallit>V</kiszallit>
            <hasznalt_uj>U</hasznalt_uj>
            <fiz_mod>1[1000],2[1200]</fiz_mod>
            <kep1>http://sajat-webshop.hu/kepek/termek1_elolrol.jpg</kep1>
            <kep2>http://sajat-webshop.hu/kepek/termek1_hatulrol.jpg</kep2>
            <kep3></kep3>
            <kep4></kep4>
            <kep5></kep5>
        </termek>
    </termekek>

Az XML egyes mezői:

• ID: A termék azonosítója. Ide azt az azonosítót írd be, ami a te webshopodban azonosítja a terméket. (kötelező)
• megnevezes: A termék neve (kötelező)
• leiras: A termék leírása
• ar: A termék bruttó ára (kötelező)
• kategoria: A termék kategóriája (kötelező)
  Minden termékkategóriának van egy azonosítószáma, ezt a számot kell ide beírnod. Az egyes kategóriák azonosítóját itt tudod megkeresni. Fontos, hogy a termékeidet a megfelelő kategóriába töltsed fel, mert így a vásárlók könnyen megtalálják.
• gyarto: A termék gyártója vagy márkája
• cimkek: Címkék
• kiszallit: A kiszállítás költsége. Lehetséges értékek:
  V - a vevőt terheli, E - az eladót terheli, R - rugalmas
• hasznalt_uj: Termék állapota: használt vagy új? Lehetséges értékek:
  H - használt, U - új
• fiz_mod: Lehetséges fizetési módok. Az XML-be a fizetési mód sorszámát kell beírni:
  

  Sorszám	Fizetési mód neve
  1	Utánvéttel postázva
  2	Futárszolgálattal
  3	Személyes átvétel
  4	Postai csomagként előre utalás után
  5	Normál levélként, előre utalás után
  6	Ajánlott levélként előre utalás után
  7	Elsőbbségi levélként előre utalás után
  8	Elsőbbségi, ajánlott levélként előre utalás után
  9	Időgarantált postai csomagként előre utalás után

  
  Többféle fizetési mód is megadható, ez esetben vesszővel kell elválasztani a sorszámokat.
  (például utánvét ÉS személyes átvétel esetén: 1,3
  
  Szállítási költség megadása:
  Minden egyes fizetési módnál megadható a (forintban értett) szállítási költség. Amelyik szállítási módnál be akarsz állítani szállítási költséget, ott a szállítási mód sorszáma után kapcsos zárójelbe írd be a termék árát.
  (például 1.000 Ft-os utánvét ÉS 200 Ft-os normál levél esetén: 1[1000],5[200]
• kep1-kep5: A webshopodban található képek URL-je.

Változásokat tartalmazó XML

Ha az első XML-t (azaz a teljes árukészletet tartalmazó XML-t) beállítottad, mi pedig ellenőriztük és feltöltöttük, akkor jön a képbe a második XML. Ennek a segítségével tudod az árukészletedben történő változásokat (pl. árváltozás, új termékek, termék törlése, stb.) frissíteni az Alkupiacon. Ezt az XML-t folyamatosan beolvassuk és feldolgozzuk.

Ez az XML egyszerre maximum 5000 terméket tartalmazhat!

AZ XML felépítése

Az XML-nek ugyanúgy kell felépülnie, ugyanazokat a mezőket kell tartalmaznia, mint a teljes árukészletet tartalmazó XML-nek. A különböző esetekről az alábbiakban olvashatsz:

Ha új terméket töltesz fel: Nincs semmi extra teendőd, az XML-ben szereplő új terméket feltöltjük az Alkupiacra. Onnan tudjuk, hogy egy termék új, hogy azzal az azonosítóval (ID mező) még nem szerepel terméked az Alkupiacon.

Ha meglévő terméket módosítasz: Ebben az esetben a termék azonosítójának (ID mező) szerepelnie kell az adatbázisunkban, azaz csak olyan terméket tudsz módosítani, amit korábban már feltöltöttél. Megkeressük az adatbázisunkban azt a terméket, aminek megegyezik az azonosítója, és felülírjuk az adatokat.

Ha terméket törölnél: Ebben az esetben elég csak két mező az XML-be: az azonosító (ID) mező, ezzel tudjuk beazonosítani, hogy melyik terméket akarod törölni. Ezen kívül csak a "megnevezes" mezőt töltsd ki, ítd bele a "DELETE" szót (nagybetűvel, idézőjelek nélkül). Ha találunk az azonosítónak megfelelő terméket, töröljük azt.

Kérdés esetén írj a tech@alkupiac.hu címre.