Stok Görünürlüğü eldeki değişiklik zamanlamaları ve karşılanabilir miktarı

Bu makalede, gelecekteki eldeki değişiklikleri zamanlamak ve karşılanabilir miktarları (KM) hesaplamak için Eldeki değişiklik zamanlaması özelliğinin nasıl ayarlanacağı açıklanmaktadır. KM, mevcut bulunan ve sonraki dönemde müşteriye vaat edilebilecek bir maddenin miktarıdır. Bu hesaplamanın kullanımı, sipariş karşılama yeteneğinizi büyük ölçüde artırabilir.

Birçok üretici, perakendeci veya satıcı için şu anda eldeki stoğu bilmek yeterli değildir. Gelecekteki kullanılabilirliğe ilişkin tam görünürlüğe sahip olmaları da gerekir. Bu gelecekteki kullanılabilirlik için gelecekteki arz, gelecekteki talep ve KM dikkate alınmalıdır.

ATP için hesaplanan ölçüler

ATP hesaplanan ölçüsü genellikle mevcut kullanılabilir eldeki miktarı bulmak için kullanılan önceden tanımlanmış hesaplanan ölçüdür. Arz miktarı, ekleme niteleyici türüne sahip fiziksel ölçülerin miktarlarının toplamıdır. Talep miktarı ise çıkarma niteleyici türüne sahip fiziksel ölçülerin miktarlarının toplamıdır.

Birden çok KM miktarını hesaplamak için birden çok hesaplanan ölçü ekleyebilirsiniz. Ancak tüm KM hesaplanan ölçülerinde ayrı fiziksel ölçülerin toplam sayısı dokuzdan az olmalıdır.

Örneğin, aşağıdaki hesaplanan ölçüyü ayarlayabilirsiniz:

Eldeki mevcut= ( PhysicalInventEldeki Sınırsız + + QualityInspection + Gelen + ) – (ReservPhysicalSoftReservePhysical + Giden + )

Toplam (PhysicalInvent + OnHand + Kısıtlamasız + QualityInspection + Gelen), arzı temsil eder ve toplam (ReservPhysical + SoftReservePhysical + Giden), talebi temsil eder. Böylece hesaplanan ölçü aşağıdaki şekilde anlaşılabilir:

Eldeki Arz-Talep =

Eldeki fiziksel miktar KM miktarını hesaplamak için başka bir hesaplanan ölçü ekleyebilirsiniz.

Elde-fiziksel = (PhysicalInvent + Elde, + Sınırsız + KaliteDenetim + , Gelen) – (Giden)

Bu iki KM hesaplanan ölçüsü genelinde sekiz farklı fiziksel ölçü vardır: PhysicalInvent, OnHand, Unrestricted, QualityInspection, Inbound, ReservPhysical, SoftReservePhysical ve Outbound.

Hesaplanan ölçüler hakkında daha fazla bilgi için bkz. Hesaplanan ölçüler.

Kullanıcı arayüzü sürüm 2'de eldeki değişiklik zamanlamasını ve ATP'yi açın ve ayarlayın

Bu bölüm, Stok Görünürlüğü Kullanıcı Arayüzü sürüm 2'yi kullandığınızda geçerlidir.

KM'yi kullanabilmeniz için önce hesaplamak üzere bir veya daha fazla hesaplanan ölçü ayarlamanız gerekir. Ayrıca Microsoft Power Apps'te özelliği açmanız ve KM ayarlarını yapılandırmanız da gerekir.

Power Apps'te Eldeki değişiklik zamanlaması özelliğini açmak ve KM ayarlarını yapılandırmak için bu adımları izleyin.

1. Power Apps'te oturum açın ve Stok Görünürlüğü uygulamasını açın.

2. Gezinti bölmesinde Özellik yönetimi'ni seçin.

3. Karşılanabilir miktar kutucuğunda Yönet'i seçin.

4. ATP özelliğini açmak için Özelliği etkinleştir seçeneğini Doğru olarak ayarlayın.

5. Daha uzun ATP zamanlama dönemini (180 gün) desteklemek için 180 günlük zamanlama seçeneğini Doğru olarak ayarlayın.

   Önemli

   Varsayılan olarak ATP özelliği yedi günle sınırlıdır. Yedi günlük ATP ve 180 günlük ATP özellikleri ayrı ve birbirinden bağımsızdır. Yedi günlük ATP özelliğini kullanarak oluşturduğunuz veya değiştirdiğiniz zamanlama değişiklikleri, 180 günlük ATP özelliğini açtığınızda geçerli olmayacaktır. Yedi günlük ATP özelliğini kullandıysanız ve 180 günlük özelliğe geçmek istiyorsanız, 180 günlük özelliği etkinleştirdikten sonra eski verileri silmenizi ve mevcut değişiklik planınızı yeniden yayınlamanızı öneririz.

6. Maks. zamanlama dönemi (gün) alanını, kullanıcıların zamanlanan eldeki değişiklikleri görüntüleyip gönderebileceği gün sayısına ayarlayın. Stok bilgilerini sorgulayan kullanıcılar, geçerli tarihten itibaren tanımlanan dönemde her gün için eldeki miktarı, zamanlanan eldeki değişiklikleri ve KM'yi elde eder. Bu alanın maksimum değeri 180 gündür. Varsayılan olarak 30 güne ayarlanmıştır. Bu nedenle, değişiklikleri bugünden itibaren 30 güne kadar planlayabilirsiniz.

   Önemli

   Zamanlama dönemi, geçerli tarihi içerir. Bu nedenle kullanıcılar, geçerli tarihten (değişikliğin gönderildiği gün) gelecekteki (zamanlama dönemi - 1) güne kadar herhangi bir zamanda gerçekleşecek eldeki değişiklikleri zamanlayabilir.

7. Planlama önlemleri bölümünde, zamanlama önlemlerini ayarlayın. Mevcut hesaplanan ölçümleri zamanlama ölçümleri olarak kullanabilir veya yenilerini oluşturabilirsiniz. Stok Görünürlüğünü sorguladığınızda, bileşen fiziksel ölçümlerinin zamanlanmış değişikliklerine dayalı olarak tanımlanmış hesaplanmış ölçümler için ATP değeri sağlanır. Ölçüleri planlayın bölümnde, ATP için yeni hesaplanan ölçü bağlamayı eklemek için araç çubuğunda Yeni eldeki değişiklik planı yapılandırması V2'yi seçin. Hesaplanan ölçü, mevcut mevcut miktarı bulmak için kullanmak istediğiniz ölçüdür. Hesaplanan ölçü oluşturma hakkında daha fazla bilgi için bkz. Hesaplanan ölçüler.

   Önemli

   Varsayılan ATP hesaplanan formülü referans amaçlıdır. İşletmeniz için doğru ATP hesaplamasını ayarlamak için diğer veri kaynaklarını ve fiziksel ölçümleri değiştirebilir ve ekleyebilirsiniz.

8. ATP dizin seti yapılandırması bölümünde ATP indeksinizi ayarlayın. ATP dizini, belirli boyutlara göre sorgu sonuçlarını gruplandırmanıza olanak tanıyan ürün dizin hiyerarşisine benzer. Örneğin ColorId ve SizeId'yi ATP dizin kümeniz olarak ayarlarsanız sorgu sonuçları renk ve boyuta göre gruplandırılır. Birden fazla dizin kümeniz olabilir.

   Önemli

   Varsayılan ColorId ve SizeId dizini, referans amaçlıdır. Boyutları kaldırabilir ve başka boyutlar ekleyebilirsiniz.

9. Kaydet'i seçin.

10. Gerekli tüm ayarları yapılandırmayı tamamladığınızda, gezinme bölmesinde Yönetici Ayarları altında Yapılandırmayı Güncelleştir'i seçin.

Daha fazla bilgi için bkz. Yapılandırmayı tamamlama ve güncelleştirme.

Kullanıcı arayüzü sürüm 1'de eldeki değişiklik zamanlamasını ve ATP'yi açın ve ayarlayın

Bu bölüm, Stok Görünürlüğü Kullanıcı Arayüzü sürüm 1'yi kullandığınızda geçerlidir.

Power Apps'te Eldeki değişiklik zamanlaması özelliğini açmak ve KM ayarlarını yapılandırmak için bu adımları izleyin.

1. Power Apps'te oturum açın ve Stok Görünürlüğü uygulamasını açın.

2. Yapılandırma sayfasını açın.

3. Özellik Yönetimi sekmesinde, Karşılanabilir miktar özelliğini açın.

4. KM Ayarı sekmesini seçin.

5. Stok Görünürlüğü'nü sorguladığınızda buraya eklediğiniz her KM hesaplanan ölçüsünü içeren bir sonuç sağlanır. KM için yeni bir hesaplanan ölçü eklemek üzere Ekle'yi seçin.

6. Aşağıdaki alanları ayarlayın:

   • Veri Kaynağı : Hesaplanan ölçüyle ilişkili veri kaynağını seçin.
   • Hesaplanan Ölçü : Seçili veri kaynağıyla ilişkili olan ve eldeki mevcut miktarı bulmak için kullanmak istediğiniz hesaplanan ölçüyü seçin.
   • Planlama Dönemi : Seçilen hesaplanan ölçü kullanıldığında, kullanıcıların eldeki zamanlanmış değişiklikleri görüntüleyebileceği ve gönderebileceği gün sayısını girin. Stok bilgilerini sorgulayan kullanıcılar, geçerli tarihten itibaren bu dönemde her gün için eldeki miktarı, zamanlanan eldeki değişiklikleri ve KM'yi elde eder. 1 ile 7 arasında bir tamsayı seçin.

   Önemli

   Zamanlama dönemi, geçerli tarihi içerir. Bu nedenle kullanıcılar, geçerli tarihten (değişikliğin gönderildiği gün) gelecekteki (zamanlama dönemi - 1) güne kadar herhangi bir zamanda gerçekleşecek eldeki değişiklikleri zamanlayabilir.

7. Kaydet'i seçin.

8. KM için gereken tüm hesaplanan ölçüleri ekleyene kadar 5 ila 7. adımları tekrarlayın.

9. Gerekli tüm ayarları yapılandırmayı tamamladığınızda Yapılandırmayı Güncelleştir'i seçin.

Eldeki değişiklik zamanlaması ve KM hesaplamaları nasıl çalışır?

Eldeki değişiklik zamanlaması, zamanlanan eldeki değişikliklerin beklenen tarihlerini ve miktarlarını belirler. Tarihlerin Zamanlama dönemi ayarı tarafından tanımlanan dönem içinde olması şartıyla Stok Görünürlüğü için bir eldeki değişiklik zamanlaması gönderebilirsiniz (bu makalenin Özellikleri etkinleştirme ve ayarlama bölümüne bakın). Stok bilgilerini sorgulayan kullanıcılar, bu dönemde her gün için eldeki miktarı, zamanlanan eldeki değişiklikleri ve KM'yi elde eder.

Zamanlanan değişiklikler başlangıçta kaydedilmez ve bu nedenle sistemdeki gerçek eldeki miktarlarınızı etkilemez. Değişiklikleri kaydetmek için gerçek kullanılabilir eldeki miktarı güncelleştiren bir eldeki değişiklik olayı göndermeniz gerekir. Ardından, eşleşen negatif miktar için bir eldeki değişiklik zamanlaması göndererek zamanlanan değişikliği geri almanız gerekir.

Örneğin, 10 bisiklet siparişi verdiniz ve ertesi gün gelmesini bekliyorsunuz. Bu nedenle, gelen miktarı 10 ve tarihi ertesi gün olan bir eldeki değişiklik zamanlaması gönderirsiniz. Sipariş ertesi gün ulaştığında bisikletleri fiziksel eldeki stoğa eklersiniz. Ardından, gerçek eldeki miktarı güncelleştirmek için değişikliği sisteminize yüklemeniz gerekir. Değişikliği kaydetmek için gelen miktarı 10 olan bir eldeki değişiklik olayı gönderirsiniz. Ardından, gelen miktarı -10 olan bir eldeki değişiklik zamanlaması göndererek zamanlanan değişikliği geri alırsınız.

Eldeki miktar ve KM için Stok Görünürlüğü'nü sorguladığınızda zamanlama dönemindeki her gün için aşağıdaki bilgiler döndürülür:

• Tarih: Sonucun geçerli olduğu tarih. Saat dilimi Eşgüdümlü Evrensel Saat'tir (UTC).
• Eldeki miktar : Belirtilen tarih için eldeki gerçek miktar. Bu hesaplama, Stok Görünürlüğü için yapılandırılan KM hesaplanan ölçüsüne göre yapılır.
• Planlanan tedarik : Belirtilen tarih itibarıyla hemen tüketim veya sevkiyat için fiziksel olarak kullanılabilir hale gelmemiş olan tüm zamanlanmış gelen miktarların toplamı.
• Zamanlanan talep : Belirtilen tarih itibarıyla tüketilmemiş veya sevk edilmemiş tüm zamanlanmış giden miktarların toplamı.
• ATP miktarı : Belirtilen tarihten plan döneminin sonuna kadar kullanılabilen minimum tahmini eldeki miktar. Bu miktar, tüm zamanlanan miktar ayarlamalarını içerir. Bu günde teslim veya tüketim için geçerli tarihte vaat edilebilecek maksimum miktardır.

Örneğin, geçerli tarih 1 Şubat 2022 ve zamanlama dönemi 7 ise kullanıcılar 1 Şubat 2022'den 7 Şubat 2022'ye kadar gerçekleşmesi beklenen zamanlanan eldeki değişiklikleri gönderebilir. Bu durumda, örneğin 3 Şubat için KM, bu gün için eldeki miktar ve 3 Şubat'tan 7 Şubat'a kadar zamanlanan miktarlar temel alınarak hesaplanır.

Örnek

Aşağıdaki örnekte, bir dizi zamanlanan miktar değişikliğinin Stok Görünürlüğü'nde raporlanan eldeki miktarı ve KM'yi nasıl etkilediği gösterilmektedir. Ayrıca, zamanlanan değişikliğin nasıl kaydedileceği, kaydedilen zamanlama değişikliğinin sonuçları nasıl etkilediği ve zamanlanan değişiklik kaydetmezseniz neler olabileceği de gösterilmektedir.

Bu örnekte sonuçlarda bir tahmini eldeki değer gösterilmektedir. Bu değer, gösterim amacıyla tüm zamanlanan güncelleştirmeleri içerir ancak Stok Görünürlüğü'nü sorguladığınızda gerçekten raporlanmaz.

1. Aşağıdaki ayarlar, Power Apps'te Stok Görünürlüğü uygulamasının ATP ayarı sayfasında sisteminiz için yapılandırılır:

   • Hesaplamaları planla: Buraya Eldeki adlı hesaplanmış bir ölçü eklenir. Bu, Eldeki = Arz - Talep olarak hesaplanır.
   • Maksimum zamanlama süresi (gün) – Değer 7 olarakayarlanır.
   • ATP dizin kümesi yapılandırması – ColorId ve SizeId buraya eklenir.

2. Aşağıdaki koşullar da geçerlidir:

   • Geçerli tarih 1 Şubat 2022'dir.
   • Geçerli eldeki miktar 20'dir.

3. Geçerli tarih (1 Şubat 2022) için zamanlanan talep miktarı olarak 3'ü Stok Görünürlüğü'ne gönderirsiniz. Böylece tahmini eldeki miktar 17 olur. Aşağıdaki tabloda sonuç gösterilmektedir.

   Tarih	Eldeki	Zamanlanan arz	Zamanlanan talep	Tahmini eldeki	KM
   2022-02-01	20		3	17	17
   2022-02-02	20			17	17
   2022-02-03	20			17	17
   2022-02-04	20			17	17
   2022-02-05	20			17	17
   2022-02-06	20			17	17
   2022-02-07	20			17	17

4. Geçerli tarihte (1 Şubat 2022), 3 Şubat 2022 için zamanlanan arz miktarı olarak 10'u gönderirsiniz. Aşağıdaki tabloda sonuç gösterilmektedir.

   Tarih	Eldeki	Zamanlanan arz	Zamanlanan talep	Tahmini eldeki	KM
   2022-02-01	20		3	17	17
   2022-02-02	20			17	17
   2022-02-03	20	10		27	27
   2022-02-04	20			27	27
   2022-02-05	20			27	27
   2022-02-06	20			27	27
   2022-02-07	20			27	27

5. Geçerli tarihte (1 Şubat 2022), aşağıdaki zamanlanan miktar değişikliklerini gönderirsiniz:

   • 4 Şubat 2022 için talep miktarı olarak 15
   • 5 Şubat 2022 için arz miktarı olarak 1
   • 6 Şubat 2022 için arz miktarı olarak 3

   Aşağıdaki tabloda sonuç gösterilmektedir.

   Tarih	Eldeki	Zamanlanan arz	Zamanlanan talep	Tahmini eldeki	KM
   2022-02-01	20		3	17	12
   2022-02-02	20			17	12
   2022-02-03	20	10		27	12
   2022-02-04	20		15	12	12
   2022-02-05	20	1		13	13
   2022-02-06	20	3		16	16
   2022-02-07	20			16	16

6. Geçerli tarihte (1 Şubat 2022), zamanlanan talep miktarı olarak 3'ü sevk edersiniz: Bu nedenle, bu değişikliği gerçek eldeki miktarınızda yansıtılacak şekilde kaydetmeniz gerekir. Değişikliği kaydetmek için giden miktarı 3 olan bir eldeki değişiklik olayı gönderirsiniz. Ardından, giden miktarı -3 olan bir eldeki değişiklik zamanlaması göndererek zamanlanan değişikliği geri alırsınız. Aşağıdaki tabloda sonuç gösterilmektedir.

   Tarih	Eldeki	Zamanlanan arz	Zamanlanan talep	Tahmini eldeki	KM
   2022-02-01	17		0	17	12
   2022-02-02	17			17	12
   2022-02-03	17	10		27	12
   2022-02-04	17		15	12	12
   2022-02-05	17	1		13	13
   2022-02-06	17	3		16	16
   2022-02-07	17			16	16

7. Sonraki gün (2 Şubat 2022), zamanlama dönemi bir gün ileri kayar. Aşağıdaki tabloda sonuç gösterilmektedir.

   Tarih	Eldeki	Zamanlanan arz	Zamanlanan talep	Tahmini eldeki	KM
   2022-02-02	17			17	12
   2022-02-03	17	10		27	12
   2022-02-04	17		15	12	12
   2022-02-05	17	1		13	13
   2022-02-06	17	3		16	16
   2022-02-07	17			16	16
   2022-02-08	17			16	16

8. Ancak iki gün sonra (4 Şubat 2022), 3 Şubat için zamanlanan arz miktarı olarak 10 hâlâ gelmemiştir. Aşağıdaki tabloda sonuç gösterilmektedir.

   Tarih	Eldeki	Zamanlanan arz	Zamanlanan talep	Tahmini eldeki	KM
   2022-02-04	17		15	2	2
   2022-02-05	17	1		3	3
   2022-02-06	17	3		6	6
   2022-02-07	17			6	6
   2022-02-08	17			6	6
   2022-02-09	17			6	6
   2022-02-10	17			6	6

   Gördüğünüz gibi, zamanlanan (ancak kaydedilmeyen) eldeki değişiklikler gerçek eldeki miktarı etkilemez.

API üzerinden değişiklik zamanlamaları, değişiklik olayları ve KM sorguları gönderme

Eldeki değişiklik zamanlamaları, değişiklik olayları ve sorgular göndermek için aşağıdaki uygulama programlama arabirimi (API) URL'lerini kullanabilirsiniz.

Daha fazla bilgi için bkz. Stok Görünürlüğü genel API'leri.

Eldeki stok değişikliği zamanlaması oluşturma

İlgili stok görünürlük hizmeti URL'sine bir POST istek gönderilerek eldeki değişiklik planı oluşturulur. Ayrıca toplu istekler de gönderebilirsiniz.

Eldeki stok değişikliği zamanlaması, yalnızca zamanlanan tarihin geçerli tarih ile geçerli zamanlama döneminin sonu arasında olması koşuluyla oluşturulabilir. Tarih saat biçimi yıl-ay-gün (ör. 2022-02-01) biçiminde olmalıdır. Saat biçimi yalnızca ilgili gün için doğru olmalıdır.

Bu API, tek bir eldeki stok değişikliği zamanlaması oluşturur.

Path:
    /api/environment/{environmentId}/onhand/changeschedule
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Body:
    {
        id: string,
        organizationId: string,
        productId: string,
        dimensionDataSource: string, # optional
        dimensions: {
            [key:string]: string,
        },
        quantitiesByDate: {
            [datetime:datetime]: {
                [dataSourceName:string]: {
                    [key:string]: number,
                },
            },
        },
    }

Aşağıdaki örnekte, dimensionDataSource olmadan örnek gövde içeriği gösterilmektedir.

{
    "id": "id-bike-0001",
    "organizationId": "usmf",
    "productId": "Bike",
    "dimensions": {
        "SiteId": "1",
        "LocationId": "11",
        "ColorId": "Red",
        "SizeId": "Small"
    },
    "quantitiesByDate": {
        "2022-02-01": {
            "pos": {
                "inbound": 10
            }
        }
    }
}

Birden fazla eldeki stok değişikliği zamanlaması oluşturma

Bu API aynı anda birden çok kayıt oluşturabilir. Bu API ile tek olay API'si arasındaki tek fark, Path ve Body değerleridir. Bu API için Body bir dizi kayıt sağlar. Maksimum kayıt sayısı 512'dir. Bu nedenle, eldeki stok değişikliği zamanlaması toplu API'si tek seferde 512 adede kadar zamanlanan değişikliği destekleyebilir.

Path:
    /api/environment/{environmentId}/onhand/changeschedule/bulk
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Body:
    [
        {
            id: string,
            organizationId: string,
            productId: string,
            dimensionDataSource: string,
            dimensions: {
                [key:string]: string,
            },
            quantityDataSource: string, # optional
            quantitiesByDate: {
                [datetime:datetime]: {
                    [dataSourceName:string]: {
                        [key:string]: number,
                    },
                },
            },
        },
        ...
    ]

Aşağıdaki örnekte, örnek gövde içeriği gösterilmektedir.

[
    {
        "id": "id-bike-0001",
        "organizationId": "usmf",
        "productId": "Bike",
        "dimensions": {
            "SiteId": "1",
            "LocationId": "11",
            "ColorId": "Red",
            "SizeId": "Small"
        },
        "quantitiesByDate": {
            "2022-02-01": {
                "pos": {
                    "inbound": 10
                }
            }
        }
    },
    {
        "id": "id-car-0002",
        "organizationId": "usmf",
        "productId": "Car",
        "dimensions": {
            "SiteId": "1",
            "LocationId": "11",
            "ColorId": "Red",
            "SizeId": "Small"
        },
        "quantitiesByDate": {
            "2022-02-05": {
                "pos": {
                    "outbound": 10
                }
            }
        }
    }
]

Eldeki değişiklik olayları oluşturma

Eldeki değişiklik etkinlikleri, ilgili stok görünürlük hizmeti URL'sine bir POST istek gönderilerek yapılır (API aracılığıyla değişiklik planlarını, değişiklik olaylarını ve ATP sorgularını gönderme bölümünün başlangıcına bakın).

Aşağıdaki örnekte, tek bir eldeki değişiklik olayı içeren istek gövdesi gösterilmektedir.

{
    "id": "id-bike-0001",
    "organizationId": "usmf",
    "productId": "Bike",
    "dimensions": {
        "SiteId": "1",
        "LocationId": "11",
        "SizeId": "Big",
        "ColorId": "Red"
    },
    "quantities": {
        "pos": {
            "inbound": 10.0
        }
    }
}

Zamanlanan eldeki değişiklikleri ve KM sonuçlarını sorgulama

Uygun API URL'sine bir POST isteği veya GET isteği göndererek zamanlanan eldeki değişiklikleri ve KM sonuçlarını sorgulayabilirsiniz (API üzerinden değişiklik zamanlamaları, değişiklik olayları ve KM sorguları gönderme bölümüne bakın).

Zamanlanan eldeki değişiklikleri ve KM sonuçlarını sorgulamak isterseniz isteğinizde QueryATP parametresini true olarak ayarlayın. Varsayılan olarak sorgu, bugünden itibaren ATP ile ilgili tüm verileri döndürür. Sonuçları daraltmak için ATPFromDate ve ATPToDate seçeneğini belirleyebilirsiniz. ("Başlangıç" ve "bitiş" tarihleri yalnızca sonucu filtreler. ATP'nin nasıl hesaplandığını etkilemezler.)

• İsteği GET yöntemini kullanarak gönderiyorsanız URL'de bu parametreyi ayarlayın.
• İsteği POST yöntemini kullanarak gönderiyorsanız istek gövdesinde bu parametreyi ayarlayın.

POST yöntemini kullanarak sorgulama

Path:
    /api/environment/{environmentId}/onhand/indexquery
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Body:
    {
        dimensionDataSource: string, # Optional
        filters: {
            organizationId: string[],
            productId: string[],
            siteId: string[],
            locationId: string[],
            [dimensionKey:string]: string[],
        },
        groupByValues: string[],
        returnNegative: boolean,
    }

Aşağıdaki örnekte, POST yöntemini kullanarak Stok Görünürlüğü'ne gönderilebilen dizin sorgusu istek gövdesinin nasıl oluşturulacağı gösterilmektedir.

{
    // OnHand Index Query fields
    "filters": {
        "organizationId": ["usmf"],
        "productId": ["Bike"],
        "SiteId": ["1"],
        "LocationId": ["11"]
    },
    "groupByValues": ["ColorId", "SizeId"],
    "returnNegative": true,

    // ATP related fields
    "QueryATP":true,
    "ATPFromDate": "2022-02-01",
    "ATPToDate": "2022-02-10",
}

GET yöntemini kullanarak sorgulama

Path:
    /api/environment/{environmentId}/onhand
Method:
    Get
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Query(Url Parameters):
    groupBy
    returnNegative
    [Filters]

Aşağıdaki örnekte, GET isteği olarak dizin sorgusu istek URL'sinin nasıl oluşturulacağı gösterilmektedir.

https://inventoryservice.{RegionShortName}-il301.gateway.prod.island.powerapps.com/api/environment/{EnvironmentId}/onhand?organizationId=usmf&productId=Bike&SiteId=1&LocationId=11&groupBy=ColorId,SizeId&returnNegative=true&QueryATP=true&ATPToDate=2022-02-01&ATPToDate=2022-02-10

Bu GET isteğin sonucu, önceki örnekteki isteğin POST sonucuyla tamamen aynıdır.

POST yöntemini kullanarak tam sorgulama

Tam bir sorgu ayarlamak için ATP ile ilgili alanları sorgu gövdesine ekleyin. Daha fazla bilgi için bkz. Post yöntemini kullanarak tam sorgu.

{
    // Exact query fields
    // ...

    // ATP related fields
    "QueryATP":true,
    "ATPFromDate": "2022-02-01",
    "ATPToDate": "2022-02-10",
}

Sorgu sonucu örneği

Önceki sorgu örneklerinin tümü aşağıdaki yanıtı oluşturabilir. Bu örnekte, sistem aşağıdaki ayarlarla yapılandırılır:

• ATP hesaplanan ölçüsü:iv.eldeki = pos.gelen – pos.giden
• Program dönemi:7

Burada yanıt gövdesi için bir örnek yer almaktadır.

[
    {
        "quantitiesByDate": {
            "2022-02-02T00:00:00": {
                "pos": {
                    "outbound": 5,
                    "inbound": 0,
                },
                "iv": {
                    "onhand": -5,
                },
            },
            "2022-02-06T00:00:00": {
                "pos": {
                    "inbound": 7,
                    "outbound": 0,
                },
                "iv": {
                    "onhand": 7,
                },
            }
        },
        "atpQuantities": {
            "2022-02-01T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-02T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-03T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-04T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-05T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-06T00:00:00Z": {
                "iv": {
                    "onhand": 12.0
                }
            },
            "2022-02-07T00:00:00Z": {
                "iv": {
                    "onhand": 12.0
                }
            }
        },
        "productId": "Bike ",
        "dimensions": {
            "ColorId": "Red",
            "SizeId": "Big",
            "siteid": "1",
            "locationid": "11"
        },
        "quantities": {
            "pos": {
                "inbound": 10.0,
                "outbound": 0,
            },
            "iv": {
                "onhand": 10.0,
            }
        }
    }
]