PHPackages                             infowijs/wisservice - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. infowijs/wisservice

ActiveLibrary[HTTP &amp; Networking](/categories/http)

infowijs/wisservice
===================

Class to do SOAP requests to the Somtoday WISService.

1.2.0(6y ago)01.3kproprietaryPHP

Since Jul 18Pushed 6y ago1 watchersCompare

[ Source](https://github.com/infowijs/wisservice)[ Packagist](https://packagist.org/packages/infowijs/wisservice)[ RSS](/packages/infowijs-wisservice/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Somtoday WISService SDK for PHP
===============================

[](#somtoday-wisservice-sdk-for-php)

This library will allow you to connect with Somtoday's SOAP webservice, which contains information about students, teachers, parents, grades, absence and schedules.

Authentication and credentials
------------------------------

[](#authentication-and-credentials)

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:

#### `portal`

[](#portal)

The portal name of the school's Somtoday installation. To find this, sign in on [somtoday.com](http://somtoday.com).

After signing in, check the URL. Example: if the URL is `https://bc-oop.somtoday.nl`, your `portal` value should be `bc`.

#### `brin`

[](#brin)

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](https://duo.nl/open_onderwijsdata/databestanden/vo/adressen/).

#### `username` and `password`

[](#username-and-password)

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](https://docs.includable.com/user-manual-nl/integraties/somtoday/integreren-met-somtoday/).

Running the examples
--------------------

[](#running-the-examples)

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.

Exploring endpoints
-------------------

[](#exploring-endpoints)

As there is no official documentation about the parameters accepted by each SOAP call endpoint, you can use a tool like [SOAPUI](https://www.soapui.org/downloads/soapui.html). This is that same tool that Topicus uses internally to develop and test the WISService endpoints.

### Autocompletion

[](#autocompletion)

The library is set up to autocomplete these function names in an IDE that supports PHPDoc.

### Notes on field formats

[](#notes-on-field-formats)

- Fields that require a date (e.g. `peilDatum`), all use ISO 8601 formatting.

### Endpoints

[](#endpoints)

**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

Credits
-------

[](#credits)

This library is developed by [Infowijs](https://infowijs.nl/?utm_source=github), an agency focussed on buidling tools to improve communication in education and governments.

Contributors:

- Thomas Schoffelen, [@tschoffelen](https://twitter.com/tschoffelen)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2490d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1af8c1e173ab229818dff16253e9b49ce9b0ec8847311d95390760eb59f9901e?d=identicon)[tschoffelen](/maintainers/tschoffelen)

---

Top Contributors

[![tschoffelen](https://avatars.githubusercontent.com/u/666220?v=4)](https://github.com/tschoffelen "tschoffelen (3 commits)")

### Embed Badge

![Health badge](/badges/infowijs-wisservice/health.svg)

```
[![Health](https://phpackages.com/badges/infowijs-wisservice/health.svg)](https://phpackages.com/packages/infowijs-wisservice)
```

###  Alternatives

[friendsofsymfony/rest-bundle

This Bundle provides various tools to rapidly develop RESTful API's with Symfony

2.8k73.3M319](/packages/friendsofsymfony-rest-bundle)[php-http/discovery

Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations

1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7

A fast PHP7 implementation of PSR-7

1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server

Library for interacting with the Pusher REST API

1.5k94.8M293](/packages/pusher-pusher-php-server)[spatie/crawler

Crawl all internal links found on a website

2.8k16.3M52](/packages/spatie-crawler)[react/http

Event-driven, streaming HTTP client and server implementation for ReactPHP

78126.4M414](/packages/react-http)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
