Első lépések, gyakorlati útmutatók > Egyedi webáruház fejlesztői dokumentációja

Az express.ügyvitelben lehetőség van egyedi webáruházból megrendeléseket importálni XML formátumból. Az importálásnak két előfeltétele van:

•a webáruház beállításokat el kell végezni a programban, ezzel felkészülve az adatok fogadására.

•a megfelelő XML struktúrát/adatfájlt legeneráltatni a webáruházból. Ennek felépítéséhez külön mintafájlokat készítettünk, ami erre a linkre kattintva letölthető jelen dokumentációval együtt, illetve az alábbi dokumentumból is kimásolhatók a kódok.

A megfelelő XML állomány elkészítéséhez a webáruházához külön beépülő szükséges, melyet egy webprogramozóval tud elkészíttetni, cégünk nem vállal ilyen feladatot.

XML adatstruktúra minta és leírásuk

Az alábbi struktúra alapján kell legenerálni a webáruházból a megrendeléseket. A csillaggal megjelölt adatok kitöltése kötelező, a többi esetben ha a mező nem tartalmaz adatot, akkor üresen kell átadni!

<?xml version="1.0" encoding="UTF-8" ?>

<Order>

</Invoice>

</Shipping>

</Addresses>

</Customer>

</CourierService>

</Payment>

<Item>

</Item>

<Item>

<Id>service_plus_1</Id>

<Sku>service_plus_1</Sku>

<Unit>doboz</Unit>

</Item>

<Item>

<Id>payment</Id>

<Sku>payment</Sku>

</Item>

<Item>

<Id>shipping</Id>

<Sku>shipping</Sku>

</Item>

<Item>

<Id>coupon500</Id>

<Sku>coupon500</Sku>

</Item>

<Item>

<Id>discount100</Id>

<Sku>discount100</Sku>

</Item>

</Items>

</Order>
</Orders>

A <![CDATA[]]> konténer használatára a speciális karakterek átadása miatt van szükség.

Futárszolgálat modul megléte esetén ügyeljünk arra, hogy a CourierService csoport Name mezőjében ugyanolyan néven jöjjön át az adat, ami a programba is rögzítve van Futárszolgálat neveként!

Megrendelések feldolgozása

Az express.ügyvitel Webáruház csoport Webáruház megrendelések menüpontban, a Letöltés webáruházból gombra a program meghívja a webes útvonalon lévő parancsot (ami válaszul a fentiekben látható XML-struktúrát adja vissza) vagy az XML adatfájlt.

Pl.: https://webshop.revol.hu/getOrders.php?key=123456 vagy a helyi XML fájlt.

A beolvasás után a Webáruház megrendelések áttekintőben megjelennek az XML-ből importált megrendelések, melyeket a Feldolgozás gombbal emelhetünk át a Megrendelésekbe.

A feldolgozás folyamata megegyezik a többi webáruházéval, azaz először partner, a fizetési mód, majd árutársítás következik.

Amennyiben Parancsfájl be lett állítva a webáruház paramétereinél, akkor a webáruház a megrendelés feldolgozásakor/elutasításakor meghívja azt, átadja paraméterben a webáruház-kulcsot, a szükséges státuszváltás azonosítóját, és vesszővel elválasztva azoknak a webáruház megrendeléseknek a webáruházbeli azonosítóját, amikre a státuszváltás vonatkozik.

Webáruházas megrendelés státuszok (status kapcsolóval) az alábbiak lehetnek:

•0: feldolgozásra vár

•1: feldolgozott

•2: elutasított

Például amennyiben feldolgozza az ID123456 és ID456789 azonosítójú megrendeléseket, akkor a következő linket hívja meg sikeres feldolgozás után:
https://webshop.revol.hu/setStatus.php?key=123456&status=1&orderid=ID123456,ID456789

amennyiben elutasítja az ID123456 webáruhaz azonosítójú megrendelést, akkor ezt:
https://webshop.revol.hu/setStatus.php?key=123456&status=2&orderid=ID123456

Ezzel a működéssel lehetőséget ad a webáruháznak, hogy módosítsa az adott megrendelések státuszát, így információt közölhet a folyamat állapotáról a webáruház oldalán, illetve szabályozhatja a letöltendő megrendeléseket, hogy a már feldolgozott, vagy elutasított státuszúakat ne generálja bele a megrendelések lekérdezésekor az XML állományba.

Példa a webáruház beállításoknál beírt mezőkre és a generált linkekre:

Kattintson a képre a nagyobb méretben való megtekintéshez!

Áruk feltöltése

Az árukat a Webáruház csoporton belül, a Webáruház – áru kapcsolat menüpontban lehet feltölteni a Feltöltés webáruházba gombbal. A megjelenő ablakban válasszuk ki az egyedi webáruházat, jelöljük be a szükséges opciókat, melyek az alábbiak lehetnek:

•Csak a kiválasztottak: ha bejelöljük, csak azok az áruk lesznek feltöltve, amiket kiválasztottunk. Több árut a CTRL vagy a SHIFT billentyűk segítségével jelölhetünk ki a Feltöltés webáruházba gomb megnyomása előtt. Ha ez az opció nincs bepipálva, minden társított áru feltöltésre kerül.

•Csak a legutóbbi feltöltésük óta módosultak: csak azok az áruk kerülnek feltöltésre, amiben változás történt a legutóbbi feltöltés óta.

•Képek nélküli feltöltés: Ha vannak a feltöltendő áruknak képei, azok is feltöltésre kerülhetnek egy „Item” előtaggal, a termék egyedi azonosítójával (Oid, kötőjelek nélkül) és 1-5 sorszámmal, aláhúzásokkal elválasztva (például.: ha az Oid 0583a555-41d7-46a8-b732-15c0fc93ea11, akkor az első kép Item_0583a55541d746a8b73215c0fc93ea11_1 fájlnévvel és a kép kiterjesztésével lesz feltöltve FTP kapcsolaton keresztül.)
Az áruhoz tartozó képeket csak akkor tölti fel a program, ameddig az áru nem lett betársítva egy webáruházas áruval. Miután már érkezett megrendelés az adott árura és betársításra került, akkor már nem töltődik fel a kép a felesleges, nagy adatforgalom elkerülése érdekében.
Ha nem akarjuk a termékképeket feltölteni, akkor ne jelöljük be ezt az opciót! Ekkor csak az árukat tartalmazó XML lesz feltöltve az FTP-re, a képek nem, társítástól függetlenül.

A kiválasztott „Express XML” típusú webáruházba FTP-n keresztül kerülnek feltöltésre az áruk XML formátumban, az előbb megadott paraméterek szerint.

Áru XML minta és leírás

<?xml version="1.0" encoding="UTF-8" ?>

<Item>

<ExtraData1>csak 1 méteres darabokban</ExtraData1>

<ExtraData2>magyar termék</ExtraData2>

<ExtraData3>törékeny</ExtraData3>

<ExtraData4>1 év garancia</ExtraData4>

<ExtraData5>valami fontos infó</ExtraData5>

</Item>

<Item>

</Item>

</Items>