--- title: Pozycje zamówienia description: "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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Rys. 1.** Pobieranie pozycji…" url: "https://skyplanner.ai/pl/docs/pozycje-zamowienia/" updated: "2025-10-08" category: Integracje tags: - API - Integracja --- # 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Rys. 1.** Pobieranie pozycji zamówienia 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 ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png) **Rys. 2.** Indeksy wierszy 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 ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png) Rys. 3. Wartości 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png) **Rys. 4.**Pobieranie pozycji zamówienia według **phaser_order_id**i **row_index** Aby pobrać konkretny element zamówienia z jego wewnętrznym identyfikatorem Skyplanner, można wykonać następujące żądanie: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png) **Rys. 5.** Pobieranie pozycji zamówienia z identyfikatorem Skyplanner 4 #### 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png) **Rys.** **6.** Tworzenie pozycji zamówienia ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png) **Rys. 7.** Utworzona pozycja zamówienia 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png) **Rys. 8.**Aktualizacja pozycji zamówienia ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png) **Rys. 9.**Zaktualizowana pozycja zamówienia #### 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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png) **Rys. 10.**Usuwanie pozycji zamówienia Pozycje zamówień można usuwać, podając wewnętrzne identyfikatory Skyplanner w tablicy **"ids"** lub zewnętrzne identyfikatory w tablicy **"external_ids"**.