---
title: Tilauksen luominen
description: "Täältä löydät kattavan oppaan siitä, miten Skyplanneriin luodaan tilaus ja kaikki siihen liittyvät tiedot. Osa tästä on käsitelty [integrointioppaassa](https://skyplanner.ai/fr/docs/tutoriel-dintegration/), mutta tässä käymme Skyplannerin tietorakenteen ja integrointiprosessin läpi yksityiskohtaisemmin. #### Tietorakenne Ensin käymme läpi, miten Skyplanner-tilaus rakentuu. Tässä mainittujen tietokokonaisuuksien [API-päätteet](https://integration.skyplanner.app/api/swagger)…"
url: "https://skyplanner.ai/fi/docs/tilauksen-luominen/"
updated: "2025-10-07"
category: Integraatiot
tags:
  - API
  - Integrointi
---

# Tilauksen luominen

Täältä löydät kattavan oppaan siitä, miten Skyplanneriin luodaan tilaus ja kaikki siihen liittyvät tiedot. Osa tästä on käsitelty [integrointioppaassa](https://skyplanner.ai/fr/docs/tutoriel-dintegration/), mutta tässä käymme Skyplannerin tietorakenteen ja integrointiprosessin läpi yksityiskohtaisemmin.

#### Tietorakenne

Ensin käymme läpi, miten Skyplanner-tilaus rakentuu. Tässä mainittujen tietokokonaisuuksien [API-päätteet](https://integration.skyplanner.app/api/swagger) on korostettu seuraavasti: /phaser-tilaukset

Ylimmällä tasolla meillä on **tilaus**(/phaser-orders).

Jokaisella **tilauksella** *on*oltava **asiakas**(/customers).

Jokaisella **tilauksella** voi olla useita **tilauskohteita**(/phaser-order-rows).

Jokaiseen **tilauserään** *voi* liittää **tuotteen**(/products), mutta se ei ole pakollista. Jokaisella tuotteella on yksi varasto(/saldos). Huomaa, että varasto-olio luodaan automaattisesti, kun tuote luodaan API:n avulla.

Jokaisella **tilauserällä** voi olla useita **tehtäviä** (eli prosessin vaiheita)(/phaser-jobs).

Jokaisella **työllä** *on*oltava **työvaihe**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Kuva 1** Tilauksen rakenne ja siihen liittyvät tiedot

#### Integroinnin työnkulku

Tässä on askel askeleelta esimerkki siitä, miten voit rakentaa integraation ERP-järjestelmästäsi Skyplanneriin.

1. Hae myynti/työtilaus ERP:stä
2. Luo **asiakas**(saat asiakkaan tunnuksen vastauksessa)
3. Luo **tilaus** asiakastunnuksella (saat tilauksen tunnuksen vastauksessa)
4. noutaa myynti-/työtilauksen tilauserätiedot ERP-järjestelmästä.
5. Luo **tuote** (saat tuotteen tunnuksen vastauksessa)
6. Luo **tilauserä** tilaustunnuksella ja muilla tiedoilla (saat tilauserän tunnuksen vastauksessa).
7. Hae prosessivaiheen tiedot ERP:stä
8. Luo **työstövaihe** (saat työstövaiheen id:n vastauksessa)
9. Luo **työ työvaiheen** id:llä ja muilla tiedoilla.

#### Lisää vinkkejä

##### Poistettaessa

Phaser-tilausten, phaser-tilauserien tai phaser-töiden poistaminen API:n kautta (ja käyttöliittymästä) tapahtuu *pehmeällä poistolla*. Tämä tarkoittaa, että tietoja ei varsinaisesti poisteta tietokannasta, vaan ne merkitään arkistoiduksi. Itse asiassa olion is_archive-attribuutti asetetaan true-arvoon, kun se poistetaan. Arkistoituja/poistettuja entiteettejä voidaan edelleen käyttää API:n avulla include_archived-parametrin avulla. Kun include_archived=true, GET-pyyntö hakee entiteetin, vaikka se olisi arkistoitu.

**Huomaa, että pehmeä poisto ei ole käytettävissä kaikissa API-päätepisteissä! Sinun on siis oltava varovainen, sillä esimerkiksi asiakkaiden, henkilöiden jne. poistaminen on pysyvää!**

##### Käyttämällä oletusarvoisia prosessivaiheita tilauskohteellesi

Jos olet luonut joitakin oletusarvoisia prosessivaiheita tuotteelle, jota tilauserä tuottaa, voit kertoa järjestelmälle, että se tuo oletusarvot tilauserään API:n avulla käyttämällä **get_default_steps** -attribuuttia.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Kuva 2.** Uuden tilauserän luominen oletusarvoisten prosessivaiheiden avulla

##### Materiaalien lisääminen tilauserään

Jos olet liittänyt materiaaleja tuotettuun tuotteeseen, ne liitetään automaattisesti tilausriville.

Jos et kuitenkaan halua käyttää tuotteeseen liitettyjä materiaaleja (esimerkiksi jos tuote on erikoistilaus ja haluat käyttää eri materiaaleja jne.), voit käyttää määrettä **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Kuva 3.** Tilauserän luominen ilman oletusmateriaalien käyttöä