sERPa súgó

Kód prefix

A webáruházból a sERPába kerülő ügyfelek az itt megadott kód előtagot kapják meg az ügyfélkódban. Továbbá a sERPába kerülő vevő rendelések kézi azonosítójába is ezzel a prefixszel kerülnek be a rendelések.

Regisztrált ügyfél idegenazonosító típus

A Webáruházban regisztrált, a sERPába bekerülő ügyfél az itt meghatározott sERPabeli idegen azonosító típushoz rendelve kapja meg az idegen azonosító kódját. Ez alapján kerül azonosításra a sERPában az ügyfél és a Webáruházban az ügyfél. Ez azért is szükséges, hogy, ha a Webáruházból átkerül az ügyfél a sERPába és itt az ügyfélkódot lemódosítják, akkor is beazonosítható legyen a két rendszer között az ügyfél. Az ügyfélkezelés részletei itt találhatók: Rendelés - Rendeles.xml.

Számla ügyfél idegenazonosító típus

A Webáruházból a sERPába bekerülő, számlázási adatokban megadott ügyfél az itt meghatározott sERPabeli idegen azonosító típushoz rendelve kapja meg az idegen azonosító kódját. Ez alapján kerül azonosításra a sERPában az ügyfél és a Webáruházban az ügyfél. Ez azért is szükséges, hogy, ha a Webáruházból átkerül az ügyfél a sERPába és itt az ügyfélkódot lemódosítják, akkor is beazonosítható legyen a két rendszer között az ügyfél. Az ügyfélkezelés részletei itt találhatók: Rendelés - Rendeles.xml.

Új ügyfél e-számlázás

(I/N)

Igen esetén a rendeléskor felvételre kerülő Ügyfeleknél igazra állítjuk az E-számlázás pipát.

Meglévő ügyfél e-számla

(I/N)

Igen esetén rendeléskor a meglévő Ügyfeleknél is igazra állítjuk az E-számlázás pipát. Ha kivesszük a Meglévő ügyfél e-számla pipát a webáruház paraméterből, az Ügyfél E-számlázás pipa egy következő rendelés esetén bent marad a jelölőnégyzetben.

Ügynök generálása regisztrált vásárló esetén

([I]/N)

Nem esetén a rendelés rögzítésekor nem veszünk fel új ügyfelet ügynökként és nem kapcsoljuk azt a rendelés ügyfeléhez.

Ha megtaláljuk az ügyfelet, azt használjuk, ha nem, akkor normál szabályok szerint veszünk fel ügyfelet. (Ld. Rendelés - Rendeles.xml.) A "bill" szakasz adatai az ügyfél székhely adatai (fejléc) lesznek, a "postal" szakasz pedig telephely lesz.

A számlák lekérdezését , a számlakép kiküldést is úgy módosítottuk, hogy "Nem" érték esetén nem csak az ügynökökkel rendelkező rendelések számláiból küldünk ki számlaképet.

Csoportos fizetési feltétel

[I/N]

Igen esetén kiküldjük a használható fizetési feltételeket. Az új XML-ben a Csop. fizetési feltétel topicban írtak kerülnek átadásra. Az ott használt Termék kategóriáknak a Termék kategória táblázat kategóriáival kell átfedésben lenniük, így webshop oldalon ezen keresztül lehet párosítani a fizetési feltételekkel.

Akciós ár szűrés

Ha az Akciós ár szűrés van megadva, akkor kizárólag azok az akciók számítanak, ahol megegyezik a szűrés feltétel (ügyfél kategória, ügyfél kategória tétel, kizárás). Ha a webáruházban nincs 'Akciós ár szűrés" beállítva, akkor az akciós árban szereplő ügyfél kategóriának is üresnek kell lenni.

Kapcsolódó folyamatleírás: ShopRenter, NetGo Akciós ár kezelés

Ügyfél adat változás

Ebbe a kategóriába és tételbe sorolt ügyfelek adatai kerülnek átadásra, kategória tétel kódja (customer_customer_group). Nem kötelező megadni.(Ert1UgyfelKategoria_ID)

Termékkategória és tétel

Ebbe a kategóriába sorolt termékek kerülnek átadásra a webáruház felé. Termékkategória-tétel megadásával tovább szűkíthető az átadásra kerülő termékek köre, de a tétel megadása nem kötelező. A termék üzenetben a <web> mezőben átadjuk a termékkategória tétel kódját.

A Webáruházban a  "Katalógus"-ra kattintva az ebbe a kategóriába (/kategória tételbe) besorolt termékek jelennek meg, ha azok "Használható eladáskor"-ra vannak állítva a sERPában a terméktörzsben.

Termékfa szűrés

Az itt megadott Termékfa szint alatti levelek kerülnek be Termék kiküldésekor a Termek XML-be.

Küldés típusa

Felsorolt / Számozott. Számozott esetében a régi működést tapasztaljuk, amikor maximum 5 darab termékfalevelet küldünk ki.

Felsorolt választása esetében egy új elem kerül a küldött XML-be a régi helyett (<categories/>) ebben annyi <category_id> elem van egy terméknél, ahány levél meg van adva, mely a paraméterben megadott szülő ággal rendelkezik.

Fordítások küldése

[I/N]

Igen esetén kiküldjük a törzsadatokhoz tartozó fordításokat. Küldésre kerül a Termék név, Termék fa, Termék kategória név és Termék kategória tétel név adatokhoz megadott minden nyelvű fordítás.

Termékleírás

[I/N]

Igen esetén kiküldjük a termékhez tartozó Leírást. (az XML tartalmazza a leírás mező tartalmát és a nyelvet az iso-639-1 szabvány szerint).

Termék kép

Nincs / Főkép / Összes

Főkép esetén csak a Sorrend szerinti első képet küldjük ki a webshopra, ha annál a holnap nagy igaz, tehát, ha cserélni szeretnénk főképet, akkor azt sorrendben első helyre kell állítani és honlap nagy pipát igazra kell állítani.

Összes esetén az összes olyan képet küldjük ki, ahol a honlap nagy igaz állapotú (a főképnél fent leírt feltétel továbbra is igaz, így minden olyan kép ami honlap nagy, de sorrendben nem első, az további kép lesz, míg az első főképként kerül kiküldésre).

A paraméter rögzítésekor nem küldjük fel a képeket automatikusan, elkerülve a szerver azonnali leterhelését, így a képek kiküldése a termékek módosításának hatására történik meg.

Kézzel indítható módszer részletei: Termék kép - TermekKep.xml

Termék videó URL

[I/N]

Igen esetén a termékekhez felvett összes videó típusú URL-t kiküldjük a termékleírással.

További adatok

[I/N]

Igen esetén átadjuk az XMLben a Térfogat, Alkoholfok, Nettó és Bruttó tömeg adatokat, ha azok nem üresek. a paraméter igazra állítása nem kezdeményez azonnali kiküldést, csak a termék változására, vagy a tárolt eljárás kézi indítására kerülnek kiküldésre a termékek az új adatokkal.

További tulajdonságok

[I/N]

Igen esetén átadjuk az XMLben a További tulajdonságok fülön szereplő mezők címkéjét, adattartalmát, címkék és felsorolt adattípusú tulajdonság esetében azok tételeinek fordítását. A paraméter igazra állítása nem kezdeményez azonnali kiküldést, csak a termék változására, vagy a tárolt eljárás kézi indítására kerülnek kiküldésre a termékek az új adatokkal.

Termék iratok

[I/N]

Igen esetén kiküldjük a kiküldésre kerülő termékekekhez csatolt iratokat, melyeknél a Webre kerül mező értéke igaz.

TermékIrat - TermekIrat.xml

Termék irat típus

A mező csak a Termék iratok pipa igaz állapota esetén módosítható. Megadható egy irat kategória, aminek a tétele az irat típusaként fog bekerülni a webshop felé kiküldött XML-ben. Javasoljuk, hogy ez az irat kategória egy egyedi irat kategória legyen, amennyiben nem egyedi és az irathoz többször fel van véve, akkor a besorolás ID szerinti elsőt küldjük ki.

Bővített ártábla lista

[I/N]

Igen esetén esetén megjelenik a "Bővített ártábla lista" nevű táblázat, ilyenkor a Listaár, Végfelhasználói, Nagyker, További ártábla 1, További ártábla 2, További ártábla 3 mezők nem látszanak, tartalmuk a táblázatban jelennek meg, ha ki voltak töltve.

Listaár

Ártábla választás, amely ártábla szerinti árakkal kerülnek átadásra a termékek a webáruház felé.

Végfelhasználói

Ártábla választás, amely ártábla szerinti árakkal kerülnek átadásra a termékek a webáruház felé.

Nagyker

Ártábla választás, amely ártábla szerinti árakkal kerülnek átadásra a termékek a webáruház felé.

További ártábla 1

Ártábla választás, amely ártábla szerinti árakkal kerülnek átadásra a termékek a webáruház felé.

További ártábla 2

Ártábla választás, amely ártábla szerinti árakkal kerülnek átadásra a termékek a webáruház felé.

További ártábla 3

Ártábla választás, amely ártábla szerinti árakkal kerülnek átadásra a termékek a webáruház felé.

Nem releváns kategória

Szövegesen beírható egy olyan termék kategória tétel. Az itt megadott termék kategória tétel kódot keressük és ha a kiküldendő termékeknél bármelyik (webshopra is kikerülő) kategóriában ezt a tételt találjuk megadva, akkor az adott termékhez az egész kategória nem kerül kiküldésre.

pl.:

A mezőbe beírjuk, hogy "n/a",

A Termékkategória táblázatban pedig meg van adva két kategória : "Forma", "Szín"

A kiküldendő termék: "Labda", melynél a két termékkategória így néz ki:

Forma - n/a

Szín - piros.

Amikor kiküldjük a terméket, akkor a paraméter szerint az n/a termékkategória tételű kategóriákat nem küldjük ki, tehát a példa szerint kikerülő termék:

Labda

Szín - piros

Vevőrendelés sorozat

A beérkező Rendeles.xml-ben átadásra kerül a sorozat. Ha ott nincs megadva, vagy olyan sorozatot adnak meg, ami nem létező vevőrendelés sorozat, akkor az itt megadott sorozatra kerül felvételre a rendelés.

Forrás

Megadhatunk egy forrást a forrás törzsadatból, amely rendelés beérkezésekor a generált rendelés Forrás mezőjébe kerül.

Ajánlat sorozat

Sorozatválasztás, amely Ajánlat sorozatra felvételre kerülnek a webáruházból érkező ajánlatkérések a sERPába.

Szállítási határidő eltolás fuvardíj kategória

A mezőben egy fuvardíj kategóriát lehet megadni, csak olyan választható, ami egyedi tulajdonságú. Ha a mezőben szerepel kategória, akkor a Szállítási határidő eltolás táblázat megjelenik a mező alatt.

Paraméterezés leírása: Rendelés - Szállítási határidők

Vevőrendelés állapot sorozat képlet

Képletként megadható több rendelés sorozat, melyek állapotáról és állapot változásáról küldünk üzenetet.

Saját ügyintéző

Az itt beállított saját ügyintéző kerül a generált rendelésbe.

Automatikus diszponálás

(Igen/Nem)

Igen esetén a rendelés tételei ha lehetséges, azaz van belőle szabad készlet, akkor lediszponálja a tételeket, amint bekerül a rendelés a webáruházból.

Tétel tulajdonság

A webáruház által küldött rendeléstétel egyedi azonosítójának tárolására szolgáló Tulajdonság kiválasztása. Csak szöveg adattípusú tulajdonság választható és a megadása kötelező, mert a webáruház felé folyó kommunikációban kötelezően visszaadandó adatot tárol.

Kifizetés státusz

Beállítható egy további adat, mely felvételre kerül a vevőrendelésbe üres értékkel. A rendelésen a további adat szöveg mezőjébe a Rendelésre befizetés- Rendeles2.xml -ből a <bank_status> elemben megadott szöveg kerül, mely az ott lévő értéket felülírja. Pl. kártyás fizetésnél van jelentősége, itt lehet követni azt, hogy a fizetési tranzakció sikeresen lebonyolódott-e.

Saját megjegyzés

Lehetőség van további adat szöveget paraméterezni,  illetve a további adat szöveghez egyéni attribútumot rendelni. Ha a vevőrendelés általános fülén található további adat táblázatba szintén felvesszük, akkor a beállított állapotokat változás esetén továbbadjuk a weboldal részére a Rendelés állapot - Rendeles3.xml üzenetben a seller_comment nevű mezőben.

Felvevő felhasználó

A mezőben megadható az a felhasználó, akinek a nevében a webáruházból érkező rendeléseket felvesszük a sERPába. Arra szolgál, hogy meg lehessen különböztetni, mely rendelés érkezett a webáruházból és melyek azok, amelyeket a sERPában vettek fel. Az ezzel a felhasználóval felvett rendelésekről a web felé soha nem megy vissza "létrehozás" (insert) típusú üzenet, hisz az a webáruházban már léteznek. (A többi rendelésről fogunk küldeni, hiszen azok a sERPában jöttek létre.)

Alapértelmezett értéke az a felhasználó, amelynél a Felhasznalo_ID = 0.

Utánvét szolgáltatás táblázat

Beállítható egy fizetési mód, pl. Utánvétel, amit a Fizetési mód funkcióban vettünk fel. Majd a Termék funkcióban kell felvenni egy új szolgáltatást pl. Utánvétel néven. Majd ebben a táblázatban kiválasztani a fizetési módot és a létrehozott utánvétel nevű szolgáltatást. Ha itt szerepel sor (a termék nem üres), akkor a Utánvét kezelés részben leírtak szerint külön tételként rögzítjük az utánvét díjat.

Számlakép kiküldése

[I/N]

Igen esetén a Webáruház felé kiküldjük a kinyomtatott számla PDF képét.

E-számla esetén a hitelesítést követően a hitelesített számlaképet küldjük csak ki, míg a Számla mentése PDFként adatbázisba menüparaméter segítségével mentett papír alapú számlát a pdf elkészültét követően küldjük ki. Az algoritmusról és az XML mintát a Számlakép - SzamlaKep.xml oldalon olvashatják.

Nem regisztrált ügyfél

[I/N]

Igen esetén a Webáruház felé kiküldjük a nem regisztrált (billwebshopcode-dal nem rendelkező) ügyfeleknek kiállított, kinyomtatott számlákat is.

A mező csak akkor látszik, ha a Számlakép kiküldése mező állapota igaz.

Előlegszámlák kiküldése

[I/N]

Igaz érték esetén a Webáruház felé kiküldjük azokat az előlegszámlákat, amelyek megfelelnek a Számlakép sorozat paraméternek. Bepipálásakor minden, a sorozatszűrésnek megfelelő előlegszámla felküldésre kerül, a program nem figyeli az érintett vevő rendelés és az előlegszámla kapcsolatát.

Számlakép sorozat

A táblázatban vevőszámla sorozat(ok) megadására van lehetőség, így csak ahhoz tartozó vevőszámla, valamint PDF számlaképe kerül kiküldésre a webshop számára. A PDF számlaképet kódoltan egy összeállított XML-ben küldjük ki a webshopnak. A táblázatban több sorozatot is megadhatunk. A táblázat akkor kerül megjelenítésre, ha a Számlakép kiküldése jelölőnégyzetben szerepel pipa.Ha a Számlakép kiküldése jelölőnégyzetben szerepel pipa viszont nem kerül felvételre egy vevőszámla sorozat sem a táblázatba, akkor minden számlasorozatra kiküldjük a PDF számlaképet.

Utolsó módosítás: 2024. 10. 25.

© PROGEN Kft.