StartedCourses

Met deze method kan informatie worden opgehaald over de inschrijvingsstatus van alle medewerkers.

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

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

username=string&password=string&fromDate=string&tillDate=string

fromDate en tillDate geven het tijdsbereik van de inschrijvingen aan, en moeten in het format "yyyy-MM-dd" worden opgegeven, bijvoorbeeld "2025-01-01". Bij het succesvol aanroepen ziet een respons 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>
  <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 met daarin elementen van type startedCoursesTable. Elk element geeft de inschrijvingsstatus van een medewerker weer. De inhoud van startedCoursesTable is als volgt opgebouwd:

<startedCoursesTable>
  <!-- De naam van de opleiding. -->
  <Opleiding>string</Opleiding>

  <!-- De unieke ID van de opleiding. -->
  <OpleidingsId>int</OpleidingsId>

  <!-- Of de opleiding verplicht is. Mogelijke waarden: "Ja", "Nee" -->
  <Verplicht>string</Verplicht>

  <!-- De naam van de lichting. -->
  <Lichting>string</Lichting>

  <!-- De naam van de trede waar de opleiding onder zit. -->
  <Trede>string</Trede>

  <!-- De contactmomenten van de opleiding. 
    Kommagescheiden waarden in het format d-M-yyyy hh:mm-hh:hh, bijvoorbeeld "5-2-2025 10:00-11:00, 11-2-2025 10:00-11:00"
  -->
  <Contactmomenten>string</Contactmomenten>

  <!-- Alle trainers die bij de opleiding betrokken zijn. Kommagescheiden waarden, bijvoorbeeld "Jan de Vries, Maria de Jong" -->
  <Trainers>string</Trainers>

  <!-- De in Pynter instelbare opleidingscode. Vaak gebruikt om een eigen identificatiesysteem toe te passen in Pynter. -->
  <Opleidingscode>string</Opleidingscode>

  <!-- De versie van de opleiding. -->
  <Versie>string</Versie>

  <!-- De status van de opleiding. Mogelijke waarden:
    "Goedgekeurd"
    "Gestart"
    "Geannuleerd (te laat)"
    "Ingepland"
    "In aanbod"
  -->
  <Status>string</Status>

  <!-- De datum dat de medewerker is gestart aan de opleiding, in het format d-M-yyyy, bijvoorbeeld 23-02-2025. -->
  <Startdatum>string</Startdatum>

  <!-- De datum dat de medewerker de opleiding heeft afgerond, in het format d-M-yyyy, bijvoorbeeld 23-02-2025. -->
  <Afronddatum>string</Afronddatum>

  <!-- De datum dat de opleiding voor de medewerker verloopt, in het format d-M-yyyy, bijvoorbeeld 23-02-2025. -->
  <Verloopdatum>string</Verloopdatum>

  <!-- De voornaam van de medewerker. -->
  <Voornaam>string</Voornaam>

  <!-- De achternaam van de medewerker, in het format "[Achternaam], [tussenvoegsel]", bijvoorbeeld "Vries, de". -->
  <Achternaam>string</Achternaam>

  <!-- Het personeelsnummer van de medewerker. -->
  <Personeelsnummer>string</Personeelsnummer>

  <!-- De locatie van de medewerker. -->
  <Locatie>string</Locatie>

  <!-- De divisie van de medewerker. -->
  <Divisie>string</Divisie>

  <!-- De functie van de medewerker. -->
  <Functie>string</Functie>

  <!-- Het e-mailadres van de medewerker. -->
  <Email>string</Email>

  <!-- De volledige naam van de leidinggevende van de medewerker. -->
  <Leidinggevende>string</Leidinggevende>

  <!-- De kostenplaats van de medewerker. -->
  <Kostenplaats>string</Kostenplaats>

  <!-- De kosten voor de opleiding. -->
  <Kosten>string</Kosten>

  <!-- Ongebruikt. Altijd leeg. -->
  <Betaling>string</Betaling>

  <!-- Of de medewerker uit dienst is. Mogelijke waarden: "Ja", "Nee" -->
  <Uit_x0020_dienst>string</Uit_x0020_dienst>

  <!-- De datum dat de medewerker zich heeft ingeschreven voor de opleiding, in het format d-M-yyyy, bijvoorbeeld 23-02-2025. -->
  <Inschrijfdatum>string</Inschrijfdatum>

  <!-- De datum dat er voor het laatst iets is veranderd aan de inschrijving, in het format d-M-yyyy, bijvoorbeeld 23-02-2025. -->
  <Mutatiedatum>string</Mutatiedatum>

  <!-- De datum dat de inschrijving voor de opleiding is geannuleerd (indien van toepassing), in het format d-M-yyyy, bijvoorbeeld 23-02-2025. -->
  <Annuleringsdatum>string</Annuleringsdatum>

  <!-- De reden van annuleren (indien van toepassing). 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_x0020_door>string</Geannuleerd_x0020_door>

  <!-- De reden van annuleren (indien van toepassing). Mogelijke waarden: "No show", "Afgemeld". -->
  <Annuleringsreden>string</Annuleringsreden>

  <!-- Of de medewerker met het afronden van de opleiding een certificaat. Mogelijke waarden: "Nee", "N.v.t.". -->
  <Certificaat_x0020_behaald>string</Certificaat_x0020_behaald>

  <!-- Het medewerkerstype. Mogelijke waarden: "Intern", "Extern". -->
  <Medewerkertype>string</Medewerkertype>

  <!-- Het percentage dat de medewerker de training heeft afgerond, in het format "X%", bijvoorbeeld "100%" of "12%". Wanneer dit niet van toepassing is wordt er "N.v.t." teruggegeven. -->
  <Percentage_x0020_gereed>string</Percentage_x0020_gereed>
</startedCoursesTable>