„Rendelés API” változatai közötti eltérés

A Hotelsystem wikiből
 
(5 közbenső módosítás ugyanattól a szerkesztőtől nincs mutatva)
1. sor: 1. sor:
<nowiki><nowiki>A rendelés átadásához a Gastrosystem rendszerbe a következő URL-re kell POST kérést küldeni:
+
A rendelés átadásához a Gastrosystem rendszerbe a következő URL-re kell POST kérést küldeni:
  
 
http://dev.hotelsystem.hu/api/manager/iev4j9vnt8uv  
 
http://dev.hotelsystem.hu/api/manager/iev4j9vnt8uv  
  
paraméterek:<br>
+
paraméterek:<br/>
auth: 12345
+
auth: 12345 <br/>
action: ADD_ORDER_XML<br>
+
action: ADD_ORDER_XML<br/>
order_id: rendelés azonosítója a forrásrendszerben (pl. webáruházbeli rendelés id)<br>
+
order_id: rendelés azonosítója a forrásrendszerben (pl. webáruházbeli rendelés id)<br/>
order: a lenti mintának megfelelően összeállított rendelés<br>
+
order: a lenti mintának megfelelően összeállított rendelés<br/>
  
 
Éles környezetben az URL és az auth paraméter értéke fog változni. Erre a fejlesztői környezetre nyugodtan lehet bármit küldeni.
 
Éles környezetben az URL és az auth paraméter értéke fog változni. Erre a fejlesztői környezetre nyugodtan lehet bármit küldeni.
 
+
<pre>
<order><br>
+
<order>
     <customer><br>
+
     <customer>
         <id>61</id> <!--ID a webshopban, ha nincs, akkor bármilyen természetes ügyfél azonosító, pl email cím--><br>
+
         <id>61</id> <!--ID a webshopban, ha nincs, akkor bármilyen természetes ügyfél azonosító, pl email cím-->
         <name>Nagy Tamas</name> <!--Vevő neve--><br>
+
         <name>Nagy Tamas</name> <!--Vevő neve-->
         <tel>+36201234567</tel> <!--Vevő telefonszáma--><br>
+
         <tel>+36201234567</tel> <!--Vevő telefonszáma-->
         <email>nagy.tamas@example.com</email> <!--Vevő email címe--><br>
+
         <email>nagy.tamas@example.com</email> <!--Vevő email címe-->
         <address><br>
+
         <address>
             <country>HU</country> <!--Szállítási cím ország--><br>
+
             <country>HU</country> <!--Szállítási cím ország-->
             <city>Budapest</city> <!--Szállítási cím város--><br>
+
             <city>Budapest</city> <!--Szállítási cím város-->
             <postalcode>1077</postalcode> <!--Szállítási cím irányítószám--><br>
+
             <postalcode>1077</postalcode> <!--Szállítási cím irányítószám-->
             <street>Izabella u. 23</street> <!--Szállítási cím utca, házszám, emelet, ajtó--><br>
+
             <street>Izabella u. 23</street> <!--Szállítási cím utca, házszám, emelet, ajtó-->
         </address><br>
+
        </address>
     </customer><br>
+
        <hswaiterid>23</hswaiterid> <!--Rendeléshez tartozó pincér ID-je, ha van, helyben fogyasztásnál (házhozszállítás esetén nem kell a tag)-->
     <date>2016-04-15 04:04:44</date> <!--Rendelés ideje--><br>
+
         <hstableid>23</hstableid> <!--Rendeléshez tartozó asztal ID-je, ha van, helyben fogyasztásnál (házhozszállítás esetén nem kell a tag)-->
     <extra><br>
+
     </customer>
         <comment>a pizzát szeletelve kérjük. kapucsengő: 16</comment> <!--Rendeléshez kapcsolódó tetszőleges megjegyzés--><br>
+
     <date>2016-04-15 04:04:44</date> <!--Rendelés ideje, teszthez mindig az adott napi dátum legyen!-->
         <invoice>Y</invoice> <!--ÁFÁS számla igény Y/N--><br>
+
     <extra>
         <note>10000</note> <!--Nagy címlettel fizet, címlet--><br>
+
         <comment>a pizzát szeletelve kérjük. kapucsengő: 16</comment> <!--Rendeléshez kapcsolódó tetszőleges megjegyzés-->
        <coupon /> <!--Kupon kódja - ha van--><br>
+
         <invoice>Y</invoice> <!--ÁFÁS számla igény Y/N-->
     </extra><br>
+
         <note>10000</note> <!--Nagy címlettel fizet, címlet-->
     <basket> <!--Rendelés adatai--><br>
+
     </extra>
         <item> <!--1. tétel--><br>
+
     <basket> <!--Rendelés adatai-->
             <code>111</code> <!--Termék azonosítója a webshopban--><br>
+
         <item> <!--1. tétel-->
             <name>Óriás pizza</name> <!--Termék neve webshopban--><br>
+
             <code>111</code> <!--Termék azonosítója a webshopban-->
             <price>1990.0000</price> <!--Termék bruttó eladási ára a webshopban (kedvezményekkel csökkentett)--><br>
+
             <name>Óriás pizza</name> <!--Termék neve webshopban-->
             <amount>2.0000</amount> <!--Termék mennyisége--><br>
+
             <price>1990.0000</price> <!--Termék bruttó eladási ára a webshopban (kedvezményekkel csökkentett)-->
             <comment>sajt nélkül!</comment> <!--tétel szintű megjegyzés, opcionális--><br>
+
             <amount>2.0000</amount> <!--Termék mennyisége-->
         </item><br>
+
             <comment>sajt nélkül!</comment> <!--tétel szintű megjegyzés, opcionális-->
         <item> <!--2. tétel--><br>
+
         </item>
             <code>222</code><br>
+
         <item> <!--2. tétel-->
             <name>Sajtos pizza</name><br>
+
             <code>222</code>
             <price>990.0000</price><br>
+
             <name>Sajtos pizza</name>
             <amount>1.0000</amount><br>
+
             <price>990.0000</price>
         </item><br>
+
             <amount>1.0000</amount>
     </basket><br>
+
         </item>
     <price> <!--Összegzés--><br>
+
     </basket>
         <net>4970.0000</net> <!--Bruttó érték összesen, kedvezményekkel csökkentve (a tételek szummája)--><br>
+
     <price> <!--Összegzés-->
         <wrapping>341</wrapping> <!--Csomagolás díja - ha van--><br>
+
         <net>4970.0000</net> <!--Bruttó érték összesen, kedvezményekkel csökkentve (a tételek szummája)-->
         <delivery>1000</delivery> <!--Házhozszállítás díja - ha van--><br>
+
         <wrapping>341</wrapping> <!--Csomagolás díja - ha van-->
         <sum>6311.9000</sum> <!--Fizetendő összesen--><br>
+
         <delivery>1000</delivery> <!--Házhozszállítás díja - ha van-->
     </price><br>
+
         <sum>6311.9000</sum> <!--Fizetendő összesen-->
</order><br>
+
        <payment_id>CASH</payment_id> <!--Fizetési mód azonosítója a külső rendszerben-->
 +
     </price>
 +
</order>
 +
</pre>

A lap jelenlegi, 2022. december 15., 14:29-kori változata

A rendelés átadásához a Gastrosystem rendszerbe a következő URL-re kell POST kérést küldeni:

http://dev.hotelsystem.hu/api/manager/iev4j9vnt8uv

paraméterek:
auth: 12345
action: ADD_ORDER_XML
order_id: rendelés azonosítója a forrásrendszerben (pl. webáruházbeli rendelés id)
order: a lenti mintának megfelelően összeállított rendelés

Éles környezetben az URL és az auth paraméter értéke fog változni. Erre a fejlesztői környezetre nyugodtan lehet bármit küldeni.

<order>
    <customer>
        <id>61</id> <!--ID a webshopban, ha nincs, akkor bármilyen természetes ügyfél azonosító, pl email cím-->
        <name>Nagy Tamas</name> <!--Vevő neve-->
        <tel>+36201234567</tel> <!--Vevő telefonszáma-->
        <email>nagy.tamas@example.com</email> <!--Vevő email címe-->
        <address>
            <country>HU</country> <!--Szállítási cím ország-->
            <city>Budapest</city> <!--Szállítási cím város-->
            <postalcode>1077</postalcode> <!--Szállítási cím irányítószám-->
            <street>Izabella u. 23</street> <!--Szállítási cím utca, házszám, emelet, ajtó-->
        </address>
        <hswaiterid>23</hswaiterid> <!--Rendeléshez tartozó pincér ID-je, ha van, helyben fogyasztásnál (házhozszállítás esetén nem kell a tag)-->
        <hstableid>23</hstableid> <!--Rendeléshez tartozó asztal ID-je, ha van, helyben fogyasztásnál (házhozszállítás esetén nem kell a tag)-->
    </customer>
    <date>2016-04-15 04:04:44</date> <!--Rendelés ideje, teszthez mindig az adott napi dátum legyen!-->
    <extra>
        <comment>a pizzát szeletelve kérjük. kapucsengő: 16</comment> <!--Rendeléshez kapcsolódó tetszőleges megjegyzés-->
        <invoice>Y</invoice> <!--ÁFÁS számla igény Y/N-->
        <note>10000</note> <!--Nagy címlettel fizet, címlet-->
    </extra>
    <basket> <!--Rendelés adatai-->
        <item> <!--1. tétel-->
            <code>111</code> <!--Termék azonosítója a webshopban-->
            <name>Óriás pizza</name> <!--Termék neve webshopban-->
            <price>1990.0000</price> <!--Termék bruttó eladási ára a webshopban (kedvezményekkel csökkentett)-->
            <amount>2.0000</amount> <!--Termék mennyisége-->
            <comment>sajt nélkül!</comment> <!--tétel szintű megjegyzés, opcionális-->
        </item>
        <item> <!--2. tétel-->
            <code>222</code>
            <name>Sajtos pizza</name>
            <price>990.0000</price>
            <amount>1.0000</amount>
        </item>
    </basket>
    <price> <!--Összegzés-->
        <net>4970.0000</net> <!--Bruttó érték összesen, kedvezményekkel csökkentve (a tételek szummája)-->
        <wrapping>341</wrapping> <!--Csomagolás díja - ha van-->
        <delivery>1000</delivery> <!--Házhozszállítás díja - ha van-->
        <sum>6311.9000</sum> <!--Fizetendő összesen-->
        <payment_id>CASH</payment_id> <!--Fizetési mód azonosítója a külső rendszerben-->
    </price>
</order>