This library will allow you to connect with Somtoday's SOAP webservice, which contains information about students, teachers, parents, grades, absence and schedules.
To ease the testing of the examples, all examples use the same credentials file. To get started, copy or
rename the credentails.example.json file to credentials.json, and fill it with your own credentails:
The portal name of the school's Somtoday installation. To find this, sign in on somtoday.com.
After signing in, check the URL. Example: if the URL is https://bc-oop.somtoday.nl, your portal value should be bc.
The BRIN number of the school (or deelschool) you wish to connect with. This is usually a 4-digit code that consists of letters and numbers. You can look these up on the DUO website.
To get access to the WISService, you need to create a user in Somtoday with the appropriate roles and permissions. Instructions can be found here.
Run composer install in the php subdirectory. After doing this, you can run the examples in the
examples directory, either through the CLI or through a web browser.
Note that when executing the examples via CLI, you need to cd into the actual examples directory:
cd php && php examples/get_grades.php won't work, but cd php/examples && php get_grades.php will!
The examples should be clear enough to get started writing your own scripts with.
As there is no official documentation about the parameters accepted by each SOAP call endpoint, you can use a tool like SOAPUI. This is that same tool that Topicus uses internally to develop and test the WISService endpoints.
The library is set up to autocomplete these function names in an IDE that supports PHPDoc.
- Fields that require a date (e.g.
peilDatum), all use ISO 8601 formatting.
View the full list of endpoints
The following endpoints are available:
- getLeerling
- getMedewerkerMetPasfoto
- getVerzorger
- saveVerzorger
- getExamenOpdracht
- getCijferOverzicht
- getPreCacheVerzorgers
- getDocentVestigingen
- getStamgroepenlijst
- getLeerlingPlaatsing
- getVerzorgerLeerlingen
- getOpleidingLestijden
- getMedewerkers
- getLeerlingAbsentieConstateringen
- getVestigingen
- schrijfInVoorKeuzeWerkTijd
- getExamenDossier
- getOpleidingVakken
- getLeerlingRelaties
- getLeerlingAbsentieMeldingen
- getMedewerkerRooster
- saveMedewerker
- getLesgroepenlijst
- getVestigingDocenten
- getKlasLeerlingenBijStamgroep
- getLeerlingRooster
- getBevoegdGezag
- getVestigingLestijden
- getMedewerkerByUsername
- getLeerlingVakkenpakket
- getBetrokkenDocentenBijLeerling
- getLeerlingMentoren
- getMedewerkersJarigInMaand
- saveToestemmingLeerling
- getKlasLeerlingenBijLesgroep
- getOpleidingen
- getInstelling
- getMedewerker
- schrijfUitVoorKeuzeWerkTijd
- saveLeerling
- getVestigingVakken
- getLeerlingMetPasfoto
- getLeerlingAbsentieTotalen
This library is developed by Infowijs, an agency focussed on buidling tools to improve communication in education and governments.
Contributors:
- Thomas Schoffelen, @tschoffelen