Kapcsolódó információk:
› Paraméterezési útmutatók

Összehasonlított verziók

Régi verzió 1

changes.mady.by.user QSoft

Mentés ekkor:

összehasonlítva

Új verzió Aktuális

changes.mady.by.user QSoft

Mentés ekkor:

Kulcs

  • Beillesztett sor.
  • Törölt sor.
  • Formázás megváltoztatva.

A DbConnector REST API felületen keresztül a SUP® cikktörzs állománya is hozzáférhető intranetes webszolgáltatásként.
A webszolgáltatás XML alapú REST API hívásokkal működtethető.

...

width50%

Az API a következő belépési ponton érhető el. A szerver név a helyi intranetet környezettől függ.

...

A válaszok XML-ben érkeznek.

A REST API hívások általános használata a DbConnector REST API oldalon található.

...

Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET

http://server/dbconnector/api/torzs/cikk

Header paraméterek: az API használathoz szükséges pkod, lickod, cegkod paraméterek.

További paraméter: a lekérdezéstől függően


A cikktörzs adatok lekérdezésre a következő lehetőségek vannak

...

width50 %

...

bgColorBeige

...

Tartalomjegyzék
maxLevel2

Cikkszámok listája

A SUP® rendszer cikktörzs állománya a következő verb-en érhető el.

Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET

...

http://server/dbconnector/api/torzs/cikk

...

Query paraméter: nincs

Result

...

bashHívás

: a cikk kódok listája vesszővel elválasztva.

Kódblokk
language
java
title
Kérés minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/cikk  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Kódblokk
languagexml
titleVálasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Message>Törzsadat: 'cikkszámok' Cégkód: 'CEGKOD'</Message>    
	<ResultListCnt>10</ResultListCnt>
    <ResultList>0001,0002,0003,0004,0005,0006,0007,0008,0009,0010</ResultList>
<ResultListCnt>10</ResultListCnt>

</DbConnectorResponse>

Egy cikk részletes adatai

Az előző verb-en lekért cikk - kódok listája alapján, egy cikk részletes adatai kérdezhetők le. A lekérdezésben a cikktörzs default formátuma van dokumentálva. Lehetőség van cégfüggő formátumok implementálására is.

Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET

...

http://server/dbconnector/api/torzs/cikk/{

...

cikkkod}

További

...

paraméter:

  • format:listaaropcionális paraméter, és cégfüggő implementáció. A formátum (adattartalom) az API-t használó kliens programhoz igazodva kerül implementálásra.

Result

...

bashHívás

: a cikk részletes adatai.

Kódblokk
language
java
title
Kérés minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/cikk/0001  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
-H format:listaar
 Kódblokk
languagexml
titleVálasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>

  
  <Success>true</Success>
  
  
<StatusCode>200</StatusCode>
  
  
<ResultListCnt>1</ResultListCnt>
  
  
<Cikkek>

  
    
  
<Cikk>
      
      
<CikkKod>0001</CikkKod>

    
      
  
<CikkNev>Infrared Micro Switch gaming mouse - Black</CikkNev>

     
      
 
<EanKod>4711421917827</EanKod>
      
      <EgysarNetto>4520</EgysarNetto>
            <SzabadKeszlet>11</SzabadKeszlet>
<Megys>db</Megys> 
      
      <Megys>db</Megys>
<Ervenyes>true</Ervenyes>
 
       <
   </Cikk>

  
  </Cikkek>
</DbConnectorResponse>
Cikkek részletes adatai tömbként
Kis méretű tételszámú cikktörzs esetén alkalmazható, a cikkek részletes adatainak tömbként történő lekérdezése.
 Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET
...
http://server/dbconnector/api/torzs/cikk
További header paraméter (kötelező)
   format:listaar cégfüggő implementáció. A formátum (adattartalom) az API-t használó kliens programhoz igazodva kerül implementálásra.
...
bashHívás 
Header paraméterek: az API használathoz szükséges pkod, lickod, cegkod paraméterek.
Paraméter:
  • format:array a paraméter megadása esetén nem csak a cikk kódok listája, hanem minden cikk részletes adatai benne lesznek a lekérdezésben, XML tömbként.
Result:cikk részletes adatai XML tömbként.
 Kódblokk
language
java
title
Kérés minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/cikk  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
  -H format:
listaar
array
 Kódblokk
languagexml
titleVálasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>

 
  
 
<Success>true</Success>

  
  <StatusCode>200</StatusCode>

  
  <ResultListCnt>3</ResultListCnt>
  
  
<Cikkek>

    
    <Cikk>

      
      <CikkKod>0001</CikkKod>

      
      <CikkNev>Infrared Micro Switch gaming mouse - Black</CikkNev>
      <EanKod>4711421917827</EanKod>
      
<EanKod>4711421917827<
<Megys>db</
EanKod>
Megys>
      <EgysarNetto>4520</EgysarNetto>
      
<EgysarNetto>4520<
<SzabadKeszlet>11</
EgysarNetto>
SzabadKeszlet>
    </Cikk>
    <Cikk>
      
<SzabadKeszlet>11<
<CikkKod>0002</
SzabadKeszlet>
CikkKod>
      <CikkNev>Infrared Micro Switch gaming mouse - 
<Megys>db<
White</
Megys>
CikkNev>
      
  <
<EanKod>4711421868334</
Cikk>
EanKod>
      <Megys>db</Megys>
  
<Cikk>

    <Ervenyes>true</Ervenyes> 
    </Cikk>
    
<CikkKod>0002</CikkKod>
<Cikk>
      <CikkKod>0003</CikkKod>
      <CikkNev>Infrared Micro Switch gaming mouse - 
White<
Blue</CikkNev>
      <EanKod>4711421876735</EanKod>
      
<EanKod>4711421868334<
<Megys>db</
EanKod>

Megys>       
      
<EgysarNetto>3900<
<Ervenyes>true</
EgysarNetto>
Ervenyes> 
    </Cikk>
  </Cikkek>
</DbConnectorResponse>
Cikkek keresése változás dátuma szerint
A partner rekordok lekédezhetők a felvitel, vagy utolsó változás dátum szerint. A felvitel szerinti lekérdezés csak az adott dátum után felvitt partnereket mutatja. A változás dátum szerinti lekérdezés a módosított, és az újként felvitt partner adatokat is tartalmazza.
 Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET
http://server/dbconnector/api/torzs/cikk?changed=2021-01-12
http://server/dbconnector/api/torzs/cikk?new=2021-01-1
Paraméter:
  • changed=2021-01-12  az adott dátum óta megváltozott vagy újként felvitt cikkek
  • new=2021-01-1  az adott dátum óta újként felvitt cikkek
Result: partnerek részletes adatai XML tömbként.
 Kódblokk
languagejava
titleKérés minta
CURL.EXE    ^
  -X GET    
<SzabadKeszlet>11</SzabadKeszlet>
^
     http://server:8080/dbconnector/api/torzs/partner?changed=2021-01-12   ^
  -H pkod:SajatSupPartnerKod   
<Megys>db</Megys>
^
  -H lickod:SajatSupLicKod     
</Cikk>
^
  -H cegkod:CegKod
 Kódblokk
languagexml
titleVálasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
  
<Cikk>
<Success>true</Success>
  <StatusCode>200</StatusCode>
  <ResultListCnt>3</ResultListCnt>
  <Cikkek>
    
  <CikkKod>0003</CikkKod>
<Cikk>
      <CikkKod>0004</CikkKod>
      <CikkNev>Infrared Micro Switch gaming mouse - 
Blue<
Yellow</CikkNev>
      
      
<EanKod>4711421876735</EanKod>
      
      <EgysarNetto>3900</EgysarNetto>
  
<Megys>db</Megys>       
   <SzabadKeszlet>9</SzabadKeszlet>

      
      <Megys>db</Megys>
       
<Ervenyes>false</Ervenyes> 
    </Cikk>

  
  </Cikkek>
</DbConnectorResponse> 
 Qsboxmegjegyz
Szorosabb integráció esetén az API-n keresztül ú.n. webes callback értesítést tudunk küldeni a cikk adatok változásáról. Ez alapján a megváltozott cikk rekord azonnal lekérdezhető, és szinkronizálható.