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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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:

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

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

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

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

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