--- title: Sipariş kalemleri description: "Burada sipariş kalemlerini getirme, oluşturma, güncelleme ve silme hakkında ayrıntılara giriyoruz. Sipariş öğelerine /phaser-order-rows uç noktasından erişilebilir. #### Sipariş kalemlerini getirme Sipariş öğelerini /phaser-order-rows uç noktasına bir GET isteği göndererek alırsınız: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Şekil 1.** Sipariş kalemlerini getirme Sipariş kalemlerini çeşitli…" url: "https://skyplanner.ai/tr/docs/siparis-kalemleri/" updated: "2025-10-08" category: Entegrasyonlar tags: - API - Entegrasyon --- # Sipariş kalemleri Burada sipariş kalemlerini getirme, oluşturma, güncelleme ve silme hakkında ayrıntılara giriyoruz. Sipariş öğelerine /phaser-order-rows uç noktasından erişilebilir. #### Sipariş kalemlerini getirme Sipariş öğelerini /phaser-order-rows uç noktasına bir GET isteği göndererek alırsınız: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **Şekil 1.** Sipariş kalemlerini getirme Sipariş kalemlerini çeşitli farklı parametrelere göre arayabilirsiniz: - **phaser_order_id** - dahili Skyplanner **sipariş**kimliği, /phaser-orders-endpoint adresinden bulunabilir - **external_id** - Sipariş kaleminin harici tanımlayıcısı - Örneğin harici sisteminizden (ERP, vb.) gelen benzersiz tanımlayıcı - **production_planning_product_id** - Dahili Skyplanner ürün kimliği - /products-endpoint adresinden bulunabilir - **parent_id** - Bir sipariş kaleminin alt kalemleri varsa (örn. alt ürünler), alt kalemlerin parent_id alanında ana sipariş kaleminin kimliği bulunur - **row_index** - Sipariş kaleminin dizin numarası ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png) **Şekil 2.** Öğe satır indekslerini sırala - **İŞ NUMARASI** - Sipariş kaleminin iş numarası değeri - **durum** - Sipariş kalemi durumu - İzin verilen değerler: **yeni**, **başladı** veya **tamamlandı** - **pozisyon** - Sipariş kaleminin pozisyon değeri ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png) Şekil 3. Sipariş öğesi konum değerleri - **delivery_date** - Sipariş kaleminin teslim tarihi - Format: **2025-06-05T22:00:00+00:00** - **delivery_date_condition** - İsteğe bağlı teslim tarihi arama koşulu - Seçenekler: >, =, <=, =, != - Değer verilmezse, **>= koşulu kullanılacaktır** - **is_prospect** - Yalnızca beklentileri olan sipariş ürünlerini iade edin - **include_archived** - Arşivlenmiş (yazılımla silinmiş) sipariş kalemlerini getirme işlemine dahil etme - **is_archive** değeri ile gösterilir - **değiştirilmiş** - Verilen tarihten sonra değiştirilen sipariş kalemlerini iade edin - Format: **2025-06-05T22:00:00+00:00** - **modifiedCondition** - Değiştirilmiş değer araması için isteğe bağlı koşul - Seçenekler: >, =, <=, =, != - Değer verilmezse, **>= koşulu kullanılacaktır** Arama parametrelerini bu şekilde karıştırabilir ve eşleştirebilirsiniz: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png) **Şekil 4.**Sipariş öğelerini **phaser_order_id**ve **row_index** ile getirme Belirli bir sipariş öğesini dahili Skyplanner kimliği ile almak için aşağıdaki gibi bir istek yapabilirsiniz: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png) **Şekil 5.** Skyplanner kimliği 4 ile bir sipariş öğesini getirme #### Sipariş kalemleri oluşturma Sipariş kalemini oluşturmadan önce bir **sipariş** oluşturmanız gerektiğini unutmayın! Bir sipariş öğesi oluşturmak için /phaser-order-rows uç noktasına bir POST isteği gönderin: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png) **Şekil** **6.** Sipariş kalemi oluşturma ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png) **Şekil 7.** Oluşturulan sipariş kalemi Burada, bir sipariş kalemi oluştururken kullanabileceğiniz alanlar hakkında genel bir bakış yer almaktadır: - **phaser_order_id** - Sipariş öğesinin bağlı olduğu **Sipariş** için dahili Skyplanner kimliği - **Zorunlu alan** - **production_planning_order_row_id** - Sipariş Skyplanner'ın üretim **planlama** modülüne aktarıldıktan sonra, **üretim planlama sipariş satırı** adı verilen ayrı bir varlık oluşturulur ve kimliği bu alana ayarlanır - **Kullanılması önerilmez**(null olarak bırakın veya bu alanı istek alanında hiç göndermeyin) - **production_planning_product_id** - Sipariş kaleminin ürettiği ürün için Skyplanner ürün kimliği - Bir üründen varsayılan işlem adımlarını getirmek istiyorsanız gereklidir - **external_id** - Sipariş kaleminin benzersiz tanımlayıcısı - Skyplanner sipariş kalemini harici bir sistemden (ERP vb.) sipariş kaleminize bağlamak için bunu kullanın - **Benzersiz olmalı** - **parent_id** - Sipariş kalemi başka bir sipariş kaleminin alt kalemiyse, burada üst kalemin kimlik değerini verin - **row_index** - Bu öğenin siparişteki sipariş öğeleri listesinin neresinde yer aldığı - **İŞ NUMARASI** - Sadece sipariş kalemi için bilgilendirici bir iş numarası değeri olarak kullanılır - Skyplanner kullanıcı arayüzünde görünmüyor - **durum** - Sipariş kaleminin durumu - İzin verilen değerler: **yeni, başladı, hazır, aşamalı** - **is_archive** - Sipariş kalemi arşivlendi mi (yumuşak silindi) - **pozisyon** - Sipariş kalemi tanımlayıcı değeri (bkz. Şekil 3.) - **miktar** - Toplam üretilen ürün miktarı - **ordered_amount** - Sipariş edilen ürün miktarı - **fiyat** - Ürün birim fiyatı - **use_custom_materials** - Ürün verilerinden varsayılan malzeme kurulumunu kullanmak istemiyorsanız, bu değeri true olarak ayarlayın - Varsayılan: **false** - **use_custom_materials_calculated** - Özel malzeme miktarları, üretilen ürün miktarına göre hesaplanır - Yanlış olarak ayarlanırsa, malzeme miktarları sabitlenir - Varsayılan: **false** - **get_default_steps** - Ürünün varsayılan işlem adımlarını temel alarak sipariş öğesi için işlem adımları oluşturma - Varsayılan: **false** - **use_calculated_job_durations** - Geçmiş zaman günlüğü verilerine dayalı olarak süreç adımı sürelerini hesaplama - Hesaplamak için yeterli veri mevcut değilse, varsayılan süreler kullanılır - Varsayılan: **false** - **sub_items** - Varsa ürünün alt öğelerini de oluşturun - Varsayılan: **false** - **delivery_date** - Format: 2022-01-01 10:30:11 - **start_eligibility_date** - Format: 2022-01-01 10:30:11 - **drawing_identifier** - Çizim/baskı/talimat tanımlayıcı - **Açıklama** - Sipariş kalemi açıklaması - **additional_description** - Sipariş kalemi için ek açıklama - **is_prospect** - Sipariş kalemi bir müşteri adayı mı - Varsayılan: **false** #### Sipariş kalemlerinin güncellenmesi Sipariş öğesi verilerini güncellemek için /phaser-order-rows uç noktasına bir PUT isteği gönderebilirsiniz: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png) **Şekil 8.**Bir sipariş kalemini güncelleme ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png) **Şekil 9.**Güncellenmiş sipariş kalemi #### Sipariş kalemlerini silme Sipariş kalemlerinin silinmesi "yumuşak silme" yöntemiyle yapılır. Gerçekte, bir sipariş kaleminin silinmesi is_archive değerini true olarak değiştirir. Bu, is_archive değerini false olarak güncelleyerek silinen sipariş kalemlerini geri yükleyebileceğiniz anlamına gelir. Bir sipariş kalemini silerken, sistem ilgili işlem adımlarını da silecektir. Sipariş öğelerini /phaser-order-rows uç noktasına bir DELETE isteği göndererek silersiniz: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png) **Şekil 10.**Sipariş kalemlerini silme **"ids"** dizisindeki dahili Skyplanner id'lerini veya **"external_ids"** dizisindeki harici_id'leri vererek sipariş öğelerini silebilirsiniz.