Pozycje zamówienia

Tutaj szczegółowo omówimy pobieranie, tworzenie, aktualizowanie i usuwanie pozycji zamówienia.

Dostęp do pozycji zamówienia można uzyskać z punktu końcowego /phaser-order-rows.

Pobieranie pozycji zamówienia #

Pozycje zamówienia można pobrać, wysyłając żądanie GET do punktu końcowego /phaser-order-rows:

Pozycje zamówienia można wyszukiwać według wielu różnych parametrów:

• phaser_order_id
  • wewnętrzny identyfikator zamówienia Skyplanner, można znaleźć w punkcie końcowym /phaser-orders-endpoint
• external_id
  • Zewnętrzny identyfikator pozycji zamówienia
  • Na przykład unikalny identyfikator z systemu zewnętrznego (ERP itp.).
• production_planning_product_id
  • Wewnętrzny identyfikator produktu Skyplanner
  • Można go znaleźć w punkcie końcowym /products-endpoint
• parent_id
  • Jeśli pozycja zamówienia ma podpozycje (np. podprodukty), podpozycje mają identyfikator swojej nadrzędnej pozycji zamówienia w polu parent_id.
• row_index
  • Numer indeksu pozycji zamówienia

• numer roboczy
  • Wartość numeru roboczego pozycji zamówienia
• status
  • Status pozycji zamówienia
  • Dozwolone wartości: nowy, rozpoczęty lub zakończony
• pozycja
  • Wartość pozycji pozycji zamówienia

• delivery_date
  • Data dostawy pozycji zamówienia
  • Format: 2025-06-05T22:00:00+00:00
• delivery_date_condition
  • Opcjonalny warunek wyszukiwania daty dostawy
  • Opcje: >, =, <=, =, !=
  • Jeśli nie podano żadnej wartości, użyty zostanie warunek >= .
• is_prospect
  • Zwracane są tylko produkty, które są perspektywiczne
• include_archived
  • Uwzględnienie w pobieraniu zarchiwizowanych (usuniętych automatycznie) pozycji zamówień
  • Oznaczone przez wartość is_archive
• zmodyfikowany
  • Zwróć pozycje zamówienia, które zostały zmodyfikowane po podanej dacie
  • Format: 2025-06-05T22:00:00+00:00
• modifiedCondition
  • Opcjonalny warunek wyszukiwania zmodyfikowanej wartości
  • Opcje: >, =, <=, =, !=
  • Jeśli nie podano żadnej wartości, użyty zostanie warunek >= .

Można również mieszać i dopasowywać parametry wyszukiwania w następujący sposób:

Aby pobrać konkretny element zamówienia z jego wewnętrznym identyfikatorem Skyplanner, można wykonać następujące żądanie:

Tworzenie pozycji zamówienia #

Pamiętaj, że musisz utworzyć zamówienie przed utworzeniem pozycji zamówienia!

Aby utworzyć pozycję zamówienia, wyślij żądanie POST do punktu końcowego /phaser-order-rows:

Oto przegląd pól, których można użyć podczas tworzenia pozycji zamówienia:

• phaser_order_id
  • Wewnętrzny identyfikator Skyplanner dla zamówienia, do którego dołączona jest pozycja zamówienia
  • Wymagane pole
• production_planning_order_row_id
  • Po wyeksportowaniu zlecenia do modułu planowania produkcji programu Skyplanner tworzony jest oddzielny podmiot zwany wierszem zlecenia planowania produkcji, a jego identyfikator jest ustawiany w tym polu
  • Nie zaleca się używania (pozostaw jako null lub nie wysyłaj tego pola w ogóle w polu żądania).
• production_planning_product_id
  • Identyfikator produktu Skyplanner dla produktu produkowanego przez pozycję zamówienia
  • Wymagane, jeśli chcesz przenieść domyślne kroki procesu z produktu.
• external_id
  • Unikalny identyfikator pozycji zamówienia
  • Użyj tego, aby połączyć pozycję zamówienia Skyplanner z pozycją zamówienia z systemu zewnętrznego (ERP itp.).
  • Musi być unikalny
• parent_id
  • Jeśli pozycja zamówienia jest pozycją podrzędną dla innej pozycji zamówienia, w tym miejscu należy podać wartość id elementu nadrzędnego
• row_index
  • Gdzie na liście pozycji zamówienia znajduje się ta pozycja?
• numer roboczy
  • Używany tylko jako informacyjna wartość numeru roboczego dla pozycji zamówienia
  • Niewidoczne w interfejsie użytkownika Skyplanner
• status
  • Status pozycji zamówienia
  • Dozwolone wartości: new, started, ready, phased
• is_archive
  • Czy pozycja zamówienia została zarchiwizowana (usunięta)?
• pozycja
  • Wartość identyfikatora pozycji zamówienia (patrz rys. 3.)
• kwota
  • Całkowita wyprodukowana ilość produktu
• ordered_amount
  • Zamówiona ilość produktu
• cena
  • Cena jednostkowa produktu
• use_custom_materials
  • Jeśli nie chcesz używać domyślnej konfiguracji materiału z danych produktu, ustaw tę wartość na true
  • Wartość domyślna: false
• use_custom_materials_calculated
  • Niestandardowe ilości materiałów są obliczane na podstawie wyprodukowanej ilości produktów
  • Jeśli ustawione na false, ilości materiałów są stałe
  • Wartość domyślna: false
• get_default_steps
  • Tworzenie kroków procesu do zamówienia pozycji na podstawie domyślnych kroków procesu produktu
  • Wartość domyślna: false
• use_calculated_job_durations
  • Obliczanie czasu trwania etapów procesu na podstawie wcześniejszych danych dziennika czasu
  • Jeśli nie ma wystarczających danych do obliczenia, używane są domyślne czasy trwania.
  • Wartość domyślna: false
• sub_items
  • Utwórz także elementy podrzędne produktu, jeśli są dostępne
  • Wartość domyślna: false
• delivery_date
  • Format: 2022-01-01 10:30:11
• start_eligibility_date
  • Format: 2022-01-01 10:30:11
• drawing_identifier
  • Identyfikator rysunku/blueprintu/instrukcji
• opis
  • Opis pozycji zamówienia
• additional_description
  • Dodatkowy opis pozycji zamówienia
• is_prospect
  • Czy pozycja zamówienia jest perspektywiczna?
  • Wartość domyślna: false

Aktualizacja pozycji zamówienia #

Aby zaktualizować dane pozycji zamówienia, można wysłać żądanie PUT do punktu końcowego /phaser-order-rows:

Usuwanie pozycji zamówienia #

Usuwanie pozycji zamówienia odbywa się za pomocą metody “miękkiego usuwania”. W efekcie usunięcie pozycji zamówienia zmienia jej wartość is_archive na true. Oznacza to, że usunięte pozycje zamówień można przywrócić, aktualizując wartość is_archive do wartości false.

Podczas usuwania pozycji zamówienia system usunie również powiązane kroki procesu.

Pozycje zamówienia można usunąć, wysyłając żądanie DELETE do punktu końcowego /phaser-order-rows:

Pozycje zamówień można usuwać, podając wewnętrzne identyfikatory Skyplanner w tablicy “ids” lub zewnętrzne identyfikatory w tablicy “external_ids”.