Job Offer Publishing
Creating a Job Offer is just the initial step to finding the perfect match for a job opening. In order to bring it to the public, one must publish it first.
Prerequisites
In order to publish a job offer, it is first necessary to have a valid recruitment product booked (have JobOfferPublishing as an available functionality). Within the booked product, the following data can be found:
- available publishing slots
- publishing channels
- if job offers will be published as a top job All of which will be used when publishing a job offer.
Acquiring Extra Publishing Slots
Since the recruitment products offer a limited amount of job offers which can be published simultaneously, it is possible to purchase extra publishing slots via add-ons for the already purchased recruitment product.
How are Publishing Slots Calculated?
There are two important values to take into consideration:
- Total publishing slots: the sum of publishing slots provided by the booked product plus the sum of all booked add-ons which include extra slots.
For example:
a. if a company booked a product which includes 5 publishing slots and has 3 extra slots from add-ons, it's a total of 8 slots. b. if a company booked a product which includes 4 publishing slots and no add-ons, it's a total of 4 slots. - Available publishing slots: Total publishing slots minus the sum of all currently published job offers.
For example:
a. if a company has an 8 total publishing slots and 2 currently published job offers, it has a 6 available publishing slots remaining.
b. if a company has a 5 total publishing slots and 3 currently published job offers, it has a 2 available publishing slots remaining.
c. if a company has a 5 total publishing slots and 5 currently published job offers, it has a 0 available publishing slots remaining.
Why are Publishing Slots Important?
The total publishing slots dictate the maximum amount of job offers which can be published at the same time. Reaching that limit means it's impossible to publish any more job offers unless slots become available either by purchasing extra slots, upgrading to a new tier, or unpublishing job offers.
Finding Out the Available Job Offer Slots
Calling the following endpoint will return the available job offer slots for an employer/company:
Simply provide the spaceId of the employer (which is equivalent of the space id from the company).
The data returned has the following structure:
{
"totalSlots": 10,
"usedSlots": 3,
"availableSlots": 7
}
The Job Offer Publishing endpoint will nevertheless provide an error message specifying that there are no available slots if there is an attempt to publish when no slots are available, hence, the get available slots endpoint is merely to provide information and not needed to actually publish.
How to Publish a Job Offer
It is as simple as calling the appropriate endpoint, which can be found in the Markee API Documentation page.
Before proceeding, please consider that the characteristics such as parameters, return values and overall endpoint may be subject to changes and the most up-to-date representation of the endpoint please always refer to the appropriate Documentation page for the Markee API.
It receives a payload composed of a list of job offers and an optional internal reference:
{
"jobOfferIds": [1073741824],
"internalReference": "string"
}
Notice that it's possible to publish multiple job offers with a single API call. This is possible as long as all of the job offers belong to the same employer.
When calling the publish job offer method, the API will take care of gathering the necessary data from the product configuration, including total slots, publishing channels, home portal and top jobs.
A Job Offer will stay published as long as the products or add-ons don't expire, or it's explicitly unpublished.
How to verify it worked?
The returned value will be a list of all the published job offers, which should each have a property statusset to ACTIVE
It's also possible to verify this individually by calling the endpoint
Then simply verify the same property.
Common Errors
- Job Offer list is empty; at least one existing job offer must be sent for the publish action to be successful
- One or more of the job offers sent in the list do not exist; the error message will include the list of the ids which couldn't be matched with an existing job offer
- Job Offers correspond to different employers; all job offers which shall be published in a single API call must belong to the same employer
- Not enough slots available; this will happen if the amount of job offers which shall be published exceeds the amount of available job offer slots