Kapcsolódó információk:
› Paraméterezési útmutatók
Korábbi változatok
...
Success | Sikeres feldolgozás esetén true, egyéb esetben false | ||
StatusCode | Sikertelen feldolgozás esetén további, részletesebb információkat közöl. Megegyezik a http statuskóddal, de a hívás sikerességének ellenőzéséhez a nem ezt, hanem a http statuskódot kell használni. | ||
Message | Sikertelen feldolgozás esetén szöveges információk a problémáról, összhangban a StatusCode válasszal | ||
Token | Kérés beküldés esetén a várólistából ezzel az azonosítóval lehet majd a status információkat lekérni | ||
BizonylatAzon | Számlázási utasítás beküldés és sikeres feldolgozás esetén, a SUP rendszerben a megadott azonosítón található meg a számla.
| ||
DocumentType | Számlázási utasítás beküldés és sikeres feldolgozás esetén, az elkészült számla PDF képe base64 enkódolt formában. A számla PDF kép visszaadáshoz a szerver oldalon további beállítások szükségesek. Ha ez nincs, akkor csak a
|
Rögzítés | ||||
---|---|---|---|---|
|
...
Hibakezelés - hibakódok
Az XML result-ban visszaadott státuszkódok megegyeznek a HTTP hívás státuszkódjaival. A fejlesztés során inkább a HTTP státuszkódokkal érdemes dolgozni,, mert előfordulhat olyan eset (pl.: time out), hogy a HTTP kérés válaszban nem az elvárt XML üzenet jön, hanem csak egy hibakód.
A HTTP státuszkódokkal az RFC 7231 foglalkozik. A DbConnector API válaszok is ebbe a logikába illeszkednek. A kódlista bővítésének jogát fenntartjuk.
A kliens fejlesztést a következő státuszkód tartományok kezelésével javasoljuk.
- 100 - információk - az API-n nincs használatban
- 200 - success
- 300 - redirection - az API-n nincs használatban
- 400 - client errors - a hívás során van valamilyen probléma
- 500 - server errors - különböző szerver oldali feldolgozási, vagy konfigurálási hiba
A ténylegesen használt kódok a következők:
- 200 OK
- 290 Not yet processed
- 401 Unauthorized
- 404 Not Found
- 490 Auth param missing
- 491 Body or param missing
- 492 XML ERROR
- 493 Already exist
- 494 Too long time not processed
- 495 Error on processing
- 499 Other error
- 590 INI error
- 591 Database connect error
- 592 Other Exception
Hibakezelés
API elérhetőség hiba
...
témában további információk a DbConnector REST API általános dokumentációban.