Varaston näkyvyyden käytössä olevat muutosaikataulut ja luvattavissa olevat määrät

Artikkeli
02/01/2024

Tässä artikkelissa kuvataan, kuinka Käytössä oleva muutosaikataulu -ominaisuus määritetään tulevien ajankohtaisten muutosten ajoittamiseksi ja ATP-määrien laskemiseksi. ATP on tuotteen määrä, joka on saatavilla ja joka voidaan luvata asiakkaalle seuraavalla kaudella. Tämän laskelman käyttö voi lisätä tilauksen täyttämiskykyä merkittävästi.

Monille valmistajille, vähittäismyyjille tai myyjille ei riitä, että vain tietää, mitä on käytettävissä. Niillä on oltava täysi näkyvyys tulevaan käytettävyyteen. Tämän tulevan saatavuuden tulisi ottaa huomioon tuleva toimitus, tuleva kysyntä ja ATP.

ATP-määrien lasketut mitat

Laskettu ATP-mitta on ennalta määritetty laskettu mitta, jota käytetään yleensä saatavissa olevan käytettävissä olevan määrän etsimiseksi. Toimitusmäärä on määrien summa fyysisille mitoille, joiden määretyyppi on lisäys, ja kysynnän määrä on määrien summa fyysisille mitoille, joiden määretyyppi on vähennys.

Voit laskea useita ATP-määriä lisäämällä useita laskettuja määreitä. Kaikkien ATP-laskettujen erillisten fyysisten mittojen kokonaismäärän pitäisi kuitenkin olla alle yhdeksän.

Tärkeä

Laskettu mitta on fyysisten mittojen yhdistelmä. Sen kaava voi sisältää vain fyysisiä mittoja ilman kaksoiskappaleita, ei laskettuja mittoja.

Voit esimerkiksi määrittää seuraavan lasketun määreen:

Käytettävissä oleva= (PhysicalInvent + OnHand + Unresrealted + QualityInspection + Inbound) – (ReservPhysical + SoftReservePhysical + Outbound)

(PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) -määrä kuvaa tarjontaa ja (ReservPhysical + SoftReservePhysical + Outbound) -määrä kuvaa kysyntää. Lasketun määreen voi näin ollen ymmärtää seuraavasti:

Käytettävissä oleva tarjonta = – Kysyntä

Voit lisätä lasketun mitan laskeaksesi Käytettävissä olevan fyysisen ATP-määrän.

Varastosyksiköllinen = (PhysicalInvent + OnHand + Unresrealted + QualityInspection + Inbound) – (Lähtevä)

Kyseisissä kahdessa lasketussa ATP-mitassa on kahdeksan erillistä fyysistä mittaa: PhysicalInvent, OnHand, Unrestricted, QualityInspection, Inbound, ReservPhysical, SoftReservePhysical ja Outbound.

Lisätietoja lasketuista mittareista on kohdassa Lasketut mittarit.

Käytettävissä olevan varaston muutosaikataulun ja ATP:n käyttöönotto käyttöliittymäversiossa 2

Tämän osan tiedot pitävät paikkansa, kun käytössä on Varaston näkyvyys -sovelluksen käyttöliittymäversio 2.

Ennen ATP:n käyttöä on määritettävä vähintään yksi laskettu mitta ATP-määrien laskemiseksi. Ominaisuus on otettava myös käyttöön ja määritettävä ATP-asetukset Microsoft Power Appsissa

Seuraavia vaiheita noudattamalla voit ottaa käyttöön käytössä olevan muutoksen ajoitus -ominaisuuden Power Appsissa ja määrittää ATP-asetukset.

Kirjaudu Power Appsiin ja avaa Varaston näkyvyys -sovellus.
Valitse siirtymisruudussa Ominaisuuksien hallinta.
Valitse Luvattavissa oleva määrä -ruudussa Hallinta.
Määritä Ota ominaisuus käyttöön -asetuksen arvoksi Tosi, jos haluat ottaa ATP-ominaisuuden käyttöön.
Määritä Aikataulu 180 päivän ajalle -asetuksen arvoksi Tosi, jos haluat tukea tätä pidempää ATP-aikataulua (180 päivää).

Tärkeää

ATP-ominaisuus on rajoitettu seitsemään päivään oletusarvoisesti. Seitsemän päivän ATP-ominaisuus ja 180 päivän ATP-ominaisuus ovat erillisiä, toisistaan riippumattomia ominaisuuksia. Seitsemän päivän ATP-ominaisuuden avulla luodut tai muokatut aikataulumuutokset eivät ole voimassa, kun käyttöön otetaan 180 päivän ATP-ominaisuus. Jos olet käyttänyt seitsemän päivän ATP-ominaisuutta ja haluat siirtyä käyttämään 180 päivän ominaisuutta, vanhat tiedot kannattaa poistaa ja käytettävissä olevan varaston muutosaikataulu julkaista uudelleen 180 päivän ominaisuuden käyttöönoton jälkeen.
Määritä Aikataulun jakso enintään (päiviä) -kentän arvoksi niiden päivien määrä, joiden aikana käyttäjä voi tarkastella ajoitettuja käytettävissä olevan varaston muutoksia ja lähettää niitä. Varastotietoja kyselevät käyttäjät saavat käytettävissä olevan varaston määrän, ajoitetut käytettävissä olevan varaston muutokset ja ATP-tiedon jokaista määritetyn kauden päivää kohden kuluvasta päivämäärästä alkaen. Tämän kentän enimmäisarvo on 180 päivää. Oletusarvo on 30 päivää. Muutoksia voi siis ajoittaa jopa 30 päivän päähän kuluvasta päivästä.

Tärkeää

Aikataulukausi sisältää nykyisen päivämäärän. Siksi käyttäjät voivat ajoittaa käytettävissä olevan varastoajan muutoksia milloin tahansa kuluvasta päivästä alkaen (muutospäivämäärä) tulevana päivänä (aikataulutuskausi – 1).
Aikataulun mitat -osassa voit määrittää aikataulun mitat. Voit käyttää olemassa olevia laskettuja mittoja aikataulun mittoina tai voit luoda uusia mittoja. Kun Varaston näkyvyys -sovelluksessa tehdään kysely, ATP-arvo annetaan määritetyille lasketuille mitoille komponentin fyysisten mittojen ajoitettujen muutosten perusteella. Valitse Aikataulun mitat -osassa Uusi käytettävissä olevan varaston muutosaikataulun määritys V2 työkalurivillä, jos haluat lisätä uuden lasketun mitan sidonnan ATP:lle. Laskettu mitta on se, jota haluat käyttää tällä hetkellä käytettävissä olevan varastosaldon etsimisessä. Lisätietoja lasketun mitan luomisesta on kohdassa Lasketut mitat.

Tärkeää

ATP:n laskettu oletusmitta on käytettävissä vain viitteenä. Voit muokata tietolähteitä ja fyysisiä mittoja ja lisätä uusia määrittääksesi oikean ATP-laskelman liiketoimintaa varten.
Määritä ATP-indeksi ATP-indeksijoukon määritys -osassa. ATP-indeksi muistuttaa tuoteindeksihierarkiaa, jossa kyselytuloksia voi ryhmitellä tiettyjen dimensioiden mukaan. Jos esimerkiksi määrität ColorId- ja SizeId-kohdat ATP-indeksijoukoksi, kyselytulokset ryhmitellään värin ja koon mukaan. Indeksijoukkoja voi olla useita.

Tärkeää

ColorId- ja SizeId-oletusindeksi on käytettävissä vain viitteenä. Voit poistaa ja lisätä dimensioita.
Valitse Tallenna.
Kun kaikki vaaditut asetukset on määritetty, valitse siirtymisruudussa Järjestelmänvalvojan asetukset -kohdassa Päivitä määritys.

Lisätietoja on kohdassa Viimeistele ja päivitä määritys.

Käytettävissä olevan varaston muutosaikataulun ja ATP:n käyttöönotto käyttöliittymäversiossa 1

Tämän osan tiedot pitävät paikkansa, kun käytössä on Varaston näkyvyys -sovelluksen käyttöliittymäversio 1.

Seuraavia vaiheita noudattamalla voit ottaa käyttöön käytössä olevan muutoksen ajoitus -ominaisuuden Power Appsissa ja määrittää ATP-asetukset.

Kirjaudu Power Appsiin ja avaa Varaston näkyvyys -sovellus.
Avaa Määritykset-sivu.
Ota Luvattavissa oleva määrä -ominaisuus käyttöön Ominaisuuksien hallinta -välilehdessä.
Valitse ATP-asetukset-välilehti.
Kun teet kyselyn varaston näkyvyydestä, tuloksena on tulos, joka sisältää jokaisen tähän lisättävän ATP-lasketun mitan. Valitse Lisää lisätäksesi uuden lasketun mittarin APT:hen.
Määritä seuraavat kentät:
- Tietolähde – Valitse laskettuun mittariin liittyvä tietolähde.
- Laskettu mitta – Valitse valittuun tietolähteeseen liittyvä laskettu mitan määrä, jota haluat käyttää käytettävissä olevan käytettävissä olevan määrän etsimiseen.
- Aikataulutuskausi – Määritä, kuinka monta päivää käyttäjä voi tarkastella ja lähettää ajoitettuja käytettävissä olevan määrän muutoksia, kun valittua laskettua mittaria käytetään. Varastotietoja kyselevät käyttäjät saavat käytettävissä olevan varaston määrän, ajoitetut käytettävissä olevan varaston muutokset ja ATP-tiedon jokaista tämän kauden päivää kohden kuluvasta päivämäärästä alkaen. Valitse kokonaisluku väliltä 1 – 7.
Tärkeä

Aikataulukausi sisältää nykyisen päivämäärän. Siksi käyttäjät voivat ajoittaa käytettävissä olevan varastoajan muutoksia milloin tahansa kuluvasta päivästä alkaen (muutospäivämäärä) tulevana päivänä (aikataulutuskausi – 1).
Valitse Tallenna.
Toista vaiheet 5 - 7, kunnes olet lisännyt kaikki ATP:hen vaadittavat laskettavat mitat.
Kun olet määrittänyt kaikki tarvittavat asetukset, valitse Päivityskonfiguraatio.

Miten käytössä oleva muutosaikataulu ja ATP-laskelmat toimivat

Käytettävissä oleva muutossuunnitelma näyttää suunniteltujen varastomuutosten odotetut päivämäärät ja määrät. Voit lähettää käytettävissä olevan varaston näkyvyyden muutosaikataulun, jos päivämäärät ovat ajoituskauden asetuksen määrittämän kauden sisällä (katso Ota käyttöön ja määritä ominaisuudet -osa tässä artikkelissa). Varastotietoja kyselevät käyttäjät saavat käytettävissä olevan varaston määrän, ajoitetut käytettävissä olevan varaston muutokset ja ATP-tiedon tämän kauden kunakin päivänä.

Ajoitetut muutokset ovat aluksi sitomattomia, eivätkä ne siksi vaikuta todellisiin, järjestelmän käytettävissä oleviin määriin. Muutokset voi tehdä lähettämällä käytettävissä olevan vaihtotapahtuman, joka päivittää todellisen käytettävissä olevan varastomäärän. Tämän jälkeen ajoitettu muutos on muutettava lähettämällä vastaavalle negatiiviselle määrälle käytettävissä olevan muutoksen aikataulu.

Teet esimerkiksi tilauksen kymmenestä pyörästä ja odotat sen saapuvan huomenna. Näin ollen lähetät käytettävissä olevan vaihtoaikataulun, jonka saapuva määrä on 10 ja jonka päivämäärä on huominen. Kun tilaus saapuu seuraavana päivänä, lisäät sen fyysiseen käytettävissä olevaan varastoon. Muutos on sitten tehtävä järjestelmään, jotta todellinen käytettävissä oleva määrä päivittyy. Voit tehdä muutoksen lähettämällä käytettävissä olevan vaihtotapahtuman, jonka saapuva määrä on 10. Tämän jälkeen ajoitettu muutos muutetaan lähettämällä ajantasainen muutosaikataulu, jonka saapuvien määrä on -10.

Kun teet kyselyn käytettävissä olevan varaston ja ATP-määrän varastonäkyvyydestä, se palauttaa seuraavat tiedot jokaista aikataulukauden päivää varten:

Päivämäärä – Päivämäärä, jolloin tulos on voimassa. Aikavyöhyke on UTC-muodossa.
Käytettävissä oleva määrä – todellinen käytettävissä oleva määrä määritettynä päivämääränä. Tämä laskelma tehdään Varaston näkyvyys -sovellusta varten määritetyn ATP:n lasketun mitan mukaan.
Ajoitettu toimitus – Niiden suunniteltujen saapuvien määrien summa, jotka eivät ole fyysisesti käytettävissä välitöntä kulutusta tai lähetystä varten määritettynä päivämääränä.
Ajoitettu kysyntä – Kaikkien ajoitettujen lähtevien määrien summa, joita ei ole kulutettu tai lähetetty määritettynä päivämääränä.
ATP-määrä – Pienin arvioitu käytettävissä oleva määrä, joka on käytettävissä määritetystä päivämäärästä ajoituskauden loppuun. Tämä määrä sisältää kaikki ajoitetun määrän oikaisut. Se on enimmäismäärä, joka voidaan luvata kuluvana päivänä toimitusta tai kulutusta varten tuona päivänä.

Jos nykyinen päivämäärä on esimerkiksi 1.2.2022 ja aikataulukausi on 7, käyttäjät voivat lähettää ajoitettuja käytettävissä olevia varastomuutoksia, joiden odotetaan tapahtuvan 1.2.–7.2.2022. Tällöin esimerkiksi 3. helmikuuta päivälle laskettu ATP-määrä lasketaan tämän päivän käytettävissä olevan määrän ja ajoitettujen määrien perusteella 3.2. - 7.2.

Esimerkki

Seuraavassa esimerkissä kerrotaan, miten ajoitettujen määrän muutosten sarja vaikuttaa varaston näkyvyysraporttien käytettävissä olevan varaston määriin ja ATP-määriin. Siinä kerrotaan myös, miten ajoitettu muutosvahvistus tehdään, miten sidottu aikataulun muutos vaikuttaa tuloksiin ja mitä tuloksia voi tapahtua, jos ajoitettua muutosta ei vahvisteta.

Tämän esimerkin tuloksissa näkyy arvioitu käytettävissä oleva arvo. Tämä arvo sisältää kaikki ajoitetut päivitykset havainnollistusta varten, mutta sitä ei todellisuudessa raportoida varaston näkyvyyskyselyn yhteydessä.

Seuraavat asetukset on määritetty järjestelmääsi varten ATP-asetukset-sivulla Power Appsin Varaston näkyvyys -sovelluksessa.
- Aikataulun mitat: Tässä lisätään varastoksi nimetty laskettu mitan nimi. Se lasketaan seuraavasti: Käytettävissä oleva = tarjonta – kysyntä.
- Enimmäissuunnitelmakausi (päivinä) – Arvoksi määritetään 7.
- ATP-indeksijoukon konfiguraatio – ColorId ja SizeId lisätään tähän.
Seuraavat ehdot myös pätevät:
- Nykyinen päivämäärä on 1. helmikuuta 2022.
- Nykyinen käytettävissä oleva määrä on 20.

Kuluvana päivänä (1.2.2022) lähetät varaston näkyvyyteen suunnitellun tarvemäärän 3. Tällöin arvioitu käytettävissä oleva määrä on 17 nimikettä. Tulokset ovat seuraavassa taulukossa.

Päivämäärä	Käytettävissä oleva	Ajoitettu kysyntä	Arvioitu käytettävissä oleva varasto	ATP
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

Kuluvana päivänä (1. helmikuuta 2022) lähetät 3.2.2022 ajoitetun toimituksen, jonka määrä on 10. Tulokset ovat seuraavassa taulukossa.

Päivämäärä	Käytettävissä oleva	Ajoitettu toimitus	Ajoitettu kysyntä	Arvioitu käytettävissä oleva varasto	ATP
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

Kuluvana päivänä (1.2.2022) lähetät seuraavat ajoitetun määrän muutokset:

4. helmikuuta 2022 tarvemäärä 15
5. helmikuuta 2022 toimitusmäärä 1
6. helmikuuta 2022 toimitusmäärä 3

Tulokset ovat seuraavassa taulukossa.

Päivämäärä	Käytettävissä oleva	Ajoitettu toimitus	Ajoitettu kysyntä	Arvioitu käytettävissä oleva varasto	ATP
2022-02-01	20		3	17	12
2022-02-02	20			17	12
2022-02-03	20	10		27	12
2022-02-04	20		päivänä	12	12
2022-02-05	20	1		13	13
2022-02-06	20	3		16	16
2022-02-07	20			16	16

Kuluvana päivänä (1.2.2022) lähetät ajoitetun määrän, joka on 3. Tämä muutos on näin ollen tehtävä, jotta se heijastuu todelliseen käytettävissä olevaan määrään. Voit tehdä muutoksen lähettämällä käytettävissä olevan vaihtotapahtuman, jonka lähtevä määrä on 3. Tämän jälkeen ajoitettu muutos muutetaan lähettämällä ajantasainen muutosaikataulu, jonka lähtevien määrä on -3. Tulokset ovat seuraavassa taulukossa.

Päivämäärä	Käytettävissä oleva	Ajoitettu toimitus	Ajoitettu kysyntä	Arvioitu käytettävissä oleva varasto	ATP
2022-02-01	17		0	17	12
2022-02-02	17			17	12
2022-02-03	17	10		27	12
2022-02-04	17		päivänä	12	12
2022-02-05	17	1		13	13
2022-02-06	17	3		16	16
2022-02-07	17			16	16

Seuraavana päivänä (2.2.2022) aikataulukausi siirtyy eteenpäin yhdellä päivällä. Tulokset ovat seuraavassa taulukossa.

Päivämäärä	Käytettävissä oleva	Ajoitettu toimitus	Ajoitettu kysyntä	Arvioitu käytettävissä oleva varasto	ATP
2022-02-02	17			17	12
2022-02-03	17	10		27	12
2022-02-04	17		päivänä	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

Kaksi päivää myöhemmin (4. helmikuuta 2022) 3. helmikuuta ajoitettu toimitusmäärä 10 ei ole kuitenkaan saapunut. Tulokset ovat seuraavassa taulukossa.

Päivämäärä	Käytettävissä oleva	Ajoitettu toimitus	Ajoitettu kysyntä	Arvioitu käytettävissä oleva varasto	ATP
2022-02-04	17		päivänä	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

Ajoitetut (mutta ei sidotut) käytettävissä olevan määrän muutokset eivät vaikuta todelliseen käytettävissä olevaan varastomäärään.

Muutosaikataulujen, muutostapahtumien ja ATP-kyselyiden lähettäminen ohjelmointirajapinnan kautta

Seuraavien ohjelmointirajapinta (API) -URL-osoitteiden avulla voit lähettää käytettävissä olevan vaihto-ohjelman muutosaikatauluja, muutostapahtumia ja kyselyitä.

Polku	Tapa	Kuvaus
`/api/environment/{environmentId}/onhand/changeschedule`	`POST`	Yhden aikataulutetun käytettävissä olevan varastosaldon muutoksen luominen.
`/api/environment/{environmentId}/onhand/changeschedule/bulk`	`POST`	Useiden aikataulutettujen käytössä olevien varastosaldojen muutosten luominen.
`/api/environment/{environmentId}/onhand`	`POST`	Yhden käytössä olevan varastosaldon muutostapahtuman luominen.
`/api/environment/{environmentId}/onhand/bulk`	`POST`	Useiden muutostapahtumien luominen.
`/api/environment/{environmentId}/onhand/indexquery`	`POST`	`POST`-menetelmää käyttävä kysely.
`/api/environment/{environmentId}/onhand`	`GET`	`GET`-menetelmää käyttävä kysely.
`/api/environment/{environmentId}/onhand/exactquery`	`POST`	`POST`-menetelmää käyttävä tarkka kysely.

Lisätietoja on kohdassa Varaston näkyvyyden julkiset API:t.

Yhden aikataulutetun käytettävissä olevan varastosaldon muutoksen luominen

Varastomuutosaikataulu luodaan lähettämällä pyyntö url-osoitteen POST varaston näkyvyyspalvelu. Voit myös lähettää joukkopyyntöjä.

Käytettävissä olevan varastosaldon muutoksen aikataulua luotaessa päivämäärän on oltava kuluvan päivämäärän ja nykyisen ajoituskauden lopun välissä. Päivämäärä/aikamuodon tulisi olla vuosi-kuukausi-päivä (esimerkiksi 2022-02-01). Aikamuodon on oltava päivän tarkkuudella.

Tämä ohjelmointirajapinta luo yhden käytettävissä olevan varastosaldon muutosaikataulun.

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,
                },
            },
        },
    }

Seuraavassa esimerkissä on näytteen tekstisisältö ilman dimensionDataSource-arvoa.

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

Useiden käytössä olevien varastosaldojen muutosaikataulujen luominen.

Tällä ohjelmointirajapinnalla voidaan luoda useita tietueita samanaikaisesti. Ainoat erot tämän ohjelmointirajapinnan ja yhden tapahtuman ohjelmointirajapinnan välillä ovat arvot Path ja Body. Tässä ohjelmointirajapinnassa Body tuottaa tietuematriisin. Tietueiden enimmäismäärä on 512. Näin ollen käytössä olevan muutosaikataulun joukkotoiminto-ohjelmointirajapinta voi tukea enintään 512 ajoitettua muutosta kerralla.

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,
                    },
                },
            },
        },
        ...
    ]

Seuraavassa esimerkissä on näytteen tekstisisältö.

[
    {
        "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
                }
            }
        }
    }
]

Käytettävissä olevan varastosaldon muutostapahtumien luominen

Käsillä olevan muutoksen POST tapahtumat tehdään lähettämällä pyyntö asiaankuuluvaan URL-varaston näkyvyyspalvelu ( katso muutosaikataulujen lähettämisen, muutostapahtumien ja ATP-kyselyiden alkamista sovellusohjelmaliittymän osan kautta).

Muistiinpano

Käytettävissä olevan varaston muutoksen tapahtumat eivät ole yksilöllisiä ATP-toiminnoille, vaan ne kuuluvat varaston vakionäkyvyyden sovellusliittymään. Tämä esimerkki on sisällytetty, koska tapahtumat ovat merkityksellisiä, kun työskentelet ATP:n kanssa. Käytettävissä olevan varastomuutosten tapahtumat muistuttavat käytettävissä olevan varastomuutosten varauksia, mutta tapahtumasanomat on lähetettävä eri sovellusliittymän URL-osoitteeseen ja tapahtumat, joissa käytetään quantities-määritettä quantityByDaten sijaan sanoman rungossa. Lisätietoja käytettävissä olevan varaston muutostapahtumista ja muista Varaston näkyvyys -ohjelmointirajapinnan ominaisuuksista on ohjeaiheessa Varaston näkyvyys -ohjelmointirajapinnat.

Seuraava esimerkki näyttää yksittäisen käytettävissä olevan muutostapahtuman sisältävän esimerkkipyynnön tekstin.

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

Ajoitettujen käytössä olevien varastomuutosten ja ATP-tulosten kysely

Voit tehdä ajoitettujen varastomuutosten ja ATP-tulosten kyselyn lähettämällä joko POST-pyynnön tai GET-pyynnön asianmukaiseen API-URL-osoitteeseen (katso Muutosaikataulujen lähettäminen, muutostapahtumat ja ATP-kyselyt ohjelmointirajapintojen avulla -osa).

Valitse QueryATP-pyyntösi arvoksi Tosi, jos haluat kysellä ajoitettuja käytössä olevan varaston muutoksia ja ATP-tuloksia. Kysely palauttaa oletusarvoisesti kaikki ATP:hen liittyvät tiedot tältä päivältä. Voit tarkentaa tuloksia määrittämällä ATPFromDate- ja ATPToDate-arvon. (Päättymis- ja aloituspäivämäärät vain suodattavat tulokset. Ne eivät muuta tapaa, jolla ATP lasketaan.)

Jos lähetät pyynnön GET-menetelmällä, määritä tämä parametri URL-osoitteeseen.
Jos lähetät pyynnön POST-menetelmällä, määritä tämä parametri pyynnön runkoon.

Muistiinpano

Riippumatta siitä, onko returnNegative-parametrin pyyntöosaosassa tosi vai epätosi, tulos sisältää negatiiviset arvot, kun ajoitettuja käytössä olevan varaston muutoksia ja ATP-tuloksia pyydetään. Nämä negatiiviset arvot sisällytetään, koska jos vain tarvetilaukset ajoitetaan tai jos toimitusmäärät ovat pienempiä kuin tarvemäärät, ajoitetut käytettävissä olevan määrän muutosmäärät ovat negatiivisia. Jos negatiivisia arvoja ei sisällytetä, tulokset voivat aiheuttaa sekaannuksia. Lisätietoja tästä vaihtoehdosta ja sen toiminnasta muun tyyppisissä kyselyissä on ohjeaiheessa Varaston näkyvyys julkisissa ohjelmointirajapinnoissa.

POST-menetelmää käyttävä kysely

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,
    }

Seuraavassa esimerkissä kerrotaan, miten luodaan indeksikyselyn pyynnön tekstiosa, joka voidaan lähettää varaston näkyvyyteen POST-menetelmällä.

{
    // 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-menetelmää käyttävä kysely

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]

Seuraavassa esimerkissä kerrotaan, miten indeksikyselyn pyynnön URL-osoite luodaan GET-pyynnöksi.

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

Tämän pyynnön tulos GET on täsmälleen sama kuin edellisen POST esimerkin pyynnön tulos.

POST-menetelmää käyttävä tarkka kysely

Jos haluat määrittää tarkan kyselyn, lisää ATP:hen liittyviä kenttiä kyselyn tekstiosaan. Lisätietoja on kohdassa Post-menetelmää käyttävä tarkka kysely.

{
    // Exact query fields
    // ...

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

Kyselyn tuloksen esimerkki

Kumpi tahansa aiemmista kyselyesimerkeistä voi tuottaa seuraavan vastauksen. Tässä esimerkissä järjestelmä on määritetty seuraavilla asetuksilla:

ATP laskettu mittari:sidonta = pos.inbound – pos.outbound
Aikataulukausi: 7

Esimerkki vastauksen tekstiosasta.

[
    {
        "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,
            }
        }
    }
]

Jaa