---
title: Tellimuse loomine
description: "Siit leiate põhjaliku juhendi, kuidas luua tellimus Skyplannerisse koos kõigi seotud andmetega. Osa sellest on juba käsitletud [integratsiooniõpetuses](https://skyplanner.ai/fr/docs/tutoriel-dintegration/), kuid siin käsitleme Skyplanneri andmestruktuuri ja integratsiooniprotsessi üksikasjalikumalt. #### Andmete struktuur Kõigepealt vaatame läbi, kuidas Skyplanneri tellimus on üles ehitatud. Siin mainitud…"
url: "https://skyplanner.ai/et/docs/tellimuse-loomine/"
updated: "2025-10-07"
category: Integratsioonid
tags:
  - API
  - Integratsioon
---

# Tellimuse loomine

Siit leiate põhjaliku juhendi, kuidas luua tellimus Skyplannerisse koos kõigi seotud andmetega. Osa sellest on juba käsitletud [integratsiooniõpetuses](https://skyplanner.ai/fr/docs/tutoriel-dintegration/), kuid siin käsitleme Skyplanneri andmestruktuuri ja integratsiooniprotsessi üksikasjalikumalt.

#### Andmete struktuur

Kõigepealt vaatame läbi, kuidas Skyplanneri tellimus on üles ehitatud. Siin mainitud andmeüksuste [API-punktid](https://integration.skyplanner.app/api/swagger) on esile toodud järgmiselt: /phaser-orders

Ülemisel tasandil on meil **tellimus**(/phaser-orders)

Igal **tellimusel** *peab*olema **klient**(/kliendid).

Igal **tellimusel** võib olla mitu **tellimusartiklit**(/phaser-order-rows).

Iga **tellimuse kirje** *võib* olla seotud **tootega**(/products), kuid see ei ole kohustuslik. Igal **tootel** on üks **varu**(/saldos). Pange tähele, et varuüksus luuakse automaatselt, kui toode luuakse API abil.

Igal **tellimusartiklil** võib olla mitu **tööd** (ehk protsessietappi)(/phaser-jobs).

Igal **tööülesandel** *peab*olema **tööetapp**(/tööetapid).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Joonis 1** Tellimuse struktuur ja sellega seotud andmed

#### Integratsiooni tööprotsess

Siin on samm-sammult näide, kuidas te võiksite oma ERP-süsteemi ja Skyplanneri integreerimist struktureerida.

1. Müügi/töötellimuse toomine ERP-st
2. Loo **klient**(saada kliendi id vastuseks)
3. Loo **tellimus** kliendi id-ga (saada vastuseks tellimuse id)
4. Müügi/töötellimuse kirje andmete hankimine ERP-st
5. Loo **toode** (saada vastuseks toote id)
6. **Tellimuse kirje** loomine tellimuse id ja muude andmetega (saada vastuseks tellimuse kirje id)
7. Protsessi etappide andmete hankimine ERP-st
8. Loo **tööetapp** (saada tööetapi id vastuseks)
9. **Töö** loomine koos tööetapi id ja muude andmetega

#### Täiendavad nõuanded

##### Kustutamisel

Phaser-tellimuste, phaser-order-items või phaser-jobs kustutamine API kaudu (ja kasutajaliidesest) toimub *pehme kustutamise* teel. See tähendab, et andmeid tegelikult andmebaasist ei kustutata, kuid need märgitakse arhiveerituks. Tegelikkuses seatakse kustutamisel olio atribuut **is_archive** väärtuseks true. Arhiveeritud/kustutatud üksustele saab API abil endiselt juurde pääseda, kasutades parameetrit include_archived. Kui include_archived=true, saab GET päringuga üksuse kätte isegi siis, kui see on arhiveeritud.

**Pange tähele, et pehme kustutamine ei ole igas API lõpp-punktis saadaval! Seega tuleb olla ettevaatlik, sest näiteks klientide, inimeste jne. kustutamine on püsiv!**

##### Kasutades vaikimisi protsessietappe teie tellimuse kirje jaoks

Kui olete loonud mõned vaikimisi protsessietapid toote jaoks, mida teie tellimusartikkel toodab, saate süsteemile öelda, et ta tooks vaikimisi parameetri API abil tellimusartiklile, kasutades atribuuti **get_default_steps (vaikimisi_etapid** ).

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Joonis 2.** Uue tellimusartikli loomine vaikimisi protsessietappidega

##### Materjalide lisamine tellimusartiklile

Kui olete tootele lisanud materjale, lisatakse need automaatselt tellimuse reale.

Kui te aga ei soovi kasutada tootele lisatud materjale (näiteks kui toode on eritellimus ja te soovite kasutada teistsuguseid materjale jne), võite kasutada atribuuti **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Joonis 3.** Tellimuse kirje loomine ilma vaikimisi materjale kasutamata