---
title: Vytvoření objednávky
description: "Zde naleznete komplexní návod, jak vytvořit objednávku do Skyplanneru se všemi souvisejícími údaji. Něco z toho bylo popsáno v [návodu k](https://skyplanner.ai/cs/docs/vyukovy-kurz-integrace/) integraci, ale zde projdeme strukturu dat Skyplanneru a proces integrace podrobněji. #### Struktura dat Nejprve si projdeme, jak je…"
url: "https://skyplanner.ai/cs/docs/vytvoreni-objednavky/"
updated: "2025-10-07"
category: Integrace
tags:
  - API
  - Integrace
---

# Vytvoření objednávky

Zde naleznete komplexní návod, jak vytvořit objednávku do Skyplanneru se všemi souvisejícími údaji. Něco z toho bylo popsáno v [návodu k](https://skyplanner.ai/cs/docs/vyukovy-kurz-integrace/) integraci, ale zde projdeme strukturu dat Skyplanneru a proces integrace podrobněji.

#### Struktura dat

Nejprve si projdeme, jak je strukturována objednávka Skyplanneru. [Koncové body API pro](https://integration.skyplanner.app/api/swagger) datové entity zde uvedené jsou zvýrazněny takto: /phaser-orders

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

Každá **objednávka** *musí*mít **zákazníka**(/zákazníky).

Každá **objednávka** může mít více **položek objednávky**(/phaser-order-rows)

Ke každé **položce objednávky** *může být* připojen **produkt**(/products), ale není to povinné. Ke každému produktu je přiřazen jeden sklad(/saldos). Všimněte si, že entita stock je vytvořena automaticky při vytvoření produktu pomocí rozhraní API.

Každá **položka objednávky** může mít více **úloh** (neboli kroků procesu)(/phaser-jobs).

Každá **úloha** *musí*mít **pracovní fázi**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Obr. 1** Struktura objednávky a souvisejících údajů

#### Pracovní postup integrace

Zde je příklad, jak můžete krok za krokem strukturovat integraci vašeho ERP systému se Skyplannerem.

1. načtení prodeje/objednávky z ERP
2. Vytvořit **zákazníka**(v odpovědi získáte id zákazníka)
3. Vytvořit **objednávku** s id zákazníka (získat id objednávky v odpovědi)
4. načtení údajů o položkách prodejních/pracovních objednávek ze systému ERP
5. Vytvořit **produkt** (v odpovědi získáte id produktu)
6. Vytvoření **položky objednávky** s id objednávky a dalšími údaji (získání id položky objednávky v odpovědi)
7. Získání dat o krocích procesu z ERP
8. Vytvoření **pracovní etapy** (v odpovědi získáte id pracovní etapy)
9. Vytvoření **úlohy** s id pracovní etapy a dalšími údaji

#### Další tipy

##### Při mazání

Mazání phaser-order, phaser-order-items nebo phaser-jobs prostřednictvím rozhraní API (a z uživatelského rozhraní) se provádí způsobem *soft delete*. To znamená, že data nejsou ve skutečnosti z databáze odstraněna, ale jsou označena jako archivovaná. Ve skutečnosti je atribut is_archive entity při smazání nastaven na hodnotu true. K archivovaným/smazaným entitám lze stále přistupovat pomocí rozhraní API s použitím parametru include_archived. Pokud je include_archived=true, dotaz GET načte entitu, i když je archivovaná.

**Všimněte si, že měkké mazání není k dispozici v každém koncovém bodě API! Musíte být tedy opatrní, protože mazání například zákazníků, lidí atd. je trvalé!**

##### Použití výchozích kroků procesu pro vaši položku objednávky

Pokud jste vytvořili některé výchozí kroky procesu pro produkt, který vaše položka objednávky vytváří, můžete systému říci, aby tyto výchozí **kroky** přenesl do položky objednávky pomocí rozhraní API pomocí atributu **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Obr. 2.** Vytvoření nové položky objednávky s výchozími kroky procesu

##### Přidání materiálů do položky objednávky

Pokud jste k vyráběnému produktu připojili materiály, jsou automaticky připojeny k řádku objednávky.

Pokud však nechcete použít materiály připojené k výrobku (například pokud se jedná o speciální objednávku a chcete použít jiné materiály atd.), můžete použít atribut **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Obr. 3.** Vytvoření položky objednávky bez použití výchozích materiálů