---
title: Vytvorenie objednávky
description: "Tu nájdete komplexný návod na vytvorenie objednávky do programu Skyplanner so všetkými súvisiacimi údajmi. Niektoré z týchto informácií boli uvedené v [návode na](https://skyplanner.ai/es/docs/tutorial-de-integracion/) integráciu, ale tu si podrobnejšie preberieme štruktúru údajov Skyplanner a proces integrácie. #### Štruktúra údajov Najprv si…"
url: "https://skyplanner.ai/sk/docs/vytvorenie-objednavky/"
updated: "2025-10-07"
category: Integrácie
tags:
  - API
  - Integrácia
---

# Vytvorenie objednávky

Tu nájdete komplexný návod na vytvorenie objednávky do programu Skyplanner so všetkými súvisiacimi údajmi. Niektoré z týchto informácií boli uvedené v [návode na](https://skyplanner.ai/es/docs/tutorial-de-integracion/) integráciu, ale tu si podrobnejšie preberieme štruktúru údajov Skyplanner a proces integrácie.

#### Štruktúra údajov

Najprv si prejdeme, ako je štruktúrovaná objednávka Skyplanner. [Body API pre](https://integration.skyplanner.app/api/swagger) uvedené dátové entity sú zvýraznené takto: /phaser-orders

Na najvyššej úrovni máme **objednávku**(/phaser-orders)

Každá **objednávka** *musí*mať **zákazníka**(/zákazníkov).

Každá **objednávka** môže mať viacero **položiek objednávky**(/phaser-order-rows)

Každá **položka objednávky** *môže* mať pripojený **produkt**(/products), ale nie je to povinné. Každý výrobok má jeden sklad(/saldos). Všimnite si, že entita stock (zásoba) sa vytvára automaticky pri vytváraní produktu pomocou API.

Každá **položka objednávky** môže mať viacero **úloh** (alias krokov procesu)(/phaser-jobs).

Každá **úloha** *musí*mať **pracovnú etapu**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Obr. 1** Štruktúra objednávky a súvisiace údaje

#### Pracovný postup integrácie

Tu je príklad, ako by ste mohli krok za krokom štruktúrovať integráciu vášho systému ERP so Skyplannerom.

1. načítanie predaja/objednávky z ERP
2. Vytvorenie **zákazníka**(získanie identifikátora zákazníka v odpovedi)
3. Vytvorenie **objednávky** s identifikátorom zákazníka (získanie identifikátora objednávky v odpovedi)
4. načítanie údajov o položkách predajných/pracovných objednávok z ERP
5. Vytvoriť **produkt** (v odpovedi získajte identifikátor produktu)
6. Vytvorenie **položky objednávky** s id objednávky a ďalšími údajmi (získanie id položky objednávky v odpovedi)
7. Získavanie údajov o krokoch procesu z ERP
8. Vytvorenie **pracovnej etapy** (získanie ID pracovnej etapy v odpovedi)
9. Vytvorenie **úlohy** s id pracovnej etapy a ďalšími údajmi

#### Ďalšie tipy

##### Pri odstraňovaní

Odstraňovanie objednávok phaser, položiek objednávok phaser alebo úloh phaser prostredníctvom rozhrania API (a z používateľského rozhrania) sa vykonáva spôsobom *soft delete*. To znamená, že údaje sa v skutočnosti nevymažú z databázy, ale označia sa ako archivované. V skutočnosti je atribút is_archive entity pri vymazaní nastavený na hodnotu true. K archivovaným/vymazaným entitám je stále možné pristupovať pomocou API pomocou parametra include_archived. Ak je include_archived=true, požiadavka GET načíta entitu, aj keď je archivovaná.

**Upozorňujeme, že mäkké mazanie nie je dostupné v každom koncovom bode API! Preto musíte byť opatrní, pretože vymazanie napríklad zákazníkov, ľudí atď. je trvalé!**

##### Použitie predvolených krokov procesu pre vašu položku objednávky

Ak ste vytvorili niektoré predvolené kroky procesu pre produkt, ktorý vaša položka objednávky vytvára, môžete systému povedať, aby tieto predvolené **kroky** preniesol do položky objednávky pomocou API pomocou atribútu **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Obr. 2.** Vytvorenie novej položky objednávky s predvolenými krokmi procesu

##### Pridanie materiálov do položky objednávky

Ak ste k vyrábanému výrobku pripojili materiály, automaticky sa pripoja k riadku objednávky.

Ak však nechcete použiť materiály pripojené k výrobku (napríklad ak ide o špeciálnu objednávku a chcete použiť iné materiály atď.), môžete použiť atribút **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Obr. 3.** Vytvorenie položky objednávky bez použitia predvolených materiálov