Termékek lekérése
Ebben a példában egy getProduct kérést láthatsz. A getProduct válaszban csak aktív termékek fognak szerepelni, maximum 50 darab termék a huszadik terméktől kezdve. FULL lekérés látható, így a termék összes adata szerepelni fog a válaszban.
Kérés
<?xml version="1.0" encoding="UTF-8" ?>
<Params>
<StatusBase>1</StatusBase>
<LimitNum>50</LimitNum>
<LimitStart>20</LimitStart>
<ContentType>full</ContentType>
</Params>
Válasz
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Action>modify</Action>
<State>live</State>
<Id>200000</Id>
<Sku>Cikkszam2</Sku>
<SkuNew>Cikkszam2</SkuNew>
<History>
<Event>
<Action>add</Action>
<Time>1348483563</Time>
<Sku>Cikkszam2_old</Sku>
</Event>
<Event>
<Action>modify</Action>
<Time>1348483571</Time>
<Sku>Cikkszam2</Sku>
<SkuOld>Cikkszam2_old</SkuOld>
</Event>
</History>
<Statuses>
<Status>
<Type>base</Type>
<Value>1</Value>
</Status>
<Status>
<Type>plus</Type>
<Id>1</Id>
<Name><![CDATA[Előrendelhető]]></Name>
<Value>1</Value>
</Status>
<Status>
<Type>plus</Type>
<Id>2</Id>
<Name><![CDATA[Külső raktáron]]></Name>
<Value>0</Value>
</Status>
</Statuses>
<NoList>0</NoList>
<Inquire>0</Inquire>
<CustDiscountDisable>0</CustDiscountDisable>
<Explicit>0</Explicit>
<Export>
<Status>1</Status>
<Forbidden>
<Format>preisvergleich.de</Format>
<Format>argep.hu</Format>
</Forbidden>
</Export>
<PublicInterval>
<Start>2019.01.01 0:00</Start>
<End>2020.12.31 23:59</End>
</PublicInterval>
<Name><![CDATA[Termék név 2]]></Name>
<Unit><![CDATA[csomag]]></Unit>
<MinimumQty>1</MinimumQty>
<MaximumQty>5</MaximumQty>
<AlertQty>5</AlertQty>
<UnitStep><![CDATA[2]]></UnitStep>
<AlterUnit>
<Qty>10</Qty>
<Unit><![CDATA[db]]></Unit>
</AlterUnit>
<Weight>1</Weight>
<Point>10</Point>
<BuyableWithPoint>yes</BuyableWithPoint>
<Description>
<Short><![CDATA[rövid leírás]]></Short>
<Long><![CDATA[ez már hosszabb]]></Long>
</Description>
<Prices>
<Vat>27%</Vat>
<Price>
<Type>normal</Type>
<Net>2000</Net>
<Gross>2540</Gross>
</Price>
<Price>
<Type>sale</Type>
<Start>2015.01.01</Start>
<End></End>
<Net>1000</Net>
<Gross>1270</Gross>
</Price>
<Price>
<Type>special</Type>
<Group>100</Group>
<Net>393.7008</Net>
<Gross>500</Gross>
</Price>
<Price>
<Type>special</Type>
<Area>200</Area>
<AreaName><![CDATA[Belföld]]></AreaName>
<Group>100</Group>
<GroupName><![CDATA[Törzsvásárló]]></GroupName>
<Net>629.9212</Net>
<Gross>800</Gross>
</Price>
<Price>
<Type>special</Type>
<Area>200</Area>
<Group>200</Group>
<Net>1000</Net>
<Gross>1270</Gross>
<SaleNet>629.9212</SaleNet>
<SaleGross>800</SaleGross>
<SaleStart>2017.01.01</SaleStart>
<SaleEnd>2017.12.31</SaleEnd>
</Price>
<Price>
<Type>special</Type>
<Area>300</Area>
<Group>300</Group>
<Percent>20%</Percent>
</Price>
<Price>
<Type>special</Type>
<Area>300</Area>
<Group>100</Group>
<CurrencyFilter>EUR</CurrencyFilter>
<Net>629.9212</Net>
<Gross>800</Gross>
<Currency>USD</Currency>
</Price>
<Price>
<Type>special</Type>
<Area>301</Area>
<AreaName><![CDATA[Külföld]]></AreaName>
<QtyDiscount>
<DiscountType>amount_fix</DiscountType>
<Step>
<Limit>
<Lower>0</Lower>
<Upper>10</Upper>
</Limit>
<Price>1400</Price>
</Step>
<Step>
<Limit>
<Lower>10</Lower>
<Upper>20</Upper>
</Limit>
<Price>1300</Price>
</Step>
<Step>
<Limit>
<Lower>20</Lower>
</Limit>
<Price>1200</Price>
</Step>
</QtyDiscount>
<Net>1100.236186667</Net>
<Gross>1400</Gross>
</Price>
</Prices>
<Categories>
<Category>
<Type>base</Type>
<Id>369560</Id>
<Name><![CDATA[Főcsoport1|Alcsoport1]]></Name>
</Category>
<Category>
<Type>alt</Type>
<Id>292475</Id>
<Name><![CDATA[Főcsoport1|Alcsoport2]]></Name>
</Category>
<Category>
<Type>alt</Type>
<Id>706395</Id>
<Name><![CDATA[Főcsoport2|Alcsoport1]]></Name>
</Category>
</Categories>
<Url><![CDATA[http://teszt.unas.hu/Cikkszam1]]></Url>
<SefUrl><![CDATA[Cikkszam1]]></SefUrl>
<Images>
<DefaultFilename><![CDATA[termekkep]]></DefaultFilename>
<DefaultAlt><![CDATA[termeknev]]></DefaultAlt>
<OG>2</OG>
<Version>20200101</Version>
<Image>
<Type>base</Type>
<SefUrl><![CDATA[http://teszt.unas.hu/img/elso.jpg]]></SefUrl>
<Filename><![CDATA[fokepnev]]></Filename>
<Alt><![CDATA[fokepalt]]></Alt>
</Image>
<Image>
<Type>alt</Type>
<Id>1</Id>
<SefUrl><![CDATA[http://teszt.unas.hu/img/masodik.jpg]]></SefUrl>
<Filename><![CDATA[masodikkep]]></Filename>
<Alt><![CDATA[masodikalt]]></Alt>
</Image>
<Image>
<Type>alt</Type>
<Id>2</Id>
<SefUrl><![CDATA[http://teszt.unas.hu/img/harmadik.jpg]]></SefUrl>
<Filename><![CDATA[harmadikkep]]></Filename>
<Alt><![CDATA[harmadikalt]]></Alt>
</Image>
</Images>
<Variants>
<Variant>
<Name><![CDATA[Szín]]></Name>
<Values>
<Value>
<Name><![CDATA[Kék]]></Name>
</Value>
<Value>
<Name><![CDATA[Piros]]></Name>
<ExtraPrice>100</ExtraPrice>
</Value>
</Values>
</Variant>
<Variant>
<Name><![CDATA[Méret]]></Name>
<Values>
<Value>
<Name><![CDATA[S]]></Name>
<ExtraPrice>-100</ExtraPrice>
</Value>
<Value>
<Name><![CDATA[M]]></Name>
</Value>
<Value>
<Name><![CDATA[L]]></Name>
<ExtraPrice>200</ExtraPrice>
</Value>
</Values>
</Variant>
</Variants>
<Datas>
<Data>
<Id>1</Id>
<Name><![CDATA[Garancia]]></Name>
<Value><![CDATA[Egy év]]></Value>
</Data>
<Data>
<Id>2</Id>
<Name><![CDATA[Szállítási Határidő]]></Name>
<Value><![CDATA[Egy hét]]></Value>
</Data>
</Datas>
<Params>
<Param>
<Id>1001</Id>
<Type>text</Type>
<Name><![CDATA[Paraméter 1]]></Name>
<Group><![CDATA[Csoport 1]]></Group>
<Value><![CDATA[Környakú]]></Value>
</Param>
<Param>
<Id>1002</Id>
<Type>textmore</Type>
<Name><![CDATA[Paraméter 2]]></Name>
<Value><![CDATA[Érték 1, Érték 2, Érték 3]]></Value>
</Param>
<Param>
<Id>1003</Id>
<Type>enum</Type>
<Name><![CDATA[Paraméter 3]]></Name>
<Value><![CDATA[Érték 1, Érték 2, Érték 3]]></Value>
</Param>
<Param>
<Id>1004</Id>
<Type>enummore</Type>
<Name><![CDATA[Paraméter 4]]></Name>
<Value><![CDATA[Érték 1, Érték 2, Érték 3]]></Value>
</Param>
<Param>
<Id>1005</Id>
<Type>num</Type>
<Name><![CDATA[Paraméter 5]]></Name>
<Value><![CDATA[100]]></Value>
<Before><![CDATA[akármi]]></Before>
<After><![CDATA[db]]></After>
</Param>
<Param>
<Id>1006</Id>
<Type>interval</Type>
<Name><![CDATA[Paraméter 6]]></Name>
<Value><![CDATA[100 - 200]]></Value>
<Before><![CDATA[akármi]]></Before>
<After><![CDATA[db]]></After>
</Param>
<Param>
<Id>1007</Id>
<Type>color</Type>
<Name><![CDATA[Paraméter 7]]></Name>
<Value><![CDATA[#ff00ff]]></Value>
</Param>
<Param>
<Id>1008</Id>
<Type>link</Type>
<Name><![CDATA[Paraméter 8]]></Name>
<Value><![CDATA[http://unas.hu]]></Value>
</Param>
<Param>
<Id>1009</Id>
<Type>linkblank</Type>
<Name><![CDATA[Paraméter 9]]></Name>
<Value><![CDATA[http://shop.unas.hu]]></Value>
</Param>
<Param>
<Id>1010</Id>
<Type>link_text</Type>
<Name><![CDATA[Paraméter 10]]></Name>
<Value><![CDATA[http://unas.hu - UNAS]]></Value>
</Param>
<Param>
<Id>1011</Id>
<Type>html</Type>
<Name><![CDATA[Paraméter 11]]></Name>
<Value><![CDATA[Teszt <b>szöveg</b>]]></Value>
</Param>
<Param>
<Id>1012</Id>
<Type>icon</Type>
<Name><![CDATA[Paraméter 12]]></Name>
<Value><![CDATA[1]]></Value>
</Param>
<Param>
<Id>1013</Id>
<Type>iconmore</Type>
<Name><![CDATA[Paraméter 13]]></Name>
<Value><![CDATA[1, 3, 10]]></Value>
</Param>
<Param>
<Id>1014</Id>
<Type>pic</Type>
<Name><![CDATA[Paraméter 14]]></Name>
<Value><![CDATA[pic_194908_api_teszt.jpg]]></Value>
</Param>
<Param>
<Id>1015</Id>
<Type>piclink</Type>
<Name><![CDATA[Paraméter 15]]></Name>
<Value><![CDATA[akarmi.jpg]]></Value>
</Param>
<Param>
<Id>1016</Id>
<Type>piclinktext</Type>
<Name><![CDATA[Paraméter 16]]></Name>
<Value><![CDATA[akarmi.jpg - AKÁRMI]]></Value>
</Param>
<Param>
<Id>1017</Id>
<Type>date</Type>
<Name><![CDATA[Paraméter 17]]></Name>
<Value><![CDATA[10|day]]></Value>
</Param>
</Params>
<AdditionalDatas>
<AdditionalData>
<Id>1</Id>
<Title><![CDATA[Első lapfül címe]]></Title>
<Content><![CDATA[Első lapfül tartalma]]></Content>
</AdditionalData>
<AdditionalData>
<Id>2</Id>
<Title><![CDATA[Második lapfül címe]]></Title>
<Content><![CDATA[Második lapfül tartalma]]></Content>
</AdditionalData>
<AdditionalData>
<Id>3</Id>
<Title><![CDATA[Harmadik lapfül címe]]></Title>
<Content><![CDATA[Harmadik lapfül tartalma]]></Content>
</AdditionalData>
</AdditionalDatas>
<QtyDiscount>
<Step>
<Limit>
<Lower>0</Lower>
<Upper>10</Upper>
</Limit>
<Discount>0%</Discount>
</Step>
<Step>
<Limit>
<Lower>10</Lower>
<Upper>20</Upper>
</Limit>
<Discount>5%</Discount>
</Step>
<Step>
<Limit>
<Lower>20</Lower>
</Limit>
<Discount>10%</Discount>
</Step>
</QtyDiscount>
<AdditionalProducts>
<AdditionalProduct>
<Id>70828162</Id>
<Sku>Cikkszam1</Sku>
<Name><![CDATA[Termék név 1]]></Name>
</AdditionalProduct>
<AdditionalProduct>
<Id>63226347</Id>
<Sku>Cikkszam3</Sku>
<Name><![CDATA[Termék név 3]]></Name>
</AdditionalProduct>
</AdditionalProducts>
<SimilarProducts>
<SimilarProduct>
<Id>85478568</Id>
<Sku>Cikkszam5</Sku>
<Name><![CDATA[Termék név 5]]></Name>
</SimilarProduct>
</SimilarProducts>
<Stocks>
<Status>
<Active>1</Active>
<Empty>1</Empty>
<Variant>1</Variant>
</Status>
<Stock>
<Variants>
<Variant><![CDATA[Kék]]></Variant>
<Variant><![CDATA[S]]></Variant>
</Variants>
<Qty>10</Qty>
</Stock>
<Stock>
<Variants>
<Variant><![CDATA[Piros]]></Variant>
<Variant><![CDATA[M]]></Variant>
</Variants>
<Qty>20</Qty>
</Stock>
</Stocks>
<OnlineContent>
<Url><![CDATA[http://teszt.hu/akarmi.pdf]]></Url>
<Limit>no</Limit>
<Filename>akarmi_mas.pdf</Filename>
</OnlineContent>
<PlusServices>
<PlusService>
<Id><![CDATA[2789]]></Id>
<Name><![CDATA[szolgáltatás neve]]></Name>
</PlusService>
</PlusServices>
<Types>
<Type>child</Type>
<Parent>Cikkszam1</Parent>
<Display>0</Display>
<Order>1</Order>
</Types>
<PackageProduct>no</PackageProduct>
<PackageComponents>
<Component>
<Sku>Cikkszam2</Sku>
<Qty>1</Qty>
</Component>
<Component>
<Sku>Cikkszam3</Sku>
<Qty>3</Qty>
</Component>
</PackageComponents>
<Meta>
<Keywords><![CDATA[szuper jó, olcsó]]></Keywords>
<Description><![CDATA[erre alkalmas]]></Description>
<Title><![CDATA[címben ez is szerepel]]></Title>
</Meta>
<AutomaticMeta>
<Keywords><![CDATA[általános termék meta keyword]]></Keywords>
<Description><![CDATA[általános termék meta description]]></Description>
<Title><![CDATA[általános termék meta title]]></Title>
</AutomaticMeta>
</Product>
</Products>
Termék létrehozása
A második példában azt láthatod, hogyan tudsz terméket létrehozni. A példa XML-ben a kötelező adatokat láthatod, amik egy termék létrehozásakor szükségesek. Ezen felül a termék "Aktív, Új" státusszal jön létre.
Kérés
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Action>add</Action>
<Statuses>
<Status>
<Type>base</Type>
<Value>2</Value>
</Status>
</Statuses>
<Sku>8fga1239012</Sku>
<Name>Első termékem</Name>
<Unit>db</Unit>
<Categories>
<Category>
<Id>678123</Id>
<Name>Termékek|Alkategória 1</Name>
<Type>base</Type>
</Category>
</Categories>
<Prices>
<Price>
<Type>normal</Type>
<Net>1000</Net>
<Gross>1270</Gross>
</Price>
</Prices>
</Product>
</Products>
Válasz
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Id>290684827</Id>
<Sku>8fga1239012</Sku>
<Action>add</Action>
<Status>ok</Status>
</Product>
</Products>
Termék módosítása
A következő példában módosításra kerül a 8fga1239012 cikkszámú termék, melynek létrehozását az előző példában láthatod. A termékhez hozzáadásra kerül egy leírás, akciós ár és mennyiségi kedvezmény valamint a termék státusza is megváltozik aktívra.
Kérés
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Sku>8fga1239012</Sku>
<Action>modify</Action>
<Statuses>
<Status>
<Type>base</Type>
<Value>1</Value>
</Status>
</Statuses>
<Description>
<Short>Ez lesz a termék rövid leírása.</Short>
<Long>Ez lesz a termék részletes leírása. Ebben a leírásban már több infó szerepel mint a rövid leírásban.</Long>
</Description>
<Prices>
<Price>
<Type>normal</Type>
<Net>2000</Net>
<Gross>2540</Gross>
</Price>
<Price>
<Type>sale</Type>
<Net>1000</Net>
<Gross>1270</Gross>
<Start>2022.03.01</Start>
<End>2022.03.25</End>
</Price>
</Prices>
</Product>
</Products>
Válasz
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Id>290684827</Id>
<Sku>8fga1239012</Sku>
<Action>modify</Action>
<Status>ok</Status>
</Product>
</Products>
Több termék egyidejű módosítása
Az ötödik esetben arra mutatunk példát, hogy hogyan lehet egyszerre több termék bizonyos adatait frissíteni. Itt a termékek árai változnak, de természetesen lehetőség van tetszőleges adat kezelésére.
Kérés
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Sku>8fga1239012</Sku>
<Action>modify</Action>
<Prices>
<Price>
<Type>normal</Type>
<Net>2000</Net>
<Gross>2540</Gross>
</Price>
</Prices>
</Product>
<Product>
<Sku>9ghb234023</Sku>
<Action>modify</Action>
<Prices>
<Price>
<Type>normal</Type>
<Net>1000</Net>
<Gross>1270</Gross>
</Price>
</Prices>
</Product>
<Product>
<Sku>7efz0128901</Sku>
<Action>modify</Action>
<Prices>
<Price>
<Type>normal</Type>
<Net>3000</Net>
<Gross>3810</Gross>
</Price>
</Prices>
</Product>
</Products>
Válasz
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Id>159850145</Id>
<Sku>8fga1239012</Sku>
<Action>modify</Action>
<Status>ok</Status>
</Product>
<Product>
<Id>159850156</Id>
<Sku>9ghb234023</Sku>
<Action>modify</Action>
<Status>ok</Status>
</Product>
<Product>
<Id>159850146</Id>
<Sku>7efz0128901</Sku>
<Action>modify</Action>
<Status>ok</Status>
</Product>
</Products>
Adatbázis lekérése
A hatodik példa egy getProductDB hívást mutat be, lekérdezésre kerül adott áruház teljes termékpalettája, magyar nyelven, csv formátumú kimenettel.
Kérés
<?xml version="1.0" encoding="UTF-8" ?>
<Params>
<Format>csv</Format>
<Compress>no</Compress>
<Lang>hu</Lang>
</Params>
Válasz
<?xml version="1.0" encoding="UTF-8" ?>
<getProductDB>
<Url>http://api11.unas.eu/shop/temp/e6cd8025e0994346e9ca19a2f6c870e8.csv</Url>
</getProductDB>
Adatbázis feltöltése
Egy setProductDB kérésre láthatsz mintát, az URL-en elérhető Unas formátumú termék adatbázis kerül feltöltésre az áruházba, magyar nyelven. A példában 64 darab termék sikeresen feltöltésre kerül, míg egy terméknél hibát jelez a rendszer - ez látható is a válaszban.
Kérés
<?xml version="1.0" encoding="UTF-8" ?>
<Params>
<Url>https://teszt.unas.hu/mintaadatbazis.csv</Url>
<DelType>no</DelType>
<Lang>hu</Lang>
</Params>
Válasz
<?xml version="1.0" encoding="UTF-8" ?>
<setProductDB>
<Ok>
<Add>64</Add>
</Ok>
<Error>
<FaultyProducts><![CDATA[1]]></FaultyProducts>
</Error>
</setProductDB>
