---
title: "persoprofiler Own Domain API-Dokumentation"
canonical: "https://campus.compleet.com/space/AGC/527073298/persoprofiler%20Own%20Domain%20API-Dokumentation"
format: markdown
---
> Macro (toc)

# Vorbereitung

Die wichtigste Information, die Sie zu Beginn von Ihren Kunden benötigen, ist die sogenannte CUQ.   
Dabei handelt es sich um einen einzigartigen Kundenschlüssel, mit dessen Hilfe Sie den Feed Ihres Kunden abrufen können. Für gewöhnlich erhält unser Kunde die CUQ durch dessen **perso***profiler-*Ansprechpartner oder durch den **perso***profiler*-* *Support.

Gerade bei Neukunden empfiehlt es sich, dass in **perso***profiler* durch <u>den Kunden</u> eine möglichst ausgefüllte Stellenanzeige erzeugt wird, damit Sie nicht mit einem leeren Feed starten müssen. Wichtig ist dabei, dass die Jobkachel *“Eigene Homepage”* ausgewählt wird:

![image](media://f2f85448-785d-4623-b897-e6100c45616d)

Da Sie vermutlich selbst keinen Zugang zum **perso***profiler* erhalten werden, es aber hilfreich sein kann, die andere Seite dieser Schnittstelle einmal zu sehen, empfiehlt sich ein Blick auf folgende Einträge in unserem BENUTZER-Campus, dem User Guide für unsere **perso***profiler*-Kunden:

[https://campus.compleet.com/space/CC/7081758/Das+Jobsmodul](https://campus.compleet.com/space/CC/7081758/Das+Jobsmodul)  
[https://campus.compleet.com/space/CC/7081708/Stellenanzeigen+anlegen](https://campus.compleet.com/space/CC/7081708/Stellenanzeigen+anlegen)

# Konfiguration des JSON-Feeds

Basis des Feeds:

```
https://jobs.compana.net/x/go?
```

**Parameter: **

| **Property** | **Bedeutung:** | **Default** | **Beschreibung** |
| --- | --- | --- | --- |
| cuq | einzigartiger Kundenschlüssel | - | <span style="color: #bf2600">PFLICHTFELD</span>   
Diese erhalten Sie durch Ihren Auftraggeber oder über den **perso***profiler* Support und ist zwingend erforderlich. |
| enc | Encoding | utf-8 | Endkodierung nach Unicode |
| json | Json | 0 | 1 = Ausgabe in JSON ein  
0 = Ausgabe in JSON aus |
| j | Jobbezeichnung | - | Ermöglicht die Suche nach einem bestimmten Jobtitel. Um alle anzuzeigen, den Wert [a-z] verwenden. |
| tags |  | 0 | 1 = Tags ausgeben  
0 = Tags nicht ausgeben<br>Der User ist in der Lage einer Stellenanzeige in **perso***profiler* *Tags* (besondere Merkmale) zu vergeben. Diese *Tags* können im Feed mitgegeben werden, um diese zu verarbeiten. *tags = 1* funktioniert nun in Kombination mit* j=[a-z].* |
| callback | Bezeichnung des antwortenden JSON-Objects | - | Wird in diesem Beispiel durch die Verwendung von **dataType: 'jsonp'** automatisch von jQuery gesetzt |
| x | Variable für den Modi des Feeds | - | Mögliche Optionen:<br>*x=filter*  
*x=search*  
*x=jobdetails* |
| sl | Select | - | Gibt an, nach welchem Kriterium gefiltert werden soll, deshalb nur mit *x=filter *kombinierbar. |
| sn / sv | Erweiterung für den Select-Parameter | - | Bedingung, die in Kombination mit *x=filter&sl=...* erfüllt sein muss.<br>Beispiel: Alle Jobgruppen mit dem Arbeitsort "Berlin": *sl=gruppe&sn=arbeitsort_ort&sv=Berlin* |
| mod | Modified | - | Zeigt nur Stellen, die seit dem übergebenen Datumswert bearbeitet / angelegt wurden.<br>> ✅ Tagsüber raten wir Ihnen die Stellen mit Hilfe des Parameter *"mod"* zu importieren. Da hierdurch nicht ersichtlich ist, welche Stellen inaktiv sind, schlagen wir vor, dass Sie nachts alle Stellen importieren. So wird aussortiert, welche Stellen nicht mehr veröffentlicht werden sollen.
> ✅ 
> ✅ Mögliche Werte:  
> ✅ 2022-09-07,08,00,00 (8:00 Uhr)
> ✅ 
> ✅ 07.09.2022,08,00,00 (8:00 Uhr)
> ✅ 
> ✅ 2022-07-07  (00:00 Uhr)
> ✅ 
> ✅ 07.07.2022 (00:00 Uhr) |
| jg | Jobgruppe | - | Zeigt nur Stellen an, die in der entsprechenden Jobgruppe sind.<br>Beispiel: *jg=pflegekräfte* |
| o | Ort | - | Zeigt nur Stellen an, deren Einsatzort mit dem übermittelten Wert übereinstimmt.<br>Beispiel: *o=Nürnberg* |
| u | Umkreis | - | Umkreis in Km des Parameters “o”<br>Beispiel: *o=5* |
| juq | Job Unique ID | - | Einzigartige ID einer Stellenanzeige. Nur in Kombination mit *x=jobdetails* kann damit nach einer einzigen Stellenanzeige gesucht werden. |
| ct | Country | DE | Land nach ISO Code, zur Zeit unterstützt: DE, CH, AT |

---

# Get

## Feed einbinden

Die komplette API kann durch clientseitige Abfragen im Browser des Benutzers abgebildet werden. Sie können die folgenden Aufrufe mit klassischem Javascript, dem Javascript Framework Ihrer Wahl oder mit HTML-Formularen und serverseitiger Verarbeitung der Responses verwenden.

Gewisse Parameter müssen bei jeder Anfrage übermittelt werden und werden in diesem Beispiel mittels [ajaxSetup()](http://api.jquery.com/jQuery.ajaxSetup/) gesetzt.

Aufgrund der [same origin policy](http://en.wikipedia.org/wiki/Same_origin_policy) und cross-domain requests wird JSONP mit **synchronen** Aufrufen verwendet.

```
	<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
	
	<script type="text/javascript">
		var cmp = {
			cuq: 'HIER CUQ EINFÜGEN',
			json: 1,
			enc: 'utf-8'
		};
		
		$(function(){
			$.ajaxSetup({
				cache: false,
				async: false,
				dataType: 'jsonp',
				url: 'http://jdb.compana.net/x/go',
				data: cmp
			});
		});
	</script>
```

## Feldbeschreibungen

Das Ausgabeformat wird vor allem durch die beiden Suchmodi *x=search* bzw. *x=jobdetails* beeinflusst.

**Mit dem Modus *****x=search***** erhalten Sie vorerst nur eine grobe Übersicht aller Stellen, die den angegebenen Kriterien entsprechen.**

> ℹ️ ***WICHTIG:*** 
> ℹ️ 
> ℹ️ *Die maximale Anzahl an Stellen pro Aufruf ist 3.500. Falls mehr Stellenangebote bestehen, teilen Sie die Aufrufe auf (z.B pro Jobgruppe ein Aufruf).*

Mit dem Modus *x=jobdetails* erhalten Sie, in Kombination mit der JUQ einer Stelle, die Informationen einer einzigen Stelle. 

| **Wert** | **Default** | **Beschreibung** |
| --- | --- | --- |
| additional_information | string | (unter normalen Bedingungen leer oder nicht relevant.) |
| aktiv_bis | string | Enddatum der Veröffentlichung der Stelle im Format DD.MM.YYYY. |
| aktiv_von | string | Startdatum der Veröffentlichung der Stelle im Format DD.MM.YYYY. |
| arbeitsbeginn | string | Arbeitsbeginn für den Bewerber im Format DD.MM.YYYY. |
| arbeitsort_bundesland | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| arbeitsort_land | string | Land der ausgeschriebenen Stelle. |
| arbeitsort_land1 | null | Land des <u>zweiten</u> Arbeitsortes. |
| arbeitsort_land2 | null | Land des <u>dritten</u> Arbeitsortes. |
| arbeitsort_land3 | null | Land des <u>vierten</u> Arbeitsortes. |
| arbeitsort_land4 | null | Land des <u>fünften</u> Arbeitsortes. |
| arbeitsort_land5 | null | Land des <u>sechsten</u> Arbeitsortes. |
| arbeitsort_land6 | null | Land des <u>siebten</u> Arbeitsortes. |
| arbeitsort_land7 | null | Land des <u>achten</u> Arbeitsortes. |
| arbeitsort_land8 | null | Land des <u>neunten</u> Arbeitsortes. |
| arbeitsort_land9 | null | Land des <u>zehnten</u> Arbeitsortes. |
| arbeitsort_ort | string | Arbeitsort der ausgeschriebenen Stelle. |
| arbeitsort_ort1 | null | Zweiter Arbeitsort |
| arbeitsort_ort2 | null | Dritter Arbeitsort |
| arbeitsort_ort3 | null | Vierter Arbeitsort |
| arbeitsort_ort4 | null | Fünfter Arbeitsort |
| arbeitsort_ort5 | null | Sechster Arbeitsort |
| arbeitsort_ort6 | null | Siebter Arbeitsort |
| arbeitsort_ort7 | null | Achter Arbeitsort |
| arbeitsort_ort8 | null | Neunter Arbeitsort |
| arbeitsort_ort9 | null | Zehnter Arbeitsort |
| arbeitsort_plz | string | Postleitzahl der ausgeschriebenen Stelle. |
| arbeitsort_plz1 | null | Postleitzahl vom zweiten Arbeitsort. |
| arbeitsort_plz2 | null | Postleitzahl vom dritten Arbeitsort. |
| arbeitsort_plz3 | null | Postleitzahl vom vierten Arbeitsort. |
| arbeitsort_plz4 | null | Postleitzahl vom fünften Arbeitsort. |
| arbeitsort_plz5 | null | Postleitzahl vom sechsten Arbeitsort. |
| arbeitsort_plz6 | null | Postleitzahl vom siebten Arbeitsort. |
| arbeitsort_plz7 | null | Postleitzahl vom achten Arbeitsort. |
| arbeitsort_plz8 | null | Postleitzahl vom neunten Arbeitsort. |
| arbeitsort_plz9 | null | Postleitzahl vom zehnten Arbeitsort. |
| arbeitsort_umkreis | null | Umkreis in Kilometern der ausgeschriebenen Stelle. |
| aspid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| at_region | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| ba_betreuung | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| ba_car | null | null oder 1. Gibt an, ob ein eigenes Auto erfordert wird. |
| ba_course | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| ba_degree_type | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| ba_education_type | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| ba_collectiveagreement | null | Tarifvertrag-Informationen. |
| ba_enclosuresrequired | null | Erforderliche Dokumente. |
| ba_hoursperweek | null | Wochenstunden. |
| ba_jobdegree | integer | Erforderlicher Abschluss. |
| ba_joboffertype | null | Arbeitsplatz-Typ (*Bundesagentur für Arbeit*) |
| ba_jobtitlecode | integer | ID der Arbeitsagentur. Für den ausgeschriebenen Wert *ba_titlecode_text* verwenden. |
| ba_jobtitlecodealt1 | null |  |
| ba_jobtitlecodealt2 | null |  |
| ba_kindofapplication | null | Bewerbungsart. Auf Nachfrage, da standardmäßig nicht in **perso***profiler* aktiviert. |
| ba_minijob | null | *null* oder* 1*. |
| ba_pv_aue | null | Gibt an, ob Stelle als Personalvermittler oder Arbeitnehmerüberlassung geschalten wird.<br>*0 Kein ÄÜ oder PV*  
*1 AÜ*  
*2 PV* |
| ba_salary | null | Gehalt als Freitext. |
| ba_schedule_summarytext | null | zusätzlicher Beschreibungstext zur Arbeitszeit |
| ba_socialinsurance | null | Sozialversicherungspflichtig *null* oder *1*. |
| ba_softskills | null | Erforderliche Softskills |
| ba_takeover | null | Übernahme *null* oder *1*. |
| ba_temporaryorregular | null | Befristung |
| ba_termdate | null | Datum Beschäftigungsende im Format DD.MM.YYYY |
| ba_termlength | null | Beschäftigungsdauer in Monaten null oder integer |
| ba_travelrequired | null | Reisebereitschaft |
| ba_workingplan | null | Beschäftigungsart |
| berufsbezeichnung | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| bildungsabschluss | null | geforderter Bildungsabschluss |
| careesma_category | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| careesma_contacttype | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| careesma_degree | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| careesma_region | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| careesma_workexperience | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| careesma_workshift | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| communication_lang | String | (unter normalen Bedingungen leer oder nicht relevant.) |
| customerid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| customeruq | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| datum | string | Datum, an dem die Stelle angelegt wurde im Format DD.MM.YYYY |
| dublette | null | *1* oder *null*, gibt an ob Stelle eine Dublette ist |
| flexible_apply | Objekt | nur vorhanden, wenn Option für flexible Bewerbungsmöglichkeiten durch den Kunden gebucht ist. |
| folderid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| freelancermap_dauer | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gj_gehalt_max | String | Maximalwert einer Gehaltsangabe |
| gj_gehalt_min | String | Minimalwert einer Gehaltsangabe |
| gj_gehaltsangabe | String | Gibt an, ob Gehalt als Spanne oder Grundgehalt angegeben wird:<br>*grundgehalt*  
*gehaltsspanne* |
| gj_grundgehalt | String | Wert des Grundgehalts |
| gj_timeunit | String | Zeiteinheit der Bezahlung |
| gj_vertragsart | String | Art des Vertrags: |
| googlejobs4indeed | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| googlejobs4stepstone | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gruppe | null | Jobgruppe, frei in **perso***profiler* anlegbar. Auf Nachfrage auf bestimmte Werte festlegbar. |
| gp_line_of_business_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gp_operating_area_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gp_package_id_csv | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gp_template_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gp_transferred | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| gruppenid | null | Niederlassung, welcher die Stelle zugewiesen ist. Zuweisung der IDs auf Nachfrage. |
| handwerker_category | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| handwerker_mod | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| handwerker_mod2 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| handwerker_mod3 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| handwerker_mod5 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| handwerker_type | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| header | String | Überschrift des jeweiligen Textmoduls |
| hijob_contracttype | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| hijob_experience | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| hijob_industry | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| hijob_workingplan | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| id | integer | Eindeutige ID der Stelle. |
| interne_ref | null | Interne Referenz, auf Wunsch des Kunden für die API gesperrt. |
| interne_ref2 | null | Interne Referenz 2, auf Wunsch des Kunden für die API gesperrt. |
| interne_ref3 | null | Interne Referenz 3, auf Wunsch des Kunden für die API gesperrt. |
| interne_ref4 | null | Interne Referenz, vielfältig einsetzbar |
| interne_ref5 | null | Interne Referenz, vielfältig einsetzbar |
| interne_ref6 | null | Interne Referenz, vielfältig einsetzbar |
| interne_ref7 | null | Interne Referenz, vielfältig einsetzbar |
| interne_ref8 | null | Interne Referenz, vielfältig einsetzbar |
| is_ba | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| is_flatrate | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| is_global_vorlage | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| is_kontingent | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| is_ba | null | *null* oder *1* . Kennzeichnet, ob diese Stelle bei der Bundesagentur für Arbeit geschalten ist oder nicht. |
| is_premium | null | *null* oder *1* . Kennzeichnet, ob diese Stelle auf einer Premium-Stellenbörse geschalten ist oder nicht. |
| is_website | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jk_berufsbereich | null | Berufsbereich. |
| jk_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jk_sb_array | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobgruppenbild | null | Absoluter URL-Pfad zu dem verknüpften Jobgruppenbild, sofern in **perso***profiler* konfiguriert. |
| jobleiter_at_anstellung | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobleiter_at_branche | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobleiter_at_funktionsbereiche | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobleiter_at_position | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| joblift_employmenttypes | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| joblift_industries | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| joblift_salary_currency | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| joblift_salary_from | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| joblift_salary_period | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| joblift_salary_to | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobninja_category | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobninja_type | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_enddate | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_languages | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_permanent | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_startdate | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_wtime_from | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobroom_wtime_to | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobsulm_berufsgruppen | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobsulm_branchen | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobsulm_position | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobsulm_spezialisierung | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| jobsulm_verhaeltnis | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| juq | string | Job-Unique-ID als 24-stelliger alphanumerischer String. Kann "-" und "@"-Zeichen enthalten. |
| kalaydo_career_level | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kalaydo_duration | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kalaydo_extent | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kalaydo_industry | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kalaydo_jobtype | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| karrierelevel | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| keywords | null | Schlagworte für Optimierung der Auffindbarkeit. |
| kontakt_anrede | integer | Anrede der angegebenen Kontaktperson: *1* (Herr) oder *2* (Frau) |
| kontakt_email | string | Email-Adresse der angegebenen Kontaktperson. |
| kontakt_fax_country | null | Landesvorwahl der Faxnummer der angegebenen Kontaktperson. |
| kontakt_fax_rf | null | Faxnummer der angegebenen Kontaktperson. |
| kontakt_fax_vw | null | Faxvorwahl der angegebenen Kontaktperson. |
| kontakt_info | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kontakt_info2 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kontakt_info3 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kontakt_name | string | Nachname der angegebenen Kontaktperson. |
| kontakt_ort | null | Ort der Niederlassung der angegebenen Kontaktperson. |
| kontakt_plz | null | Postleitzahl der Niederlassung der angegebenen Kontaktperson. |
| kontakt_strasse | null | Straße der Niederlassung der angegebenen Kontaktperson. |
| kontakt_tel_country | null | Landesvorwahl der Telefonnummer der angegebenen Kontaktperson. |
| kontakt_tel_rf | string | Telefonnummer der angegebenen Kontaktperson. |
| kontakt_tel_vw | string | Vorwahl der angegebenen Kontaktperson.<br>> ℹ️ ***Achtung: ***  
> ℹ️ *Ortsvorwahl wird ohne führende "0" ausgegeben und muss ggf. bei der Ausgabe manuell vorangestellt werden.* |
| kontakt_vorname | string | Vorname der angegebenen Kontaktperson. |
| kontaktid | integer | ID der Kontaktperson der Stelle. Zuweisungen der IDs auf Nachfrage. |
| kundenid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kurz_titel | string | Kurztitel als Freitext. |
| leadership | integer | Erwartete Führungskompetenzen |
| mitarbeiterid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| modified | string | Letzte Änderung der Stelle (Datum + Uhrzeit). |
| monster_arbeitszeit | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| monster_berufsfeld | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| monster_berufsgruppe | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| monster_branche | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| monster_region | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| monster_vertragsart | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| notify_contact_email | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| offene_stellen | integer | Anzahl offener Stellen |
| orderid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| parts_sb_array | Objekt | (unter normalen Bedingungen leer oder nicht relevant.) |
| placement_company_size | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| placement_employment_type | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| placement_management_level | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| placement_occupation | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| placement_salary | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| placement_sector | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| praktischarzt_anzeigentyp | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| praktischarzt_fachbereich | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| praktischarzt_jobtyp | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training2 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training3 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training4 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training5 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training6 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training7 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training8 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| professional_training9 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| publish_ba | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| publish_website | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| qualifikation | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| regionaljobs_kategorie | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| salzburgerjobs_kategorie | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| show_linkedin_poster_url | URL | *Linkedin*-Profil des Sachbearbeiters |
| show_xing_poster_url | URL | *Xing*-Profil des Sachbearbeiters |
| status | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_anstellungsart | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_arbeitszeit | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_berufserfahrung | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_branche | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_liquid_mod | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_liquid_mod2 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_liquid_mod3 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_liquid_mod4 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| stepstone_liquid_mod5 | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| teaser | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| thenetwork_request_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| titel | string | Titel als Freitext. |
| uid | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| userid | null | User-ID des Erstellers. Zuweisungen der IDs auf Nachfrage. |
| vam_branche | String | (unter normalen Bedingungen leer oder nicht relevant.) |
| xing_industry_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| xing_job_type | null | (unter normalen Bedingungen leer oder nicht relevant.) |

> ℹ️ *Mit dem Schlüssel JUQ stellen Sie dann die Verbindung zwischen den Ergebnissen einer Suche und der Detailansicht einer Stelle her.*

## Nur mit JUQ aufrufbar

| **Wert** | **Default** | **Beschreibung** |
| --- | --- | --- |
| arbeitsort_latitude | String | Breitengrad des Arbeitsorts |
| arbeitsort_latitude1 | String | Breitengrad des 2. Arbeitsorts |
| arbeitsort_latitude2 | String | Breitengrad des 3. Arbeitsorts |
| arbeitsort_latitude3 | String | Breitengrad des 4 .Arbeitsorts |
| arbeitsort_latitude4 | String | Breitengrad des 5. Arbeitsorts |
| arbeitsort_latitude5 | String | Breitengrad des 6. Arbeitsorts |
| arbeitsort_latitude6 | String | Breitengrad des 7. Arbeitsorts |
| arbeitsort_latitude7 | String | Breitengrad des 8. Arbeitsorts |
| arbeitsort_latitude8 | String | Breitengrad des 9. Arbeitsorts |
| arbeitsort_latitude9 | String | Breitengrad des 10. Arbeitsorts |
| arbeitsort_longitude | String | Längengrad des Arbeitsorts |
| arbeitsort_longitude1 | String | Längengrad des 2. Arbeitsorts |
| arbeitsort_longitude2 | String | Längengrad des 3. Arbeitsorts |
| arbeitsort_longitude3 | String | Längengrad des 4. Arbeitsorts |
| arbeitsort_longitude4 | String | Längengrad des 5. Arbeitsorts |
| arbeitsort_longitude5 | String | Längengrad des 6. Arbeitsorts |
| arbeitsort_longitude6 | String | Längengrad des 7. Arbeitsorts |
| arbeitsort_longitude7 | String | Längengrad des 8. Arbeitsorts |
| arbeitsort_longitude8 | String | Längengrad des 9. Arbeitsorts |
| arbeitsort_longitude9 | String | Längengrad des 10. Arbeitsorts |
| ba_titlecode_text | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| catalog_gruppe_id | null | (unter normalen Bedingungen leer oder nicht relevant.) |
| kontakt_latitude | null | Breitengrad der Kontakt-PLZ |
| kontakt_longitude | null | Höhengrad der Kontakt-PLZ |
| textmodule | Objekt | JSON-Objekt der Stellenbeschreibung. Aufgeteilt in 5 Module, je in *"header"* und *"body"* unterteilt. |
| tags | null | Falls *tags=1* als URL-Parameter gesetzt ist, dann die *Tags* der Jobs mitausgeben. Tags sind unter "tags" zu finden. |
| flexible_apply | Objekt | nur vorhanden, wenn Option für flexible Bewerbungsmöglichkeiten durch den Kunden gebucht ist. |
| flexible_apply.pitchyou | Objekt | (nur vorhanden, wenn im Stellenangebot aktiviert) |
| flexible_apply.pitchyou.apply_url | String | URL für die Bewerbung über PitchYou (z.B. *WhatsApp*). |
| flexible_apply.pitchyou.label | String | Optionales Label für den Bewerben-Button. |

## Interne Referenz /  Tags

Es kommt häufig vor, dass in Abhängigkeit bestimmter Werte ein unterschiedliches Verhalten auf einer Stelle gewünscht wird.   
Zum Beispiel sollen dynamische Icons für Benefits angezeigt werden, wenn diese in **perso***profiler* ausgewählt werden oder Stellen vom *Type 1* sollen in einem bestimmten Design angezeigt werden, während Stellen vom *Type 2* in einem anderen Design angezeigt werden sollen. 

Sollte sich unser Kunde für solche Abhängigkeiten entscheiden, empfiehlt sich die Nutzung von den Feldern *“Tags”* oder *“Interne Referenz (0-9)”*. Der kundenseitige Administrator ist in der Lage individuelle Tags sowie Katalogwerte für die Referenzen zu hinterlegen. Nach einem Mapping können die individuell vergebenen Werte für diese Fälle verwendet werden. Siehe hierzu die oben stehenden Feldbeschreibungen. 

## Beispielhafte API-Calls

Anzeige aller veröffentlichten Stellen nach Orten:

```
	$.ajax({
		data: { x: 'filter', sl: 'arbeitsort_ort' },
		success: function(response){
			$('#example_orte').empty();
			$.each(response, function(i, v){
				$('#example_orte').append(i+': '+v+'<br/>');
			});
		}
	});
```


Anzeige aller in **perso***profiler* hinterlegten Berufsbereiche:

```
	$.ajax({
		data: { x: 'filter', sl: 'gruppe' },
		success: function(response){
			$('#example_gruppe').empty();
			$.each(response, function(i, v){
				$('#example_gruppe').append(i+': '+v+'<br/>');
			});
		}
	});
```


Sämtliche Stellen einer Niederlassung (anhand der Gruppenid) anzeigen:

```
$.ajax({
		data: { x: 'search', j: '[a-z]', jgid: 12345, li: 5 },
		success: function(response){
			$('#example_gruppeIDAll').empty();
			$.each(response.search, function(ind, val){
				$.each(val, function(i, v){
					$('#example_gruppeIDAll').append(i+': '+v+'<br/>');
				});
			});
		}
	});
```


Suche nach Ort im Umkreis von 200km:

```
	$.ajax({
		data: { x: 'search', j: '[a-z]', o: 'Nürnberg', u: 200 },
		success: function(response){
			$('#example_ortUmkreis').empty();
			$.each(response.search, function(ind, val){
				$.each(val, function(i, v){
					$('#example_ortUmkreis').append(i+': '+v+'<br/>');
				});
			});
		}
	});
```


Suche nach Stellenbezeichnung in allen Orten:

```
	$.ajax({
		data: { x: 'search', j: 'Hörgeräteakustiker' },
		success: function(response){
			$('#example_stelleOrt').empty();
			$.each(response.search, function(ind, val){
				$.each(val, function(i, v){
					$('#example_stelleOrt').append(i+': '+v+'<br/>');
				});
			});
		}
	});
```


Eine Stelle per **juq** aufrufen:

```
	$.ajax({
		data: { x: 'jobdetails', juq: 'UQ@iMH8AAQEAACDaN3IAAAAN' },
		success: function(response){
			$('#example_stelleJuq').empty();
			$.each(response.display, function(ind, val){
				if(ind == 'textmodule'){
					$.each(val, function(i, v){
						$('#example_stelleJuq').append(i+': '+v.header+'<br/>'+v.body+'<br/>');
					});
				} else {
					$('#example_stelleJuq').append(ind+': '+val+'<br/>');
				}
			});
		}
	});
```


Auflisten aller **juq,** die aktuell online sind. Dies kann mit weiteren Filterkriterien verknüpft werden.  
Die Auflistung der StellenIDs nur über den Parameter **check_online=1** kann wie gewohnt weiter genutzt werden, steht aber auch über **modus=id** zur Verfügung.

```
  $.ajax({
    data: { x: 'search', check_online: 1, modus: 'juq' },
    success: function(response){
      $('#example_list_juqs').empty();
      $.each(response.online_ids, function(ind, val){
        $('#example_list_juqs').append(  '{ juq: '  + val.juq );
        $('#example_list_juqs').append(  ', modified: ' +  val.modified + '},<br/>');
      });
    }
  });
```

---

# Post

## Bewerbung absenden 

Die Bewerbungsinformation kann mittels **multipart/form-data** an `http://jobs.compana.net/x/webapi` versendet werden. Folgende Werte können oder müssen (<span style="color: #bf2600">*Pflichtfeld*</span>) dabei übergeben werden:

| **Parameter** | **Beschreibung** |
| --- | --- |
| c | <span style="color: #bf2600">PFLICHTFELD</span> - Wert  muss immer ***run*** lauten. Wird für interne Zwecke benötigt. |
| cuq | <span style="color: #bf2600">PFLICHTFELD</span> - einzigartiger Kundenschlüssel |
| juq | <span style="color: #bf2600">PFLICHTFELD</span> - einzigartiger Stellenschlüssel |
| anrede |  |
| vorname |  |
| name |  |
| strasse |  |
| plz |  |
| ort |  |
| telefon |  |
| mobil |  |
| mail |  |
| familienstand |  |
| geburtstag |  |
| staatsangehoerigkeit |  |
| land | Hier wird der zweistellige ISO-Ländercode erwartet (ISO 3166 ALPHA-2): DE,AT,CH etc. |
| art | Art der Bewerbung. Da beim Kunden ein Katalog hinterlegt ist, ist hier eine Abstimmung der zur Auswahl stehenden Werte notwendig |
| bildungsabschluss |  |
| verfuegbar_ab |  |
| gehaltsvorstellung |  |
| berufsbezeichnung |  |
| bewerbungsgrund | Grund der Bewerbung. Da beim Kunden ein Katalog hinterlegt ist, ist hier eine Abstimmung der zur Auswahl stehenden Werte notwendig. |
| mtag.NameDerTagGruppe | Um einem Bewerber direkt einen *Tag* anzuhängen.   
mtag.TagGruppenName = TagName<br>Da beim Kunden ein Katalog hinterlegt ist, ist hier eine Abstimmung der zur Auswahl stehenden Werte notwendig.   
Beispiel: mtag.benefits = urlaubsgeld |
| einsatzbereitschaft_bw | Bewerber erklärt sich dazu bereit, bundesweit eingesetzt zu werden.<br>**-1** Nein  
**1** Ja  
**null** Keine Angaben |
| candiate_msg | Freitext für Bemerkungen des Bewerbers |
| dse_update | Bewerber erklärt sich mit der Datenschutzerklärung einverstanden.  
Wert **1,** um das heutige Datum zu setzen. |
| dse_pool_approval | Bewerber erklärt sich damit einverstanden in einem Kandidatenpool zu verbleiben.  
Wert **1,** um das heutige Datum zu setzen |
| file0 | Um Dokumente zu übergeben. Dokumente können nicht als *Array* übergeben werden, sondern jedes Dokument wird mit einem neuen Stellenwert übergeben:<br>file0  
file1  
file2<br>Die maximale Gesamtgröße der übermittelten Dokumente beträgt 20Mb. Höchste Benamung file1000: |
| afp | application finger print<br>Cookie Informationen des Bewerbers |
| json | Ausgabeformat auf json umstellen. Standardmäßig wird ein html zurückgegeben.<br>Wert 1, um auf json umzustellen |
| country_iso | Alternative, um das Land beim Anlegen einzustellen.<br>Zweistelliger ISO-Ländercode wird erwartet (ISO 3166 ALPHA-2): DE,AT,CH etc.<br>Nicht beim Aktualisieren verwenden, überschreibt sonst vorherige Angaben. Zum Aktualisieren "land" verwenden. |
| umkreis | Zum Festlegen des Umkreises beim Anlegen.<br>Überschreibt vorherige Werte, falls er beim Aktualisieren mitgegeben wird. |
| countAsStandard | Soll das jobboard als “Art” oder als “Bewerbungsgrund” abgespeichert werden?<br>Wert 1 = Art<br>leer = Bewerbungsgrund<br>(nur für own-domain Kunden) |
| jobboard | Tracking für die Herkunft des Bewerbers |
| kommentar | Weitere Möglichkeit, um Nachrichten des Kandidaten zu hinterlegen.<br>Wir empfehlen eher candidate_msg zu verwenden. |
| geburtsjahr |  |

**Nur bei Updates von existierenden Bewerbern:**

|  |  |
| --- | --- |
| check_id | Meta-skill Werte bestehender Bewerber aktualisieren |
| check_uq | Meta-skill Werte bestehender Bewerber aktualisieren |
| check_ml | Meta-skill Werte bestehender Bewerber aktualisieren |
| skill_id | Hinterlegen von Skills bei existierenden Bewerbern. |

# Rückgabe

Rückgabeformat ist HTML oder JSON. HTML ist der Standardwert, aber falls die Webapi mit json=1 aufgerufen wurde, ändert sich das Format zu JSON.  
Hier eine Auflistung der Informationen, die Sie bei der JSON Rückgabe erhalten.

|  |  |
| --- | --- |
| **Wert** | **Beschreibung** |
| success_page | Hier befindet sich das HTML, welches normalerweise als Default versendet wird (falls kein json-Parameter existiert). |
| bewerberid | Interne Persoprofiler-ID des Bewerbers. |
| mail | E-Mail-Adresse des Bewerbers |
| rejectedAttachments | Datentyp: Array.  
Falls befüllt, eine Auflistung der Dateien, die nicht von Persoprofiler verarbeitet werden konnten.  
Zum Beispiel aufgrund fehlendem/falschen Dateiformat.  
Gültige Formate sind: 'pdf','doc','docx','odt','xls','xlsx','ppt','pptx','jpeg','rtf','jpg','gif','png','tif','tiff'. |
| uq | Einzigartiger Key des Bewerbers |

# persoprofiler CV-Parser

Es ist möglich **vor dem Absenden** der Bewerbung an unser System den CV-Parser von **perso***profiler* zu nutzen.   
Dieser ist in der Lage die Informationen des Bewerbers aus seinem Lebenslauf auszulesen, um damit das Bewerbungsformular automatisch zu befüllen. 

Um die Expressauswertung verwenden zu können, muss der Aufruf von einer Domain aus stattfinden, die bei uns als autorisiert gilt. Alle Aufrufe von nicht freigegebenen Domains schlagen fehl.  
Um die absendende Domain registrieren zu lassen, wenden Sie sich, nach Absprache mit ihrem Kunden, an den **perso***profiler* Support. 

Um den Lebenslauf auszuwerten, schicken Sie ihn mittels **multipart/form-data** an `https://jobs.compana.net/x/tp-proxy`. Die erkannten Kontaktdaten, Skills und Lebenslaufabschnitte werden per JSON zurückgegeben und können anschließend im Textformat angezeigt oder in Formularfelder gefüllt werden, die der Bewerber anschließend ergänzen oder korrigieren kann.

Sie werden nachfolgendes Object ausgefüllt als Response erhalten:

```
	{
		"anrede": "",
		"vorname": "",
		"name": "",
		"strasse": "",
		"plz": "",
		"ort": "",
		"telefon": "",
		"telefon_san": "",		// Formatierte Telefonnummer
		"telefon_san_ort": "",		// Ortsvorwahl
		"mobil": "",
		"mobil_san": "",		// Formatierte Mobilnummer
		"mobil_san_ort": "",		// Netzbetreiber
		"mail": "",
		"familienstand": "",
		"kinder": "",
		"geburtstag": "",
		"geburtsjahr": "",
		"geburtsort": "",
		"staatsangehoerigkeit": ""
	}
```

Diese Daten können Sie dem Bewerber zum Überprüfen und Korrigieren in einem Formular bereitstellen.

---

# Auswertung  


Mit der Jobauswertung können gewisse Statistiken wie Besucherzahlen, Aufenthaltsdauer, etc. in **perso***profiler* eingesehen werden.   
Dazu stellen wir ein jQuery-Modul bereit: [https://jobs.compana.net/jobslog.js](https://jobs.compana.net/jobslog.js)

Beispiel:

```
	$.fn.companaJobsLog({
		juq: '<eindeutige ID des Stellenangebots>',
		cuq: '<einzigartiger Kundenschlüssel>',
		container_id: 'main',
		id_btn_appl: 'bewerben',
		padding_top: 30,
		log_url: 'https://jobs.compana.net/x/log',
		display_center: true,
		remove_offset: true
	});
```

| **Wert** | **Type** | **Beschreibung** |
| --- | --- | --- |
| juq | *string* | eindeutige ID des Stellenangebots. |
| cuq | *string* | einzigartiger Kundenschlüssel. |
| container_id | *string* | ID des Elements, welches den Beschreibungstext des Stellenangebots beinhaltet. |
| id_bt_appl | *string* | ID des Elements, welches als *"jetzt bewerben"*-Button fungiert. |
| id_btn_mail | *string* | ID des Elements, welches zur Kontaktaufnahme per Mail dient. |
| log_url | *string* | Sollte keine eigene Infrastruktur verwendet werden, dann immer "[https://jobs.compana.net/x/log](https://jobs.compana.net/x/log)". |
| padding_left | *integer* | Innenabstand nach links von *container_id*. |
| padding_top | *integer* | Innenabstand nach oben von *container_id*. |
| offset_top | *integer* | Außenabstand nach oben von *container_id*. |
| display_center | *boolean* | Ob die Stelle mittig zentriert angezeigt wird oder nicht. |
| remove_offset | *boolean* | Für den Fall, dass der [.offsetParent()](https://api.jquery.com/offsetParent/) von *container_id* nicht das <body>-Element ist. |

# Kanaltracking

Unabhängig von der Auswertung der Anzahl der Aufrufe, Klicks und Aufenthaltsdauer