---
title: Замовляйте товари
description: "Тут ми детально розглянемо вибірку, створення, оновлення та видалення позицій замовлення. Елементи замовлення доступні з кінцевої точки /phaser-order-rows. #### Отримання позицій замовлення Ви отримуєте позиції замовлення, надсилаючи GET-запит до кінцевої точки /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Рис. 1.** Отримання позицій замовлення Ви можете…"
url: "https://skyplanner.ai/uk/docs/%d0%b7%d0%b0%d0%bc%d0%be%d0%b2%d0%bb%d1%8f%d0%b9%d1%82%d0%b5-%d1%82%d0%be%d0%b2%d0%b0%d1%80%d0%b8/"
updated: "2025-10-08"
category: Інтеграції
tags:
  - API
  - Інтеграція
---

# Замовляйте товари

Тут ми детально розглянемо вибірку, створення, оновлення та видалення позицій замовлення.

Елементи замовлення доступні з кінцевої точки /phaser-order-rows.

#### Отримання позицій замовлення

Ви отримуєте позиції замовлення, надсилаючи GET-запит до кінцевої точки /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Рис. 1.** Отримання позицій замовлення

Ви можете шукати позиції замовлення за різними параметрами:

- **phaser_order_id**
  - внутрішній ідентифікатор **замовлення**Skyplanner, який можна знайти у файлі /phaser-orders-endpoint
- **external_id**
  - Зовнішній ідентифікатор позиції замовлення
  - Наприклад, унікальний ідентифікатор з вашої зовнішньої системи (ERP тощо)
- **production_planning_product_id**
  - Внутрішній ідентифікатор продукту Skyplanner
  - Можна знайти за адресою /products-endpoint
- **parent_id**
  - Якщо позиція замовлення має підпозиції (наприклад, дочірні товари), підпозиції мають ідентифікатор батьківської позиції замовлення в полі parent_id
- **row_index**
  - Індексний номер позиції замовлення

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Рис. 2.** Індекси рядків позицій замовлення

- **робочий номер**
  - Значення робочого номера позиції замовлення
- **статус**
  - Статус позиції замовлення
  - Допустимі значення: **новий**, **запущений** або **завершений**
- **позиція**
  - Значення позиції позиції замовлення

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Рис 3. Значення позиції позиції замовлення

- **дата_поставки**
  - Дата доставки товару
  - Формат: **2025-06-05T22:00:00+00:00**
- **дата_поставки_умова**
  - Необов'язкова умова пошуку дати доставки
  - Варіанти: >, =, <=, =, !=
  - Якщо значення не вказано, буде використано **>= умова**
- **is_prospect**
  - Повертайте тільки ті позиції замовлення, які є потенційними
- **include_archived**
  - Включити заархівовані (м'яко видалені) позиції замовлень у вибірку
  - Позначається значенням **is_archive**
- **модифікований**
  - Повернути позиції замовлення, які були змінені після вказаної дати
  - Формат: **2025-06-05T22:00:00+00:00**
- **modifiedCondition**
  - Необов'язкова умова пошуку модифікованого значення
  - Варіанти: >, =, <=, =, !=
  - Якщо значення не вказано, буде використано **>= умова**

Ви також можете змішувати і поєднувати параметри пошуку таким чином:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Рис 4.**Отримання елементів замовлення за **phaser_order_id**та **row_index**

Щоб отримати конкретну позицію замовлення з її внутрішнім ідентифікатором Skyplanner, ви можете зробити такий запит:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Рис. 5.** Отримання позиції замовлення з ідентифікатором Skyplanner 4

#### Створення позицій замовлення

Зверніть увагу, що ви повинні створити **замовлення** до створення позиції замовлення!

Щоб створити позицію замовлення, надішліть POST-запит на кінцеву точку /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Рис** **6.** Створення позиції замовлення

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Рис. 7.** Створена позиція замовлення

Ось огляд полів, які ви можете використовувати при створенні позиції замовлення:

- **phaser_order_id**
  - Внутрішній ідентифікатор Skyplanner для **Замовлення**, до якого прикріплена позиція замовлення
  - **Обов'язкове поле**
- **production_planning_order_order_row_id**
  - Після експорту замовлення в модуль планування виробництва Skyplanner створюється окрема сутність, яка називається **рядком замовлення планування виробництва**, і в це поле заноситься його ідентифікатор
  - **Не рекомендується використовувати**(залиште нульове значення або взагалі не надсилайте це поле в полі запиту)
- **production_planning_product_id**
  - Ідентифікатор продукту Skyplanner для продукту, який виробляє позиція замовлення
  - Потрібно, якщо ви хочете перенести кроки процесу за замовчуванням з продукту
- **external_id**
  - Унікальний ідентифікатор позиції замовлення
  - Використовуйте це, щоб зв'язати позицію замовлення Skyplanner з позицією замовлення із зовнішньої системи (ERP тощо)
  - **Має бути унікальним**
- **parent_id**
  - Якщо позиція замовлення є підпунктом для іншої позиції замовлення, вкажіть тут значення ідентифікатора батька
- **row_index**
  - Де в списку позицій замовлення знаходиться ця позиція
- **робочий номер**
  - Використовується лише як інформативне значення робочого номера для позиції замовлення
  - Не відображається в інтерфейсі Skyplanner
- **статус**
  - Статус позиції замовлення
  - Допустимі значення: **новий, розпочатий, готовий, поетапний**
- **is_archive**
  - Чи заархівована позиція замовлення (м'яко видалена)
- **позиція**
  - Значення ідентифікатора позиції замовлення (див. рис. 3.)
- **кількість**
  - Загальна кількість виробленої продукції
- **замовлена_сума**
  - Замовлена кількість товару
- **ціна**
  - Ціна за одиницю продукції
- **використання_кастомних_матеріалів**
  - Якщо ви не хочете використовувати налаштування матеріалу за замовчуванням з даних про виріб, встановіть це значення на true
  - За замовчуванням: **false**
- **використання_нестандартних_матеріалів_розраховано**
  - Нестандартна кількість матеріалів розраховується на основі виготовленої кількості продукції
  - Якщо встановлено значення false, кількість матеріалу фіксується
  - За замовчуванням: **false**
- **get_default_steps**
  - Створіть кроки процесу замовлення товару на основі кроків процесу за замовчуванням для цього товару
  - За замовчуванням: **false**
- **використовувати_розраховані_тривалості_роботи**
  - Розрахунок тривалості етапів процесу на основі даних попередніх часових журналів
  - Якщо для розрахунку недостатньо даних, використовуються значення за замовчуванням
  - За замовчуванням: **false**
- **sub_items**
  - Створіть також підпункти товару, якщо вони доступні
  - За замовчуванням: **false**
- **дата_поставки**
  - Формат: 2022-01-01 10:30:11
- **start_eligibility_date**
  - Формат: 2022-01-01 10:30:11
- **ідентифікатор_малюнка**
  - Ідентифікатор креслення/плану/інструкції
- **опис**
  - Опис позиції замовлення
- **additional_description**
  - Додатковий опис для позиції замовлення
- **is_prospect**
  - Чи є товар, що замовляється, перспективним
  - За замовчуванням: **false**

#### Оновлення позицій замовлення

Щоб оновити дані про позиції замовлення, ви можете надіслати PUT-запит до кінцевої точки /phaser-order-rows:

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

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Рис. 9.**Оновлена позиція замовлення

#### Видалення позицій замовлення

Видалення позицій замовлення виконується методом "м'якого видалення". Фактично, видалення позиції замовлення змінює її значення is_archive на true. Це означає, що ви можете відновити видалені позиції замовлення, оновивши значення is_archive до false.

При видаленні позиції замовлення система також видалить пов'язані з нею кроки процесу.

Ви видаляєте позиції замовлення, відправивши DELETE-запит на кінцеву точку /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Рис. 10.**Видалення позицій замовлення

Ви можете видалити позиції замовлення, вказавши внутрішні ідентифікатори Skyplanner в масиві **"ids"** або зовнішні ідентифікатори в масиві **"external_ids** ".