Skip to main content

CompletedCourses

Met deze methode kunnen alle afgeronde (voltooide) cursussen worden opgehaald, voor een opgegeven tijdsperiode.

**Let op:** Gebruik geen GET-requests. Deze worden in plaintext verstuurd, en zijn dus niet veilig.

POST /service/apiservice.asmx/CompletedCourses HTTP/1.1
Host: domein.pynter.nl
Content-Type: application/x-www-form-urlencoded
Content-Length: length

username=string&password=string&fromDate=datetime&toDate=datetime
  • username (string): De gebruikersnaam van de organisatie/klant.
  • password (string): Het bijbehorende wachtwoord.
  • fromDate (datetime in YYYY-MM-DD format): De begindatum (inclusief) van het tijdvak waarin cursussen afgerond moeten zijn.
  • toDate (datetime in YYYY-MM-DD format): De einddatum (inclusief) van het tijdvak waarin cursussen afgerond moeten zijn.

Bij een succesvolle aanroep ziet de response er als volgt uit:

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<ApiResponseOfDataTable xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tempuri.org/">
  <Success>true</Success>
  <Contents>
    <!-- Metadata, deze kan genegeerd worden. -->
    <xs:schema id="NewDataSet"></xs:schema>
    <diffgr:diffgram>
      <DocumentElement>
      </DocumentElement>
    </diffgr:diffgram>
  </Contents>
</ApiResponseOfDataTable>

De Contents.diffgr:diffgram bevat een DocumentElement waarin elke rij een afgeronde cursus representeert. De kolommen en hun betekenis zijn als volgt:

<completedCoursesTable>
  <!-- De unieke identificatie van de opleiding/module. -->
  <OpleidingsId>int</OpleidingsId>
  
  <!-- De naam van de gevolgde opleiding of module. -->
  <Opleiding>string</Opleiding>
  
  <!-- De naam van de lichting waarin de opleiding is gevolgd. -->
  <Lichting>string</Lichting>
  
  <!-- De trede waar de opleiding onder hoort. -->
  <Trede>string</Trede>
  
  <!-- Overzicht van data en tijden van contactmomenten, als kommagescheiden lijst. -->
  <Contactmomenten>string</Contactmomenten>
  
  <!-- Namen van de trainers (kommagescheiden indien meerdere). -->
  <Trainers>string</Trainers>
  
  <!-- De code van de opleiding. -->
  <Opleidingscode>string</Opleidingscode>
  
  <!-- De versie van de opleiding. -->
  <Versie>string</Versie>
  
  <!-- De status: 'Afgerond' of 'Verlopen', afhankelijk van geldigheid. -->
  <Status>string</Status>
  
  <!-- De startdatum van de opleiding. -->
  <Startdatum>datetime</Startdatum>
  
  <!-- De datum waarop de opleiding is afgerond. -->
  <Afronddatum>datetime</Afronddatum>
  
  <!-- De datum waarop de opleiding verloopt. -->
  <Verloopdatum>datetime</Verloopdatum>
  
  <!-- De voornaam van de deelnemer. -->
  <Voornaam>string</Voornaam>
  
  <!-- De achternaam en eventuele tussenvoegsels van de deelnemer. -->
  <Achternaam>string</Achternaam>
  
  <!-- Het externe personeelsnummer van de deelnemer. -->
  <Personeelsnummer>string</Personeelsnummer>
  
  <!-- De locatie van de deelnemer. -->
  <Locatie>string</Locatie>
  
  <!-- De divisie van de deelnemer. -->
  <Divisie>string</Divisie>
  
  <!-- De functietitel van de deelnemer. -->
  <Functie>string</Functie>
  
  <!-- Het e-mailadres van de deelnemer. -->
  <Email>string</Email>
  
  <!-- Volledige naam van de leidinggevende van de deelnemer. -->
  <Leidinggevende>string</Leidinggevende>
  
  <!-- De kostenplaats van de deelnemer. -->
  <Kostenplaats>string</Kostenplaats>
  
  <!-- De kosten van deelname aan de opleiding. -->
  <Kosten>string</Kosten>
  
  <!-- De wijze van betaling (indien bekend). -->
  <Betaling>string</Betaling>
  
  <!-- 'Ja' als de deelnemer uit dienst is, anders 'Nee'. -->
  <Uit_dienst>string</Uit_dienst>
  
  <!-- De datum van inschrijving voor de opleiding. -->
  <Inschrijfdatum>datetime</Inschrijfdatum>
  
  <!-- De datum van de laatste wijziging van de registratie. -->
  <Mutatiedatum>datetime</Mutatiedatum>
  
  <!-- De datum van annulering (indien van toepassing). -->
  <Annuleringsdatum>datetime</Annuleringsdatum>
  
  <!-- Als de inschrijving is geannuleerd staat hier de reden van annuleren. Mogelijke waarden:
    * Reden onbekend
    * Geweigerd door planner
    * Geweigerd door leidinggevende
    * Geannuleerd door medewerker
    * Geannuleerd door planner
    * Omgepland door medewerker
    * Omgepland door planner
    * Omgepland door teaminschrijving
    * Medewerker uit dienst
    * Overgeplaatst van wachtlijst
   -->
  <Geannuleerd_door>string</Geannuleerd_door>
  
  <!-- Reden van annulering ('No show', 'Afgemeld', of leeg). -->
  <Annuleringsreden>string</Annuleringsreden>
  
  <!-- 'Ja', 'Nee' of 'N.v.t.' afhankelijk van behaalde certificering. -->
  <Certificaat_behaald>string</Certificaat_behaald>
  
  <!-- 'Ja' als de opleiding verplicht was, anders 'Nee'. -->
  <Verplicht>string</Verplicht>
  
  <!-- 'Intern' of 'Extern' afhankelijk van het type dienstverband. -->
  <Medewerkertype>string</Medewerkertype>
  
  <!-- Altijd '100%' voor afgeronde modules. -->
  <Percentage_gereed>string</Percentage_gereed>
</completedCoursesTable>