Leírás
Termék adatok információit tartalmazza a Termektorzs.XML. A sERPa küldi, web nyugtázza Termektorzs_response.xml-el.
Mezők
Üzemmód,kód, név, áfakulcs, kiszerelés, csomagolási egység, mennyiségi egység, listaár, végfelhasználói ár, nagyker ár, illetve további 3 ártábla, akciós ár, akció kezdete, akció vége, használható eladáskor, weben elérhető, főkategória(termékfa) azonosítója, egyéb tulajdonságok.
Algoritmus
Amely termékek a paraméterben megadott besorolásba esnek, a Használható eladáskor = Hamis termékek is,
Amennyiben egy termék besorolásra kerül, melynek következtében kiküldenénk, akkor kiküldjük vele együtt a Termék leírást, Termék iratot, Termék képet és Termék készletet.
Egyéb esetben csak a változásokat küldjük ki (pl termék kép változás esetén csak a termék képet, stb.).
Ha a be van sorolva és kiesik a besorolásból akkor még elküldjük az XML-t, 0-val, utána már nem, hogy a másik oldalt is kikerüljön.
properties / item-ben átadott kategóriák tételének neve, mellett átadjuk a benne megadott leírást, vagy képet is, amennyiben a paraméterben a mező értéke igaz.
Referencia mennyiség egység és ár - a Termék / További adatok / Átváltás táblázatban jelölhető, hogy mely mennyiségegységet szeretnénk referenciának megjelölni. Itt fontos hogy csak LTR, MTR, KGM ISO kódú mennyisegegységek esetén értelmezi a program a referencia mennyiségegységet.
https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:52006DC0325&from=MT
Adatátadás feltétele
Termék (Rest napló típus = NetGo-Termék) - products/product
Változást beindító funkció: (Útvonal: sERPa Alap \ Adminisztráció \ Termék) --> BizonylatValtozasFigyeles(BizonylatTipus_ID = 101)
Változást okozó események (amennyiben teljesül a változás további feltételeinél meghatározott összes kritérium is):
1. Felvétel:
- Ha új "Termék" törzsadat kerül felvételre,
- Az termék a webáruház paraméterben megadott termék kategória és (tétel magadása esetén) termék kategória tétel alapján besorolásra kerül és ez által webre kerülhet.
2. Módosítás: ha az előző állapothoz képest bármely alábbi mező megváltozott:
Általános fülön:
- Kód
- Név
- Használható eladáskor
- Besorolási szám
- Mennyiségi egység
- Ha a 'Termékfa' nevű táblában bármi módosul.
- Ha a 'Besorolás' nevű táblában bármi módosul.
További adatok fülön:
- Az átváltás táblában olyan sor változik, ahol a 'Kiszerelés' vagy 'Referencia ár mennyiségi egység' pipa értéke igaz.
- Ha a webáruház paraméterben beállításra került a további tulajdonságok küldése, akkor a 'További tulajdonság' nevű mező értéke.
- Ha a 'Helyettesítő termékek' nevű táblában bármi módosul.
- Ha a 'Kapcsolódó termékek' nevű táblában bármi módosul.
- Ha a Göngyöleg / DRS visszaváltási díj nevű táblában bármi módosul.
- Ha a 'Vonalkód' nevű táblában bármi módosul.
Tulajdonság fülön:
- Ha a webáruház paraméterben beállításra került a további tulajdonságok küldése, akkor bármely tulajdonság.
Eladási ár fülön:
- Ha a webáruház paraméterben bővített ártábla lista van választva, akkor bármely itt megadott ártáblán lévő összes változás.
- Ha a webáruház paraméterben nincs bővített ártábla lista pipálva, akkor a megadható fix 6 db ártáblán lévő összes változás. (pl. Listaár ártábla stb.)
3. Törlés:
- Ha "Termék" törzsadat kerül törlésre.
- Az ügyfél kikerül a küldendő ügyfél besorolásból.
*Változás további feltétele, az összes feltételnek teljesülni kell:
- A webáruház paraméterben a webáruház használhatóra legyen állítva.
- A webáruház paraméter 'Általános adat' fülén található URL mező ne legyen üres.
- A termék szerepel a webáruház paraméterben megadott termék besorolásban.
*Megjegyzés:
- Aszinkron történik az üzenetek küldése. A kérés az optimalizálás miatt bekerül egy végrehajtási sorba (//sERPa/AUGAsync/TargetQueue). Tehát a küldéshez szükséges, hogy a Service Broker és az említett Queue engedélyezett legyen.
(ha 1 másodpercen belül több azonos típusú csomag kerülne küldésre, akkor összevonásra kerülnek egy üzenetbe).
- A felvétel típusánál: insert, a módosítás típusánál: update, a törlés típusánál: delete értéke kerül a type mezőbe.
*Kiegészítő megjegyzés:
'product' alelemeinek küldése:
1. product/product_name_translations
- Változásnak minősülő esemény következik be.
- Van termékhez kapcsolódó fordítás.
- Ha a 'Terméknévfordítás' nevű táblában bármi módosul.
- A webáruház paraméterben a 'Fordítások küldése' pipa értéke igaz.
2. product/categories
- Változásnak minősülő esemény következik be.
- Van termékhez kapcsolódó termékfa, amely szűrés esetén megfelel a webáruház paraméterben megadott szűrésnek.
- A webáruház paraméterben a termékfa szűrésnél a 'Küldés típusa' = Felsorolt
3. product/product_price
- Változásnak minősülő esemény következik be.
- Van termékhez használható, a küldés pillanatában érvényes ártábla megadva.
- A webáruház paraméterben a 'Bővített ártábla lista' pipa értéke igaz.
4. product/properties/item
- Változásnak minősülő esemény következik be.
- A termék olyan termék besorolásban szerepel, amely kategóriája vagy kategória tétele alapján: a webáruház paraméterben szereplő 'Termék kategória' nevű tábla szűrése szerint küldhető lesz.
- Csak olyan besorolás kerül küldésre, amely nem került kizárásra a nem releváns kategória tétel megadásával.
- megjegyzés: properties_name_translations, properties_value_translations alelemek akkor szerepelnek, ha a webáruház paraméterben a 'Fordítások küldése' pipa értéke igaz és található fordítás.
5. product/additional_properties/property
- Változásnak minősülő esemény következik be.
- Van a termékhez termék tulajdonság megadva.
- A webáruház paraméterben a 'További tulajdonságok' pipa értéke igaz
- megjegyzés: property_name_translations, property_value_translation alelemek akkor szerepelnek, ha a webáruház paraméterben a 'Fordítások küldése' pipa értéke igaz és található fordítás.
6. product/connected_products/item
- Változásnak minősülő esemény következik be.
- Van a termékhez kapcsolódó termék megadva.
7. product/similar_products/item
- Változásnak minősülő esemény következik be.
- Van a termékhez helyeteesítő termék megadva.
8. product/deposit_fee_products/item
- Változásnak minősülő esemény következik be.
- Van a termékhez olyan göngyöleg termék megadva, amely be van sorolva az Általános paraméterben megadott DRS kategóriába.
Termektorzs.XML leírás
<serpa
<head
<token
<type ; product
<time ; az xml készítésének időpontja
head>
<products
<product
type ; insert - új rekord/felvétel, update - meglévő módosítása, delete -törlés -->
product_code ; CDATA: termék kódja
erp_product_code ; termék ID-je
product_name ; termék neve
<product_name_translations
<translation id="1" language = "en" ; Leírás nyelve (ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes )
name ; fordításban a nyelvhez megadott termék név.
translation>
product_name_translations>
vat ; áfa százalék a mai napon pl.: 27
barcode ; termék alapértelmezett mennyiségi egysége szerinti vonalkód
packing ; kiszerelés szerinti mennyiség
packing_unit ; termék kiszerelési szerinti mennyiségi egység neve
quantity_unit ; termék alapértelmezett mennyiségi egység neve pl: db
reference_unit ; termék referencia árhoz megjelölt mennyiség egység
list_price_net ; paraméterben megadott Listaár ártábla szerinti nettó ár
list_price_gross ; paraméterben megadott Listaár ártábla szerinti bruttó ár
price_net ; paraméterben megadott Végfelhasználói ártábla szerinti nettó ár
price_gross ; paraméterben megadott Végfelhasználói ártábla szerinti bruttó ár
wholesale_price_net ; paraméterben megadott Nagyker ártábla szerinti nettó ár
wholesale_price_gross ; paraméterben megadott Nagyker ártábla szerinti bruttó ár
price1_net ; paraméterben megadott További ártábla1 szerinti nettó ár
price1_gross ; paraméterben megadott További ártábla1 szerinti bruttó ár
price2_net ; paraméterben megadott További ártábla2 szerinti nettó ár
price2_gross ; paraméterben megadott További ártábla2 szerinti bruttó ár
price3_net ; paraméterben megadott További ártábla3 szerinti nettó ár
price3_gross ; paraméterben megadott További ártábla3 szerinti bruttó ár
<product_prices ; Bővített ártábla lista esetén az összes ártáblát itt adjuk át
price id="1" name="Lista ár" type="0" ; Ide kerül a táblázatban További ártábla típussal felvett ártáblák árai. ID az Artabla tábla ID-je Nev pedig az ártábla neve. type a táblázatban az Ártábla típusa. 0-5-ig dedikált ártáblák a régi működéssel való kompatibilitás miatt (ezek csak egyszer vehetők fel), a 6 pedig egyéb megadható ártáblák, ez korlátlan számban felvehető.
price_net>200.00</price_net>
price_gross>200.00</price_gross>
reference_price_gross ;referencia mennyiség alapján az ártábla árából számolt referencia ár. Az ártábla devizájában.
price>
product_price>
active ; használható eladáskor, logikai
deposit_fee ; Ha a sERPában a termék az Általános paraméterben megadott DRS kategóriába van sorolva, akkor 1-gyel küldjük ki ezt a mezőt, egyébként át se adjuk a mezőt.
web ; paraméterben megadható (szűrés) termékkategória tétel kódja
category1_id ; termékfalevél legalsó szintjének ID-je. Paraméterben szabályozható, hogy
category2_id
category3_id
category4_id
category5_id
<category_id> ;Többször előforduló elem. Paraméterben megadható, hogy hány, a paraméterben megadott Termékfának megfelelő termékfalevél_id-t küldjön ki a program.
categories>
<product_additional_data ; Termék további adat fül, további adat sáv
<volume ; térfogat
<abv ; alkoholfok
<net_weight ; nettó tömeg
<gross_weight ; bruttó tömeg
product_additional_data>
<properties ; paraméterben megadott kategóriák és tételei
<item
<name> ; kategória neve
<properties_name_translations
<translation id="1" language = "en" ; Leírás nyelve (ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes )
name ; fordításban a nyelvhez megadott termék név.
translation>
properties_name_translations>
<value> ; kategória tétel neve
<properties_value_translations
<translation id="1" language = "en" ; Leírás nyelve (ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes )
name ; fordításban a nyelvhez megadott termék név.
translation>
properties_value_translations>
<description> ; kategória tétel leírása
<picture> ; kategória tétel képe, ahol Honlap nagy = igaz és Sorrend =1
item>
properties>
<additional_properties ; Termékek további tulajdonságai (TermekTulajdonsag tábla )
<property id = "1" ; TermekTulajdonsag.Tulajdonsag_ID
<name> ; Tulajdonság neve
<property_name_translations
<translation id="1" language = "en" name = "test name" ; további tulajdonság nyelv (ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ), fordításban a nyelvhez megadott szöveg.
translation>
property_name_translations>
<property_value> ; tulajdonságnál megadott érték
<property_value_translations
<translation id="1" language = "en" name = "test value" ; további tulajdonság nyelv (ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ), fordításban a nyelvhez megadott szöveg, ez csak felsorolt adattípusú tulajdonság esetén használható.
translation>
property_value_translations>
property>
additional_properties>
<connected_products
<item
erp_product_code ; kapcsolódó termék ID (több is lehet, mindig új <item alatt)
product_code ; kapcsolódó termék kódja
item>
connected_products>
<similar_products
<item
erp_product_code ; helyettesítő termék ID (több is lehet, mindig új <item alatt)
product_code ; helyettesítő termék kódja
item>
similar_products>
<item ; csak azt adjuk át, ha DRS besorolású (több is lehet, mindig új <item> alatt) (Kapcsolódó üzleti folyamat: Webáruház interfészek visszaváltási díj kezelése)
erp_product_code ; göngyöleg termék ID
product_code ; göngyöleg termék kódja
quantity ; a göngyöleg táblában kapacitást tárolunk a Meret mezőben, ezért itt annak a reciprokát kell átadjuk (pl. 0,166 helyett 6-ot)
price_net ; a göngyöleg táblában megadott termék ált. paraméterben megadott DRS ártábla szerinti nettó ára
price_gross ; a göngyöleg táblában megadott termék ált. paraméterben megadott DRS ártábla szerinti bruttó ára
vat ; a göngyöleg táblában megadott termék áfa kulcsa (pl. 27 vagy 0)
item>
/deposit_fee_products>
product>
products>
serpa>
Termektorzs.XML példa
<product>
<type>insert</type>
<product_code>AR0010</product_code>
<erp_product_code>1357</erp_product_code>
<product_name>alma</product_name>
<product_name_translations>
<language>en</language>
<name>apple</name>
<language>de</language>
<name>apfel</name>
</product_name_translations>
<vat>27</vat>
<!-- csak akkor adjuk át ezeket a mezőket, ha a bővített ártábla pipa hamis -->
<quantity_unit>fm</quantity_unit>
<list_price_net>110</list_price_net>
<list_price_gross>139.7</list_price_gross>
<price_net>300</price_net>
<price_gross>381</price_gross>
<wholesale_price_net>150</wholesale_price_net>
<wholesale_price_gross>190.5</wholesale_price_gross>
<price1_net>20</price1_net>
<price1_gross>25.4</price1_gross>
<price2_net>15</price2_net>
<price2_gross>19.05</price2_gross>
<price3_net>100</price3_net>
<price3_gross>127</price3_gross>
<!------------------------------------------------------------------------------------------------------------>
<active>1</active>
<web>netgo</web>
<category1_id>115</category1_id>
<!-- csak akkor adjuk át ezeket a mezőket, ha a bővített ártábla pipa igaz -->
<product_prices>
<price id="1" name="Lista ár" type="0">
<price_net>200.00</price_net>
<price_gross>200.00</price_gross>
</price>
<price id="95" name="Végfelhasználói" type="1">
<price_net>300.00</price_net>
<price_gross>300.00</price_gross>
</price>
<price id="2" name="Nagyker ár" type="2">
<price_net>100.00</price_net>
<price_gross>100.00</price_gross>
</price>
<price id="31" name="KL_1" type="3">
<price_net>10.00</price_net>
<price_gross>10.00</price_gross>
</price>
<price id="32" name="KL_2" type="4">
<price_net>20.00</price_net>
<price_gross>20.00</price_gross>
</price>
<price id="33" name="KL_3" type="5">
<price_net>30.00</price_net>
<price_gross>30.00</price_gross>
</price>
<price id="6" name="Webes ár 01 HUF" type="6">
<price_net>999.00</price_net>
<price_gross>999.00</price_gross>
</price>
<price id="7" name="Webes ár 02 EUR" type="6">
<price_net>1.23</price_net>
<price_gross>1.23</price_gross>
</price>
</product_prices>
<!------------------------------------------------------------------------------------------------------------>
<properties>
<item>
<name>2015 májusi akció</name>
<value>Igenxx</value>
</item>https://www.youtube.com/watch?v=Z0QgBX4WFKQ&list=PLSMETuURtTXDkOm6Xx4Q-1HS8W54GrBDm&index=18
<item>
<name>Aktív</name>
<value>igen</value>
</item>
</properties>
<connected_products>
<item>
<erp_product_code>1359</erp_product_code>
</item>
</connected_products>
<similar_products>
<item>
<erp_product_code>1358</erp_product_code>
</item>
</similar_products>
<deposit_fee_products>
<item>
<erp_product_code>528</erp_product_code>
<product_code>DRS001</product_code>
<quantity>1</quantity>
<price_net>50</price_net>
<price_gross>50</price_gross>
<vat>0</vat>
</item>
</deposit_fee_products>
</product>
Termektorzs_response.XML leírás
Nem várunk semmit vissza, de amit kapunk elteszzük a Rest Naplóba.
