• Vacatures
• CV Plaatsen
• Voor werkgevers

Als u de XML koppeling wilt gebruiken kunt u contact opnemen met Jeroen Sentel (jsentel@cxomedia.nl). Finance.nl behoud zich het recht voor om zonder overleg vacatures te weigeren indien deze niet aansluiten bij de doelgroep van Finance.nl

De rest van deze pagina omschrijft de techniek die gebruikt wordt en hoe u de XML interface kunt gebruiken. Voor het lezen van deze instructies is het handig als u een basis kennis heeft van XML en HTTP requests.

Inhoud

• Hoe werkt het?
• XML Structuur
• Data velden
• Response

Hoe werkt het?

1. Ontvangst XML data
2. Controle en validatie
3. Opslaan
4. Rapportage

1. Ontvangst XML data
De XML data wordt door uw systeem via HTTP POST verstuurd naar http://www.finance.nl/interface. De POST naam van de xml moet zijn: data[interface][xml]. Verderop deze pagina vind u een voorbeeld en uitleg over de XML structuur.

2. Controle en validatie
De XML interface controleert de xml structuur en kijkt of alle benodigde gegevens aanwezig zijn. De interface controleert ook of de opgegeven gebruikersnaam en wachtwoord kloppen en of de user de interface mag gebruiken.

3. Opslaan
De XML interface schoont de data op zodat deze netjes in onze database gezet kan worden. Bij opschonen kunt u denken aan het weghalen van html code (Een lijst van toegestane html elementen vind u onderaan deze pagina). Zodra de data is opgeslagen is de vacature direct zichtbaar op Finance.nl

4. Rapportage
De interface geeft een XML structuur terug (Response) waarin de status van bepaalde acties staat. Mocht er gaandeweg iets fout zijn gegaan, dan kan u makkelijk terug zien waar het probleem ligt, het is raadzaam de response te bewaren als bestand in een map. Als er geen fouten zijn staat er ook de url in waar de vacature op Finance.nl kan worden teruggevonden. Een volledige lijst van meldingen en hun betekenis vind u onderaan deze pagina.

XML Structuur

Hieronder ziet u een voorbeeld van de xml structuur die gepost moet worden naar de interface. Het bestaat uit een blok xml met daarin twee blokken, settings en data. In het settings blok staan de username, password en actie die uitgevoerd moet worden. In het data blok staat de data waarmee gewerkt moet worden.

Voorbeeld

<?xml version="1.0" encoding="UTF-8" ?>

<xml>

  <settings>
    <license> </license>
    <action> </action>
  </settings>

  <data>
    <referentie> </referentie>
    <expired> </expired>
    <functie_titel> </functie_titel>
    <functie_korte_omschrijving> </functie_korte_omschrijving>
    <functie_omschrijving> </functie_omschrijving>
    <functie_organisatie> </functie_organisatie>
    <functie_afdeling> </functie_afdeling>
    <functie_regio> </functie_regio>
    <functie_plaats> </functie_plaats>
    <functie_postcode_cijfers> </functie_postcode_cijfers>
    <functie_postcode_letters> </functie_postcode_letters>
    <functie_beroepsveld> </functie_beroepsveld>
    <functie_branche> </functie_branche>
    <functie_salaris> </functie_salaris>
    <functie_salaris_eenheid> </functie_salaris_eenheid>
    <functie_opleidingsniveau> </functie_opleidingsniveau>
    <functie_ervaring> </functie_ervaring>
    <functie_aanstelling> </functie_aanstelling>
    <functie_dienstverband> </functie_dienstverband>
    <contact_persoon> </contact_persoon>
    <contact_telefoon> </contact_telefoon>
    <contact_adres> </contact_adres>
    <contact_postcode> </contact_postcode>
    <contact_plaats> </contact_plaats>
    <contact_email> </contact_email>
    <contact_website> </contact_website>
  </data>

</xml>

Verplichte velden
Een aantal velden zijn verplicht om vacatures te plaatsen. Dit heeft als reden de weergave op de website, unieke indentificatie van de vacature en autenticatie van de user. De verplichte velden voor het toevoegen, wijzigen of verwijderen van een vacature zijn:

• license
• action
• referentie
• functie_titel*
• functie_omschrijving*
• functie_organisatie*
• functie_plaats*
• contact_email*

* Niet verplicht voor verwijderen van een vacature (<action>delete</action>)

Data velden

Hieronder vindt u de lijst met alle velden in de XML structuur en de bijbehorende mogelijkheden.

Voor een aantal velden is het aan te raden u aan de conventies van Finance.nl te houden, dit i.v.m. bladeren, zoekformulieren en vindbaarheid op de site.

Response

Hieronder ziet u hoe de response eruit kan zien. Verderop vindt u ook een lijst met uitleg over errors.

Voorbeeld (zonder errors)

<?xml version="1.0" encoding="UTF-8" ?>

<response>

  <parse_xml>ok</parse_xml>
  <settings_structure>ok</settings_structure>
  <data_structure>ok</data_structure>
  <license>ok</license>
  <required_referentie>ok</required_referentie>
  <required_functie_titel>ok</required_functie_titel>
  <required_functie_omschrijving>ok</required_functie_omschrijving>
  <required_functie_organisatie>ok</required_functie_organisatie>
  <required_functie_plaats>ok</required_functie_plaats>
  <required_contact_email>ok</required_contact_email>
  <action>edit</action>
  <save>ok</save>
  <job_id>4760</job_id>
  <url>http://www.finance.nl/vacatures/view/4760</url>

</response><!-- 0.14s -->

Voorbeeld (met errors)

<?xml version="1.0" encoding="UTF-8" ?>

<response>

  <parse_xml>ok</parse_xml>
  <settings_structure>ok</settings_structure>
  <data_structure>ok</data_structure>
  <license>ok</license>
  <required_referentie>ok</required_referentie>
  <required_functie_titel>ok</required_functie_titel>
  <required_functie_omschrijving>ok</required_functie_omschrijving>
  <required_functie_organisatie>ok</required_functie_organisatie>
  <required_functie_plaats>ok</required_functie_plaats>
  <required_contact_email>error: contact_email can not be empty</required_contact_email>

</response><!-- 0.14s -->

Hieronder vind u een lijst met codes en de waardes voor succes of failure.