---
title: Tuotteet ja materiaalit
description: "Tässä käymme läpi, miten voit luoda tuotteita ja materiaaleja ja miten voit liittää ne tilauksiisi Skyplanner-API:n avulla. Näytämme myös, miten voit luoda tuotteillesi oletusarvoisia prosessivaiheita ja miten voit luoda tilauseriä käyttämällä näitä oletusarvoja. #### Tuotteen/materiaalin luominen Sekä tuotteiden että materiaalien…"
url: "https://skyplanner.ai/fi/docs/tuotteet-ja-materiaalit/"
updated: "2025-10-07"
category: Integraatiot
tags:
  - API
  - Integrointi
---

# Tuotteet ja materiaalit

Tässä käymme läpi, miten voit luoda tuotteita ja materiaaleja ja miten voit liittää ne tilauksiisi Skyplanner-API:n avulla. Näytämme myös, miten voit luoda tuotteillesi oletusarvoisia prosessivaiheita ja miten voit luoda tilauseriä käyttämällä näitä oletusarvoja.

#### Tuotteen/materiaalin luominen

Sekä tuotteiden että materiaalien luominen ja päivittäminen tapahtuu saman API-päätepisteen kautta: /products. Tuotteen tyyppi määritetään **type-attribuutilla**: 'product' tai 'material'.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**Kuva 1.** Tuotteen luominen

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**Kuva 2.** Materiaalin luominen

Kun luot tuotteita ja materiaaleja, varmista, että asetat **is_active-arvoksi** true, jos haluat tuotteen/materiaalin näkyvän aktiivisena tuoteluettelossa. Huomaa myös, että voit asettaa käytettävissä olevan varastomäärän **free_amount-attribuutilla**.

#### Tuotteen oletusprosessin vaiheiden luominen

Ennen kuin voit lisätä tuotteelle oletusprosessin vaiheita, sinulla on oltava asianmukaiset työvaiheet. Työvaiheet voidaan luoda joko Skyplannerin käyttöliittymän tai /workstages-päätepisteen kautta.

Oletusprosessin vaiheiden lisääminen tapahtuu /products/jobs/{productId}-loppupisteestä.

Jos esimerkiksi haluat lisätä oletusaskeleen tuotteeseen, jonka tunniste on 22220, teet POST-kyselyn seuraavasti:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**Kuva 3.** Oletusprosessin vaiheen lisääminen

Joitakin merkittäviä aloja:

- tilausnumero
  - Tämä on indeksinumero, joka kertoo Skyplannerille, missä järjestyksessä prosessin vaiheet on tarkoitus suorittaa.
  - Esimerkiksi: ensimmäinen askel saa arvon 1, toinen askel saa arvon 3, kolmas askel saa arvon 3 ja niin edelleen....
- työasemat
  - Tämä on luettelo työasemista, joihin tämä prosessivaihe voidaan ajoittaa.
  - Anna työasemien tunnukset pilkulla erotettuna luettelona, esimerkiksi näin: "61,62,63"
- time_variation
  - Mahdolliset arvot: time_per_pcs, pcs_per_time, fixed_time.
- duration, settingtime, settletime
  - Anna nämä arvot *sekunteina*

#### Oletusprosessin vaiheen päivittäminen

Kun päivität oletusprosessin vaihetta, sinun on käytettävä attribuuttia **order_number** määrittämään, mikä vaihe päivitetään.

Esimerkiksi tämän tuotteen ensimmäinen prosessivaihe**(tilausnumero 1**) tehdään seuraavanlaisella PUT-kyselyllä:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**Kuva 4.** Oletusprosessin vaiheen päivittäminen

#### Oletusprosessin vaiheiden poistaminen

Oletusprosessin vaiheiden poistaminen tapahtuu myös käyttämällä **order_number-arvoja**.

Tilausnumerot annetaan seuraavanlaisena joukkona:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**Kuva 5.** Oletusprosessin vaiheiden poistaminen

##### Materiaalin/alatuotteen lisääminen tuotteeseen

Materiaalin tai alatuotteen liittämiseen on käytettävä /sub-products-päätepistettä.

Prosessi on melko suoraviivainen: laitamme materiaalin tai alatuotteen id:n **production_planning_product_id-attribuuttiin** ja sen tuotteen id:n, johon haluamme materiaalin/alatuotteen liitettävän, **production_planning_product_parent_id-attribuuttiin**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**Kuva 6.** Materiaalin kiinnittäminen tuotteeseen

##### Materiaalin lisääminen tilauserään

Voit myös liittää materiaaleja suoraan tilauserään käyttämällä /row-materials-päätepistettä. Näin voit liittää tilauserään lisämateriaaleja tai käyttää tilauserässä täysin erilaista materiaaliluetteloa kuin tuotteille oletusarvoisesti asetetut materiaalit. Huomaa, että sinulla voi olla vain yksi rivi-materiaali-olio tilauserää varten kutakin materiaalia varten. Et siis voi luoda kahta oliota, joilla on sama **production_planning_product_id**, samaan **phaser_order_row_id**:hen.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**Kuva 7.** Materiaalin lisääminen tilauserään

#### Varastotason päivittäminen

Voit päivittää tuotteen tai materiaalin varastotasoa lähettämällä PUT-pyynnön, jossa on attribuutti **free_amount**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**Kuva 8.** Varastotason päivittäminen