Alkalmazó funkciók

Az alábbi XML-t a következő funkciók alkalmazzák

A webszerviz paraméterezésében megadhatók mind a Webáruház rendeléskezelésben, mind a Közvetlen szállítólevél felvételben azon extra mezők, melyek a webről érkező rendelés, ill. szállítólevél xml-ből betöltésre kerülhetnek. Mindkét helyen a szükséges extra mezőkhöz xml tag nevet kell adni, mely csak az angol ABC betűiből, ill . számokból állhat. Ha az xml-ben az <info> blokkban van ilyen tag, a program a megfelelő extra mezőbe betölti annak értékét. Az extra mező típusra figyelemmel kell lenni az érték megadásánál. A működés használható a webről érkező rendeléseknél, ill. szállítóleveleknél, és a CF_WEBAF-CF_WEBRF funkciókban is.

Tehát a Rendszerfunkciók – Web paraméterek – Rendelés kezelésnél lehet megadni a paramétereket:

input xml szerkezete

<?xml version="1.0" encoding="Windows-1250" ?><!-- A kódolás itt is mindegy! -->

<szallitolevelek><!-- Több szállítólevél esetén kell csak. Alternatív nevek: bizonylatok/documents/stock_traffics-->

  <szallitolevel><!-- Alternatív név: stock_traffic-->

    <fejlec><!-- Alternatív név:head-->

      <partner>

        <kod>12345678</kod><!-- Machinátoros ügyfélkód. Ha ez a mező ki van töltve, akkor az ügyfél többi adata fölösleges. Alternatív név:code-->

        <adoszam>1234567890123</adoszam><!-- Opcionális, csak üres kód mező esetén kerül feldolgozásra, ekkor megpróbálja ez alapján előkeresni az ügzfe Alternatív név:taxcode-->

        <csopadoszam>1234567890123</csopadoszam><!-- Opcionális, csak üres kód mező esetén kerül feldolgozásra. Alternatív név:grouptaxcode-->

        <id>xxx</id><!-- Opcionális, csak üres kód mező esetén kerül feldolgozásra, ekkor megpróbálja ez alapján előkeresni az ügyfelet az ÜgyfélID állományban, ha nincs akkor ezt is felveszi! Alternatív név:azonosito,identifier-->

        <nev>xxx</nev><!-- Opcionális. Ügyfélnév, csak új ügyfél esetén kerül feldolgozásra, akkor kötelező. Max 40 karakter. Alternatív név:name-->

        <hosszunev>xxx</hosszunev><!-- Opcionális, csak új ügyfél esetén kerül feldolgozásra. Max 80 karakter. Alternatív név: longname-->

        <irszam>1234</irszam><!-- Opcionális. Irányitószám, csak új ügyfél esetén kerül feldolgozásra. Alternatív nevek: zip/postalcode-->

        <telepules>xxx</telepules><!-- Opcionális. Település, csak új ügyfél esetén kerül feldolgozásra. Alternatív nevek: city/cityname/town-->

        <cim>xxx</cim><!-- Opcionális. Utca, házszám..., csak új ügyfél esetén kerül feldolgozásra. Alternatív név: address-->

        <megjegyzes>xxx</megjegyzes><!-- Opcionális. Ügyfél megjegyzés, csak új ügyfél esetén kerül feldolgozásra. Max 40 karakter. Alternatív nevek: comment/megj/other_data-->

        <telefon>xxx</telefon><!-- Opcionális. Telefonszám, csak új ügyfél esetén kerül feldolgozásra. Max 40 karakter. Alternatív nevek: telephone/tel-->

        <fax>xxx</fax><!-- Opcionális. Fax szám, csak új ügyfél esetén kerül feldolgozásra. Max 40 karakter.-->

        <mobil>xxx</mobil><!-- Opcionális. Mobiltelefon szám, csak új ügyfél esetén kerül feldolgozásra. Max 40 karakter.-->

        <email>xxx</email><!-- Opcionális. Email cím, csak új ügyfél esetén kerül feldolgozásra. Max 50 karakter.-->

        <loginnev>xxx</loginnev><!-- Opcionális. Bejelentkezési név, csak új ügyfél esetén kerül feldolgozásra. Max 20 karakter. Alternatív név: loginname-->

        <loginjelszo>xxx</loginjelszo><!-- Opcionális. Bejelentkezési jelszó, csak új ügyfél esetén kerül feldolgozásra. Max 20 karakter. Alternatív név: loginpsw-->

        <euadoszam>xxx</eudoszam><!-- Opcionális, EU adószám. csak új ügyfél esetén kerül feldolgozásra. Max 30 karakter. Alternatív név:eutaxcode-->

        <ean>xxx</ean><!-- Opcionális, ean kód. csak új ügyfél esetén kerül feldolgozásra. Max 13 karakter.-->

        <orszag>xxx</orszag><!-- Opcionális, ország kód. Csak új ügyfél esetén kerül feldolgozásra. Alternatív név: countrycode -->

        <regio>xxx</regio><!-- Opcionális, régió kód. Csak új ügyfél esetén kerül feldolgozásra. Alternatív név: region -->

        <paramétekben rögzített node név>extra mező értéke/paramétekben rögzített node név><!-- Opcionális, Ügyfél extra mező. csak új ügyfél esetén kerül feldolgozásra.-->

        <telephely><!-- Opcionális. Alternatív név: office -->

          <kod>12</kod><!-- Machinátoros telephely kód. Ha ez a mező ki van töltve, akkor a telephely többi adata fölösleges. Alternatív név:code-->

          <nev>xxx</nev><!-- Opcionális. Telephely név, csak új telephely esetén kerül feldolgozásra, akkor kötelező. Max 40 karakter. Alternatív név:name-->

          <irszam>1234</irszam><!-- Opcionális. Irányitószám, csak új telephely esetén kerül feldolgozásra. Alternatív nevek: zip/postalcode-->

          <telepules>xxx</telepules><!-- Opcionális. Település, csak új telephely esetén kerül feldolgozásra. Alternatív nevek: city/cityname/town-->

          <cim>xxx</cim><!-- Opcionális. Utca, házszám..., csak új telephely esetén kerül feldolgozásra. Alternatív név: address-->

          <megjegyzes>xxx</megjegyzes><!-- Opcionális. Telephely megjegyzés, csak új telephely esetén kerül feldolgozásra. Max 40 karakter. Alternatív nevek: comment/megj/other_data-->

          <telefon>xxx</telefon><!-- Opcionális. Telefonszám, csak új telephely esetén kerül feldolgozásra. Max 40 karakter. Alternatív nevek: telephone/tel-->

          <fax>xxx</fax><!-- Opcionális. Fax szám, csak új telephely esetén kerül feldolgozásra. Max 40 karakter.-->

        </telephely>

        <szemely><!-- Opcionális. Alternatív név: person -->

          <kod>12</kod><!-- Machinátoros ügyfélszemély kód. Ha ez a mező ki van töltve, akkor a személy többi adata fölösleges. Alternatív név:code-->

          <nev>xxx</nev><!-- Opcionális. Szemely név, csak új személy esetén kerül feldolgozásra, akkor kötelező. Max 40 karakter. Alternatív név:name-->

          <telefon>xxx</telefon><!-- Opcionális. Telefonszám, csak új személy esetén kerül feldolgozásra. Max 40 karakter. Alternatív nevek: telephone/tel-->

          <email>xxx</email><!-- Opcionális. Email cím, csak új személy esetén kerül feldolgozásra. Max 50 karakter.-->

        </szemely>

      </partner>

      <info>

        <datum>2014-09-17</datum><!-- Kötelező! A kibocsátás dátuma YYYY-MM-DD formában. Alternatív nevek: date/kibocsatas/documentdate -->

        <mozgasnem>1234</mozgasnem><!-- Opcionális. Mozgásnem kód, ha eltér a paraméterezésben beállítottól. -->

        <alapbizonylat>xxx</alapbizonylat><!-- Opcionális. Alapbizonylat. Alternatív nevek: hivszam/reference.  -->

        <extra1>xxx</extra1><!-- Opcionális. RaktForgHead rekord Extra1 mezőjébe kerülő adat.  -->

        <extra2>xxx</extra2><!-- Opcionális. RaktForgHead rekord Extra2 mezőjébe kerülő adat.  -->

        <deviza>HUF</deviza><!-- Opcionális! Devizanem. Csak akkor dolgozza fel, ha a mozgásnem devizás. Alternatív név: devnem|currency. -->

              <raktar>99999999</raktar><!-- Opcionális! Alternatív név: warehouse -->

        <ugyintezo>99999999</ugyintezo><!-- Opcionális! Saját ügyintéző kód. Alternatív név: ugynok|administrator|broker. -->

              <ugyintezonev>xxx</ugyintezonev><!-- Opcionális! Saját ügyintéző név. Alternatív név: ugynoknev|administratorname|brokername. -->

       <paramétekben rögzített node név>extra mező értéke/paramétekben rögzített node név><!-- Opcionális, Szállítólevél törzs extra mező.-->

        <sorozat>99999</sorozat><!-- Opcionális. A szállítólevélből létrejövő számla PArId-je. A RaktForgHead rekord SzlaParId mezőjébe kerülő adat.  -->

      </info>

    </fejlec>

    <tetelek><!-- Alternatív név: items -->

      <tetel><!-- Alternatív név: item -->

        <cikkszam>xxx</cikkszam><!-- Kötelező! Machinátoros cikkszám (formázás nélkül!). Alternatív nevek: product_code/termekkod/productcode -->

        <egysegar>123</egysegar><!-- Kötelező! Nettó egységár. Alternatív nevek: price/nettoegysar/netunitprice -->

        <engedmeny>12</engedmeny><!-- Engedmény százalék. Opcionális, csak eladás irány esetén lesz feldolgozva. Alternatív nevek: save_percent/engedmenyszazalek -->

        <elad_egysegar>123</elad_egysegar><!-- Opcionális, csak vevő viszáru esetén lesz feldolgozva. Az eredeti eladás nettó egységára. Alternatív nevek: sale_price/elad_nettoegysar/sale_netunitprice -->

        <elad_engedmeny>12</elad_engedmeny><!-- Opcionális, csak vevő viszáru esetén lesz feldolgozva. Az eredeti eladás engedmény százaléka. Alternatív nevek: sale_save_percent/elad_engedmenyszazalek -->

        <mennyiseg>123</mennyiseg><!-- Kötelező! Mennyiség. Alternatív nevek: quantity/qty/menny -->

            <rekesz>99999999</rekesz><!-- Opcionális! Alternatív név: tray -->

       <paramétekben rögzített node név>extra mező értéke/paramétekben rögzített node név><!-- Opcionális, Szállítólevél tétel extra mező.-->

        <gyszamok><!-- Opcionális. Alternatív név: batchcodes -->

          <gyszam><!-- Alternatív név: batchcode -->

            <ertek>xxx</ertek><!-- Kötelező! A gyártási szám értéke. Max 30 karakter. Alternatív név: value -->

            <mennyiseg>123</mennyiseg><!-- Kötelező! A gyártási szám mennyisége. Alternatív nevek: quantity/qty/menny -->

            <datum1>2018-05-02</datum1><!-- Opcionális. A gyártási szám első extra dátuma YYYY-MM-DD formában. Alternatív nevek: date1 -->

            <datum2>2018-05-02</datum2><!-- Opcionális. A gyártási szám második extra dátuma YYYY-MM-DD formában. Alternatív nevek: date2 -->

            <szoveg1>xxx</szoveg1><!-- Opcionális. A gyártási szám első extra szövege. Alternatív nevek: text1 -->

            <szoveg2>xxx</szoveg2><!-- Opcionális. A gyártási szám második extra szövege. Alternatív nevek: text2 -->

          </gyszam>

          <gyszam>

            ...

          </gyszam>

        </gyszamok>

      </tetel>

      <tetel>

        ...

      </tetel>

    </tetelek>

  </szallitolevel>

  <szallitolevel>

    ...

  </szallitolevel>

</szallitolevelek>

 

A válasz xml, ha sikeres a felvétel:

<?xml version="1.0" encoding="Windows-1250" ?>

<RESPONSE>

  <STOCK_TRAFFIC_ADDED>123412345678</STOCK_TRAFFIC_ADDED><!-- Szállítólevél száma (Mozgásnem/Bizonylatszám) elválasztó karakterek nélkül. -->

</RESPONSE>