Rendszer célja

Az összetett rendszer végső feladata, hogy az állásközvetítő cégektől érkező MER számára releváns adatokat elemezhetővé tegye.

A működés rövid összefoglalása

A MER által az állásközvetítőkről és az álláskölcsönzőkről egy központi törzsadat karbantartó és forgalom riportoló rendszerben kell a MER számára kezelhetővé tenni. Ezen törzsadatokból azokat az elemeket, amelyek az Állásközvetítők működésében vagy az adatszolgáltatásban szerepet játszanak egy API technologián alapuló interfészen szükséges publikálni az Állásközvetítők rendszerei számára. Az állásközvetítők ugyanezen az API-n keresztül az állásajánlók tételes adatait szükséges fogadni és negyedéves szintű összegzést adni a MER központi rendszer számára.

A rendszer elemei

1.  A rendszer külső elemei és az elemek funkciói:
   a. MER felhasználó: A MER megbízott felhasználója, aki a MER rendszeréből riportokat kér le és az esetleges központi törzsadatok változásait elvégzi
2. A rendszer belső elemei és az elemek funkciói:
   MER központi törzsadat karbantartó és riportoló rendszer: A MER az állásközvetítőkkel kapcsolatos bizonyos, a kommunikációban és a riportolásban szerepet játszó törzsadatait és a riportok futtatására alkalmas rendszer.

A kezelt statikus törzsadatok és bejövő adatok a következőek:

MER központi törzsadat karbantartó rendszerben tárolt, illetve onnan származó adatok:
• FEOR számok
• Megyék
• Vállalkozás típusai
MER kommunikációs interface-en keresztül az állásközvetítő szoftveréből származó adatok:
• Nyitott állás pozíciók

b. Webszerver: Webszerver, amely az állásközvetítő egységek szoftvere és a MER központi törzsadat karbantartó és riportoló rendszer közötti kommunikáció külső rétegét biztosítja. A kommunikációnak API Kulcs - Token alapú azonosítással és https protokollon keresztül kell megvalósulnia.
c. Kommunikációs szolgáltatás: Az állásközvetítő egységek állásközvetítő szoftvere és a MER központi törzsadat karbantartó és riportoló rendszer közötti kommunikációt biztosító szolgáltatás. A szolgáltatás egyrészt lekérdezéseket végez a MER által karbantartott törzsadatokból. Másrészt a kommunikációs szolgáltatás az egyes kiskereskedelmi szoftverektől kapott forgalmi adatokat rögzíti a MER riportoló rendszerbe.

Az adatcsere részletei és a kommunikációs szolgáltatás specifikációja

Alapvető integrációs sajátosságok és elvárások:
Az állásközvetítőknél működő kereskedelmi szoftverek az aktuális és lejárt státuszú állásokat tartja nyilván. A MER központi törzsadat és karbantartó rendszer ezeket az adatokat negyedéves időszakban fogadja.
API Specifikáció:
A kommunikációs szolgáltatást egy API technológián alapuló szerviz valósítja meg. Az API-n keresztüli kommunikációt a MER állásközvetítők profilkezelésében található API kulccsal valósítható meg.
Az API kommunikációs interface-eket a következő szervízek implementálják. Minden szervíznek kötelező paramétere az API kulcs (token), amely az állásközvetítő cég egyedi azonosítója. Minden kérés header-jében szerepelnie kell az API kulcsnak.

Interfész leírás

Interfész neve: MER állásközvetítő és álláskölcsönző interfész

Interfész célja: Szabványos webes API biztosítása az állásközvetítő és álláskölcsönző cégektől érkező adatok fogadására.

Interfészek (WEB API Endpoints

• MEGYEK: Megyék lekérdezését biztosító interfész
• FEOROK: A MER rendszerében nyilvántartott FEOR számok listája
• VALLALKOZAS_TIPUSOK: A MER rendszerében nyilvántartott Vállalkozás típusok listája
• ALLAS (GET): Az adott időszakban felküldött adatok listája
• ALLAS (POST): Létrehozza a paraméterben kapott állás adatokat

Megyék

Megyék lekérdezését biztosító interfész

API ENDPOINT

AUTHORIZATION

No auth

HEADER

REQUEST BODY
{}

EXAMPLES

POSTMAN CLIENT
Request:
{
"info": {
"_postman_id": "bb1004f9-0b51-4961-b598-72a4cb544ae2",
"name": "AdatSzotar",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "Megyek",
"protocolProfileBehavior": {
"disabledSystemHeaders": {
"user-agent": true,
"accept": true,
"accept-encoding": true,
"connection": true
}
},
"request": {
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{ApiKeyValue}}",
"type": "string"
},
{
"key": "key",
"value": "{{ApiKeyName}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"method": "GET",
"header": [],
"url": {
"raw": "{{BaseUrl}}/adatszolgaltatas/adatszotar/megyek",
"host": [
"{{BaseUrl}}"
],
"path": [
"adatszolgaltatas",
"adatszotar",
"megyek"
]
}
},
"response": []

} 

],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "4A17D7EC-896F-4685-BA26-DBEC10AB3DFF",
"type": "string"
},
{
"key": "value",
"value": "teszt.newid",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}

RESULTS
[MegyeListDto {
id integer($int32)
nev string nullable: true
}]

[
{
"id": 1,
"nev": "Bács-Kiskun"
},
{
"id": 2,
"nev": "Baranya"
},
{
"id": 3,
"nev": "Békés"
},
{
"id": 4,
"nev": "Borsod-Abaúj-Zemplén"
},
{
"id": 5,
"nev": "Budapest"
},
{
"id": 6,
"nev": "Csongrád"
},
{
"id": 7,
"nev": "Fejér"
},
{
"id": 8,
"nev": "Győr-Moson-Sopron"
},
{
"id": 9,
"nev": "Hajdú-Bihar"
},
{
"id": 10,
"nev": "Heves"
},
{
"id": 11,
"nev": "Jász-Nagykun-Szolnok"
},
{
"id": 12,
"nev": "Komárom-Esztergom"
},
{
"id": 13,
"nev": "Nógrád"
},
{
"id": 14,
"nev": "Pest"
},
{
"id": 15,
"nev": "Somogy"
},
{
"id": 16,
"nev": "Szabolcs-Szatmár-Bereg"
},
{
"id": 17,
"nev": "Tolna"
},
{
"id": 18,
"nev": "Vas"
},
{
"id": 19,
"nev": "Veszprém"
},
{
"id": 20,
"nev": "Zala"
}
]