The client will log into Broadbean when they have an advert to publish. They will select one or more destination job boards (this may include their own career site) and Broadbean creates a unique form based upon the selection.
Broadbean processes the data entered and sends an individual feed to each site. Each submission contains data for one advert, which is submitted as and when a user chooses to post.
The data will be sent to the 3rd party interface over a HTTP POST (the data will be in the body of the post). XML is our preferred format, but we can support other methods where XML cannot be supported. We can only submit data to a single posting URL.
The 3rd party interface (this interface is not created by Broadbean but is the responsibility of the 3rd party) should receive the data, process it and load the advert into the website database.
Your interface must accept a unique email address with each advert. This address should be used for applications, as we receive responses back into our system for applicant tracking purposes. This is a mandatory requirement for all job boards and as part of this requirement job boards must return the candidates CV back to us along with the application.
When an advert is posted successfully the interface should print a success message back to the page, we are flexible in the format of your success message eg. Plain text/XML/HTML. Where the advert fails validation (for example "Invalid credentials" or "Invalid value in field Industry") an error message should be returned.
Where possible, we will recognise this error and forward the information to the end user.
The success message should include the URL to the advert on the site, as this enables us to provide a direct link to the job from our system.
A delete request can be actioned by the end user and this should remove the advert from the site prior to its natural expiry. Again, this will be submitted to the 3rd party interface over a HTTP POST.
Broadbean will not send a delete request upon an adverts expiry, the 3rd party should expire the advert automatically after the specified duration.