Hier laten we zien hoe je producten en materialen kunt maken en hoe je deze aan je orders kunt koppelen met de Skyplanner-API. We laten je ook zien hoe je standaardprocesstappen kunt maken voor je producten en hoe je bestelitems kunt maken met behulp van die standaardstappen.
Een product/materiaal maken #
Het maken en bijwerken van zowel producten als materialen gebeurt via hetzelfde API-endpoint: /products. Het type van het product wordt ingesteld door het type-attribuut: ‘product’ of ‘materiaal’.
Zorg er bij het maken van producten en materialen voor dat je de waarde is_active op true zet als je wilt dat het product/materiaal wordt weergegeven als actief in de productlijst. Merk ook op dat je de beschikbare voorraadhoeveelheid kunt instellen met het free_amount attribuut.
Standaardprocesstappen voor een product maken #
Voordat je standaard processtappen voor een product kunt toevoegen, moet je de juiste workstages hebben. Workstages kunnen worden aangemaakt via de Skyplanner UI of het /workstages-endpoint.
Standaard processtappen toevoegen gebeurt vanaf het /products/jobs/{productId}-endpoint.
Dus als je bijvoorbeeld een standaard stap wilt toevoegen aan het product met id 22220, doe je een POST-request zoals dit:
Enkele opmerkelijke velden:
- bestelnummer
- Dit is een indexnummer dat Skyplanner vertelt in welke volgorde de processtappen moeten worden voltooid.
- Bijvoorbeeld: eerste stap krijgt waarde 1, tweede stap krijgt waarde 3, derde stap krijgt waarde 3 enzovoort…
- werkstations
- Dit is een lijst met werkstations waarop deze processtap gepland kan worden
- Geef hier werkstation id’s als een door komma’s gescheiden lijst, zoals dit: “61,62,63”
- tijd_variatie
- Mogelijke waarden: time_per_pcs, pcs_per_time, fixed_time
- duur, insteltijd, insteltijd
- Geef deze waarden in seconden
Een standaardprocesstap bijwerken #
Bij het bijwerken van een standaard processtap moet je het order_number attribuut gebruiken om aan te geven welke stap bijgewerkt moet worden.
Bijvoorbeeld, de eerste processtap(order_number 1) in dit product wordt gedaan met een PUT-request zoals dit:
Standaard processtappen verwijderen #
Het verwijderen van standaard processtappen wordt ook gedaan door gebruik te maken van de order_number waarden.
Bestelnummers worden als volgt in een array gegeven:
Een materiaal/subproduct aan een product toevoegen #
Om een materiaal of subproduct te koppelen, moeten we het eindpunt /sub-products gebruiken.
Het proces is vrij eenvoudig: we plaatsen de id van het materiaal of subproduct in het kenmerk production_planning_product_id en de id van het product waaraan we het materiaal/subproduct willen koppelen in het kenmerk production_planning_product_parent_id.
Materiaal toevoegen aan bestelitem #
Je kunt ook materialen rechtstreeks aan een bestelitem koppelen met behulp van het eindpunt /row-materials. Op deze manier kun je extra materialen toevoegen of een compleet andere materialenlijst gebruiken in een bestelitem dan de standaard materialen die zijn ingesteld voor de producten. Merk op dat je maar één rij-materialen entiteit voor een bestelitem kunt hebben voor elk materiaal. Je kunt dus niet twee entiteiten met dezelfde production_planning_product_id aan dezelfde phaser_order_row_id koppelen.
Het voorraadniveau bijwerken #
Je kunt het product- of materiaalvoorraadniveau bijwerken door een PUT-verzoek te sturen met het kenmerk free_amount.
