---
title: Tworzenie zamówienia
description: "Tutaj można znaleźć kompleksowy przewodnik na temat tworzenia zamówienia w Skyplanner ze wszystkimi powiązanymi danymi. Niektóre z tych zagadnień zostały omówione w [samouczku](https://skyplanner.ai/it/docs/tutorial-sullintegrazione/) integracji, ale tutaj omówimy bardziej szczegółowo strukturę danych Skyplanner i proces integracji. #### Struktura danych Najpierw omówimy…"
url: "https://skyplanner.ai/pl/docs/tworzenie-zamowienia/"
updated: "2025-10-07"
category: Integracje
tags:
  - API
  - Integracja
---

# Tworzenie zamówienia

Tutaj można znaleźć kompleksowy przewodnik na temat tworzenia zamówienia w Skyplanner ze wszystkimi powiązanymi danymi. Niektóre z tych zagadnień zostały omówione w [samouczku](https://skyplanner.ai/it/docs/tutorial-sullintegrazione/) integracji, ale tutaj omówimy bardziej szczegółowo strukturę danych Skyplanner i proces integracji.

#### Struktura danych

Najpierw omówimy strukturę zamówienia Skyplanner. [Punkty końcowe API](https://integration.skyplanner.app/api/swagger) dla wspomnianych tutaj jednostek danych są wyróżnione w następujący sposób: /phaser-orders

Na najwyższym poziomie mamy **zamówienie**(/phaser-orders)

Każde **zamówienie** *musi mieć* **klienta**(/customers).

Każde **zamówienie** może mieć wiele **pozycji zamówienia**(/phaser-order-rows).

Każda **pozycja zamówienia** *może* mieć dołączony **produkt**(/products), ale nie jest to obowiązkowe. Każdy **produkt** ma jeden **stan magazynowy**(/saldos). Należy pamiętać, że jednostka magazynowa jest tworzona automatycznie, gdy produkt jest tworzony za pomocą interfejsu API.

Każda **pozycja zamówienia** może mieć wiele **zadań** (aka etapów procesu)(/phaser-jobs).

Każde **zadanie** *musi mieć* **etap roboczy**(/workstages).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Rys. 1** Struktura zamówienia i powiązane dane

#### Przepływ pracy integracji

Oto przykład krok po kroku, jak można zorganizować integrację z systemu ERP do Skyplanner.

1. Pobieranie sprzedaży/zamówień roboczych z systemu ERP
2. Utwórz **klienta**(uzyskaj identyfikator klienta w odpowiedzi)
3. Utwórz **zamówienie** z identyfikatorem klienta (uzyskaj identyfikator zamówienia w odpowiedzi)
4. Pobieranie danych pozycji zamówienia sprzedaży/zamówienia roboczego z systemu ERP
5. Utwórz **produkt** (uzyskaj identyfikator produktu w odpowiedzi)
6. Utwórz **pozycję zamówienia** z identyfikatorem zamówienia i innymi danymi (uzyskaj identyfikator pozycji zamówienia w odpowiedzi)
7. Pobieranie danych etapu procesu z systemu ERP
8. Utwórz **etap roboczy** (uzyskaj identyfikator etapu roboczego w odpowiedzi)
9. Tworzenie **zadania** z identyfikatorem etapu roboczego i innymi danymi

#### Dodatkowe wskazówki

##### Przy usuwaniu

Usuwanie phaser-orders, phaser-order-items lub phaser-jobs za pośrednictwem interfejsu API (i interfejsu użytkownika) odbywa się w sposób *miękki*. Oznacza to, że dane nie są faktycznie usuwane z bazy danych, ale są oznaczane jako zarchiwizowane. W efekcie atrybut is_archive encji jest ustawiany na true, gdy jest ona usuwana. Zarchiwizowane/usunięte encje mogą być nadal dostępne za pomocą API przy użyciu parametru **include_archived**. Gdy include_archived=true, żądanie GET pobierze encję, nawet jeśli jest zarchiwizowana.

**Należy pamiętać, że miękkie usuwanie nie jest dostępne w każdym punkcie końcowym API! Należy więc zachować ostrożność, ponieważ usuwanie np. klientów, osób itp. jest trwałe!**

##### Korzystanie z domyślnych kroków procesu dla pozycji zamówienia

Jeśli utworzyłeś kilka domyślnych kroków procesu dla produktu, który wytwarza pozycja zamówienia, możesz powiedzieć systemowi, aby wprowadził wartości domyślne do pozycji zamówienia za pomocą interfejsu API przy użyciu atrybutu **get_default_steps**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Rys. 2.** Tworzenie nowej pozycji zamówienia z domyślnymi krokami procesu

##### Dodawanie materiałów do pozycji zamówienia

Jeśli do wyprodukowanego produktu dołączono materiały, są one automatycznie dołączane do wiersza zamówienia.

Jeśli jednak nie chcesz używać materiałów dołączonych do produktu (na przykład, jeśli produkt jest zamówieniem specjalnym i chcesz użyć innych materiałów itp.), możesz użyć atrybutu **use_custom_materials**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Rys. 3.** Tworzenie pozycji zamówienia bez użycia domyślnych materiałów