--- title: Tijdlogs description: "#### Skyplanner gegevensstructuur Voordat we in de timelogs duiken, moeten we eerst iets vertellen over de gegevensstructuur in Skyplanner en hoe alles onder de motorkap werkt. Dit zal later allemaal aan bod komen. Als je je order-/werkorder-/jobgegevens in Skyplanner hebt…" url: "https://skyplanner.ai/nl/docs/tijdlogs/" updated: "2025-10-07" category: Integraties tags: - API - Integratie --- # Tijdlogs #### Skyplanner gegevensstructuur Voordat we in de timelogs duiken, moeten we eerst iets vertellen over de gegevensstructuur in Skyplanner en hoe alles onder de motorkap werkt. Dit zal later allemaal aan bod komen. Als je je order-/werkorder-/jobgegevens in Skyplanner hebt geïntegreerd, heb je waarschijnlijk ten minste deze API-endpoints gebruikt: - faser-bestellingen - faser-order-rows - faser-jobs Gegevens die in deze eindpunten worden ingevoerd, worden in de Skyplanner UI als volgt weergegeven: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-25-1024x714.png) **Fig 1.** Bestelling (faser-bestellingen) ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-26-1024x715.png) **Fig 2.** Bestelitems (phaser-order-rows (rood)), Processtappen (phaser-jobs (groen)) Na het invoegen van je orders in Skyplanner wil je **ze exporteren** (dit kan via de UI of het /phaser-orders/export-endpoint) naar de module Productieplanning: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-27-1024x596.png) **Fig 3.** Exporteren via de UI ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-28-1024x597.png) **Fig 4.** Geëxporteerde order in Productieplanning Bij het exporteren van orders kopieert Skyplanner de ordergegevens van de ene databasetabel naar de andere. Dus als je iets wijzigt via bijvoorbeeld het /phaser-orders -endpoint, moet je de gegevens opnieuw exporteren om ze bij te werken in Productieplanning. Dit betekent ook dat je verschillende API-endpoints moet gebruiken om toegang te krijgen tot de orders die je ziet in het venster Productieplanning! De "gewijzigde" eindpunten gaan als volgt: - /phaser-orders → /orders - /phaser-order-rows → /order-rows - /phaser-jobs → /jobs Dit is belangrijk om te weten, want als je het /timelogs -endpoint gebruikt om je productiegebeurtenissen etc. te loggen **, moet je de gerelateerde entiteiten gebruiken die je vindt in Production Scheduling -endpoints!** Je hebt bijvoorbeeld de **production_planning_job_id** nodig (om te herhalen: production_planning_jobs zijn de entiteiten die worden benaderd vanaf het /jobs -endpoint) om een nieuw timelog te POST'en: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-29.png) **Fig 5.** Tijdlog POST verzoek Je kunt de production_planning_job_id die je nodig hebt vinden via het /phaser-jobs -endpoint: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-30.png) **Fig 6.** Phaser job GET verzoek (rood is phaser_job_id, **NIET GEBRUIKEN IN TIMELOGS**) Of vanaf het /job -eindpunt: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-31.png) **Fig 7.** /job GET-verzoek #### Tijdlogs maken met de REST-API Het maken van tijdschema's naar Skyplanner via de API maakt gebruik van dezelfde regels en systemen als in de UI. Het kan dus nuttig zijn om jezelf vertrouwd te maken met hoe het systeem werkt in de UI voordat je het probeert te gebruiken via de API. ##### Basisprincipes tijdlog Skyplanner heeft vier soorten tijdloggebeurtenissen: - shift_begin - gepauzeerd - vervolg - shift_einde Shift_begin-event wordt verzonden wanneer de taak voor de eerste keer wordt gestart. **Stuur nooit meer dan één shift_begin-event voor elke taak!** Met Paused-event wordt de taak gepauzeerd. Continued-event hervat een gepauzeerde taak. Shift_end voltooit de taak. **Stuur nooit meer dan één shift_end gebeurtenis voor elke taak!** Vereiste gegevens voor timelogs: - persoon_id - Kan worden gevonden via het /people-endpoint - Niet hetzelfde als user_id! - gepland_werkstation_id - De werkplek waar de taak wordt uitgevoerd - Kan worden gevonden vanaf het /workstations-eindpunt - datum_tijd - Het tijdstip waarop de gebeurtenis plaatsvindt - Formaat: 2024-01-01 10:30:11 Om te specificeren welke Skyplanner timelog gekoppeld is aan de timelog van welk extern systeem je ook gebruikt, kun je het **external_id**veld gebruiken. Je kunt dan bijvoorbeeld GET-verzoeken doen met dit id om een specifiek timelog van Skyplanner te vinden. ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-32-1024x438.png) **Fig 8.** External_id in timelogs #### Een baan beginnen Je kunt taken starten door een POST-verzoek als dit naar de API te sturen: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-33.png) **Fig 9.** Shift_begin tijdlog Stel bij het instellen van de POST-gegevens voor de timelogs **workshift_id**in op 0 en **timelog_finalized**op **true**. #### Een taak onderbreken Taken pauzeren door een POST-verzoek als dit te verzenden: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-34.png) **Fig 10.** Gepauzeerd tijdlogboek In timelogs van het gepauzeerde type kun je het **bedrag**en **fout_bedrag** instellen. Let ook op het **timelogtype**en **de date_time**. #### Een baan voortzetten Zo ga je verder met een gepauzeerd timelog: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-35.png) **Fig 11.** Voortgezet tijdlogboek Merk op dat als je een taak probeert voort te zetten die is beëindigd door een shift_end gebeurtenis, je een foutmelding krijgt. #### Een baan beëindigen Hier zie je hoe je een taak beëindigt met een shift_end timelog: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-36.png) **Fig 12.** Tijdlog shift_einde In shift_end-events kun je de waarden **amount**en **faulty_amount**opgeven, net als in paused-events. Merk op dat als je een shift_end-event probeert uit te voeren op een taak die niet actief is, je een foutmelding krijgt. #### Tijdlogs bijwerken Je kunt timeloggegevens bijwerken door PUT-verzoeken te sturen naar het /timelogs-endpoint, zoals dit: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-37.png) **Fig 13.** Tijdlogboeken bewerken Merk op dat je zowel de **beginTimelog**als de **eindTimelog**gegevens moet hebben om een update te kunnen doen. Timelogs in Skyplanner worden als volgt opgeslagen: elke "volledige" (timelog die zowel een begin als einde heeft (bijv. shift_begin/continued & paused/shift_end) timelog heeft een aparte entiteit voor het begin en einde. Deze worden gekoppeld door de **begin_id**waarde die gevonden wordt in het eindlog. In het bovenstaande voorbeeld heeft de beginTimelog de id-waarde 1 en dus heeft de eindTimelog de **begin_id**waarde 1. Je moet ook de **person_id**en **endTimelog**waarden opgeven voor elke keer dat je een updateverzoek doet, zelfs als je ze niet wijzigt. #### Alternatieve manieren om tijdlogs te maken Hier zijn enkele alternatieve manieren waarop je je kunt aanmelden bij je taken met behulp van de API. ##### Logfull Als je zowel de begin- als eindtijdlogs in een enkel verzoek wilt verzenden, kun je het **/timelogs/log-full** -endpoint gebruiken, zoals dit: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-38.png) **Fig 14.** Logfull verzoek Merk op hoe de bedragen hier worden verzonden: de eerste "amount" waarde duidt het **foutieve bedrag** aan en de tweede het **bedrag**. Dit verzoek creëert de entiteiten beginlog en endlog in één enkel verzoek. ##### Snellog "Quicklogging" naar een taak voltooit deze in een enkele aanvraag en stelt het voltooide aantal producten in op de waarde die is ingesteld in het bestelitem. Quicklogging wordt gedaan met behulp van het **/timelogs/quick-log** -endpoint: ![](https://skyplanner.ai/wp-content/uploads/2025/03/image-39.png) **Fig 15.** Snelloggen Merk op dat je hier alleen de **production_planning_job_id**, **planned_workstation_id**en **person_id** hoeft op te geven. De waarden voor tijd en bedrag worden automatisch ingevuld. Merk ook op dat quicklogged jobs altijd worden voltooid met de shift_end-event, dus er is geen verdere logging mogelijk na quicklog!