Job Offer Unpublishing
Whether the perfect candidate for job position was already found or the search for such a position needs to be paused, there will inevitably be a need to stop displaying an open job position in the job portals. In order to do this, one must unpublish a job offer.
Prerequisites
To unpublish a job offer, the only requirement is to have an active, published job offer for an employer. Naturally, it is only possible to unpublish job offers that are currently published.
Getting Job Offer Publishing Slots Back
Unpublishing a job offer will free up one publishing slot, increasing the available publishing slots by 1. This means that, if an employer has a 5 total publishing slots, 1 available publishing slots and 1 of the 4 published job offers gets unpublished, 1 slot will become available, resulting in now having 2 available publishing slots.
Generally, if an employer has x job offers published and unpublishes y job offers given y <= x, it will free up y job offer publishing slots.
What happens if a Recruitement subscription expires?
If an employer has a recruitment subscription and zero or more job offer slot add-ons, it is possible for any of these recruitement-related products to expire. In case any of those expire, there is an automated process which will calculate if the remaining amount of total publishing slots (if any) is greater than or equal to the amount of job offers currently published:
- If yes, there is no need to unpublish any job offers.
- If no, then there will be a calculation to determine the
namount of job offers which need to be unpublished, and with this value, thenjob offers which were published most recently will be unpublished.
How is n calculated?
The value n is calculated as the total number of published job offers minus the employer's total available job offer slots (from all active products and corresponding add-ons).
- If the result is zero or negative, it means there are more slots than job offers, so none will be unpublished.
- If the result is 1 or greater, there are more published job offers than available slots, and the resulting number will determine how many job offers are unpublished.
This is an important edge case because an employer might purchase a main recruitment product alongside several publishing slot add-ons. These add-ons may expire before the main product, causing the total number of job offer slots to decrease. If the main recruitment product expires, its add-ons will automatically expire as well, resulting in all of the employer's job offers being unpublished.
How to explicitly Unpublish 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:
{
"jobOfferIds": [1073741824]
}
Notice that it's possible to unpublish multiple job offers with a single API call. This is possible as long as all of the job offers belong to the same employer.
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 INACTIVE
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 unpublish 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 unpublished in a single API call must belong to the same employer