A webshop a cikk adatok lekérdezését megegyezés szerint naponta egyszer, a hajnali órákban kezdeményezi. Maga az xml elkészítése igen időigényes lehet (szélsőséges esetekben akár 10-20 perc), ezért érdemes a webszervízzel előre elkészíttetni. Viszont ennek az időzítésével viszont vigyázni kell, mert a webszervíz, míg ezt az xml-t készíti, addig semmilyen más kérdésekre nem fog válaszolni.
A lekérdezés url-je kimásolható a paraméterezés megfelelő mezőjéből, ezt az url-t kell megadni az Extreme Digital-nak.
Mivel az adatcserében vannak kötelező mezők, a beállított cikk szűrésen felül kimaradnak azok a cikkek, ahol:
•Üres a cikk KN kódja és vámtarifaszáma és KSH kódja,
•Nincs a megadott "cikk csoport besorolás" törzsbe besorolva,
•Üres a cikk EAN kódja.
Az xml a webszervíz terminál ExtremeDigitalFileChache könyvtárába fog elkészülni.
Az Extreme Digital a következő adatokat veszi át a Machinátortól:
number
|
A cikk cikkszáma, egyedi azonosító a cikkhez, szöveges adat (kötelező)
A Machinátor saját cikkszáma kerül az xml-be.
|
name
|
A cikk neve (kötelező)
A cikknév 1 + cikknév 2 kerül az xml-be.
|
available
|
Megjelenik-e a cikk a weben - lehetséges értékei: 1 = Igen; 2 = Nem; 3 = Hívjon. Azt is ez a mező jelzi, ha egy cikk törölt státuszba kerül - ilyenkor is 2-es fog visszajönni benne.(kötelező)
Ha a cikknek az Extreme Digital mint ügyfél engedménnyel csökkentett ára nem nulla, akkor 1, különben 2 kerül az xml-be.
|
storageCondition
|
Ez a termékállapot - lehetséges értékei: 1 = Rendelhető; 2 = Nem rendelhető; 3 = Ideiglenesen nem rendelhető (kötelező)
Ha a cikk készlete nem nulla, akkor 1, különben 2 kerül az xml-be.
|
manufacturerName
|
A cikk gyártója (kötelező) noname ha nincs
Ha a paraméterezésben meg van adva a "gyártó besorolás törzs", akkor a megfelelő tétel neve, különben "noname" kerül az xml-be.
|
unitType
|
A cikk mennyiségi egysége (bliszt, cs., csomag, db, disp, doboz, ft, garn, hó, ív, karton, kg, lap, m., nap, óra, pár, raklap, szett, tek, tömb, tubus, üveg) (alapértelmezett: db)
A cikk mértékegysége kerül az xml-be.
|
unitBase
|
A cikk legkisebb, alap mennyiségi egysége pl. dobozban árult ceruzánál a doboz a mennyiségi egység (unitType), és db az alap (unitBase) (alapértelmezett: db)
Nem kerül bele az xml-be.
|
unitCount
|
Hány van az alap egységből a mennyiségi egységben, vagyis az előző példa alapján egy dobozban hány db ceruza van (alapértelmezett: 1)
Nem kerül bele az xml-be.
|
cbsNumber
|
A cikk KSH száma (kötelező)
Ha a cikknek mag van adva a KN kódja, akkor az, ha az nincs, akkor a vámtarifaszáma, ha az sincs, akkor a KHS kódja kerül bele az xml-be.
|
mainGroupCode
|
A cikk főcsoportjának kódja. Ebben a csoportban van a cikk cikkcsoportja.
Ha meg van adva a "főcsoport besorolás törzs", akkor a megfelelő tétel kódja kerül az xml-be.
|
mainGroupName
|
A cikk főcsoportjának neve. Ebben a csoportban van a cikk cikkcsoportja.
Ha meg van adva a "főcsoport besorolás törzs", akkor a megfelelő tétel neve kerül az xml-be.
|
productGroupCode
|
Cikkcsoportkód, amibe a cikk tartozik, minden cikk csak egy csoportban lehet (kötelező)
A megadott "csoport besorolás törzs" megfelelő tételének a kódja kerül az xml-be.
|
productGroupName
|
A cikkcsoport neve, amibe a cikk tartozik (kötelező)
A megadott "csoport besorolás törzs" megfelelő tételének a neve kerül az xml-be.
|
supplyType
|
Ez a beszerzéstípus - lehetséges értékei: 1 = Csak rendelésre; 2 = Készletre (alapértelmezett: 2)
Nem kerül bele az xml-be.
|
descriptionShort
|
A cikk rövid megjegyzése.
Egyenlőre nem kerül bele az xml-be.
|
description
|
A cikkről egy hosszabb leírás (ajánlott)
Egyenlőre nem kerül bele az xml-be.
|
weight
|
A cikk tömege kg-ban (nem kötelező, de ajánlott a szállíthatóság miatt)
Ha a cikk bruttó tömege meg van adva, akkor az, ha nincs, akkor a nettó tömeg kerül az xml-be.
|
sizeX, sizeY, sizeZ
|
A cikk méret adatai cm-ben (hosszúság, szélesség, magasság) (nem kötelező, de ajánlott a szállíthatóság miatt)
A cikk további adatok, karton adatok szélesség, magasság, mélység számadata kerül be az xml-be. (Nincs átváltás, azaz a Machinátorban kell cm-ben megadni ahhoz, hogy helyes adatot kapjon a webshop!)
|
warrantyType
|
A cikk garanciális idejének típusa. Lehetséges értékei: 1 = Nap; 2 = Hét; 3 = Hónap; 4 = Év. (kötelező alapértelmezett: 3),
Ha a cikk / további adatok / garanciális adatok / típus = nincs, akkor 1 kerül az xml-be. Különben az alap garancia idő mértékegysége alapján:
•Naptári nap, munkanap esetén 1,
•Hét esetén 2,
•Hónap, Negyedév, Félév esetén 3,
•Év esetén 4 kerül az xml-be. |
warrantyPeriod
|
A cikk garanciális ideje (kötelező)
Ha a cikk / további adatok / garanciális adatok / típus = nincs, akkor 0 kerül az xml-be. Különben az alap garancia idő mérőszáma. ( Negyedév, félév esetén 3-al, ill 6-al szorozva. )
|
productType
|
A cikk cikkfajtája (kötelező alapértelmezett: áru)
Ha a cikk alap típusa termék, akkor "áru" kerül az xml-be, különben "szolgáltatás".
|
taxRate
|
A cikk áfakulcsa (kötelező)
A cikk áfakulcsa alapján az áfa százalék kerül az xml-be.
|
manufacturerNumber
|
A cikk gyártói cikkszáma (kötelező ha nincs akkor megegyezhet az EAN kóddal)
A cikk EAN kódja kerül az xml-be.
|
serialNumberUsage
|
Kezel-e a cikk sorozatszámot. Lehetséges értékei: 1: Nincs 2: Nem egyedi 3: Egyedi (alapértelmezett: 1)
A cikk gyártási szám beállítása alapján kap értéket.
|
orderUnit
|
A cikk értékesítési mennyisége, figyelembe véve a készletezési mennyiségi egységen megadott minimális mennyiséget is. A cikkből csak ennek a számnak egész számú többszöröse rendelhető meg!
Nem kerül bele az xml-be.
|
stockFree
|
szabad készlet (kötelező)
A paraméterezésben megadott készlet típus kerül az xml-be.
|
stockExpectedQuantity
|
Várható beérkezés darabszáma (visszaigazolt kimenő megrendelés van rá)
Nem kerül bele az xml-be.
|
stockWaitingReceipts
|
Bevétre váró termékek darabszáma (már rögzítették a bejövő számlát/szállítólevelet, de még nem rögzítették a raktári bizonylatot)
Nem kerül bele az xml-be.
|
stockAvailableDate
|
Mikorra lehet a cikket beszerezni.Ha semmilyen készlet információ nincs, akkor a mai nap jön benne.
Nem kerül bele az xml-be.
|
stockOuterType
|
Külső készlet, ha nincs pontos érték. Lehetséges értékei: 1: Nincs, 2: Van, 3: Várható (tehát a külső cégnél is csak várható, hogy lesz) (alapértelmezett: 1)
Nem kerül bele az xml-be.
|
stockOuterQuantity
|
Külső készleten lévő mennyiség, az automata beszerző alapján
Nem kerül bele az xml-be.
|
priceMembership
|
Listaár: ha van ajánlott végfelhasználói nettó lista ár ha nincs akkor a priceDiscount értékét kell megadni (kötelező)
Ha a paraméterezésben meg van adva a kisker ár ügyfele, akkor az ő engedmény nélküli egységára kerül az xml-be, ha nincs akkor az Extreme Digital mint ügyfél engedménnyel csökkentett ára.
|
priceNormal
|
A partnerre vonatkozó ár: ha van ajánlott végfelhasználói akciós nettó ár ha nincs akkor a priceDiscount értékét kell megadni (kötelező)
Ha a paraméterezésben meg van adva a kisker ár ügyfele, akkor az ő engedménnyel csökkentett egységára kerül az xml-be, ha nincs akkor az Extreme Digital mint ügyfél engedménnyel csökkentett ára.
|
priceDiscount
|
A partnerre vonatkozó akciós nettó ár: amennyiért az Extreme Digital meg tudja venni, az összes kedvezménnyel csökkentett ár. (kötelező)
Az Extreme Digital mint ügyfél engedménnyel csökkentett ára kerül az xml-be.
|
currency
|
Devizanem (kötelező alapértelmezett: HUF)
Fixen "HUF" kerül az xml-be.
|
eanCode
|
A vonalkód (kötelező)
A cikk elsődleges, és további ena-jai kerülnek az xml-be.
|
image_url
|
A cikk képének letöltési URL-e (kötelező)
A paraméterezésben megadott gyűjtőből az xml készítéskor a program a cikkekhez iktatott jpg képeket átmásolja a webszerviz terminál netpub\ExtremeDigitalImages könyvtárába, cikkszám+sorszám.jpg néven. A paraméterezésben megadott saját url, és saját port alapján a képek http eléréséhez szükséges url kerül az xml-be.
|
|