---
title: Užsakymo kūrimas
description: "Čia rasite išsamų vadovą, kaip sukurti užsakymą \"Skyplanner\" su visais susijusiais duomenimis. Kai kurie iš šių dalykų buvo aptarti integracijos [vadovėlyje](https://skyplanner.ai/lt/docs/integravimo-pamoka/), tačiau čia išsamiau apžvelgsime \"Skyplanner\" duomenų struktūrą ir integracijos procesą. #### Duomenų struktūra Pirmiausia apžvelgsime, kaip sudarytas \"Skyplanner\" užsakymas.…"
url: "https://skyplanner.ai/lt/docs/uzsakymo-kurimas/"
updated: "2025-10-07"
category: Integracijos
tags:
  - API
  - Integracija
---

# Užsakymo kūrimas

Čia rasite išsamų vadovą, kaip sukurti užsakymą "Skyplanner" su visais susijusiais duomenimis. Kai kurie iš šių dalykų buvo aptarti integracijos [vadovėlyje](https://skyplanner.ai/lt/docs/integravimo-pamoka/), tačiau čia išsamiau apžvelgsime "Skyplanner" duomenų struktūrą ir integracijos procesą.

#### Duomenų struktūra

Pirmiausia apžvelgsime, kaip sudarytas "Skyplanner" užsakymas. Čia paminėtų duomenų esybių [API taškai](https://integration.skyplanner.app/api/swagger) pažymėti taip: /phaser-order

Viršutiniame lygyje turime **užsakymą**(/phaser-orders)

Kiekvienas **užsakymas** *turi*turėti **klientą**(/customers).

Kiekvienas **užsakymas** gali turėti kelis **užsakymo elementus**(/phaser-order-rows)

Prie kiekvieno **užsakymo elemento** *gali būti* prijungtas **produktas**(/products), tačiau tai nėra privaloma. Kiekvienas produktas turi vieną atsargą(/saldos). Atkreipkite dėmesį, kad atsargų esybė sukuriama automatiškai, kai produktas sukuriamas naudojant API.

Kiekvienas **užsakymo elementas** gali turėti keletą **užduočių** (dar vadinamų proceso etapais)(/phaser-jobs).

Kiekvienas **darbas** *turi*turėti **darbo etapą**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**1 pav.** Užsakymo ir susijusių duomenų struktūra

#### Integracijos darbo eiga

Čia pateikiamas žingsnis po žingsnio pavyzdys, kaip galėtumėte struktūrizuoti savo ERP sistemos integraciją su "Skyplanner".

1. Pardavimų ir (arba) darbo užsakymų gavimas iš ERP
2. Sukurti **klientą**(atsakyme gaukite kliento ID)
3. Sukurti **užsakymą** su kliento ID (atsakyme gaukite užsakymo ID)
4. Pardavimo ir (arba) darbo užsakymo užsakymo elementų duomenų gavimas iš ERP
5. Sukurti **gaminį** (atsakyme gaukite gaminio ID)
6. Sukurti **užsakymo elementą** su užsakymo ID ir kitais duomenimis (atsakyme gauti užsakymo elemento ID)
7. Proceso etapo duomenų gavimas iš ERP
8. Sukurti **darbo etapą** (atsakyme gaukite darbo etapo ID)
9. Sukurti **užduotį** su darbo etapo id ir kitais duomenimis

#### Papildomi patarimai

##### Dėl ištrynimo

Fazerio užsakymų, fazerio užsakymų elementų arba fazerio darbų šalinimas per API (ir iš vartotojo sąsajos) atliekamas *švelniuoju šalinimo* būdu. Tai reiškia, kad duomenys iš duomenų bazės iš tikrųjų nėra ištrinami, bet pažymimi kaip *archyvuoti*. Iš tikrųjų, kai esybė ištrinama, jos atributas is_archive nustatomas į true. Suarchyvuotas / ištrintas esybes vis tiek galima pasiekti per API naudojant parametrą include_archived. Kai include_archived=true, GET užklausa bus gauta esybė, net jei ji yra archyvuota.

**Atkreipkite dėmesį, kad švelnus šalinimas galimas ne kiekviename API galiniame taške! Todėl turite būti atsargūs, nes, pavyzdžiui, klientų, žmonių ir pan. ištrynimas yra nuolatinis!**

##### Numatytųjų proceso žingsnių naudojimas jūsų užsakymo elementui

Jei esate sukūrę tam tikrus numatytuosius užsakymo elemento gaminio proceso žingsnius, galite nurodyti sistemai, kad ji perkeltų numatytuosius **žingsnius** į užsakymo elementą, naudodama API atributą **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**2 pav.** Naujo užsakymo elemento su numatytaisiais proceso veiksmais kūrimas

##### Medžiagų pridėjimas prie užsakymo elemento

Jei prie pagaminto gaminio pridėjote medžiagų, jos automatiškai pridedamos prie užsakymo eilutės.

Tačiau jei nenorite naudoti prie gaminio pridėtų medžiagų (pavyzdžiui, jei gaminys yra specialus užsakymas ir norite naudoti kitokias medžiagas ir t. t.), galite naudoti atributą **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**3 pav.** Užsakymo elemento kūrimas nenaudojant numatytųjų medžiagų