Documentation for FCMS generic XML format #
The purpose of this document is to cover the generic xml format for job postings within the FCMS ecosystem.
Full exemple #
Here is an expected XML in FCMS format.
The exemple below list all available fields for describing a job posting. Most of them are optional, but we encourage you to complete them as much as you can.
<?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>
Mandatory fields #
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 can be automatically filled based on job posting title. Please contact your sale representative to enable this feature. If enabled, it’s not required to fill this field.
Fields #
Title #
type: string
Job title. Number of characters should be between 2 and 76.
PartnerId #
type: string
Job posting unique identifier from customer side. Maximum length is 150 characters.
Occupation #
Description #
type: string
Job description. The HTML tags are stripped out except ones authorized by the publisher.
Number of characters should be between 25 and 4000.
ProfileDescription #
type: string
Job profile description. The HTML tags are stripped out except ones authorized by the publisher.
Number of characters should be between 25 and 4000.
ProfileStatus #
type: string
Job profile status. Two values are expected:
- non-executive
- executive
Other values will be ignored.
ExperienceRequirements #
type: []Classification
Job experience requirements. It’s a list of classification items
FCMS Nomenclature exemple:
code | 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
Job education requirements. It’s a list of classification items
FCMS nomenclature exemple:
code | 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
Job location. It’s a list of postal addresses.
This is basically the location(s) where job postings take place.
OccupationalCategories #
type: []Classification
Job occupational categories. It’s a list of classification items.
Qualifications #
type: []string
Job qualifications. It’s a collection of qualification string. No predefined format.
Responsibilities #
type: []string
Job responsibilities. It’s a collection of responsibility string. No predefined format.
EmploymentTime #
type: string
Job employment time. Accepted values :
- parttime
- fulltime
Salary #
type: object
Job salary.
Field | Description | type |
---|---|---|
Period | A duration as defined in ISO 8601 standard | string |
Currency | The currency code as listed in ISO 4217 standard | string |
MaxValue | Salary maximum amount value | float64 |
MinValue | Salary minimum amount value | float64 |
Comment | An additional comment about the salary | string |
Hidden | Display or not the salary on publisher site | boolean |
For a fixed salary, fill the same amount for MaxValue
and MinValue
.
You can hide the job salary by setting Hidden
to true
.
EmploymentDuration #
type: string
Job employment duration. It represents the job total duration. Only duration a value from ISO_8601 standard is accepted.
EmploymentType #
type: Classification
Job employment type. It’s a classification item.
HiringOrganization #
type: object
Job hiring organization.
Field | Description | type |
---|---|---|
Siret | The company siret | string |
Identifier | The FCMS company identifier (aka bizio id) | string |
LegalName | The company legal name | string |
Description | An additional description | string |
If you don’t know the hiring organization Identifier
or Siret
, you can fill the LegalName
instead.
Industries #
type: []classification
Job industries. It’s a collection of classification items.
Application #
type: object
Job application. It’s basically the “how to apply” field
Field | Description | type |
---|---|---|
Person | The contact name | Person |
The contact email | string | |
Telephone | The contact telephone | string |
Url | The job posting url where the candidate can apply | string |
Reference | The job reference, most of the time similar to PartnerId | string |
Info | Additional application info | string |
Person #
type: object
Recruitment person information.
Field | Description | type |
---|---|---|
Name | Full name | string |
Telephone | Telephone number | string |
FaxNumber | Fax number | string |
string |
CreatedAt #
type: time
Job first publication date. Accepts only a time value
UpdatedAt #
type: time
Job last update date. Accepts only a time value
ValidThrough #
type: time
Job validity date. Accepts only a time value
Remote #
type: object
Job remote.
Field | Description | type |
---|---|---|
RemoteDays | Number of days in remote | float64 |
Temporary | Is remote temporary ? | boolean |
Classification #
type: object
A classification item is based on a nomenclature term to help classifying a job offer.
The chosen nomenclature may be the FCMS nomenclature or the one you have provided to us.
A classification item is listing two fields :
Field | Description | type |
---|---|---|
Identifier | The nomenclature term code or identifier | string |
Label | The nomenclature term label | string |
Postal Address #
type: object
A postal address list the field bellow:
Field | Description | type |
---|---|---|
Country.Identifier | The country name | string |
Country.Code | The country iso code. Based on ISO 3166-1 alpha-2 | string |
Locality | The city name | string |
Region.Name | The region name | string |
Region.Code | The region code | string |
Region.IsoCode | The region iso code based on ISO_3166-2 | string |
SubRegion.Name | The SubRegion name | string |
SubRegion.Code | The SubRegion code | string |
SubRegion.IsoCode | The SubRegion iso code based on ISO_3166-2 | string |
PostalCode | The location postal code | string |
StreetAddress | The location street address | string |
Coordinates.Latitude | The GPS latitude number | float64 |
Coordinates.Longitude | The GPS longitude number | float64 |
Hidden | Whether the postal address shall be displayed on publisher site | boolean |
Time #
type: string
A time value accepts the formats bellow:
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 |