---
title: Een bestelling maken
description: "Hier vind je een uitgebreide handleiding over hoe je een order aanmaakt in Skyplanner met alle bijbehorende gegevens. Een deel hiervan is al behandeld in de [integratietutorial](https://skyplanner.ai/fr/docs/tutoriel-dintegration/), maar hier gaan we dieper in op de gegevensstructuur en het integratieproces van…"
url: "https://skyplanner.ai/nl/docs/een-bestelling-maken/"
updated: "2025-10-07"
category: Integraties
tags:
  - API
  - Integratie
---

# Een bestelling maken

Hier vind je een uitgebreide handleiding over hoe je een order aanmaakt in Skyplanner met alle bijbehorende gegevens. Een deel hiervan is al behandeld in de [integratietutorial](https://skyplanner.ai/fr/docs/tutoriel-dintegration/), maar hier gaan we dieper in op de gegevensstructuur en het integratieproces van Skyplanner.

#### Gegevensstructuur

Eerst bekijken we hoe een Skyplanner-bestelling is opgebouwd. De [API-endpoints](https://integration.skyplanner.app/api/swagger) voor de hier genoemde data-entiteiten zijn als volgt gemarkeerd: /phaser-orders

Op het hoogste niveau hebben we de **bestelling**(/phaser-orders)

Elke **bestelling** *moet*een **klant**(/klanten) hebben.

Elke **order** kan meerdere **orderitems** hebben(/phaser-order-rows)

Aan elk **orderitem** *kan* een **product**(/products) worden gekoppeld, maar dat is niet verplicht. Elk **product** heeft een **voorraad**(/saldos). Merk op dat de voorraadentiteit automatisch wordt aangemaakt wanneer een product wordt aangemaakt met de API.

Elk **orderitem** kan meerdere **jobs** hebben (ook wel processtappen genoemd)(/phaser-jobs).

Elke **taak** *moet*een **workstage**(/workstages) hebben.

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Fig. 1** Structuur van bestelling en gerelateerde gegevens

#### Integratie workflow

Hier is een stap-voor-stap voorbeeld van hoe je de integratie van je ERP-systeem naar Skyplanner zou kunnen structureren.

1. Verkoop-/werkorder ophalen uit ERP
2. Creëer **klant**(krijg klant id in antwoord)
3. Maak **order** aan met klant id (krijg order id in antwoord)
4. Verkoop-/werkorderorderitemgegevens ophalen uit ERP
5. **Product** maken (krijg product id in antwoord)
6. **Bestelitem** maken met bestelid en andere gegevens (bestelitem id krijgen in antwoord)
7. Gegevens van processtappen ophalen uit ERP
8. Maak **workstage** (krijg workstage id in antwoord)
9. **Taak** aanmaken met workstage id en andere gegevens

#### Extra tips

##### Bij het verwijderen

Het verwijderen van phaser-orders, phaser-order-items of phaser-jobs via de API (en vanuit de UI) gebeurt op een *soft delete* manier. Dit betekent dat de gegevens niet daadwerkelijk uit de database worden verwijderd, maar worden gemarkeerd als gearchiveerd. In feite wordt het is_archive attribuut van de entiteit op true gezet wanneer deze wordt verwijderd. De gearchiveerde/verwijderde entiteiten zijn nog steeds toegankelijk met de API met behulp van de **include_archived** parameter. Wanneer include_archived=true, zal een GET-verzoek de entiteit ophalen, zelfs als deze gearchiveerd is.

**Merk op dat zacht verwijderen niet beschikbaar is in elk API-eindpunt! Je moet dus voorzichtig zijn, want het verwijderen van bijvoorbeeld klanten, mensen etc. is permanent!**

##### Standaard processtappen gebruiken voor je bestelitem

Als je een aantal standaard processtappen hebt gemaakt voor het product dat je bestelitem produceert, kun je het systeem vertellen om de standaardstappen naar het bestelitem te brengen met de API door het **get_default_steps** attribuut te gebruiken.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Fig 2.** Een nieuw bestelitem maken met standaard processtappen

##### Materialen toevoegen aan bestelitem

Als je materialen hebt gekoppeld aan het geproduceerde product, worden ze automatisch gekoppeld aan de bestelrij.

Als je echter niet de materialen wilt gebruiken die aan het product zijn gekoppeld (bijvoorbeeld als het artikel een speciale bestelling is en je andere materialen wilt gebruiken), kun je het kenmerk **use_custom_materials** gebruiken.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Fig 3.** Een bestelitem maken zonder de standaardmaterialen te gebruiken