sERPa súgó

Leírás

Rendelés és Ajánlat adatok visszaküldése webshop felé - Rendeles_3.XML. A Rendeles_3_response.XML -t a web küldi, melyben a sERPa-ban felvett rendelés, vagy rendelés tétel megkapja a webtől az azonosítókat is. 

Az üres item_ID-t nem módosítjuk a rendelésen a tételeket a rendelés tétele pozíciója (serpaban sorrend) és product_code alapján azonosítjuk, így lehetőség nyílik azonos termékeket több tételben a rendelésre felvenni

Csak Élő állapotú, érvényes ajánlatról (érvényesség mező ki van töltve és az abból kiszámított nap nagyobb vagy egyenlő mint a mai nap) kell üzenetet küldeni a webnek.

 

További adat szöveg átadása rendelés állapotba: A webáruház paraméterben található a saját megjegyzés nevű mezőt, ahol 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 ebben az üzenetben a seller_comment nevű mezőben.

 

DRS visszaváltási díj - állapotváltozás küldés:

Ha rendelés tétel állapotváltozást küldünk egy DRS-be bevont italtermékről a webáruház felé, akkor rendelésen felvett, hozzá tartozó visszaváltási díj tételről is kiküldésre kerül ugyanaz az állapotváltozás, a DRS visszaváltási díj kapacitásnak megfelelő mennyiségben.

Tehát ha rendelünk 5 zsugor ásványvizet (6 db-os), ahhoz 30 db visszaváltási díjat rögzít a rendszer. Ha ebből 3 zsugor ásványvíz kerül teljesítésre, 2 zsugor visszamondásra, akkor ezzel egyidőben kiküldésre kerül a 3*6=18 db visszaváltási díjról teljesített, 2*6=12 db visszaváltási díjról visszamondás rendelés állapot változás a webshop felé.

Algoritmus

Minden, az elmúlt 30 napban.

(üres paraméterrel nem csak egy rendelés kerül átküldésre hanem minden, így üres webshop feltöltése is alkalmas)

A Status_ID 6 és 7 (belső továbbrendelt és szállító továbbrendelt) csak foglalásba kerüléskor kerül átadásra, a foglalás módosítást nem követi a program.

Adatátadás feltétele

Rendelés állapot változás (Rest napló típus = NetGo-Rendelés állapot) - order
 
Változást beindító esemény:
 - Ajánlat változás (Útvonal: sERPa Alap \ Logisztika \ Rendelés-nyilvántartás \ Ajánlat) --> BizonylatValtozasFigyeles(BizonylatTipus_ID = 10)
 - Vevő rendelés változás (Útvonal: sERPa Alap \ Logisztika \ Rendelés-nyilvántartás \ Vevő rendelés) --> BizonylatValtozasFigyeles(BizonylatTipus_ID = 11)
 - Szállító rendelés változás (Útvonal: sERPa Alap \ Logisztika \ Rendelés-nyilvántartás \ Szállító rendelés) --> BizonylatValtozasFigyeles(BizonylatTipus_ID = 12)
 - Rendelés válasz változás: BizonylatValtozasFigyeles(BizonylatTipus_ID = 34)
 
Változást okozó események (amennyiben teljesül a változás további feltételeinél meghatározott összes kritérium is):
Felvétel, módosítás, törlés:
 - Az ajánlat vagy vevőrendelés bármely tételén szerepel vagy szerepelt olyan rendelés tétel tulajdonság, amely típusa a webáruház paraméterben meg megadva.
 - Bármilyen válasz változik a vevőrendelésen.
 
*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.
  - Ajánlat esetén az ajánlat sorozata megegyezik a webáruház paraméterben megadott ajánlat sorozattal.
  - Vevőrendelés esetén a sorozatra teljesül a webáruház paraméterben beállított 'Vevőrendelés állapot sorozat képlet'.
  - Szállítórendelés esetén a bizonylathoz olyan vevőrendelés típusú foglalás kerül bekapcsolásra, amelyre teljesül a webáruház paraméterben beállított 'Vevőrendelés állapot sorozat képlet'.
 
*Megjegyzés:
  - Ajánlatról csak akkor küldünk változást, ha a mai napra nézve az érvényessége vagy annak hiányában a bizonylat dátuma nem kisebb a mai napnál.
  - Tétel felvételnél a túl oldal válaszából elrakjuk a túl oldaltól kapott item_id azonosítókat a rendelés (vagy ajánlat) tétel tulajdonságába. A hivatkozási számba mentésre kerül egy szintén kapott azonosító.
  - A felvétel típusánál: insert, a módosítás típusnál: update, a törlés típusánál: deleted értéke kerül a type mezőbe. (itt miért nem delete?)
    (ha a felvétel felhasználója, eltér az eljárást futtató felhasználótól, akkor update lesz a típus).

Rendeles_3 XML leírás

<serpa

  <head

    <token

    <type                                                ; Lehetséges értékek order_serpa vagy offer

    <time                                                ; Az XML készítésének időpontja

  head>

  <content

    <order

      type                                                ; Lehetséges értékek 

                                                   update

                                                   insert - csak a sERPa-ban felvett rendelés esetén. Azt tekintjük sERPa-ban felvett rendelésnek, aminél a felvevő felhasználó NEM! egyezik meg a Gépdepo paraméterben megadott                                                                         Webes rendelés felhasználóval)

                                                   deleted - ekkor csak az order_code és az erp_order_code kerül átadásra.

      order_code                                                ; Hivatkozási szám (webes rendelés azonosító)

      erp_order_code                                        ; sERPa bizonylatszám

      currency                                                ; Bizonylat devizanem

      offer_valid_date                                        ; Ajánlat esetén az érvényesség dátuma. (Bizonylat dátum + Érvényesség=ÉÉHHNN)

      invoice_code                                        ; Rendeléshez kapcsolt szállítólevélhez kapcsolt vevőszámla bizonylatszáma, ha több van, akkor az első, bizonylatszám szerint rendezve

      <customer_comment/>                                ; Fejléc megjegyzés (CDATA, maximum 10 000 karakter)

        <customer

 phone                                                ; A rendelésen szereplő ügyfélben lévő hivatali telefon. Ha üres, akkor a rendelésben szereplő ügynök ügyfelében megadott.

 email                                                ; A rendelésen szereplő ügyfélben lévő hivatali e-mail. Ha üres, akkor a rendelésben szereplő ügynök ügyfelében megadott.

 customer_webshop_code                        ; Ha van a rendelésben ügynök, akkor az ahhoz kapcsolt ügyfélben szereplő Regisztrációs idegenazonosító. (vendég vásárló által leadott rendelés esetén nincs ilyen adat.)

 bill_webshop_code                                ; A rendelésben szereplő ügyélben megadott Számlázási idegenazonosító - ha meg van adva. (vendég vásárló által leadott rendelés esetén nincs ilyen adat.)

 taxnumber                                        ; A rendelésen szereplő ügyfélben lévő adószám. Magánszemély esetén nem adjuk á

 bill_name                                        ; Rendelésben szereplő Ügyfél név.

 bill_zip                                                ; Rendelésben szereplő Ügyfél irányítószám.

 bill_city                                                ; Rendelésben szereplő Ügyfél város.

 bill_street                                        ; Rendelésben szereplő Ügyfél utca-házszám.

 postal_name                                        ; Rendelésben szereplő Ügyféltelephely név.

 postal_zip                                        ; Rendelésben szereplő Ügyféltelephely irányítószám.

 postal_city                                        ; Rendelésben szereplő Ügyféltelephely város.

 postal_street                                        ; Rendelésben szereplő Ügyféltelephely utca-házszám.

        customer>

        <items

 <item

   type                                                ; lehetséges értékek update, insert és deleted. (deleted esetén csak az item_id kerül átadásra)

   item_id                                        ; rendelés tétel azonosító. Új tétel esetén üresen marad.

   product_code                                        ; termék kód

   pc                                                ; mennyiség

   net_unit_price                                        ; nettó egységár (kedvezménnyel csökkentett)

   gross_unit_price                                ; bruttó egységár (kedvezménnyel csökkentett)

   net_price                                        ; kedvezményekkel csökkentett nettó érték

   gross_price                                        ; kedvezményekkel csökkentett bruttó érték

   original_net_price                                ; nettó érték (a rendelés tételen szereplő érték)

   original_gross_price                                ; bruttó érték  (a rendelés tételen szereplő érték)

   vat                                                ; Áfa %

   <statuses

     <status

       status_id                                        ; 0-rendelt, 1-visszaigazolt,2-diszponált,3-teljesített,4-elutasított,5-visszamondott,6-belső továbbrendelt, 7 szállító továbbrendelt

       pc                                                ; mennyi darabra vonatkozik a megadott státusz

       supply_time                                         ; továbbrendelt (6,7) esetén a beérkezés dátuma(MAX), (foglaláson keresztül) ha teljesítve van akkor is átadásra kerül, hogy ez a tétel továbbrendeléssel teljesült.

                <supply_time_by_quantity                        ; Amennyiben egy napon több mennyiség érkezik be, azokat a mennyiségeket összeadjuk és egy dátummal adjuk át (pl 3 rendelésen érkezik 50 labda (10-20-20 darab), mindegyik 2021.10.15-én, akkor azt összevonjuk)

                  <quantity value="10"                                ; mennyiség

                    supply_time="2021-10-25"                        ; adott mennyiség beérkezés dátuma                                                         

                  quantity>

                supply_time_by_quantity>

             status>

   statuses>

 item>

        items>

        <delivery

 delivery_id_id                                        ; Fuvardij_ID

 delivery_cost_net                                ; Fuvar összeg nettó (fixen 27% áfa)

 delivery_cost_gross                                ; Fuvar összeg bruttó (fixen 27% áfa)

        delivery>

        <payment

 payment_id                                        ; fizetési mód sERPa ID-je

 payment_name                                        ; fizetési mód név

        </payment>        

        <seller_comment>                                        ; Saját megjegyzés mezőben kiválasztott további adat szöveg értéke

 

Rendeles_3 példa XML

<serpa>

  <head>

    <token></token>

    <type>order_serpa</type>

    <time>2021-10-21T11:59:33.673</time>

  </head>

  <content>

    <order>

      <type>update</type>

      <order_code>2110211047</order_code>

      <erp_order_code>2021-WGP2/000002</erp_order_code>

      <currency>HUF</currency>

      <customer_comment>&lt;body&gt;&lt;p&gt;Rendelés megjegyzés&lt;/p&gt;&lt;/body&gt;</customer_comment>

      <customer>

        <phone>06204058182</phone>

        <email>netgoandras@gmail.com</email>

        <customer_webshop_code>netgo_customer_1</customer_webshop_code>

        <bill_webshop_code>netgo_bill_1</bill_webshop_code>

        <bill_name>NetGo András</bill_name>

        <bill_zip>1141</bill_zip>

        <bill_city>Budapest</bill_city>

        <bill_street>Egressy út 113/Hi /B/1/3</bill_street>

        <postal_name>NetGo András</postal_name>

        <postal_zip>1141</postal_zip>

        <postal_city>Budapest</postal_city>

        <postal_street>Egressy út 113/Hi /B/1/3</postal_street>

      </customer>

      <items>

        <item>

          <type>update</type>

          <product_code>WEB001</product_code>

          <pc>10</pc>

          <net_unit_price>100</net_unit_price>

          <gross_unit_price>127</gross_unit_price>

          <net_price>1000</net_price>

          <gross_price>1270</gross_price>

          <original_net_price>1000</original_net_price>

          <original_gross_price>1270</original_gross_price>

          <vat>27</vat>

          <recommended_delivery_date>2021-10-26</recommended_delivery_date>

          <statuses>

            <status>

              <status_id>1</status_id>

              <pc>10.00</pc>

            </status>

            <status>

              <status_id>2</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>3</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>4</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>5</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>6</status_id>

              <pc>5.00</pc>

              <supply_time>2021-10-26</supply_time>

              <supply_time_by_quantity>

                <quantity value="5.00" supply_time="2021-10-26" />

              </supply_time_by_quantity>

            </status>

            <status>

              <status_id>7</status_id>

              <pc>5.00</pc>

              <supply_time>2021-10-23</supply_time>

              <supply_time_by_quantity>

                <quantity value="2.00" supply_time="2021-10-22" />

                <quantity value="3.00" supply_time="2021-10-23" />

              </supply_time_by_quantity>

            </status>

          </statuses>

        </item>

        <item>

          <type>update</type>

          <product_code>WEB002</product_code>

          <pc>1</pc>

          <net_unit_price>4900</net_unit_price>

          <gross_unit_price>6223</gross_unit_price>

          <net_price>4900</net_price>

          <gross_price>6223</gross_price>

          <original_net_price>5000</original_net_price>

          <original_gross_price>6350</original_gross_price>

          <vat>27</vat>

          <recommended_delivery_date>2021-10-21</recommended_delivery_date>

          <statuses>

            <status>

              <status_id>1</status_id>

              <pc>1.00</pc>

            </status>

            <status>

              <status_id>2</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>3</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>4</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>5</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>6</status_id>

              <pc>0.00</pc>

            </status>

            <status>

              <status_id>7</status_id>

              <pc>0.00</pc>

            </status>

          </statuses>

        </item>

      </items>

      <delivery>

        <delivery_id>5</delivery_id>

        <delivery_cost_net>100</delivery_cost_net>

        <delivery_cost_gross>127</delivery_cost_gross>

      </delivery>

      <payment>

        <payment_id>2</payment_id>

        <payment_name>Kp</payment_name>

      </payment>

      <seller_comment>Saját megjegyzés további adat szöveg</seller_comment>

    </order>

  </content>

</serpa>

Rendeles_3_response XML leírás

<serpa

  <head

    <token

    <type                                                ; order_serpa

    <time                                                ; az xml készítésének időpontja

  head>

    <response

      <status                                                ; 0 a sikeres

      <response_text                                        ; egyéb üzenet

      <erp_order_code                                        ; sERPa bizonylatszám, ez alapján azonosítjuk, hogy melyik sERPa rendeléshez kell az új adatokat felvenni.

      <order_code                                        ; web által adott rendelés azonosító, amit a Hivatkozási szám mezőbe be kell írni. Akkor van jelentősége, ha sERPa-ban vettek fel új rendelést.

      <items

        <item

 product_code                                        ; ez alapján azonosítjuk, hogy melyik újonnan felvett bizonylat tételhez kell felvenni a kapott item_id -t.

 item_id                                                ; web által adott rendeléstétel azonosító, ami a paraméterben megadott tétel tulajdonságba kerül felvételre. Csak azoknál a tételeknél figyeljük, amik a sERPa-ban újonnan kerültek felvételre. Mivel ez az adat a bizonylat újabb módosítását eredményezi, ezért az item_ID rögzítése után a bizonylatot újra elküldjük az áruháznak.