sERPa súgó

Leírás

Termék adatok átadása sERPa-ból, termék felvétel, módosítás, esetén, fordítással. Termék törlés nem kerül átküldésre. Termékfa és termékbesorolások amelyek a webáruház paraméterben meg vannak adva, valamint ügyfélfüggetlen akciós ár.

 

Termék törlés nincs, ha paraméterben megadott besorolásból kivesszük a terméket, attól még nem kerül le a webáruházból, csak a szinkronja kerül "kikapcsolásra". Ha nem akarjuk, hogy a termék megjelenjen akkor a Használható eladáskor legyen hamis, ekkor nem lesz látható a webáruházba. (admin felületen továbbra is ott van)

 

Készlet feltöltés: Új termék első feltöltésekor a készlet adatok is átadásra kerülnek, amennyiben a feltöltés előtt a termék már létezett és rendelkezett készlettel.

 

Algoritmus

 

Adatátadás feltétele

Rest napló típus = ShopRenter-Termék

Termék (Product Resource)

 

A.) Változást beindító funkció: (Útvonal: sERPa Alap \ Struktúra \ Általános \ Termék) --> BizonylatValtozasFigyeles(BizonylatTipus_ID = 101, idegen: 104)

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,

     - a termék most kerül be a küldhető termék besorolás szűrésbe

     - a termék most kerül be a küldhető termékfa szűrésbe

 2. Törlés: nem történik semmi

 3. Módosítás: ha megváltozik bármelyik alábbi tényező:

     a.) Terméket érintő mezők:

           - Termék kód

           - Használható eladáskor

           - Használható beszerzéskor

           - Bármilyen eladási ár változás a webáruházban beállított ártábla szerint.

     b.) Termék leírást érintő mezők

           - Termék név

           

           -  A 'Leírás' fülön szereplő 'Rövid leírás', 'Leírás' mezők, amennyiben az adott leírás a webáruház paraméterben megadott ID szerint sorrendben az első kettő nyelvkódhoz tartozó azonosítóval megegyezik.

     c.) Termék besorolást érintő mezők (összes)

          (Ha van küldendő releváns besorolás, akkor küldésre kerül. A termék státusz kategória is ide tartozik)

     d.) Termékfát érintő mezők(összes)

           Feltétele::a webáruház szűrésnek megfelelő adat legyen (bekerülés és kikerülés is beindít változást).

     e.) Termékképet érintő mezők

          - Sorrend változás

          - Honlap nagy pipa

          - Kép ellenőrző kódja (ez maga  kép).

     f.) Termék idegenazonosítót érintő mezők (ha az ügyfélen keresztül történik módosítás, akkor is triggerelünk).

          Feltétele: Az idegen azonosító típusa azonos legyen a webáruház paraméterben beállított idegen típussal, vagy marketing névvel.

         - Idegenazonosító kód

         - Idegenazonosító név

         - Idegen azonosító mennyiség egység

         - Idegen azonosító vonalkód táblázatának bármely része.

     g.) A Termék / További adatok fülén rendelkezésre álló bruttó tömeg adat

 - Mindig kilogramban kifejezve küldjük a tömeget, a Shoprenter oldalon is így kell paraméterezni a termékeket.

       - Megjegyzés: a Shoprenter a dokumentációja szerint sehol nem jeleníti meg a termék adatlapján a vásárlók számára a tömeget, csak a súly szerinti szállítási módnál veszi figyelembe.

 

*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ó 'Webáruház Internet URL' nevű mező ne legyen üres.

 - A termék szerepel a webáruház paraméterben megadott termék besorolásban.

 - A termék szerepel a webáruház paraméterben megadott termékfa alatt, amennyiben a termékfa meghatározásra került.

 

*Megjegyzés:

 1. products Resource küldésének feltételei, ha bármely feltétel teljesül:

    - felvételnek minősülő esemény következik be.

    - az a.) pontban meghatározott mezők valamelyike módosul.

    - a webáruház paraméterben be van állítva a termékkép küldés és sorrendben az első termék változik e.) pont szerint.

   - ha bármely besorolás változik a c.) pont alapján. (státusz miatt, optimalizálás nélkül)

 2. productDescription Resource küldésének feltételei, ha bármely feltétel teljesül:

    - felvételnek minősülő esemény következik be.

    - a b.) pontban meghatározott mezők valamelyike módosul.

 3.  productImages Resource küldésének feltételei, ha bármely feltétel teljesül:

    - felvételnek minősülő esemény következik be.

    - a webáruház paraméterben be van állítva a termékkép küldés. (csak "összes termék" esetén, tehát ha olyan változás is történik, ami nem sorrendben az első terméket érinti)

    - az e.) pontban meghatározott mezők valamelyike módosul. (itt törlés is történhet, vagy ha az 1 sorrendet érinti a változás, akkor kép útvonal módosítás).

 4.  File Resource küldésének feltételei, ha bármely feltétel teljesül (3. ponthoz tartozó kép):

    - felvételnek minősülő esemény következik be.

    - a webáruház paraméterben be van állítva a termékkép küldés.

    - az e.) pontban meghatározott mezők valamelyike módosul.

      (itt törlés is történhet, vagy ha az 1 sorrendet érinti a változás, akkor kép útvonal módosítás; ha csak 1-nél nagyobb sorrend változik, akkor optimalizálás miatt nem küldjük újra a képeket).

 5.  productCategoryRelations Resource küldésének feltételei, ha bármely feltétel teljesül:

    - felvételnek minősülő esemény következik be.

    - az d.) pontban meghatározott mezők valamelyike módosul. (itt törlés is történhet).

 6.  productListAttributeValueRelations Resource küldésének feltételei, ha bármely feltétel teljesül:

    - felvételnek minősülő esemény következik be.

    - az c.) pontban meghatározott mezők valamelyike módosul. Csak a webáruház paraméterben beállított kategóriának megfelelő termék besorolás kerül felküldésre, de csak akkor ha a termék kategória releváns (bármely kategória tétel eltér a webáruházban megadott nem releváns kategóriától).

Mező megfeleltetések

Product (Termék)

Product Class (Termékkategória) - Mezők megfeleltetése:

Product Description (Termék leírás) - Mezők megfeleltetése:

productImages (Termékkép) - Mezők megfeleltetése:

 

 

 

Példa hívás

http metódus POST

 

{"data":{"requests":[{"method":"POST","uri":"https:\/\/teszt437.api.myshoprenter.hu\/productDescriptions\/UDE4M0wx","data":{"name":"Fehérszőlő (013a)","product":{"id":"UDE4Mw=="},"language":{"id":"bGFuZ3VhZ2UtbGFuZ3VhZ2VfaWQ9MQ=="},"measurementUnit":"kg","packagingUnit":"","description":"<p>A szőlő (Vitis) a szőlőfélék (Vitaceae) családjának egyik sok fajt és azon belül sok alfajt magába foglaló nemzetsége. Minden ide tartozó növény közös jellemzője, hogy fás szárúak, terméseik fürtökben helyezkednek el és levelük általában tenyeresen összetett. Magyarország területén több mint ezer éve termesztenek bortermő szőlőt, a honfoglaló magyarok az akkori Dunántúlon már virágzó szőlőművelést találtak.<\/p><p\/><p>A termék adatlapja ekkor frissült: \"2025-04-04 06:08\"<\/p>"}},{"method":"POST","uri":"https:\/\/teszt437.api.myshoprenter.hu\/productDescriptions\/UDE4M0wz","data":{"name":"White Grape","product":{"id":"UDE4Mw=="},"language":{"id":"bGFuZ3VhZ2UtbGFuZ3VhZ2VfaWQ9Mw=="},"measurementUnit":"kg","packagingUnit":"","description":"<span><span><span><span><span><span><span><span><span><span><span><span><span><p><span><span><span>A grape is a fruit, botanically a berry, of the deciduous woody vines of the flowering plant genus Vitis.<\/span><\/span><\/span><\/p><p><span><span><span>Grapes can be eaten fresh as table grapes or they can be used for making wine, jam, juice, jelly, grape seed extract, raisins, vinegar, and grape seed oil. Grapes are a non-climacteric type of fruit, generally occurring in clusters.<\/span><\/span><\/span><\/p><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span>"}}]}}

Példa válasz

<response>

 <requests>

   <request>

     <method>POST</method>

     <uri>https://teszt437.api.myshoprenter.hu/productDescriptions/UDE4M0wx</uri>

     <response>

       <header>

         <statusCode>200</statusCode>

       </header>

       <body>

         <href>http://teszt437.api.myshoprenter.hu/productDescriptions/UDE4M0wx</href>

         <id>UDE4M0wx</id>

         <name>Fehérszőlő (013a)</name>

         <metaTitle/>

         <metaKeywords/>

         <metaDescription/>

         <shortDescription/>

         <description>&lt;p&gt;A szőlő (Vitis) a szőlőfélék (Vitaceae) családjának egyik sok fajt és azon belül sok alfajt magába foglaló nemzetsége. Minden ide tartozó növény közös jellemzője, hogy fás szárúak, terméseik fürtökben helyezkednek el és levelük általában tenyeresen összetett. Magyarország területén több mint ezer éve termesztenek bortermő szőlőt, a honfoglaló magyarok az akkori Dunántúlon már virágzó szőlőművelést találtak.&lt;/p&gt;&lt;p/&gt;&lt;p&gt;A termék adatlapja ekkor frissült: "2025-04-04 06:08"&lt;/p&gt;</description>

         <parameters/>

         <packagingUnit/>

         <measurementUnit>kg</measurementUnit>

         <customContentTitle/>

         <customContent/>

         <dateCreated>2019-09-16T07:31:34</dateCreated>

         <dateUpdated>2025-04-04T06:08:34</dateUpdated>

         <videoCode/>

         <product>

           <href>http://teszt437.api.myshoprenter.hu/products/UDE4Mw==</href>

         </product>

         <language>

           <href>http://teszt437.api.myshoprenter.hu/languages/bGFuZ3VhZ2UtbGFuZ3VhZ2VfaWQ9MQ==</href>

         </language>

       </body>

     </response>

   </request>

   <request>

     <method>POST</method>

     <uri>https://teszt437.api.myshoprenter.hu/productDescriptions/UDE4M0wz</uri>

     <response>

       <header>

         <statusCode>200</statusCode>

       </header>

       <body>

         <href>http://teszt437.api.myshoprenter.hu/productDescriptions/UDE4M0wz</href>

         <id>UDE4M0wz</id>

         <name>White Grape</name>

         <metaTitle/>

         <metaKeywords/>

         <metaDescription/>

         <shortDescription/>

         <description>&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;&lt;p&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;A grape is a fruit, botanically a berry, of the deciduous woody vines of the flowering plant genus Vitis.&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/p&gt;&lt;p&gt;&lt;span&gt;&lt;span&gt;&lt;span&gt;Grapes can be eaten fresh as table grapes or they can be used for making wine, jam, juice, jelly, grape seed extract, raisins, vinegar, and grape seed oil. Grapes are a non-climacteric type of fruit, generally occurring in clusters.&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/p&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;</description>

         <parameters/>

         <packagingUnit/>

         <measurementUnit>kg</measurementUnit>

         <customContentTitle/>

         <customContent/>

         <dateCreated>2019-09-16T07:31:34</dateCreated>

         <dateUpdated>2025-04-04T06:08:34</dateUpdated>

         <videoCode/>

         <product>

           <href>http://teszt437.api.myshoprenter.hu/products/UDE4Mw==</href>

         </product>

         <language>

           <href>http://teszt437.api.myshoprenter.hu/languages/bGFuZ3VhZ2UtbGFuZ3VhZ2VfaWQ9Mw==</href>

         </language>

       </body>

     </response>

   </request>

 </requests>

</response>