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

Ez az oldal egy régebbi verziója. Nézze meg a jelenlegi verziót.

Összehasonlítás a jelenlegivel Korábbi változatok megtekintése

1 verzió Tovább »

A DbConnector REST API felületen keresztül a SUP® partnertö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ő.

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

GET
   http://server/dbconnector/api/torzs/parner

A válaszok XML-ben érkeznek.

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

Tartalom

Partner kódok listája

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

GET
    http://server/dbconnector/api/torzs/partner

Paraméter
   További header paraméterek nem szükségesek

Result
   XML - <ResultList> : A partnerkódok listája vesszővel elválasztva.

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

Egy partner részletes adatai

Az előző verb-en lekért partnerkódok listája alapján egy partner részletes adatai kérdezhetők le.

GET
    http://server/dbconnector/api/torzs/partner/{PartnerKod}

Result
   XML - <Partner> : Egy partner részletes adatai.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner/0001  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>MAG002</PartnerKod>
            <PartnerRovnev>Magyar Posta Zrt.</PartnerRovnev>
            <PartnerNev>Magyar Posta Zrt.</PartnerNev>
            <Adoszam/>
            <cimIrsz>1063</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Virág u. 10.</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>

Partnerek részletes adatai tömbként

Kevés számú partner esetén alkalmazható, a partnerek részletes adatainak XML tömbként történő lekérdezése.

GET
    http://server/dbconnector/api/torzs/partner

További header paraméter
     format:array A paraméter megadása esetén nem csak a partnerkódok listája, hanem minden partner részletes adatai benne lesznek a lekérdezésben, XML tömbként.

 Megjegyzés

Nagy partnertörzs esetén a lekérdezés time-ot hibát, vagy egyéb túlcsordulás hibát is okzhat. Csak abban az esetben célszerű használni, ha kisebb partnertörzset kell kezelni.


Result
   XML - <ResultList> : Partnerek részletes adatai XML tömbként.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod             ^
  -H format:array
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <ResultListCnt>3</ResultListCnt>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>ALL001</PartnerKod>
            <PartnerRovnev>Allianz Hungária</PartnerRovnev>
            <PartnerNev>Allianz Hungária</PartnerNev>
            <Adoszam/>
            <orszagKod/>
            <cimIrsz>1054</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Bajcsy Zs. 52.</cimUtca>
        </Partner>
        <Partner>
            <PartnerKod>ATL001</PartnerKod>
            <PartnerRovnev>Atlanta Kft.</PartnerRovnev>
            <PartnerNev>Atlanta Kft.</PartnerNev>
            <Adoszam>10557390241</Adoszam>
            <orszagKod/>
            <cimIrsz>1118</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Budaörsi út 765.</cimUtca>
        </Partner>
        <Partner>
            <PartnerKod>AUT001</PartnerKod>
            <PartnerRovnev>Autópálya Zrt.</PartnerRovnev>
            <PartnerNev>Autópálya Zrt.</PartnerNev>
            <Adoszam/>
            <orszagKod/>
            <cimIrsz>1031</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Lövedék utca 2.</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>

Partner keresés adótörzsszám szerint

A partnerkód mellett, más lekérdezési szempont szerint is lekérdezhető a partnertörzs. Ilyen pl.: az adótörzsszám.

GET
    http://server/dbconnector/api/torzs/partner?adotorzs=12345678

Paraméter
     adotorzs  A cég adótörzsszáma alapján keres.

Result
   XML - <Partner> : A kért partner részletes adatai.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner?adotorzs=10895797  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>QSOFT</PartnerKod>
            <PartnerRovnev>QSoft Kft.</PartnerRovnev>
            <PartnerNev>QSoft Számítástechnikai és Ügyviteli Szolgáltató Kft.</PartnerNev>
            <Adoszam>10895797243</Adoszam>
            <cimIrsz>1119</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Fehérvári út 85.</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>

Partner keresés megnevezés szerint

További lekérdezési szempont a partner neve.

GET
    http://server/dbconnector/api/torzs/partner?megnev=Cégnév

Paraméter
     megnev  A cég rövid nevében és teljes nevében keres.

Result
   XML - <Partnerek> : A lekérdezés több rekordot is adhat eredményül.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner?megnev=Magyar  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <ResultListCnt>2</ResultListCnt>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>MAG002</PartnerKod>
            <PartnerRovnev>Magyar Posta Zrt.</PartnerRovnev>
            <PartnerNev>Magyar Posta Zrt.</PartnerNev>
            <Adoszam/>
            <cimIrsz>1063</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Virág u. 10.</cimUtca>
        </Partner>
        <Partner>
            <PartnerKod>TEL001</PartnerKod>
            <PartnerRovnev>Telenor</PartnerRovnev>
            <PartnerNev>Telenor Magyarország Zrt.</PartnerNev>
            <Adoszam/>
            <cimIrsz>2040</cimIrsz>
            <cimVaros>Budaörs</cimVaros>
            <cimUtca>Baross u. 165</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>

Partner keresés bankszámlaszám szerint

További lekérdezési szempont a partner(ek) bankszámlaszáma.

GET
    http://server/dbconnector/api/torzs/partner?bankszla=1090009912345678

Paraméter
     bankszla  A cég bankszámlaszámai alapján keres. Szótöredék használat is lehetséges, a bankszámlaszámot kötőjelek nélkül kell megadni.

Result
   XML - <ResultList> : A lekérdezés több rekordot is adhat eredményül.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner?bankszla=1090009912345678   ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>TET001</PartnerKod>
            <PartnerRovnev>Tételes ÁFA Kft.</PartnerRovnev>
            <PartnerNev>Tételes ÁFA Kft.</PartnerNev>
            <Adoszam/>
            <cimIrsz>1111</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Zöld u. 11.</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>

Partner keresés partnercsoport szerint

További lekérdezési szempont a partner(ek) SUP-ban nyilvántartott partnercsoport szerinti lekérdezés.

GET
    http://server/dbconnector/api/torzs/partner?pcsop=1

Paraméter
     pcsop  A SUP rendszerben használható 1-8 intervallumban megadható partnercsoport besorolás alapján keres. Ettől eltérő intervallum megadása esetén hibaüzenet az eredmény.

Result
   XML - <ResultList> : A lekérdezés több rekordot is adhat eredményül.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner?pcsop=1   ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>TET001</PartnerKod>
            <PartnerRovnev>Tételes ÁFA Kft.</PartnerRovnev>
            <PartnerNev>Tételes ÁFA Kft.</PartnerNev>
            <Adoszam/>
            <cimIrsz>1111</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Zöld u. 11.</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>

Partner keresés 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.

GET
    http://server/dbconnector/api/torzs/partner?changed=2021-01-12
    http://server/dbconnector/api/torzs/partner?new=2021-01-1


Paraméter
     changed  Az ISO formátumban megadott dátum napján, vagy annál későbbi időpontban felvitt vagy módosított partner adatok jelennek meg.
     new      A megadott dátum napkán vagy később felvitt új partner adatok jelennek meg.

Result
   XML - <ResultList> : A lekérdezés több rekordot is adhat eredményül.

Hívás minta
CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/torzs/partner?changed=2021-01-12   ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod     ^
  -H cegkod:CegKod
Válasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <ResultListCnt>2</ResultListCnt>
    <Partnerek version="PTD_1.0">
        <Partner>
            <PartnerKod>MAG002</PartnerKod>
            <PartnerRovnev>Magyar Posta Zrt.</PartnerRovnev>
            <PartnerNev>Magyar Posta Zrt.</PartnerNev>
            <Adoszam/>
            <cimIrsz>1063</cimIrsz>
            <cimVaros>Budapest</cimVaros>
            <cimUtca>Virág u. 10.</cimUtca>
        </Partner>
        <Partner>
            <PartnerKod>TEL001</PartnerKod>
            <PartnerRovnev>Telenor</PartnerRovnev>
            <PartnerNev>Telenor Magyarország Zrt.</PartnerNev>
            <Adoszam/>
            <cimIrsz>2040</cimIrsz>
            <cimVaros>Budaörs</cimVaros>
            <cimUtca>Baross u. 165</cimUtca>
        </Partner>
    </Partnerek>
</DbConnectorResponse>