Beetween peut configurer un flux XML pour la diffusion des offres d’emploi du client sur son espace carrière.
Beetween peut configurer un flux XML pour la diffusion des offres d’emploi du client sur son espace carrière. Les offres d’emploi sont alors diffusées et retirées par l’intermédiaire de Beetween et les candidatures sont automatiquement centralisées par dossier de recrutement dans Beetween.
Pré-requis
1- Un site pré-existant
La mise en place d’un connecteur par flux XML nécessite que le client dispose d’un espace carrière déjà en place et d’un outil/script de lecture du flux XML permettant d’alimenter les offres de cet espace carrière (ou que le client en fasse développer un à ses frais).
2- Information préalable de votre prestataire digital
Avant tout développement du flux XML par Beetween, la personne en charge des développements de votre site carrière doit avoir pris connaissance de ce document. En effet, la mise en place du flux XML peut engendrer des coûts et délais de développements importants qui peuvent être facturés par votre prestataire en charge des développements de votre site carrière.
3- Un formulaire de candidature
L’espace carrière doit intégrer un formulaire de candidature pour chaque offre d’emploi permettant aux candidats de postuler : une adresse email spécifique sera associée à chaque offre d’emploi pour l’envoi des candidatures via ce formulaire (ou rediriger vers l’Url présent pour chaque offre dans le flux XML, comme indiqué ci-dessous).
Spécificité du flux XML
Beetween vous fournit l’URL en https du flux XML, consultable à toute heure et sans authentification particulière.
- Encodage : UTF-8
- Mise à jour des données du flux : temps réel
- Fréquence recommandée de consultation : entre toutes les heures et tous les jours. Au-delà de 1 fois par heure, des frais spécifiques pourront être facturés.
L’URL contient un numéro d’identification pseudo-aléatoire permettant de la rendre non devinable.
Composition du flux
Par défaut, sont inclus dans le flux XML, les champs de l’annonce suivants (présents dans l’exemple disponible ici) s’ils ont été remplis par le recruteur :
Balise | Description | Type | Spécificité | Valeurs |
id | Champ à 10 caractères alpha-numériques imposé par Beetween servant de référence et généré automatiquement | Text | Autogenerated | – |
clientId | Identifiant du client sur le jobboard cible | Text | Optionnel | – |
title | Titre de l’offre d’emploi | Text | Required | – |
recruiter | Raison sociale de l’entreprise qui recrute | Text | Required | – |
creation_date | Date de la première publication | Datetime | Autogenerated | – |
last_modification_date | Date de la dernière publication (modification, republication…) | Datetime | Autogenerated | – |
application_email | Adresse email à laquelle envoyer les candidatures | Text | Autogenerated | – |
application_url | Url d’une page de candidature Beetween pour l’annonce avec formulaire de candidature intégré | Text | Autogenerated | – |
job_description | Inclut les balises de contenu de l’offre | – | – | – |
― company | Description de la société | HTML | Required | – |
― mission | Description des missions | HTML | Required | – |
― profile | Description du profil recherché | HTML | Required | – |
location | Inclut les balises de localisation géographique du poste à pourvoir, générées à partir de l’adresse sélectionnée par l’utilisateur | – | – | – |
― city | Ville | Text | Required | – |
― post_code | Code postal | Text | Required | – |
― region2_code | Code du département | Text | Required | – |
― region2 | Nom du département | Text | Required | – |
― region1 | Nom de la région | Text | Required | – |
― country_code | Code du pays | Text | Required | – |
― country_name_fr | Nom du pays en français | Text | Required | – |
― longitude | Coordonnées GPS : longitude | Number | Required | – |
― latitude | Coordonnées GPS : latitude | Number | Required | – |
logo_url | URL du logo lié à la raison sociale enregistrée et configuré dans Beetween | Text | Autogenerated | – |
contract | Inclut les balises liées au contrat de travail proposé | – | – | – |
― type | Typde de contrat proposé, valeurs fixes proposées dans une liste déroulante | Text | Required | |
― duration | Durée du contrat pour les contrats à durée déterminée Contient des attributs value (type Number) et unit (type Text) |
Text | Required pour Stage, CDD et Intérim | |
― rythm | Nombre d’heures par semaine sélectionné Contient des attributs hours_per_weekdisplay_value (type Text) |
Text | – | |
― starting_date | Date de début de mission | Date | Indique également un attribut "asap" avec la date de publication pour les postes à pourvoir dès que possible. | |
job_language | Langue d’écriture de l’annonce (liste déroulante) | Text | – | |
salary | Salaire proposé – 2 types d’affichages : salaire, et fourchette de salaire Contient des attributs value, currency, unit ; et pour l’affichage en fourchette min et max |
Text | – | |
skills | Compétences nécessaires pour le poste (texte libre) 1 sous-balise skill est ajoutée pour chaque compétence renseignée |
Text | Valeurs multiples | – |
job_title | Domaine d’activité correspondant au poste (liste déorulante) | Text | – | |
main_activity_area | Secteur d’activité primaire | Text | Required | |
secondary_activity_area | Secteur d’activité secondaire | Text | – | |
qualification | Niveau de qualification | Text | – | |
experience | Expérience requise : nombre d’années d’expérience requises et nombre d’années en management | Number | – | Détails |
study_levels | Niveau de qualification accepté 1 sous-balise study_level est ajoutée pour chaque niveau de qualification renseigné |
Text | Valeurs multiples | |
school_types | Type d’école 1 sous-balise school_type est ajoutée pour chaque type d’école renseigné | Text | Valeurs multiples | |
education_domain | Domaine d’études | Text | – | – |
Liste des valeurs possibles
Contract Type
Les valeurs possibles pour les balises <contract>/<type> sont indiquées dans le tableau ci-après. Il est préférable d’exploiter les valeurs “code” pour faire un mapping et ainsi éviter tout problème de mise à jour.
Code | displayValue |
PERMANENT | CDI |
TEMPORARY | CDD |
INTERIM | Intérim |
INTERNSHIP | Stage |
APPRENTICESHIP | Contrat d’apprentissage |
CONTRAT_DE_PROFESIONNALISATION | Contrat de professionnalisation |
FRANCHISE | Franchise |
FREELANCE | Freelance |
COLLABORATION_AGREEMENT | Contrat de collaboration |
SUMMER_JOB | Job d’été |
FAMILY | Emplois familiaux |
INTERNATIONAL_VOLUNTEERING | Volontariat international |
PERMANENT_PROJECT | CDI de chantier |
Contract Duration
Attribut Unit | Valeur |
YEAR | an(s) |
MONTH | mois |
WEEK | semaine(s) |
DAY | jour(s) |
HOUR | heure(s) |
Contract Rythm
Pour le flux, la balise rythm contient deux attributs : "hours_per_week" qui contient le nombre d'heures travaillées par semaine et "display_value" qui contient la valeur "Temps plein" ou "Temps partiel". La valeur contenu par la balise est de la forme xx.xh/semaine.
Exemple :
<rythm hours_per_week="37.0" display_value="Temps plein">37.0h/semaine</rythm>Retour au tableau
Contract Starting Date
La balise <contract>/<starting_date > indique la date de début de contrat. Quand une date est choisie pour le début du contrat, l’attribut asap="false" et la valeur dans la balise est égale à la date saisie par l’utilisateur. Si l’utilisateur choisi « dès que possible », l’attribut asap="true" et la date de la balise correspond à la date de publication de l’annonce.
Retour au tableauLanguage
Valeur | Signification |
en | Anglais |
fr | Français |
Salary
Valeur fixe :
<salary value="100000.0" currency="EUR" unit="YEAR">100000 € (Euros) par an</salary>
Fourchette :
<salary min="100000.0" max="150000.0" currency="EUR" unit="YEAR">De 100000 à 150000 € (Euros) par an</salary>
Les valeurs possibles pour les attributs de <salary> sont indiquées dans les tableau ci-après :
Attribut Unit | Valeur |
YEAR | par an |
MONTH | par mois |
WEEK | par semaine |
DAY | par jour |
HOUR | par heure |
Attribut Currency | Valeur |
EUR | € (Euros) |
GBP | £ (Livre britannique) |
MAD | DH (Dirham marocain) |
USD | $ (Dollar américain) |
CAD | $ (Dollar canadien) |
JPY | ¥ (Yen japonais) |
CHF | CHF (Franc suisse) |
Job title
code | displayValue |
Craft / Worker | Artisan / Ouvrier |
Craft / Shop | Artisan / Commerce de proximité |
Worker | Ouvrier / BTP |
Technician | Technicien |
Hospitality / Travel | Hôtellerie / Restauration / Tourisme / Loisirs |
Sales | Commerce / Vente |
MLM Commission | VDI |
Computer | Informatique / Internet / Télécom |
Marketing / Communication | Marketing / Communication |
House help | Services à domicile |
Cleaning / Help | Ménage / Entretien |
Nurse / Babysitting / School help | Services à la personne |
Management | Direction / Encadrement |
Entity management | Direction générale / Responsable d’un centre de profit |
Project management | Gestion de projet |
Engineering | Études / Recherches / Ingénieries |
HR / Formation / Teaching | RH / Formation / Enseignement |
HR | Ressources Humaines / Formation |
Formation / Teaching | Éducation / Enseignement |
Health Care | Santé / Médecine / Social |
Multi services | Services généraux |
Administration | Administration |
Assistant | Assistanat / Secrétariat / Accueil |
Accounting / Finance | Comptabilité / Gestion / Finance |
Legal / Tax | Juridique / Fiscal |
Security / Help | Sécurité / Défense / Gardiennage |
Logistic | Transport / Logistique / Achat |
Activity area
code | displayValue |
Bank | Banque |
Finance | Finance |
Assurance | Assurance |
Accounting | Comptabilité |
Gestion | Gestion |
Legal | Juridique |
Tax | Fiscal |
Agriculture | Agriculture / Pêche |
Agri | Agroalimentaire |
Building | BTP & second œuvre |
Building / infrastucture | BTP Usines / Routes / Canalisation |
Installation / Maintenance / Repair | Installation / Maintenance / Réparation |
Architecture | Architecture |
Design | Design |
Town planning | Urbanisme |
Real estate | Immobilier |
Craft | Commerce / Artisanat |
Retail | Commerce de détail / Vente |
Distribution | Grande distribution |
Export | Commerce international / Export |
Customer service | Service client / après-vente |
Call center | Centre d’appel |
Hostelry | Hôtellerie |
Food | Restauration |
Tourism | Tourisme |
Hobbies | Loisirs |
Sport | Sport |
Equipment manufacturer | Automobile / Aéronautique / Transport |
Metallurgy | Métallurgie |
Mechanical / Robotics | Mécanique / Automatisme / Robotique |
Materials processing | Transformation des matériaux |
Electrical and electronic equipment | Equipements électriques et électroniques |
Quality | Qualité / Inspection |
High technologies | Hautes technologies |
Raw materials | Extraction et transformation de matières premières |
Chemicals | Chimie – Caoutchouc – Plastique |
Pharmaceutical | Industrie pharmaceutique / Biotechnologie |
Manufacturing / Production | Industrie / Production, autres (meubles, textiles, imprimerie) |
Health | Santé |
Social | Social |
Veterinary | Vétérinaire |
Web | Sites Web / SEO / Webdesign |
Software | Développement logiciel |
Telecom | Télécommunications |
E-business | E-business |
IT Services | Société de Services en Ingénierie Informatique |
ConsultingProject management | ConsultingProject management |
Cleaning | Ménage / entretien en entreprise |
Other company services | Autres services aux entreprises |
Individual services | Services à la personne |
Public service | Service public / Administrations |
Fashion | Mode |
Luxury | Luxe |
Beauty | Beauté |
Transport | Transport |
Logistic | Logistique |
Handling | Manutention |
HR | RH |
Recruitment firm | Cabinet de recrutement |
Interim firm | Cabinet d’intérim |
Marketing | Marketing |
Communication | Communication / Médias / Presse |
Advertising | Publicité |
Journalism | Journalisme |
Edition | Édition et Écriture |
Engineering | Ingénierie |
RnD | R&D / Haute technologie |
Consultancy | Bureau d’études |
Private research | Recherche privée |
Public research | Recherche publique |
Security | Sécurité / Défense |
Art | Art / Spectacle / Culture |
Teaching | Teaching |
Public teaching | Enseignement public |
Private teaching | Enseignement privé |
Formation | Formation professionnelle |
Apprenticeship Formation | Formation en alternance |
Water | Eau |
Electricity | Électricité |
Oil and gas | Pétrole / Gaz |
Nuclear | Nucléaire |
Environment | Environnement / Nature |
Waste | Gestion des déchets |
Humanitarian | Humanitaire |
Qualification
Code | displayValue |
MANOEUVRE | Manoeuvre |
OUVRIER_SPECIALISE | Ouvrier spécialisé |
P1_P2 | Ouvrier qualifié (P1,P2) |
P3_P4_OHQ | Ouvrier qualifié (P3,P4,OHQ) |
ENQ | Employé non qualifié |
EQ | Employé qualifié |
TECHNICIEN | Technicien |
AGENT_DE_MAITRISE | Agent de maîtrise |
CADRE_PRIVE | Cadre du secteur privé |
CADRE_PUBLIC | Cadre du secteur public / Armées |
Expérience
Pour un flux, la balise <experience> renvoie l’une des valeurs suivantes :
- Tous niveaux d’expérience
- Débutant / Stage
- Junior (1-2 ans)
- Confirmé (3-5 ans)
- Senior (6-10 ans)
- Expert (10 ans et +)
La balise <experience> possèdes 2 attributs :
- "experience_year" : indique le nombre d’années d’expérience nécessaire pour le poste. Une valeur négative indique que tous les niveaux d’expérience sont acceptés.
- "including_management_years" : indique le nombre d’années d’expérience requises en tant que manager.
Exemple :
<experience experience_year="-2" including_management_years="10.0">Tous niveaux d'expérience</experience>
Study Levels
Code | Valeur |
ALL | Aucun |
BEP_CAP | BEP/CAP |
BAC | Bac |
BAC_1_2 | Bac+1/Bac+2 |
BAC_3 | Bac+3 |
BAC_4 | Bac+4 |
BAC_5 | Bac+5 |
BAC_6_PLUS | Bac+6 et plus |
School Types
Code | Valeur |
ALL | Peu importe |
UNI | Université |
RESEARCH_LAB | Laboratoire de recherche |
BUSINESS_SCHOOL | Grande école de commerce |
ENGINEER_SCHOOL | École d’ingénieur |
A | A |
A_PLUS | A+ |
Mapping et interprétation du flux XML
De manière générale, le mapping est à faire du côté du jobboard (ou du site carrière).
Les valeurs présentes dans le flux XML par défaut ne sont pas modifiables sauf si convenu dans les échanges : il faudra donc faire un mapping des données pour que les valeurs soient affichées comme vous le souhaitez dans votre espace emploi.
Les champs de type liste déroulante et spécifiques à votre jobboard reprendront la nomenclature que vous nous aurez demandée.
Par exemple, pour une liste de spécialités propre à votre jobboard que vous souhaitez intégrer dans le flux XML, la nomenclature sera :
- Nom du champ : Spécialité
- Type de champ : Menu déroulant
- Obligatoire : Oui
- Valeurs possibles (avec leur code à insérer dans le flux) :
- Code : security | Libellé : Sécurité
- Code : hardware | Libellé : Matériel
- Code : network | Libellé : Réseau
- Code : software | Libellé : Logiciel
- Code : web | Libellé : Web
- Nombre de valeurs sélectionnable : 3
- Balise : <job_speciality>
- Exemple : <job_speciality code="security">Sécurité</job_speciality>
Il est important de prévoir un garde fou du côté de l’interprétation du flux XML afin que si vous rencontrez un flux vide ou en erreur, les offres ne soient pas supprimées du site web. Ce scénario pouvant arriver, il est important de le prendre en compte pour éviter des suppressions massives par erreur par exemple.