---
title: Produkty i materiały
description: "Tutaj omówimy, w jaki sposób można tworzyć produkty i materiały oraz jak można je dołączać do zamówień za pomocą interfejsu Skyplanner-API. Pokażemy również, jak tworzyć domyślne kroki procesu dla produktów i jak tworzyć pozycje zamówień przy użyciu tych domyślnych ustawień.…"
url: "https://skyplanner.ai/pl/docs/produkty-i-materialy/"
updated: "2025-10-07"
category: Integracje
tags:
  - API
  - Integracja
---

# Produkty i materiały

Tutaj omówimy, w jaki sposób można tworzyć produkty i materiały oraz jak można je dołączać do zamówień za pomocą interfejsu Skyplanner-API. Pokażemy również, jak tworzyć domyślne kroki procesu dla produktów i jak tworzyć pozycje zamówień przy użyciu tych domyślnych ustawień.

#### Tworzenie produktu/materiału

Tworzenie i aktualizowanie zarówno produktów, jak i materiałów odbywa się za pośrednictwem tego samego punktu końcowego API: /products. Typ produktu jest ustawiany przez **atrybut typu**: "product" lub "material

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**Rys. 1.** Tworzenie produktu

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**Rys. 2.** Tworzenie materiału

Podczas tworzenia produktów i materiałów upewnij się, że ustawiłeś wartość **is_active** na true, jeśli chcesz, aby produkt/materiał był wyświetlany jako aktywny na liście produktów. Należy również pamiętać, że można ustawić dostępną ilość zapasów za pomocą atrybutu **free_amount**.

#### Tworzenie domyślnych kroków procesu dla produktu

Przed dodaniem domyślnych kroków procesu dla produktu należy mieć odpowiednie etapy pracy. Etapy pracy można tworzyć za pośrednictwem interfejsu użytkownika Skyplanner lub punktu końcowego /workstages.

Dodawanie domyślnych kroków procesu odbywa się z punktu końcowego /products/jobs/{productId}.

Na przykład, jeśli chcesz dodać domyślny krok do produktu o identyfikatorze 22220, wykonaj żądanie POST w następujący sposób:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**Rys. 3.** Dodawanie domyślnego kroku procesu

Niektóre godne uwagi dziedziny:

- order_number
  - Jest to numer indeksu informujący Skyplanner, w jakiej kolejności należy wykonać poszczególne kroki procesu
  - Na przykład: pierwszy krok otrzymuje wartość 1, drugi krok otrzymuje wartość 3, trzeci krok otrzymuje wartość 3 i tak dalej...
- stacje robocze
  - Jest to lista stacji roboczych, dla których można zaplanować ten krok procesu
  - Podaj tutaj identyfikatory stacji roboczych jako listę oddzieloną przecinkami, na przykład: "61,62,63"
- time_variation
  - Możliwe wartości: time_per_pcs, pcs_per_time, fixed_time
- czas trwania, czas ustawiania, czas ustawiania
  - Podaj te wartości w *sekundach*

#### Aktualizacja domyślnego kroku procesu

Podczas aktualizacji domyślnego kroku procesu należy użyć atrybutu **order_number**, aby określić, który krok ma zostać zaktualizowany.

Na przykład pierwszy krok procesu**(order_number 1**) w tym produkcie jest wykonywany za pomocą żądania PUT w następujący sposób:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**Rys. 4.** Aktualizacja domyślnego kroku procesu

#### Usuwanie domyślnych kroków procesu

Usuwanie domyślnych kroków procesu odbywa się również za pomocą wartości **order_number**.

Order_numbers są podawane w tablicy w następujący sposób:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**Rys. 5.** Usuwanie domyślnych kroków procesu

##### Dodawanie materiału/podproduktu do produktu

Aby dołączyć materiał lub podprodukt, musimy użyć punktu końcowego /sub-products.

Proces jest dość prosty: umieszczamy identyfikator materiału lub podproduktu w atrybucie **production_planning_product_id** oraz identyfikator produktu, do którego chcemy dołączyć materiał/podprodukt w atrybucie **production_planning_product_parent_id.**

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**Rys. 6.** Dołączanie materiału do produktu

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

Materiały można również dołączać bezpośrednio do pozycji zamówienia za pomocą punktu końcowego /row-materials. W ten sposób można dołączyć dodatkowe materiały lub użyć zupełnie innej listy materiałów w pozycji zamówienia niż domyślne materiały ustawione dla produktów. Należy pamiętać, że dla pozycji zamówienia można mieć tylko jedną jednostkę wiersz-materiał dla każdego materiału. W efekcie nie można utworzyć dwóch encji z tym samym **identyfikatorem production_planning_product_id**dla tego samego **identyfikatora phaser_order_row_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**Rys. 7.** Dodawanie materiału do pozycji zamówienia

#### Aktualizacja poziomu zapasów

Poziom zapasów produktu lub materiału można zaktualizować, wysyłając żądanie PUT z atrybutem **free_amount**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**Rys. 8.** Aktualizacja poziomu zapasów