---
title: Ustvarjanje naročila
description: "Tukaj najdete izčrpen vodnik o tem, kako ustvariti naročilo v Skyplannerju z vsemi povezanimi podatki. Nekaj tega je bilo obravnavano v [vodniku za](https://skyplanner.ai/es/docs/tutorial-de-integracion/) integracijo, vendar tukaj podrobneje obravnavamo strukturo podatkov Skyplannerja in postopek integracije. #### Struktura podatkov Najprej bomo pregledali,…"
url: "https://skyplanner.ai/sl/docs/ustvarjanje-narocila/"
updated: "2025-10-07"
category: Integracije
tags:
  - API
  - Integracija
---

# Ustvarjanje naročila

Tukaj najdete izčrpen vodnik o tem, kako ustvariti naročilo v Skyplannerju z vsemi povezanimi podatki. Nekaj tega je bilo obravnavano v [vodniku za](https://skyplanner.ai/es/docs/tutorial-de-integracion/) integracijo, vendar tukaj podrobneje obravnavamo strukturo podatkov Skyplannerja in postopek integracije.

#### Struktura podatkov

Najprej bomo pregledali, kako je strukturirano naročilo Skyplannerja. [Točke API za](https://integration.skyplanner.app/api/swagger) podatkovne entitete, ki so omenjene tukaj, so označene takole: /phaser-orders

Na najvišji ravni imamo **naročilo**(/phaser-orders)

Vsako **naročilo** *mora*imeti **stranko**(/customers).

Vsako **naročilo** ima lahko več **elementov naročila**(/phaser-order-rows)

Vsakemu **elementu naročila** je *lahko* priložen **izdelek**(/products), vendar to ni obvezno. Vsak **izdelek** ima eno **zalogo**(/saldos). Upoštevajte, da se entiteta zaloge ustvari samodejno, ko je izdelek ustvarjen z vmesnikom API.

Vsako **element naročila** ima lahko več **opravil** (tudi korakov postopka)(/phaser-jobs).

Vsako **opravilo** *mora*imeti **delovno stopnjo**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Slika 1** Struktura naročila in povezanih podatkov

#### Delovni tok integracije

Tukaj je primer, kako lahko po korakih strukturirate integracijo iz sistema ERP v Skyplanner.

1. Pridobivanje prodaje/delovnega naloga iz sistema ERP
2. Ustvari **stranko**(v odzivu pridobi id stranke)
3. Ustvarite **naročilo** z id stranke (v odzivu dobite id naročila)
4. Pridobivanje podatkov o prodajnih postavkah/delovnih nalogih iz sistema ERP
5. Ustvari **izdelek** (v odzivu pridobi id izdelka)
6. Ustvarite **element naročila** z id naročila in drugimi podatki (v odzivu dobite id elementa naročila)
7. Pridobivanje podatkov o korakih procesa iz sistema ERP
8. Ustvari **delovno stopnjo** (v odzivu pridobi id delovne stopnje)
9. Ustvarjanje **delovnega mesta** z id delovnega mesta in drugimi podatki

#### Dodatni nasveti

##### Ob brisanju

Brisanje phaser-naročil, phaser-naročil-postavk ali phaser-delov prek vmesnika API (in iz uporabniškega vmesnika) poteka na način *mehkega brisanja*. To pomeni, da se podatki dejansko ne izbrišejo iz podatkovne zbirke, temveč so označeni kot *arhivirani*. Atribut **is_archive** entitete je ob izbrisu nastavljen na true. Do arhiviranih/izbrisanih entitet je še vedno mogoče dostopati z vmesnikom API z uporabo parametra include_archived. Če je include_archived=true, bo zahteva GET priklicala entiteto, tudi če je arhivirana.

**Upoštevajte, da mehko brisanje ni na voljo v vseh končnih točkah API! Zato morate biti previdni, saj je brisanje na primer strank, oseb itd. trajno!**

##### Uporaba privzetih korakov postopka za element naročila

Če ste ustvarili nekaj privzetih korakov postopka za izdelek, ki ga izdeluje element naročila, lahko sistemu poveste, naj privzete **korake** prenese v element naročila z vmesnikom API z uporabo atributa **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Slika 2.** Ustvarjanje novega elementa naročila s privzetimi procesnimi koraki

##### Dodajanje materialov v element naročila

Če ste izdelanemu izdelku priložili materiale, so ti samodejno priloženi vrstici naročila.

Če ne želite uporabiti materialov, ki so priloženi izdelku (na primer, če gre za posebno naročilo in želite uporabiti drugačne materiale itd.), lahko uporabite atribut **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Slika 3.** Ustvarjanje elementa naročila brez uporabe privzetih materialov