---
title: Продукти та матеріали
description: "Тут ми розглянемо, як ви можете створювати продукти і матеріали і як ви можете прикріплювати їх до ваших замовлень за допомогою Skyplanner-API. Ми також покажемо, як створювати кроки процесу за замовчуванням для ваших продуктів і як створювати позиції замовлення, використовуючи…"
url: "https://skyplanner.ai/uk/docs/%d0%bf%d1%80%d0%be%d0%b4%d1%83%d0%ba%d1%82%d0%b8-%d1%82%d0%b0-%d0%bc%d0%b0%d1%82%d0%b5%d1%80%d1%96%d0%b0%d0%bb%d0%b8/"
updated: "2025-10-07"
category: Інтеграції
tags:
  - API
  - Інтеграція
---

# Продукти та матеріали

Тут ми розглянемо, як ви можете створювати продукти і матеріали і як ви можете прикріплювати їх до ваших замовлень за допомогою Skyplanner-API. Ми також покажемо, як створювати кроки процесу за замовчуванням для ваших продуктів і як створювати позиції замовлення, використовуючи ці кроки за замовчуванням.

#### Створення продукту/матеріалу

Створення та оновлення як продуктів, так і матеріалів відбувається через одну і ту ж API-кінцеву точку: /products. Тип товару задається **атрибутом type**: 'product' або 'material'

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**Рис. 1.** Створення продукту

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**Рис. 2.** Створення матеріалу

При створенні продуктів і матеріалів переконайтеся, що ви встановили значення **is_active** як true, якщо хочете, щоб продукт/матеріал відображався як активний у списку продуктів. Також зверніть увагу, що ви можете задати доступну кількість на складі за допомогою атрибута **free_amount**.

#### Створення кроків процесу за замовчуванням для продукту

Перш ніж додавати стандартні етапи процесу для продукту, вам потрібно створити відповідні робочі етапи. Робочі етапи можна створити або за допомогою інтерфейсу Skyplanner, або за допомогою /workstages-endpoint.

Додавання кроків процесу за замовчуванням виконується з кінцевої точки /products/jobs/{productId}-endpoint.

Наприклад, якщо ви хочете додати крок за замовчуванням до товару з ідентифікатором 22220, вам потрібно зробити POST-запит, як цей:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**Рис. 3.** Додавання кроку процесу за замовчуванням

Кілька помітних полів:

- номер_замовлення
  - Це індексний номер, який вказує Skyplanner, в якому порядку мають бути виконані кроки процесу
  - Наприклад: перший крок отримує значення 1, другий крок отримує значення 3, третій крок отримує значення 3 і так далі...
- робочі станції
  - Це список робочих станцій, на які можна призначити цей крок процесу
  - Введіть тут ідентифікатори робочих станцій у вигляді списку, розділених комами, наприклад, так: "61,62,63"
- час_варіації
  - Можливі значення: time_per_pcs, pcs_per_time, fixed_time
- тривалість, час встановлення, час заселення
  - Наведіть ці значення в *секундах*

#### Оновлення кроку процесу за замовчуванням

При оновленні кроку процесу за замовчуванням ви повинні використовувати атрибут **order_number**, щоб вказати, який саме крок потрібно оновити.

Наприклад, перший крок процесу**(order_number 1)** в цьому продукті виконується за допомогою PUT-запиту, як цей:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**Рис. 4.** Оновлення кроку процесу за замовчуванням

#### Видалення кроків процесу за замовчуванням

Видалення кроків процесу за замовчуванням також здійснюється за допомогою значень **order_number**.

Номери_замовлень задаються у масиві таким чином:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**Рис. 5.** Видалення кроків процесу за замовчуванням

##### Додавання матеріалу/субпродукту до продукту

Щоб прикріпити матеріал або субпродукт, ми повинні використовувати кінцеву точку /sub-products.

Процес досить простий: ми вводимо ідентифікатор матеріалу або субпродукту в атрибут **production_planning_product_id**, а ідентифікатор продукту, до якого ми хочемо прикріпити матеріал/субпродукт, - в атрибут **production_planning_product_parent_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**Рис. 6.** Прикріплення матеріалу до виробу

##### Додавання матеріалу до позиції замовлення

Ви також можете прикріпити матеріали безпосередньо до позиції замовлення за допомогою кінцевої точки /row-materials. Таким чином ви можете прикріпити додаткові матеріали або використати в позиції замовлення список матеріалів, відмінний від матеріалів за замовчуванням, встановлених для продуктів. Зверніть увагу, що ви можете мати лише одну сутність ряд-матеріал для позиції замовлення для кожного матеріалу. Таким чином, ви не можете створити дві сутності з однаковим ідентифікатором **product_planning_product_id**для одного і того ж ідентифікатора **phaser_order_row_id**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**Рис. 7.** Додавання матеріалу до позиції замовлення

#### Оновлення рівня запасів

Ви можете оновити рівень запасу товару або матеріалу, відправивши PUT-запит з атрибутом **free_amount**.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**Рис. 8.** Оновлення рівня запасів