Hier leer je hoe je uitzonderingen voor werkstations en personen kunt maken, bijwerken en verwijderen. Uitzonderingen zijn pauzes in de diensten van een werkstation of persoon. Een machine-uitzondering kan bijvoorbeeld een service- of onderhoudspauze zijn en een persoonsuitzondering een vakantie, ziekteverlof of een vakantie.
Uitzonderingen op werkstations #
Uitzonderingen op werkstations zijn toegankelijk via het eindpunt /workstation-exceptions.
Persoonsuitzonderingen zijn toegankelijk via het eindpunt /person-exceptions.
Uitzonderingen ophalen #
Je haalt bestaande uitzonderingen op door GET-verzoeken te sturen zoals dit:
Je kunt uitzonderingen op werkstations ophalen op type, werkstation_id, extern_id of gewijzigde voorwaarden.
Je kunt uitzonderingen van personen ophalen op type, person_id of gewijzigde voorwaarden
Een uitzondering maken #
Je kunt een uitzondering op het werkstation maken door een POST-verzoek als dit te sturen:
Om aan te geven op welk werkstation de uitzondering is gepland, gebruik je het veld workstation_id.
De toegestane soorten uitzonderingen voor werkstations zijn: Onderhoud, Schoonmaken en Verplaatsen/Organiseren.
Merk op dat je ook een externe_id kunt opgeven voor een uitzondering op het werkstation.
Om een persoonsexceptie te maken, stuur je een POST-verzoek zoals dit:
Om aan te geven voor welke persoon de uitzondering wordt gemaakt, moet je de person_id gebruiken.
De toegestane soorten uitzonderingen voor mensen zijn: Vakantie, Ziekteverlof, Flexi-verlof, Onbetaald verlof.
Een uitzondering bijwerken #
Om een uitzondering bij te werken moet je het uitzondering-id gebruiken dat je kunt krijgen door GET-verzoeken te sturen of uit het antwoordbericht bij het maken van die uitzondering.
Uitzonderingen verwijderen #
Het verwijderen van uitzonderingen op werkstations kan worden gedaan door interne uitzonderingsid’s, externe_id’s of werkstation_id’s op te geven.
Het verwijderen van persoonsuitzonderingen kan worden gedaan door interne uitzonderingsid’s of person_ids op te geven.
Meerdere sets van uitzonderingen kunnen in een enkel verzoek worden verwijderd door de id’s in een array op te geven:
Het antwoordbericht van een DELETE-verzoek vertelt je hoeveel uitzonderingen er zijn verwijderd.