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:
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ı
- İŞ 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
- 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:
Belirli bir sipariş öğesini dahili Skyplanner kimliği ile almak için aşağıdaki gibi bir istek yapabilirsiniz:
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:
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:
Sipariş kalemlerini silme #
Sipariş kalemlerinin silinmesi “yumuşak silme” yöntemiyle yapılır. Gerçekte, bir sipariş kaleminin silinmesi
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:
“ids” dizisindeki dahili Skyplanner id’lerini veya “external_ids” dizisindeki harici_id’leri vererek sipariş öğelerini silebilirsiniz.