Jobillico

The Network of Employers
 
 

JobIllico-API

This section examines all requests to modify or add job postings. You must always use the entry point https://www.jobillico.com/api/push.

Please note that the “bsandboxoff” node is optional. By default, the request is processed in our “sandbox” environment. The following nomenclature will enable you to make a request directly through our production environment: <bsandboxoff>1</bsandboxoff>.

ocreator: Contains the job's creator informations sparam: The job's creator email address

Each offer is represented by a node. Several nodes of this type can exist, which would require the insertion of multiple offers at the same time. Here is the structure of the data that represents an offer, presented in the order of the nodes in the example above:

Mandatory

  1. ijob : Posting Identification Number, when it is an update. default value: 0
  2. ideactivatejob : Specify (1) if the posting is to be deactivated. default value: empty string
  3. elang : Specify the default language (fr or en) of the posting. default value: fr
  4. irecruiter : Recruiter’s ID Number. default value:creator id
  5. inotificationoverride : Indicate whether (yes:1) or not (no:0) the issuer, if different from the recruiter for this position, must receive an alert whatever his/her account parameters may be. He/she may receive a notification immediately after an application or nothing at all. default value:1
  6. boffer : Specify whether this is a posting (1) or an opportunity (0). default value:1
  7. bequalaccess : Specify whether this posting conforms to principles of employment equity (1:yes) or not (no:0). default value:0
  8. stitle_fr : French Job title. default value: empty string
    stitle_en : English Job title. default value: empty string
    One of the nodes is obligatory.
  9. srefnumber : Internal Reference Number at client business. default value: empty string
  10. idepartment : Identification Number for corresponding department. default value:0
  11. ojobfunctions : List of all fields of activity related to this posting. Contains a maximum of 3 elements:
    • ichoice: Identification Number for related field of activity.

    A maximum of 3 will be considered for this posting.

  12. obenefits : A list of all the benefits of the company linked to the job posting:
    • ichoice: The identification number of the benefit concerned.
  13. olocations: A list of all locations related to the posting. Contains elements of the following type(s) :
    • ilocation: Location Identification Number.
  14. banonymous: Specify whether posting is anonymous (1) or not (0). default value:0
  15. bhidemap: Specify whether address is anonymous (1) or not (0). default value:0
  16. iavailability: Specify number of available places. default value:0
  17. dbegin: Specifies the start date of employment (YYYY-MM-DD format). default value: empty string
  18. sdescription_fr: French Job description. default value: empty string
    sdescription_en: English Job description. default value: empty string
    One of the nodes is obligatory.
  19. ostatus: List of properties related to type of job:
    • bcontract: Is this a contractual job (1) or not (0)? default value:0
    • boccasional: Is this an occasional job (1) or not (0)? default value:0
    • bpermanent: Is this a permanent job (1) or not (0)? default value:0
    • bseasonal: Is this a seasonal job (1) or not (0)? default value:0
    • bpaindinternship: Is this a paid internship (1) or not (0)? default value:0
    • bunpaidinternship: Is this a non-paid internship (1) or not (0)? default value:0
    • btelecommuting: Is this teleworking (1) or not (0)? default value:0
    • bstudentemployment: Is this a student job (1) or not (0)? default value:0
  20. oschedule: Complementary list of properties related to the type of job:
    • bfulltime: Is this a full-time job (1) or not (0)? default value:0
    • bparttime: Is this a part-time job (1) or not (0)? default value:0
  21. oworkshift: List of properties related to the schedule (work shifts) for this job:
    • bday: Is this a day shift (1) or not (0)? default value:0
    • bevening: Is this an evening shift (1) or not (0)? default value:0
    • bnight: Is this a night shift (1) or not (0)? default value:0
    • bweekend: Is this a weekend shift (1) or not (0)? default value:0
    • boncall: Is this an on-call shift (1) or not (0)? default value:0
    • bonshift: Is this a pre-programmed shift (1) or not (0)? default value:0
  22. ohoursperweek: Specifics on the weekly number of hours for this job:
    • fmin: Minimum number of hours default value: empty string
    • fmax: Maximum number of hours default value: empty string
  23. osalary: Specifics on the pay offered for this job:
    • fmin: Minimum salary default value: empty string
    • fmax: Maximum salary default value: empty string
    • eunit: Determining factor in allocating salary as stated above. Year (Annual), Hour (Time). default value:HOUR
  24. scommissions_fr: French description of commissions. default value: empty string
  25. scommissions_en: English description of commissions. default value: empty string
  26. oradiuscriteria: Radius within which a user must be for this job :
    • evalue: Constant in defining radius and distance : RAD25 (25 km), RAD50 (50 km), RAD75 (75 km), RAD100 (100 km). default value:25km
    • iweight: Weight of criterion default value:1
  27. oeducationcriteria: Level of education required to be considered for this job:
    • evalue: Constant defining education level : NIL(none), HIS(college), COL(college/CEGEP), PRO(professional), UNI(university), TRA(training). default value:NIL.
    • iweight: Weight of criterion default value:1
    • ediploma: Diploma obtained : NIL(none), DES, AEP, ASP, AEC, DEC, CER(university certificate), BAC, DSS (dess), MAS(master), PHD, POS(post-doctoral) default value:NIL
    • bcleared: Graduate (1) or not (0) default value:undefined
  28. oexperiencecriteria: Level of experience required to be considered for this job:
    • evalue: Constant in defining experience level : EXP2(0-2 years), EXP5(3-5 years), EXP9(6-9 years), EXP10(10 +years). default value: undefined
    • iweight: Weight of criterion default value:1
  29. okeyword1: Key word to look for in job seeker information for this job :
    • svalue: Key word. default value: empty string
    • svalue_en: English key word. default value: empty string
    • svalue_fr: French key word. default value: empty string
    • iweight: Weight of criterion default value:1
  30. okeyword2: Key word to look for in job seeker information for this job :
    • svalue: Key word. default value: empty string
    • svalue_en: English key word. default value: empty string
    • svalue_fr: French key word. default value: empty string
    • iweight: Weight of criterion default value:1
  31. okeyword3: Key word to look for in job seeker information for this job :
    • svalue: Key word. default value: empty string
    • svalue_en: English key word. default value: empty string
    • svalue_fr: French key word. default value: empty string
    • iweight: Weight of criterion default value:1
  32. okeyword4: Key word to look for in job seeker information for this job :
    • svalue: Key word. default value: empty string
    • svalue_en: English key word. default value: empty string
    • svalue_fr: French key word. default value: empty string
    • iweight: Weight of criterion default value:1
  33. okeyword5: Key word to look for in job seeker information for this job :
    • svalue: Key word. default value: empty string
    • svalue_en: English key word. default value: empty string
    • svalue_fr: French key word. default value: empty string
    • iweight: Weight of criterion default value:1

    When present, the value of the field <svalue_fr> replaces that of <svalue>. It would therefore be preferable to use the default fields <svalue_fr>.
  34. eenglishspeaking: Level of spoken English : BEG(beginner), INT(intermediate), ADV(advanced). default value: undefined
  35. eenglishwriting: Level of written English : BEG(beginner), INT(intermediate), ADV(advanced). default value: undefined
  36. efrenchspeaking: Level of spoken French : BEG(beginner), INT(intermediate), ADV(advanced). default value: undefined
  37. efrenchwriting: Level of written French : BEG(beginner), INT(intermediate), ADV(advanced). default value: undefined
  38. sotherlangspeaking: Level of spoken other language, in french default value: empty string
  39. sotherlangspeaking_en: Level of spoken other language, in english default value: empty string
  40. sotherlangwriting: Level of written other language, in french default value: empty string
  41. sotherlangwriting_en: Level of written other language, in english default value: empty string
  42. sskills_fr: French Skills. default value: empty string
  43. sskills_en: English Skills. default value: empty string
  44. surl_fr: Redirection link for client business, French page. default value: empty string
  45. surl_en: Redirection link for client business, English page. default value: empty string
  46. dpublication: Date of posting online. default value:today
  47. ipublicationperiod: Indicates the length of time a job posting is published. This period is 30 days. Otherwise, the system will schedule an automatic 30-day posting

Example of Request :

<?xml version="1.0" encoding="utf-8"?>
<request>
      <bsandboxoff>1</bsandboxoff>
      <oauth>
        <sparam><![CDATA[your_email@jobillico.com]]></sparam>
            <sparam><![CDATA[ApiTest]]></sparam>
      </oauth>
      <ocreator>
           <sparam><![CDATA[your_email@jobillico.com]]></sparam>
      </ocreator>
      <job>
       <irecruiter><![CDATA[193]]></irecruiter>
        <inotificationoverride><![CDATA[1]]></inotificationoverride>
           <boffer><![CDATA[1]]></boffer>
           <bequalaccess><![CDATA[1]]></bequalaccess>
            <stitle_fr><![CDATA[Offre d'emploi]]></stitle_fr>
            <stitle_en><![CDATA[Job posting]]></stitle_en>
            <srefnumber><![CDATA[JOB-12345]]></srefnumber>
            <idepartment><![CDATA[2]]></idepartment>
            <ojobfunctions>
                  <ichoice><![CDATA[9]]></ichoice>
            </ojobfunctions>
            <obenefits>
                  <ichoice><![CDATA[9]]></ichoice>
            </obenefits>
            <olocations>
                  <ilocation><![CDATA[]]>327</ilocation>
            </olocations>
            <banonymous><![CDATA[0]]></banonymous>
            <bhidemap><![CDATA[0]]></bhidemap>
            <iavailability><![CDATA[4]]></iavailability>
            <dbegin><![CDATA[2013-07-04]]></dbegin>
            <sdescription_fr><![CDATA[Une description pour une offre d'emploi test]]></sdescription_fr>
            <sdescription_en><![CDATA[Describing a Job posting test]]></sdescription_en>
            <ostatus>
                  <bcontract><![CDATA[0]]></bcontract>
                  <boccasional><![CDATA[0]]></boccasional>
                  <bpermanent><![CDATA[1]]></bpermanent>
                  <bseasonal><![CDATA[0]]></bseasonal>
                  <bpaidinternship><![CDATA[1]]></bpaidinternship>
                  <bunpaidinternship><![CDATA[0]]></bunpaidinternship>
                  <btelecommuting><![CDATA[0]]></btelecommuting>
                  <bstudentemployment><![CDATA[0]]></bstudentemployment>
            </ostatus>
            <oschedule>
                  <bfulltime><![CDATA[1]]></bfulltime>
                  <bparttime><![CDATA[0]]></bparttime>
            </oschedule>
            <oworkshift>
                  <bday><![CDATA[1]]></bday>
                  <bevening><![CDATA[0]]></bevening>
                  <bnight><![CDATA[0]]></bnight>
                  <bweekend><![CDATA[1]]></bweekend>
                  <boncall><![CDATA[0]]></boncall>
                  <bonshift><![CDATA[0]]></bonshift>
            </oworkshift>
            <ohoursperweek>
                  <fmin><![CDATA[37.5]]></fmin>
                  <fmax><![CDATA[40.0]]></fmax>
            </ohoursperweek>
            <osalary>
                  <fmin><![CDATA[45000]]></fmin>
                  <fmax><![CDATA[45000]]></fmax>
                  <eunit><![CDATA[YEAR]]></eunit>
            </osalary>
            <scommissions_fr><![CDATA[]]></scommissions_fr>
            <scommissions_en><![CDATA[]]></scommissions_en>
            <oradiuscriteria>
                  <evalue><![CDATA[RAD25]]></evalue>
                  <iweight><![CDATA[5]]></iweight>
            </oradiuscriteria>
            <oeducationcriteria>
                  <evalue><![CDATA[COL]]></evalue>
                  <iweight><![CDATA[3]]></iweight>
                  <ediploma><![CDATA[BAC]]></ediploma>
                  <bcleared><![CDATA[1]]></bcleared>
            </oeducationcriteria>
            <oexperiencecriteria>
                  <evalue><![CDATA[EXP2]]></evalue>
                  <iweight><![CDATA[5]]></iweight>
            </oexperiencecriteria>
            <okeyword1>
                  <svalue><![CDATA[communication]]></svalue>
                  <svalue_fr><![CDATA[communication]]></svalue_fr>
                  <svalue_en><![CDATA[communication]]></svalue_en>
                  <iweight><![CDATA[1]]></iweight>
            </okeyword1>
            <okeyword2>
                  <svalue><![CDATA[debrouillardise]]></svalue>
                  <svalue_fr><![CDATA[debrouillardise]]></svalue_fr>
                  <svalue_en><![CDATA[resourcefulness]]></svalue_en>            
                  <iweight><![CDATA[1]]></iweight>
            </okeyword2>
            <okeyword3>
                  <svalue><![CDATA[informatique]]></svalue>
                  <svalue_fr><![CDATA[informatique]]></svalue_fr>
                  <svalue_en><![CDATA[informatics]]></svalue_en>
                  <iweight><![CDATA[1]]></iweight>
            </okeyword3>
            <okeyword4>
                  <svalue><![CDATA[rapport]]></svalue>
                  <svalue_fr><![CDATA[rapport]]></svalue_fr>
                  <svalue_en><![CDATA[report]]></svalue_en>
                  <iweight><![CDATA[1]]></iweight>
            </okeyword4>
            <okeyword5>
                  <svalue><![CDATA[statistique]]></svalue>
                  <svalue_fr><![CDATA[statistique]]></svalue_fr>
                  <svalue_en><![CDATA[statistics]]></svalue_en>
                  <iweight><![CDATA[1]]></iweight>
            </okeyword5>
            <eenglishspeaking><![CDATA[INT]]></eenglishspeaking>
            <eenglishwriting><![CDATA[INT]]></eenglishwriting>
            <efrenchspeaking><![CDATA[ADV]]></efrenchspeaking>
            <efrenchwriting><![CDATA[ADV]]></efrenchwriting>
            <sotherlangspeaking><![CDATA[italien]]></sotherlangspeaking>
            <sotherlangwriting><![CDATA[italien]]></sotherlangwriting>
            <surl_fr></surl_fr>
            <surl_en></surl_en>
            <sskills_fr><![CDATA[MS Office]]></sskills_fr>
            <sskills_en><![CDATA[MS Office]]></sskills_en>
            <dpublication><![CDATA[2013-07-04]]></dpublication>
            <ipublicationperiod><![CDATA[15]]></ipublicationperiod>
      </job>
</request>

Response Obtained :

<?xml version="1.0" encoding="utf-8"?>
<results>
      <job>
           <ilocation><![CDATA[351]]></ilocation>
           <ijob><![CDATA[535]]></ijob>
           <icompany><![CDATA[535]]></icompany>
      </job>
</results>