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! -->

<rendelesek><!-- Több rendelés esetén kell csak. Alternatív nevek: bizonylatok/documents/orders-->

  <rendeles><!-- Alternatív név: order-->

    <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 ügyfelet 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.-->

        <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 -->

        <szalldatum>2014-09-25</szalldatum><!-- Kötelező! A kért szállítás dátuma YYYY-MM-DD formában. Alternatív nevek: teljesites/date_shipped -->

        <szallito>mi</szallito><!-- Opcionális! Alternatív név: shipper. Lehetséges értékek: mi|we, partner. Alapértelmezett a paraméterezésben beállított -->

        <szallitasicim><!-- Opcionális! Alternatív név: shippingaddress -->

          <irszam>1234</irszam><!-- Irányitószám. Alternatív nevek: zip/postalcode-->

          <telepules>xxx</telepules><!-- Település. Alternatív nevek: city/cityname/town-->

          <cim>xxx</cim><!-- Utca, házszám... Alternatív név: address-->          

        </szallitasicim>

        <fizetesimod>0</fizetesimod><!-- Kötelező! Fizetési mód kódja. A default értékek:

          0 : Átutalás

          2 : Csekk

          4 : Készpénz1

          5 : Készpénz2

          7 : Utánvétel

          8 : Előre utalás

          11 : Hitelkártya -->

        <fizdatum>2014-09-31</fizdatum><!-- Opcionális! Fizetési határidő. Alternatív név: esedekes|date_payment_due. Alapértelmezetten az ügyféltörzsben megadott -->

        <sorozat>YY99</sorozat><!-- Opcionális! Rendelés sorozat. Alternatív név: series. Ha nincs megadva, akkor webszervíz paraméterekben megadott sorozatra kerül a rendelés -->

        <alapbizonylat>xxx</alapbizonylat><!-- Opcionális! Alternatív név: hivszam|reference -->

        <ajanlatiszam>xxx</ajanlatiszam><!-- Opcionális! Alternatív név: hivszam|reference; jegyzettámogatás esetén ide kerül a vásárló NEPTUN kódja -->  

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

        <telephely_id>99</telephely_id><!-- Opcionális! Sajátcímben rögzített telephely id: a rendelés/szállítólevél/számla ezzel a telephely id-vel fog elkészülni. Alternatív név: office_id -->

        <deviza>HUF</deviza><!-- Opcionális! Devizanem. Alternatív név: devnem|currency. --> 

        <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. --> 

        <megjegyzes>xxx</megjegyzes><!-- Opcionális! Megjegyzés. Alternatív név: comment|megj|other_data. -->

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

        <tamogatas>9999</tamogatas><!-- Opcionális! A Jegyzettámogatás funkció használja. -->

      </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 -->

        <mennyiseg>123</mennyiseg>

        <megjegyzes>xxx</megjegyzes><!-- Opcionális! Alternatív név: comment/megj/other_data. Max. 16 karakterig a VevőRTétel.Megjegyzésbe kerül, felette a VevőRTétel3.Szöveg mezőbe -->

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

      </tetel>

      <tetel>

        ...

      </tetel>

    </tetelek>

  </rendeles>

  <rendeles>

    ...

  </rendeles>

</rendelesek>

Régi xml szerkezete

aa

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

<ORDERS>

  <ORDER>

    <ORDERHEAD_DATE> 2010-03-01 </ORDERHEAD_DATE>    <!-- Kötelező! A rendelés dátuma YYYY-MM-DD formában -->

    <ORDERHEAD_PARTNER_CODE> 12345678 </ORDERHEAD_PARTNER_CODE>    <!-- Ügyfélkód, ha az ügyfél már létezik, ha nincs, vagy üres, akkor új ügyfelet fog felvenni. -->

    <ORDERHEAD_PARTNER_NAME> xxx </ORDERHEAD_PARTNER_NAME>    <!-- Opcionális. Ügyfélnév, csak új ügyfél esetén kerül feldolgozásra, akkor kötelező -->

    <ORDERHEAD_PARTNER_ZIP> 1234 </ORDERHEAD_PARTNER_ZIP>    <!-- Opcionális. Új ügyfél esetén az irányítószám, illetve ha nincs ORDERHEAD_PARTNER_SHIPPING_ZIP, akkor ez kerül a helyére. -->

    <ORDERHEAD_PARTNER_CITY> xxx </ORDERHEAD_PARTNER_CITY>    <!-- Opcionális. Új ügyfél esetén a város, illetve ha nincs ORDERHEAD_PARTNER_SHIPPING_CITY, akkor ez kerül a helyére. -->

    <ORDERHEAD_PARTNER_ADDRESS> xxx </ORDERHEAD_PARTNER_ADDRESS>    <!-- Opcionális. Új ügyfél esetén az utca, házszám..., illetve ha nincs ORDERHEAD_PARTNER_SHIPPING_ADDRESS, akkor ez kerül a helyére. -->

    <ORDERHEAD_PARTNER_OTHER_DATA> xxx </ORDERHEAD_PARTNER_OTHER_DATA>    <!-- Opcionális. Ügyfél megjegyzés, csak új ügyfél esetén kerül feldolgozásra -->

    <ORDERHEAD_PARTNER_TEL> xxx </ORDERHEAD_PARTNER_TEL>    <!-- Opcionális. Ügyfél telefonszám, csak új ügyfél esetén kerül feldolgozásra -->

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

    <ORDERHEAD_PARTNER_MOBIL> xxx </ORDERHEAD_PARTNER_MOBIL>    <!-- Opcionális. Ügyfél mobil telefonszám, csak új ügyfél esetén kerül feldolgozásra -->

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

    <ORDERHEAD_PARTNER_TAX_CODE> xxx </ORDERHEAD_PARTNER_TAX_CODE>    <!-- Opcionális. Ügyfél adószám, csak új ügyfél esetén kerül feldolgozásra -->

    <ORDERHEAD_PARTNER_OFFICE_CODE> 1234 </ORDERHEAD_PARTNER_OFFICE_CODE>    <!-- Opcionális. Ügyfél telephely kód. -->

    <ORDERHEAD_PARTNER_PERSON_CODE> 12 </ORDERHEAD_PARTNER_PERSON_CODE>    <!-- Opcionális. Ügyfél ügyintéző kód. -->

    <ORDERHEAD_PARTNER_PERSON_NAME> xxx </ORDERHEAD_PARTNER_PERSON_NAME>    <!-- Opcionális. Ügyfél ügyintéző név. Abban az esetben használható, ha az ügyintéző nem szerepel a machinátor adatbázisában. -->

    <ORDERHEAD_SHIPPER> WE </ORDERHEAD_SHIPPER>    <!-- Opcionális. Szállító. Ha az érték érték "WE", akkor "Mi szállítunk" lesz a felvett rendelés fejben, minden más érték esetén 'Ők szállítanak". -->

    <ORDERHEAD_PARTNER_SHIPPING_ZIP> xxx </ORDERHEAD_PARTNER_SHIPPING_ZIP>    <!-- Opcionális. Szállítási irányítószám, ha nem egyezik az ügyféllel vagy telephellyel. -->

    <ORDERHEAD_PARTNER_SHIPPING_CITY> xxx </ORDERHEAD_PARTNER_SHIPPING_CITY>    <!-- Opcionális. Szállítási város, ha nem egyezik az ügyféllel vagy telephellyel. -->

    <ORDERHEAD_PARTNER_SHIPPING_ADDRESS> xxx </ORDERHEAD_PARTNER_SHIPPING_ADDRESS>    <!-- Opcionális. Szállítási cím, ha nem egyezik az ügyféllel vagy telephellyel. -->

    <ORDERHEAD_PAYMENTMETHOD_CODE> 0 </ORDERHEAD_PAYMENTMETHOD_CODE>    <!-- Kötelező! Fizetési mód kódja. A default értékek:

          0 : Átutalás

          2 : Csekk

          4 : Készpénz1

          5 : Készpénz2

          7 : Utánvétel

          8 : Előre utalás

          11 : Hitelkártya -->

    <ORDERHEAD_DATE_SHIPPED> 2010-03-15 </ORDERHEAD_DATE_SHIPPED>    <!-- Kötelező! A szállítási határidő YYYY-MM-DD formában -->

    <ORDERHEAD_DATE_PAYMENT_DUE> 2010-03-15 </ORDERHEAD_DATE_PAYMENT_DUE>    <!-- Opcionális. A fizetési határidő YYYY-MM-DD formában -->

    <ORDERHEAD_WAREHOUSE> 12345678 </ORDERHEAD_WAREHOUSE>    <!-- Opcionális. Raktárkód -->

    <ORDERHEAD_SERIES> 1234 </ORDERHEAD_SERIES>    <!-- Opcionális. Rendelés sorozat (elválasztó karakteres nélül!). Az "YY"-t behelyettesíti az évszámmal ( YY12, vagy 12YY)  -->

    <ORDERHEAD_REFERENCE> xxx </ORDERHEAD_REFERENCE>    <!-- Opcionális. Hivatkozási szám -->

    <ORDERHEAD_COMMENT> xxx </ORDERHEAD_COMMENT>    <!-- Opcionális. Rendelés fejléc megjegyzés -->

    <ORDERITEM>

      <ORDERITEM_PRODUCT_CODE> xxx </ORDERITEM_PRODUCT_CODE>      <!-- Kötelező! Cikkszám -->

      <ORDERITEM_COMMENT> xxx </ORDERITEM_COMMENT>      <!-- Opcionális. Rendelés tétel megjegyzés -->

      <ORDERITEM_PRICE> 1.23 </ORDERITEM_PRICE>      <!-- Kötelező! Egységár -->

      <ORDERITEM_SAVE_PERCENT> 10 </ORDERITEM_SAVE_PERCENT>      <!-- Opcionális. Engedmény % -->

      <ORDERITEM_QTY> 1 </ORDERITEM_QTY>      <!-- Kötelező! Mennyiség -->

    </ORDERITEM>

    <ORDERITEM>

      ...

    </ORDERITEM>

  </ORDER>

  <ORDER>

    ...

  </ORDER>

</ORDERS>