Hier gaan we in detail in op het ophalen, maken, bijwerken en verwijderen van bestelitems.
Orderitems zijn toegankelijk via het eindpunt /phaser-order-rows.
Bestelitems ophalen #
Je haalt bestelitems op door een GET-verzoek te sturen naar het eindpunt /phaser-order-rows:
Je kunt naar bestelitems zoeken aan de hand van verschillende parameters:
- faser_bestel_id
- interne Skyplanner order id, kan worden gevonden via het /phaser-orders-endpoint
- extern_id
- Externe identificatie van het bestelitem
- Bijvoorbeeld de unieke identificatiecode van uw externe systeem (ERP, enz.)
- productie_planning_product_id
- Interne Skyplanner product id
- Kan worden gevonden via het /products-endpoint
- ouder_id
- Als een bestelitem subitems heeft (bijv. subproducten), hebben de subitems de id van hun bovenliggende bestelitem in het veld parent_id.
- rij_index
- Indexnummer van het bestelitem
- werknummer
- De werknummerwaarde van het bestelitem
- status
- Status bestelitem
- Toegestane waarden: nieuw, gestart of voltooid
- positie
- De positiewaarde van het bestelitem
- leveringsdatum
- De leveringsdatum van het bestelitem
- Formaat: 2025-06-05T22:00:00+00:00
- leverings_datum_voorwaarde
- Optionele voorwaarde voor het zoeken naar een leveringsdatum
- Opties: >, =, <=, =, !=
- Als er geen waarde is opgegeven, wordt >= gebruikt.
- is_vooruitzicht
- Retourneer alleen bestelde artikelen die in verwachting zijn
- include_archived
- Gearchiveerde (zacht verwijderde) bestelitems opnemen in fetch
- Aangegeven door de waarde is_archive
- gemodificeerd
- Retourneer bestelitems die zijn gewijzigd na een opgegeven datum
- Formaat: 2025-06-05T22:00:00+00:00
- modifiedCondition
- Optionele voorwaarde voor het zoeken naar gewijzigde waarden
- Opties: >, =, <=, =, !=
- Als er geen waarde is opgegeven, wordt >= gebruikt.
Je kunt de zoekparameters ook op deze manier mixen en matchen:
Om een specifiek bestelitem met zijn interne Skyplanner-id op te halen, kun je een verzoek als volgt doen:
Bestelitems maken #
Merk op dat je een bestelling moet aanmaken voordat je het bestelitem aanmaakt!
Stuur om een bestelitem te maken een POST-verzoek naar het eindpunt /phaser-order-rows:
Hier volgt een overzicht van de velden die je kunt gebruiken bij het maken van een bestelitem:
- faser_bestel_id
- Interne Skyplanner-id voor de order waaraan het orderitem is gekoppeld
- Verplicht veld
- productie_planning_order_rij_id
- Nadat de order is geëxporteerd naar de productieplanningsmodule van Skyplanner wordt een aparte entiteit aangemaakt die een productieplanningsorderrij wordt genoemd en wordt de id ingesteld in dit veld
- Niet aanbevolen om te gebruiken (laat als null staan of stuur dit veld helemaal niet mee in het verzoekveld)
- productie_planning_product_id
- Skyplanner product id voor het product dat het bestelitem produceert
- Vereist als je standaard processtappen van een product wilt meenemen
- extern_id
- Unieke identificatie van het bestelitem
- Gebruik dit om het Skyplanner bestelitem te koppelen aan uw bestelitem vanuit een extern systeem (ERP enz.)
- Moet uniek zijn
- ouder_id
- Als het bestelitem een subitem is voor een ander bestelitem, geef dan hier de id-waarde van de ouder
- rij_index
- Waar in de lijst met bestelitems in de bestelling dit item zich bevindt
- werknummer
- Alleen gebruikt als een informatieve werknummerwaarde voor het bestelitem
- Niet zichtbaar in Skyplanner UI
- status
- Status van het bestelitem
- Toegestane waarden: nieuw, gestart, klaar, gefaseerd
- is_archief
- Is het bestelitem gearchiveerd (zacht verwijderd)?
- positie
- Identificatiewaarde bestelitem (zie Fig 3.)
- bedrag
- Totale geproduceerde hoeveelheid product
- besteld_bedrag
- Bestelde hoeveelheid product
- prijs
- Prijs per eenheid product
- gebruik_aangepaste_materialen
- Als je de standaard materiaalinstelling van de productgegevens niet wilt gebruiken, stel deze waarde dan in op waar
- Standaard: onwaar
- gebruik_aangepaste_materialen_berekend
- Hoeveelheden aangepast materiaal worden berekend op basis van de geproduceerde hoeveelheid producten
- Als false is ingesteld, zijn de materiaalhoeveelheden vast
- Standaard: onwaar
- get_default_steps
- Processtappen maken om een artikel te bestellen op basis van de standaardprocesstappen van het product
- Standaard: onwaar
- gebruik_berekende_job_duraties
- De duur van processtappen berekenen op basis van tijdloggegevens uit het verleden
- Als er niet genoeg gegevens beschikbaar zijn om te berekenen, worden standaardlooptijden gebruikt
- Standaard: onwaar
- sub_items
- Maak ook subitems van het product aan, indien beschikbaar
- Standaard: onwaar
- leveringsdatum
- Formaat: 2022-01-01 10:30:11
- start_verkiesbaarheidsdatum
- Formaat: 2022-01-01 10:30:11
- tekening_identificatie
- Tekening/blauwdruk/instructie-identificatiesymbool
- beschrijving
- Beschrijving bestelitem
- extra_beschrijving
- Extra beschrijving voor bestelitem
- is_vooruitzicht
- Is het bestelitem een prospect?
- Standaard: onwaar
Bestelitems bijwerken #
Om de gegevens van bestelitems bij te werken kun je een PUT-verzoek sturen naar het eindpunt /phaser-order-rows:
Bestelitems verwijderen #
Het verwijderen van bestelitems gebeurt in een “zachte delete” methode. In feite verandert het verwijderen van een bestelitem de
Bij het verwijderen van een bestelitem verwijdert het systeem ook de bijbehorende processtappen.
Je verwijdert bestelitems door een DELETE-verzoek te sturen naar het eindpunt /phaser-order-rows:
Je kunt bestelitems verwijderen door de interne Skyplanner ids op te geven in de matrix “ids” of de externe_ids in de matrix “external_ids”.