Importovať ponuky je možné dvoma spôsobmi:
- Cez Profesia API Odporúčame
Ponuky sa importujú hneď po zverejnení vo vašom systéme. Komunikácia medzi vaším systémom a systémom Profesia.sk prebieha prostredníctvom tzv. API volaní, ktoré sú definované v dokumentácii Profesia API. Rovnako dynamicky prebieha aj aktualizácia číselníkov. Priamou komunikáciou aplikácie s aplikáciou minimalizujete riziko vzniku chýb pri importe ponúk. Do systému Profesia.sk je možné zadávať pracovné ponuky automaticky - pomocou importu pracovných ponúk. - Prostredníctvom XML súboru
Importovať pracovné ponuky na Profesia.sk môžete aj z XML súboru. Na výber sú 2 spôsoby XML importu:- import do konceptov - v prípade, že chcete mať nad importovanými ponukami pred zverejnením úplnú kontrolu
- import s okamžitým zverejneným - ponuky sa zverejnia hneď po importe podľa nasledovných pravidiel:
- na stránku www.profesia.sk sa pridajú nové ponuky
- v už zverejnených ponukách sa informácie aktualizujú
- ponukám, ktoré sa v XML súbore už nevyskytujú, sa ukončí ich zverejnenie
Upozornenie: Pri importovaní ponúk do systému je potrebné mať dostatočné množstvo predplatených kreditov. Kredity potrebné na zverejnenie ponúk nie sú súčasťou služby Import.
TIP: Overte si, či dodávateľ vášho HR systému podporuje možnosť exportovania pracovných ponúk na náš portál. Môžete tak ušetriť čas pri príprave XML súboru s ponukami.
Profesia API je jednoduchý, rýchly a pohodlný spôsob, ako importovať pracovné ponuky z vášho systému na stránku Profesia.sk.
Aby ste mohli začať využívať Profesia API, musíte mať vytvorené konto a pridelený autentifikačný token, ktorý získate pri aktivácii služby.
Následne môžete začať využívať API volania na importovanie ponúk na stránku Profesia.sk.
Pozrite si kompletnú dokumentáciu API volaní.
TIP: Overte si, či dodávateľ vášho HR systému podporuje možnosť exportovania pracovných ponúk prostredníctvom API na stránku Profesia.sk. Môžete tak ušetriť čas pri technickej príprave importovania ponúk.
Službu vám vieme aktivovať, ak:
- máte vytvorené firemné konto na Profesia.sk
- nám pošlete linku na XML súbor s pracovnými ponukami a ktorý je nahratý na vašom serveri – XML súbor musí byť v správnom formáte
Našim klientom poskytujeme číselníky pre XML súbory, ktoré vám umožnia okamžité zverejnenie importovaných ponúk na Profesii.
V prípade, že naše číselníkové údaje nepoužívate, uložia sa vám importované ponuky do konceptov vo vašom firemnom konte a zverejniť ich budete musieť manuálne.
V prípade záujmu prosím kontaktujte obchodné oddelenie alebo vášho Account manažéra.
Požiadavky na XML súbor
-
štruktúra XML súboru musí mať predpísaný formát
-
každá importovaná ponuka musí mať vyplnené všetky povinné polia
-
XML súbor musí byť prístupný na stálej URL adrese
-
na importovanie ponúk musíte mať dostatočný počet kreditov
Upozornenie: Ak nemáte dostatočný počet kreditov na zverejnenie všetkých ponúk, ponuky sa nenaimportujú a zobrazí sa vám chybová hláška Odmietnutá pracovná ponuka z dôvodu nedostatočného kreditu. Platnosť jednej ponuky je maximálne 1 mesiac. Ak sa ponuka v XML súbore nachádza dlhšie, považuje sa po uplynutí tohto obdobia za novopridanú ponuku a za jej zverejnenie sa strhne ďalší kredit.
Obsah:
Povinné polia pracovnej ponuky
Voliteľné polia pracovnej ponuky
Voliteľné polia (len pre personálne agentúry)
Riešenia pre klientov na mieru
Číselníky
Validácia XML
Názov (atribút/element) |
Popis a typ poľa |
príklad |
---|---|---|
job (E), |
Ponuka a ID ponuky v systéme partnera |
|
offerlanguage (E) |
Jazyk, v akom je ponuka napísaná. |
|
position (E) |
Názov pracovnej pozície |
|
jobtasks (E) |
Náplň práce |
|
workplacetype (E) |
Typ miesta práce 1 = Práca na určenom pracovisku 4 = Práca na pracovisku s možnosťou práce z domu NOVINKA
|
|
offerlocation (E), |
Miesto práce na trvalom pracovisku |
|
offerlocation (E), |
Miesto práce - práca ktorá vyžaduje cestovanie |
|
offerlocation (E) |
Miesto práce nevyžaduje návštevu pracoviska (práca z domu, telepráca) Element musí byť súčasťou XML, ale nemusí obsahovať žiadnu hodnotu |
|
offercategorypositions (E), |
Kategória a pozícia pracovnej ponuky Číselník CATPOS |
|
jobtype (E), |
Druh pracovného pomeru Číselník JOBTYPE |
|
educationlevel (E), |
Požadovaná úroveň vzdelania Číselník EDUCATIONLEVELS |
|
numberofopenings (E) |
Počet obsadzovaných pozícií |
|
contactperson (E) |
Kontaktná osoba |
|
Názov (atribút/element) |
popis |
príklad |
---|---|---|
Vlastnosti ponuky | ||
last_modified (A) |
Dátum a čas poslednej aktualizácie exportu |
|
offerchannel (E), |
ID kanála zverejnenia ponuky |
|
date (E), |
Dátum, kedy sa má pracovná ponuka znovu zverejniť |
|
refnr (E) |
Referenčné číslo ponuky v systéme partnera |
|
sendcv (E), |
Vyhovujúce životopisy vám budú chodiť na e-mail |
|
applicationwithoutcv (E) |
false - životopis je povinná súčasť reakcie (default) |
|
Obsah ponuky |
||
otherbenefits (E) |
Výhody ponúkané zamestnávateľom |
|
prerequisites (E) |
Osobnostné predpoklady a zručnosti |
|
noteforcandidate (E) |
Ďalšie informácie pre uchádzača |
|
salary interval (E), |
Mzdové podmienky (brutto)
Currency ID: |
|
salary (E) |
Doplňujúce informácie o mzde |
|
startdate (E) |
Termín nástupu - textová informácia v jazyku ponuky |
|
applicabletill (E) |
Dátum ukončenia výberového konania |
|
specialization (E) |
Vyštudovaná špecializácia alebo odbor |
|
languageconjuction (E) |
Spájanie jazykových znalostí |
|
offerskills (E), |
Požadované znalosti (jazykové, PC administratívne a ekonomické znalosti) Číselníky SKILLS, LEVELS |
|
drivinglicence (E) |
typ vodičského preukazu |
|
validforgraduate (E), |
Ponuka vhodná pre absolventa |
|
requiredexperience (E), |
Počet rokov praxe |
|
suitableforukrainians (E) |
Ponuky vhodné pre ukrajinských utečencov |
|
Náš systém ráta s tým, že zadávateľom ponuky je užívateľ ktorý je u nás zaregistrovaný s používateľským právom pridávať a zverejňovať ponuky. |
||
title_before (E) |
Titul kontaktnej osoby |
|
first_name (E) |
Meno kontaktnej osoby |
|
surname (E) |
Priezvisko kontaktnej osoby |
|
contactphone (E) |
Telefón kontaktnej osoby |
|
contactemail (E) |
E-mail kontaktnej osoby |
|
Reakcie kandidátov
Nás systém podporuje nasledovné možnosti:
-
Email kontaktnej osoby - Reakcie štandarne posielame na e-mail kontaktnej osoby/zadávateľa pracovnej ponuky.
-
Presmerovanie kandidáta na externý reakčný formulár. - Vieme aktivovať zvlášť políčko pre zadávanie URL adresy pre externú reakciu. Uchádzač je smerovaný na externé stránky klienta a týmpádom vypĺňa externý formulár. Dáta z reakcie sa ukladajú priamo do systému klienta.
-
Unikátny e-mail ku každej ponuke. - Vieme aktivovať zvlášť políčko pre zadávanie reakčného e-mailu. Niektoré ATS používajú unikátny e-mail ku každej pracovnej ponuke. Reakcie chodia na speciálne e-mailové adresy a na základe toho vie ATS triediť a odsledovať reakcie.
Názov (atribút/element) | popis | príklad |
---|---|---|
application_url (E) |
Reakcie do iného HR systému (Taleo, Kenexa, G2,...) |
|
applicationemail (E) |
Unikátny e-mail ku každej ponuke. |
|
Názov (atribút/element) | popis | príklad |
---|---|---|
Businessarea (E), |
Hlavná oblasť pôsobenia spoločnosti klienta Číselník BUSINESSAREAS |
|
Shortcompanycharacteristics (E) |
Krátka charakteristika spoločnosti klienta, pre ktorú je pozícia obsadzovaná |
|
V prípade, že využívate službu Vlastné polia (Custom fields) a chcete využívať importy, je potrebné tieto polia uviesť v XML súbore.
Čo sú to tie Vlastné polia (Custom fields)?Sú to polia ktoré vieme pridať a zobrazit vrámci detailu ponuky alebo firemnej podstránky.
Textové polia:
- textfield - pre zadávanie krátkych textových informácií, jednoriadkové pole
- textarea - pole pre zadávanie objemnejšieho textu, viacriadkové textové pole
Klient má možnosť si požiadať o vlastné kategórie pomocou ktorých umožníme zobrazovať rozdielne prvky (text/obrázok) alebo použiť ako vlastný filter pre rozdielne kategórie pracovných ponúk.
Vlastné kategórie (Custom categories):
- single select - Drop down list s výberom jednej kategórie
- selectize - Multi select s možnosťou výberu viacero kategórií
- checkbox - Kde dokážeme určiť či ponuka patrí do určitej kategórie. Či je hodnota true/false, kde true = 1.
Názov (atribút/element) | popis | príklad |
---|---|---|
Customfields (E), |
Vlastné používateľské polia a kategórie |
|
Ak chcete aby pracovné ponuky uchádzač našiel čo najľahšie a aby sa na pracovné ponuky hlásili relevantní uchádzači, okrem textových informácii v pracovných ponukách odporúčame vyplniť aj číselníkové hodnoty.
TIP: Číselníky pravidelne aktualizujeme, odporúčame preto pravidelne sledovať zmeny v horeuvedených XML exportoch.
Jednoduché hľadanie na hlavnej stránke zadaním pozície a lokality: https://www.profesia.sk/
Rozšírené vyhľadávanie: https://www.profesia.sk/search_offers.php
Vytvorením agenta pre ponuky https://www.profesia.sk/agent/
Povinné číselníky:
- Typ miesta práce
- Miesto práce
- Kategória a pozícia pracovnej ponuky
- Druh pracovného pomeru
- Požadovaná úroveň vzdelania
Všetky číselníky:
Súhrn všetkých čiselníkov pre profesia.sk v slovenskom jazyku (použitím parametra lang=sk nájdete na linke:
https://www.profesia.sk/codebook.php?lang=sk
Podporované jazyky
Číselníky dokážete zobraziť v piatich jazykoch pomocou parametra lang
- SK: https://www.profesia.sk/codebook.php?lang=sk
- CZ: https://www.profesia.sk/codebook.php?lang=cz
- HU: https://www.profesia.sk/codebook.php?lang=hu
- EN: https://www.profesia.sk/codebook.php?lang=en
- DE: https://www.profesia.sk/codebook.php?lang=de
Číselníky sú dostupné aj zvlásť
Podľa kanála
- Profesia.sk: https://www.profesia.sk/codebook.php?lang=sk
- Profesia.cz: https://www.profesia.cz/codebook.php?lang=cz
- Typ miesta práce: https://www.profesia.sk/codebook_workplacetypes.php?lang=sk
- Miesto práce na trvalom pracovisku: https://www.profesia.sk/codebook_regions.php?workplacetype=1&lang=sk
- Miesto práce - práca ktorá vyžaduje cestovanie: https://www.profesia.sk/codebook_regions.php?workplacetype=2&lang=sk
- Oblasti a pozície: https://www.profesia.sk/codebook_catpos.php?lang=sk
- Druh pracovného pomeru: https://www.profesia.sk/codebook_jobtypes.php?lang=sk
- Vzdelanie: https://www.profesia.sk/codebook_educationlevels.php?lang=sk
- Skills – jazykové a ostatné schopnosti: https://www.profesia.sk/codebook_skills.php?lang=sk
- Mena (mzda): https://www.profesia.sk/codebook_currencies.php?lang=sk
- Obdobie (mzda): https://www.profesia.sk/codebook_salaryperiods.php?lang=sk
Najčastejšie chyby pri importoch - prehľad chybových hlásení
Náš systém nedokáže prečítať XML súbor, ktorý obsahuje pracovné ponuky. Súbor je chybný, alebo nie je pre náš systém dostupný. Import ponúk sa preto neuskutoční. Kontaktujte prosím vaše IT oddelenie, alebo dodávateľa vášho exportu a uistite sa, že XML súbor je v predpísanom formáte.
Aj keď sa ponuky importujú automaticky, každá pracovná ponuka musí mať uvedenú kontaktnú osobu, ktorá musí byť zaregistrovaná na Profesia.sk. Prosím skontrolujte, či sa osoba uvedená pri pracovnej ponuke zhoduje s osobou registrovanou vo vašom firemnom konte na Profesia.sk. Prihlásenie do firemného konta
Pri identifikácii kontaktnej osoby môžu vzniknúť nasledovné chyby:
- Kontaktná osoba nie je zaregistrovaná na stránke www.profesia.sk. Prosím skontrolujte vo vašom konte, či je kontaktná osoba uvedená v pracovnej ponuke zaregistrovaná. Ak nie, je potrebné ju pridať.
- Kontaktná osoba je síce zaregistrovaná na stránke www.profesia.sk, ale pri ponuke nebol uvedený žiaden kontakt (identifikačné údaje - meno, priezvisko a e-mail). Tieto položky sú pri importe pracovných ponúk povinné.
- Kontaktná osoba je zaregistrovaná na stránke www.profesia.sk, ale neboli správne vyplnené identifikačné údaje, ako je Meno, Priezvisko a e-mail kontaktu. Kontakty uvedené v systéme Profesia.sk musia byť zhodné s údajmi v pracovnej ponuke.
- Zadali ste identifikačné údaje viacerých kontaktných osôb. Pracovná ponuka sa môže priradiť len pod jedného zadávateľa. Ak potrebujete uviesť inú kontaktnú osobu, odporúčame tak spraviť v pracovnej ponuke ako textovú informáciu.
Pracovná ponuka, ktorú sa snažíte importovať, neobsahuje povinné polia Pracovná pozícia alebo Pracovná oblasť. Uistite sa, že požadované hodnoty (positions, offercategorypositions) v XML súbore sú vyplnené.
Pracovná ponuka, ktorú sa snažíte importovať musí mať zadané povinné pole Miesto práce. Uistite sa, že požadovaná hodnota (offerlocation) v XML súbore je vyplnená.
Ak ste pri pracovnej ponuke nezadali Druh pracovného pomeru, náš systém jej automaticky nastaví hodnotu 1 (plný pracovný úväzok).
Ak pri importovaní nechcete dostávať tento typ hlášky, odporúčame vám nastaviť parameter druh pracovného pomeru priamo v XML súbore. Podrobnosti nájdete v technickej špecifikácii.
Pracovná pozícia v importovanom súbore nie je zaradená do správnej pracovnej oblasti.
Zaradenie treba upraviť podľa špecifikácie pracovných pozícií v číselníku CATPOS.
V importovanom XML súbore je zadaných viacero ponúk s tým istým ID, alebo sa tá istá pracovná ponuka vyexportovala viackrát s identickým ID.
Náš systém naimportuje prvú ponuku s duplicitným identifikátorom, ostatné ponuky sa neimportujú.
Aby sa vám chybová hláška nezobrazovala, skontrolujte prosím, či sa v ponukách pri parametri external ID nenachádza viackrát rovnaké číslo.
Ak ste pri pracovnej ponuke nezadali typ miesta výkonu práce, náš systém automaticky nastaví parametru workplacetype hodnotu 1 (práca je na pravidelnom pracovisku).
Ak pri importovaní nechcete dostávať tento typ hlášky, odporúčame vám nastaviť parameter druh pracovného pomeru priamo v XML súbore. Podrobnosti nájdete v technickej špecifikácii.
Ak práca vyžaduje cestovanie je povolené zadať maximálne 3 hodnoty číselníka REGIONS. Náš systém automaticky nastavil ako miesto výkonu práce prvé 3 zadané hodnoty.
Ak práca vyžaduje cestovanie (workplacetype=2) je povolené zadať lokality iba z číselníka REGIONS pre tento typ miesta práce (kraj alebo zahraničnú krajinu). Uistite sa, že v elemente offerlocation používate správne hodnoty.
Pre prácu na trvalom pracovisku je povolené zadať iba jednu lokalitu. Náš systém automaticky nastavil ako miesto výkonu práce prvú zadanú hodnoty.
Ulicu, ktorú ste zadali v elemente offerlocation v atribúte street sa nám nepodarilo nájsť. Náš systém nastavil ako miesto výkonu práce hodnotu zadanú číselníkovú hodnotu z číselníka REGIONS.