Documentation pour le format générique XML chez FCMS #
Le but de ce document est d’aborder le format générique XML pour une offre d’emploi dans l’écosystème de FCMS.
Exemple complet #
Voici un exemple d’un XML attendu au format FCMS.
Cet exemple liste tous les champs disponibles pour décrire une offre d’emploi. La plupart sont optionnels, mais nous vous encourageons à en remplir un maximum.
<?xml version="1.0" encoding="UTF-8"?>
<jobs>
<job>
<PartnerId><![CDATA[399f923225c901]]></PartnerId>
<Title><![CDATA[Aide-Soignant à Domicile en CDI H/F]]></Title>
<Occupation>
<Description><![CDATA[Description de l'offre]]></Description>
<ProfileDescription><![CDATA[Description du profil attendu]]></ProfileDescription>
<ProfileStatus><![CDATA[non-executive]]></ProfileStatus>
<ExperienceRequirements>
<Classification>
<Identifier>2</Identifier>
<Label><![CDATA[1 à 2 ans d'expérience]]></Label>
</Classification>
</ExperienceRequirements>
<EducationRequirements>
<Classification>
<Identifier>3</Identifier>
<Label><![CDATA[CAP / BEP ou équivalent]]></Label>
</Classification>
</EducationRequirements>
<Location>
<PostalAddress>
<Country>
<Identifier><![CDATA[France]]></Identifier>
<Code><![CDATA[FR]]></Code>
</Country>
<Locality><![CDATA[Charenton-le-Pont]]></Locality>
<Region>
<Name><![CDATA[Île-de-France]]></Name>
<Code><![CDATA[IDF]]></Code>
<IsoCode><![CDATA[FR-IDF]]></IsoCode>
</Region>
<SubRegion>
<Name><![CDATA[Val-de-Marne]]></Name>
<Code>94</Code>
<IsoCode><![CDATA[FR-94]]></IsoCode>
</SubRegion>
<PostalCode>94220</PostalCode>
<StreetAddress><![CDATA[52 Rue de Paris]]></StreetAddress>
<Coordinates>
<Latitude>48.793144</Latitude>
<Longitude>2.474034</Longitude>
</Coordinates>
<Hidden>false</Hidden>
</PostalAddress>
</Location>
<OccupationalCategories>
<Classification>
<Identifier><![CDATA[K1304]]></Identifier>
<Label><![CDATA[Services domestiques]]></Label>
</Classification>
</OccupationalCategories>
<Qualifications>
<Qualification><![CDATA[assidu(e)]]></Qualification>
<Qualification><![CDATA[attentionné(e)]]></Qualification>
</Qualifications>
<Responsibilities>
<Responsibility><![CDATA[encadrement de personnes]]></Responsibility>
</Responsibilities>
<EmploymentTime><![CDATA[parttime]]></EmploymentTime>
</Occupation>
<Salary>
<Period>P1M</Period>
<Currency>EUR</Currency>
<MaxValue>3000</MaxValue>
<MinValue>2500.50</MinValue>
<Comment><![CDATA[Salaire minimum de 2500.50 euros]]></Comment>
<Hidden>false</Hidden>
</Salary>
<EmploymentDuration>P1Y</EmploymentDuration>
<EmploymentType>
<Identifier>2</Identifier>
<Label><![CDATA[CDD]]></Label>
</EmploymentType>
<HiringOrganization>
<Siret>52099004500053</Siret>
<Identifier>150321626112783351</Identifier>
<LegalName>ODELYS</LegalName>
<Description><![CDATA[société de recrutement ODELYS]]></Description>
</HiringOrganization>
<Industries>
<Classification>
<Identifier>1000</Identifier>
<Label><![CDATA[Informatique / Télécom / Internet]]></Label>
</Classification>
</Industries>
<Application>
<Person>
<Name><![CDATA[John FORD]]></Name>
<Email>john.ford@gmail.com</Email>
<Telephone>+33612345678</Telephone>
<FaxNumber>+33612345677</FaxNumber>
</Person>
<Email>john.ford@gmail.com</Email>
<Telephone>+33612345678</Telephone>
<Url>https://mycompany.com/to-job-posting.html</Url>
<Reference><![CDATA[399f923225c901]]></Reference>
<Info><![CDATA[extra info for application purposes]]></Info>
</Application>
<CreatedAt>2006-01-02T15:04:05+07:00</CreatedAt>
<UpdatedAt>2006-01-02T15:04:05+07:00</UpdatedAt>
<ValidThrough>2006-01-02T15:04:05+07:00</ValidThrough>
<Remote>
<RemoteDays>3</RemoteDays>
<Temporary>false</Temporary>
</Remote>
</job>
</jobs>
Champs Requis #
PartnerId
Title
- one of {
Occupation.description
,Occupation.profiledescription
} Occupation.Location.PostalAddress.PostalCode
Occupation.Location.PostalAddress.Country.Code
Occupation.occupationalcategories.Classification.Label
(*)- one of {
HiringOrganization.LegalName
,HiringOrganization.Identifier
} EmploymentType.Label
Application.Url
(*) occupational categories
autrement appelées les fonctions peut-être automatiquement remplies en se basant sur le
titre de
l’offre d’emploi. Si vous décidez d’activer cette fonctionnalité, n’hésitez pas à vous rapprocher de votre commercial
chez FCMS.
Une fois celle-ci activée, il n’est plus nécessaire de remplir le
champs Occupation.occupationalcategories.Classification.Label
Champs #
Title #
type: string
Le titre de l’offre.
Le nombre de caractères dans le titre de l’offre doit être compris entre 2 et 76.
PartnerId #
type: string
Ce champ représente l’identifiant unique de l’offre généré par le client qui est la source de l’offre.
La longueur maximale de ce champ est de 150 caractères.
Occupation #
Description #
type: string
Ce champ représente la description du poste.
Les informations de formatage incluses dans la description sont pour la plupart ignorées. Seules les balises autorisées (en nombre très limité) par le site publiant l’offre seront conservées après traitement de l’offre. De même les données de style (CSS) sont supprimées de l’offre après traitement.
Le nombre de caractères dans la description doit être compris entre 25 et 4000.
ProfileDescription #
type: string
Ce champ représente la description du profil recherché.
Les informations de formatage incluses dans la description sont pour la plupart ignorées. Seules les balises autorisées (en nombre très limité) par le site publiant l’offre seront conservées après traitement de l’offre. De même les données de style (CSS) sont supprimées de l’offre après traitement.
Le nombre de caractères dans la description doit être compris entre 25 et 4000.
ProfileStatus #
type: string
Ce champ permet d’indiquer s’il s’agit d’un poste de cadre. Il peut prendre l’une des valeurs suivantes :
- non-executive
- executive
Toutes les autres valeurs seront ignorées.
ExperienceRequirements #
type: []Classification
Ce champ permet de renseigner le niveau d’expérience requis pour le poste.
Ses valeurs doivent provenir d’un référentiel.
C’est une liste de Classification
En voici des exemples issus de la nomenclature de Figaro Emploi :
identifiant | label |
---|---|
1 | Premier emploi |
2 | 1 à 2 ans d’expérience |
3 | 3 à 5 ans d’expérience |
4 | 6 à 10 ans d’expérience |
5 | Plus de 10 ans d’expérience |
EducationRequirements #
type: []Classification
Ce champ permet de renseigner le niveau d’études requis pour le poste. Ses valeurs doivent provenir d’un référentiel.
C’est une liste de Classification
En voici des exemples issus de la nomenclature de Figaro Emploi :
identifiant | label |
---|---|
1 | Non qualifié |
2 | Brevet des collèges ou équivalent |
3 | CAP / BEP ou équivalent |
4 | Baccalauréat |
5 | Bac +2 ou équivalent |
6 | Bac +3 / Bac +4 ou équivalent |
7 | Bac +5 ou équivalent |
8 | Bac +8 ou équivalent |
Location #
type: []PostalAddress
La localisation de l’offre d’emploi.
C’est une liste de postal addresses.
OccupationalCategories #
type: []Classification
Ce champ permet de renseigner les fonctions associées à l’offre. Ses valeurs doivent provenir d’un référentiel. L’information de la fonction est requise par Figaro Emploi.
C’est une liste de Classification
Qualifications #
type: []string
Ce champ permet de lister les qualifications spécifiques requises pour ce poste. Il y a une limite technique de 500 caractères pour chaque qualification.
Responsibilities #
type: []string
Ce champ permet de lister les responsabilités associées à ce poste. Il y a une limite technique de 500 caractères pour chaque responsabilité.
EmploymentTime #
type: string
Ce champ permet d’indiquer la durée de temps de travail.
Deux valeurs sont possibles :
- parttime
- fulltime
Salary #
type: object
Ce champ permet de renseigner les informations sur le salaire de l’offre. Il a la structure suivante :
Field | Description | type |
---|---|---|
Period | La période à considérer pour le salaire basé sur la norme ISO 8601 | string |
Currency | La devise utilisée comme définie dans la norme ISO 4217 | string |
MaxValue | Le montant maximum du salaire | float64 |
MinValue | Le montant minimum du salaire | float64 |
Comment | Infos complémentaires sur le salaire | string |
Hidden | Indique si le salaire doit être caché sur le site | boolean |
Pour un salaire fixe, veuillez remplir le même montant pour MaxValue
et MinValue
.
EmploymentDuration #
type: string
EmploymentDuration
permet de renseigner la durée du contrat du poste si cela s’applique à l’offre en question.
Elle est exprimée dans le format défini dans l’ISO 8601 comme pour la période du salaire.
EmploymentType #
type: Classification
EmploymentType
permet de renseigner le type de contrat du poste.
Ses valeurs doivent provenir d’un référentiel.
C’est une liste de Classification
HiringOrganization #
type: object
Ce champ permet de renseigner les informations sur l’entreprise qui recrute. Il est constitué comme suit :
Field | Description | type |
---|---|---|
Siret | Le siret de la société si elle est en France | string |
Identifier | L’identifiant FCMS de la société qui recrute (aka bizio id) | string |
LegalName | Le nom de la société qui recrute | string |
Description | La description de la société | string |
Les informations de formatage incluses dans la description de la société sont pour la plupart ignorées. Seules les balises autorisées (en nombre très limité) par le site publiant l’offre seront conservées après traitement de l’offre. De même les données de style (CSS) sont supprimées de la description après traitement.
Si vous ne connaissez pas le Identifier
ou Siret
de la société, vous pouvez remplir à la place son LegalName
.
Industries #
type: []classification
Ce champ permet de renseigner les secteurs d’activité associés à l’offre. Ses valeurs doivent provenir d’un référentiel.
C’est une liste de Classification
Application #
type: object
Ce champ Application
permet de renseigner les informations pour postuler à l’offre.
Field | Description | type |
---|---|---|
Person | Personne référente pour les candidatures | Person |
L’adresse email pour postuler si elle existe | string | |
Telephone | Le numéro de téléphone de la personne référente | string |
Url | URL pour postuler si elle existe | string |
Reference | La référence de l’offre | string |
Info | Info complémentaire sur la manière de postuler | string |
Person #
type: object
Ce champ Person
permet de renseigner les informations de la personne référente pour les candidatures.
Field | Description | type |
---|---|---|
Name | Le nom complet de la personne référente | string |
Telephone | Le numéro de téléphone de la personne référente | string |
FaxNumber | Le numéro de fax de la personne référente | string |
Le courriel de la personne référente | string |
CreatedAt #
type: time
Le champ CreatedAt
correspond à la première date de publication de l’offre.
Accepte uniquement une valeur de type time.
UpdatedAt #
type: time
Le champ UpdatedAt
correspond à la dernière date de mise à jour de l’offre.
Accepte uniquement une valeur de type time.
ValidThrough #
type: time
Le champ validThrough
correspond à la date d’expiration de l’offre.
Accepte uniquement une valeur de type time.
Remote #
type: object
Ce champ permet de renseigner si le télétravail est possible avec le poste et d’en donner les modalités.
Il est structuré comme suit :
Field | Description | type |
---|---|---|
RemoteDays | Nombre de jours en télétravail | float64 |
Temporary | Indique si le télétravail est temporaire ou permanent | boolean |
Classification #
type: object
Un objet de classification représente un terme d’un critère de nomenclature. Il aide à la classification d’une offre d’emploi.
Les cinq critères principaux utilisés dans une offre d’emploi sont les suivants :
- Fonctions ==
OccupationnalCategories
- Secteurs d’activité ==
Industries
- Niveau d’étude ==
EducationRequirements
- Contrat ==
EmploymentType
- Niveau d’expérience ==
ExperienceRequirements
La nomenclature choisie peut-être celle de FCMS ou la nomenclature que vous nous avez fournie
Un objet comprends les champs suivants :
Field | Description | type |
---|---|---|
Identifier | L’identifiant du terme de nomenclature | string |
Label | Le label du terme de nomenclature | string |
Postal Address #
type: object
L’objet contient les champs suivants :
Field | Description | type |
---|---|---|
Country.Identifier | Le nom du pays | string |
Country.Code | Le code ISO du pays basé sur la norme ISO 3166-1 alpha-2 | string |
Locality | La localité du poste | string |
Region.Name | Le nom de la région | string |
Region.Code | Le code région | string |
Region.IsoCode | Le code ISO de la région basé sur la norme ISO 3166-2 | string |
SubRegion.Name | Le nom du département | string |
SubRegion.Code | Le code du département | string |
SubRegion.IsoCode | Le code ISO du département basé sur la norme ISO 3166-2 | string |
PostalCode | Le code postal | string |
StreetAddress | L’adresse complète | string |
Coordinates.Latitude | La latitude des coordonnées GPS | float64 |
Coordinates.Longitude | La longitude des coordonnées GPS | float64 |
Hidden | Indique si la localisation doit être affichée | boolean |
Time #
type: string
Une valeur Time
accepte les formats suivants :
Format | Exemple value |
---|---|
ANSIC | Mon Jan _2 15:04:05 2006 |
UnixDate | Mon Jan _2 15:04:05 MST 2006 |
RubyDate | Mon Jan 02 15:04:05 -0700 2006 |
RFC822 | 02 Jan 06 15:04 MST |
RFC822Z | 02 Jan 06 15:04 -0700 |
RFC850 | Monday, 02-Jan-06 15:04:05 MST |
RFC1123 | Mon, 02 Jan 2006 15:04:05 MST |
RFC1123Z | Mon, 02 Jan 2006 15:04:05 -0700 |
RFC3339 | 2006-01-02T15:04:05+07:00 |
RFC3339Nano | 2006-01-02T15:04:05.999999999+07:00 |