Burada, ilgili tüm verilerle birlikte Skyplanner’da bir siparişin nasıl oluşturulacağına dair kapsamlı bir kılavuz bulabilirsiniz. Bunların bir kısmı entegrasyon eğitiminde ele alınmıştır, ancak burada Skyplanner veri yapısını ve entegrasyon sürecini daha ayrıntılı olarak inceleyeceğiz.
Veri yapısı #
İlk olarak bir Skyplanner siparişinin nasıl yapılandırıldığını inceleyeceğiz. Burada bahsedilen veri varlıkları için API uç noktaları şu şekilde vurgulanmıştır: /phaser-orders
En üst seviyede siparişimiz var(/phaser-orders)
Her siparişin bir müşterisi(/customers) olmalıdır .
Her sipariş birden fazla sipariş öğesine sahip olabilir(/phaser-Order-items)
Her sipariş kalemine bir ürün(/products) eklenebilir, ancak bu zorunlu değildir. Her ürünün bir stoğu(/saldos) vardır. API ile bir ürün oluşturulduğunda stok varlığının otomatik olarak oluşturulduğunu unutmayın.
Her sipariş öğesi birden fazla işe (diğer bir deyişle işlem adımına) sahip olabilir(/phaser-jobs).
Her işin bir iş aşaması(/workstages) olmalıdır .
Entegrasyon iş akışı #
İşte ERP sisteminizden Skyplanner’a entegrasyonunuzu nasıl yapılandırabileceğinize dair adım adım bir örnek.
- ERP’den satış/iş emri getirme
- Müşteri oluşturun (yanıt olarak müşteri kimliğini alın)
- Müşteri kimliği ile sipariş oluşturun (yanıt olarak sipariş kimliğini alın)
- ERP’den satış/iş emri kalemi verilerini getirme
- Ürün oluşturun (yanıt olarak ürün kimliğini alın)
- Sipariş kimliği ve diğer verilerle sipariş kalemi oluşturun (yanıt olarak sipariş kalemi kimliğini alın)
- ERP’den süreç adımı verilerini getirme
- İş sahnesi oluşturun (yanıt olarak iş sahnesi kimliğini alın)
- İş aşaması kimliği ve diğer verilerle iş oluşturma
Ekstra ipuçları #
Silinirken #
phaser-Order’ların, phaser-Order-item’lerin veya phaser-job’ların API aracılığıyla (ve kullanıcı arayüzünden) silinmesi yumuşak silme yöntemiyle yapılır. Bu, verilerin aslında veritabanından silinmediği, ancak arşivlenmiş olarak işaretlendiği anlamına gelir. Gerçekte, varlık silindiğinde is_archive özelliği true olarak ayarlanır. Arşivlenen/silinen varlıklara yine de include_archived parametresi kullanılarak API ile erişilebilir. include_archived=true olduğunda, bir GET isteği arşivlenmiş olsa bile varlığı getirecektir.
Yumuşak silmenin her API uç noktasında mevcut olmadığını unutmayın! Bu nedenle, örneğin müşterileri, kişileri vb. silmek kalıcı olduğu için dikkatli olmanız gerekir!
Sipariş kaleminiz için varsayılan işlem adımlarını kullanma #
Sipariş kaleminizin ürettiği ürün için bazı varsayılan işlem adımları oluşturduysanız get_default_steps özelliğini kullanarak sisteme API ile varsayılanları sipariş kalemine getirmesini söyleyebilirsiniz.
Sipariş kalemine malzeme ekleme #
Üretilen ürüne malzeme eklediyseniz, bunlar otomatik olarak sipariş satırına eklenir.
Ancak, ürüne ekli malzemeleri kullanmak istemiyorsanız (örneğin, ürün özel bir siparişse ve farklı malzemeler kullanmak istiyorsanız) use_custom_materials niteliğini kullanabilirsiniz.
