How to post a new assignment to the Brainville Marketplace.
Note: in this document the word assignment refers to a job posting on the BrainvilleMarketplace.
The request body should be formatted as XML, see below.
<?xml version=""1.0"" encoding=""UTF-8""?><requisition> <assignmentstartdate></assignmentstartdate> <assignmentenddate></assignmentenddate> <competenceareaid></competenceareaid> <extent></extent> <extenttype></extenttype> <location></location> <locationcountryid></locationcountryid> <masterlevel></masterlevel> <maxrate></maxrate> <publicationenddate></publicationenddate> <regionid></regionid> <role></role> <text></text> <title></title> <applicationemail></applicationemail></requisition>
Start date for the assignment. If specified, should be formatted as YYYY-MM-DD
End date for the assignment. If specified, should be formatted as YYYY-MM-DD
An integer value for competence area (industry). Possible values can be found here:
Extent in hours or percentage. Must be an integer. Extent is the number of hours or percentage of full time that the consultant is expected to work with the assignment.
1 - Percentage2 - Hours
Geographic location, i.e. city name
Country id. Possible values can be found here:
Skill/Experience level. Possible values areLow Medium High Advanced Expert
Rate, if specified must be a numeric value. Decimal values are allowed.
End date for assignment publication. Must be a date on the format YYYY-MM-DD hh:mm:ss.Note: The date has to be in the future!
Internal reference number used by posting company
Region ID. Possible values can be found here:https://www.brainville.com/content/xml/countries.xmlNote that regions belong to countries. Which regions belong to which countries can be found in the above xml.* If the country has no region listed, this value is not required
Id-number för the Co-worker that will be shown as Contact for the assignment. This Id can be found as the last numeric part of the URL when clicking on a Co-worker in Brainville. If not specified, the user identified by the authkey will be set as requestor.
Consultant role for the assignment. Must be a text containing max 100 characters.
Description of assignment. Must be a text containing max 10 000 characters. HTML-formatting can be used, but is limited to the following tags:
br i b li ulObserve that if you send HTML-tags as part of the text, these have to be XML-encoded, or sent as part of a CDATA-element.
Title of the assignment. Must be a text containing max 100 characters.
Tracking email from calling system
Boolean value (true/false)Publishes the assignment directly to non-premium users of Brainville (without the normal delay of 48 hours). Note that in most cases the publishing company will be charged for each assignment published with NoDelay.
Boolean value (true/false) or"No", "Yes", "Partly"If the assignment allows for remote work
The Brainville API will respond to the HTTP POST in the following manner:
If the post was successful, the response will be the URL to the posted assignment. For example: https://www.brainville.com/Market/RequisitionSearchResult/Details/6020
Bad XML – If the XML is malformed, a HTTP Status 400 (Bad Request) will be returned.Missing/incorrect data – If the XML is correct, but the data inside it is wrong (for example, a required value is missing, out of range or of the wrong type), a message with HTTP Status 200 (OK) will be returned. The message will begin with “ERROR:”, then followed by a text describing the specific error.