Breytingaáætlun á lager og ATP-afhendingarspá Inventory Visibility

Grein
05/29/2024

Þessi grein lýsir því hvernig á að setja upp viðskiptaáætlun eiginleikann til að skipuleggja framtíðar breytingar á hendi og reikna út magn sem er tiltækt til að lofa (ATP). ATP er magn vöru sem er tiltækt og hægt er að lofa viðskiptavinum á næsta tímabili. Notkun þessa útreiknings getur aukið til muna uppfyllingargetu pöntunar.

Fyrir marga framleiðendur, smásala eða seljendur er það ekki nóg bara að vita hvað er til staðar. Þeir verða að hafa fullan sýnileika yfir tiltækileika í framtíðinni. Þetta framtíðarframboð ætti að taka tillit til framboðs, eftirspurnar og ATP í framtíðinni.

Reiknaðir mælikvarðar fyrir ATP magn

ATP útreiknuð mælikvarði er fyrirfram skilgreind útreiknuð mælikvarði sem er venjulega notaður til að finna það magn sem er í boði núna. framboðsmagnið er summa magns fyrir þær líkamlegu mælingar sem hafa breytugerð samlagning, og eftirspurnarmagn er summan af stærðum fyrir þá eðlisfræðilegu mælikvarða sem hafa breytitegundina frádrátt.

Þú getur bætt við mörgum reiknuðum mælingum til að reikna út ólíkt magn ATP. Hins vegar ætti heildarfjöldi mismunandi efnislegra ráðstafana á öllum ATP reiknuðum ráðstöfunum að vera minni en níu.

Mikilvægt

Reiknuð mæling er samsetning efnislegra mælinga. Formúla þess getur aðeins falið í sér efnislegar mælieiningar án tvítekninga, ekki reiknaðar mælingar.

Til dæmis er hægt að setja upp eftirfarandi reiknuð mæling:

Til staðar = (PhysicalInvent + OnHand + Ótakmarkað + Gæðaskoðun + Á heimleið) – (ReservPhysical + SoftReservePhysical + Útleið)

Summan (PhysicalInvent + OnHand + Ótakmarkað + Gæðaskoðun + Á heimleið) táknar framboð og summan (ReservPhysical + SoftReservePhysical + Útleið) táknar eftirspurn. Því er hægt að skilja reiknaða mælingu á eftirfarandi hátt:

Fáanlegt = Framboð – eftirspurn

Þú getur bætt við annarri útreiknuðum mælikvarða til að reikna út Á hendi líkamlegt ATP magn.

Á hendi-líkamlegt = (PhysicalInvent + OnHand + Ótakmarkað + Gæðaskoðun + Á heimleið) – (Á heimleið)

Það eru átta mismunandi líkamlegar mælingar á þessum tveimur ATP reiknuðu mælikvarða: PhysicalInvent, OnHand, Ótakmarkað, Gæðaskoðun, Á heimleið, ReservPhysical, SoftReservePhysical og Útleið.

Fyrir frekari upplýsingar um reiknaðar mælikvarða, sjá Reiknaðar mælikvarðar.

Kveiktu á og settu upp breytingaáætlun og ATP í UI útgáfu 2

Þessi hluti á við þegar þú ert að nota Inventory Visibility UI útgáfu 2.

Áður en hægt er að nota ATP þarf að setja upp eina eða fleiri reiknaðar mælingar til að reikna út magn ATP. Þú verður einnig að kveikja á eiginleikanum og stilla ATP stillingar í Microsoft Power Apps.

Fylgdu þessum skrefum til að kveikja á viðskiptaáætlun eiginleikanum í Power Apps og stilla ATP stillingarnar.

Skráðu þig inn á Power Apps og opnaðu Inventory Visibility appið.
Á yfirlitsrúðunni skaltu velja Eiginleikastjórnun.
Veldu Stjórna á Lagt til að lofaflisunni.
Stilltu Virkja eiginleika valkostinn á True til að kveikja á ATP eiginleikanum.
Stilltu Tímaáætlun í 180 daga valkostinn á True til að styðja við lengri ATP áætlunartímabilið (180 dagar).

Mikilvægt

Sjálfgefið er að ATP eiginleiki er takmarkaður við sjö daga. Sjö daga ATP og 180 daga ATP eiginleikarnir eru aðskildir og óháðir hver öðrum. Tímasetningar breytingar sem þú býrð til eða breytir með því að nota sjö daga ATP eiginleikann munu ekki taka gildi þegar þú kveikir á 180 daga ATP eiginleikanum. Ef þú hefur notað sjö daga ATP eiginleikann og vilt flytja yfir í 180 daga eiginleikann, mælum við með því að þú eyðir gömlu gögnunum og endurbirtir skiptaáætlun þína fyrir hendi eftir að þú hefur virkjað 180 daga eiginleikann.
Stilltu reitinn Hámarks áætlunartímabil (dagar) á fjölda daga sem notendur geta skoðað og sent inn áætlaðar breytingar á hendi. Notendur sem biðja um hlutabréfaupplýsingar munu fá birgðamagn, áætlaðar breytingar á hendi og ATP fyrir hvern dag á skilgreindu tímabili, frá og með núverandi dagsetningu. Hámarksgildi fyrir þennan reit er 180 dagar. Sjálfgefið er það stillt á 30 daga. Þess vegna geturðu tímasett breytingar í allt að 30 daga frá deginum í dag.

Mikilvægt

Áætlunartímabilið inniheldur núverandi dagsetningu. Því geta notendur skipulagt breytingar á lager hvenær sem er frá núverandi (deginum sem breytingin er send inn) í gegnum (áætlunartímabil – 1) daga fram í tímann.
Í kaflanum Skrá ráðstafanir skaltu setja upp áætlunarráðstafanir. Þú getur notað fyrirliggjandi reiknaðar mælikvarða sem áætlunarmælingar, eða þú getur búið til nýjar. Þegar spurt er um Birgðasýnileika er ATP-gildið gefið upp fyrir skilgreindar reiknaðar mælikvarða, byggt á áætlaðum breytingum á efnislegum mælikvarða íhluta. Í kaflanum Tímaáætlunarráðstafanir veljið Nýja staðbundna breytingaáætlunarstillingu V2 á tækjastikunni til að bæta við nýjum reiknað mælikvarða bindingu fyrir ATP. Reiknuð mælikvarði er það sem þú vilt nota til að finna tiltækt magn sem er í boði. Fyrir upplýsingar um hvernig á að búa til reiknaða mælikvarða, sjá Reiknaðar mælikvarðar.

Mikilvægt

Sjálfgefin ATP reiknuð formúla er til viðmiðunar. Þú getur breytt og bætt við öðrum gagnaheimildum og líkamlegum ráðstöfunum til að setja upp réttan ATP útreikning fyrir fyrirtæki þitt.
Í ATP index set configuration hlutanum skaltu setja upp ATP vísitöluna þína. ATP vísitalan líkist afurðavísitölustigveldinu sem gerir þér kleift að flokka niðurstöður fyrirspurna eftir tilteknum víddum. Til dæmis, ef þú stillir ColorId og SizeId sem ATP vísitölusettið þitt, verða niðurstöður fyrirspurna flokkaðar eftir litum og stærð. Þú getur haft mörg vísitölusett.

Mikilvægt

Sjálfgefin ColorId og SizeId vísitalan er til viðmiðunar. Þú getur fjarlægt víddir og bætt við öðrum víddum.
Veljið Vista.
Þegar þú hefur lokið við að stilla allar nauðsynlegar stillingar skaltu velja Uppfæra stillingar undir Stjórnendastillingar á yfirlitsrúðunni.

Fyrir frekari upplýsingar, sjá Ljúka við og uppfæra stillinguna.

Kveiktu á og settu upp breytingaáætlun og ATP í UI útgáfu 1

Þessi hluti á við þegar þú ert að nota Inventory Visibility UI útgáfu 1.

Fylgdu þessum skrefum til að kveikja á viðskiptaáætlun eiginleikanum í Power Apps og stilla ATP stillingarnar.

Skráðu þig inn á Power Apps og opnaðu Inventory Visibility appið.
Opnaðu Stillingar síðuna.
Á flipanum Eiginleikastjórnun skaltu kveikja á Fáanlegt til að lofa eiginleikanum.
Veldu flipann ATP Stilling .
Þegar þú leggur fyrirspurn fyrir Inventory Visibility mun það veita niðurstöðu sem inniheldur hverja ATP reiknaða mælingu sem þú bætir við hér. Veldu Bæta við til að bæta við nýrri reiknuðum mælikvarða fyrir ATP.
Stilltu eftirfarandi svæði:
- Gagnaheimild – Veldu gagnagjafann sem er tengdur útreiknuðu mælikvarðanum.
- Reiknuð mælikvarði – Veldu reiknaða mælikvarða sem er tengdur völdum gagnagjafa og sem þú vilt nota til að finna tiltækt magn sem er tiltækt.
- Áætlunartímabil – Sláðu inn fjölda daga sem notendur geta skoðað og sent inn áætlaðar breytingar á hendi þegar valinn reiknaður mælikvarði er notaður. Notendur sem biðja um upplýsingar um birgðir fá magn á lager, áætlaðar breytingar á lager og ATP fyrir hvern dag á því tímabili sem hefjast á núverandi degi. Veldu heiltala á bilinu 1 til 7.
Mikilvægt

Áætlunartímabilið inniheldur núverandi dagsetningu. Því geta notendur skipulagt breytingar á lager hvenær sem er frá núverandi (deginum sem breytingin er send inn) í gegnum (áætlunartímabil – 1) daga fram í tímann.
Veljið Vista.
Endurtakið skref 5 til 7 þar til öllum reiknaðar mælingar sem þarf fyrir ATP hefur verið bætt við.
Þegar þú hefur lokið við að stilla allar nauðsynlegar stillingar skaltu velja Uppfæra stillingar.

Hvernig breytingaráætlun á lager og ATP útreikninga virka

áhugaverð breytingaáætlun tilgreinir væntanlegar dagsetningar og magn áætlaðra breytinga. Þú getur sent inn áætlun um breytingar á birgðum í Birgðasýnileika, að því tilskildu að dagsetningarnar séu innan þess tímabils sem er skilgreint af Tímaáætlunartímabilinu stillingunni (sjá Virkja og setja upp eiginleika hluta þessarar greinar). Notendur sem biðja um upplýsingar um birgðir fá magn á lager, áætlaðar breytingar á lager og ATP fyrir hvern dag á því tímabili.

Áætlaðar breytingar eru í upphafi ósamþykktar og hafa því ekki áhrif á raunverulegt magn á lager í kerfinu. Til að framfylgja breytingunum verður þú að senda inn viðskiptaviðburð, sem uppfærir raunverulegt tiltækt magn á lager. Þú verður að breyta áætlaðri breytingu aftur með því að senda inn breytingaráætlun á lager fyrir samsvarandi neikvætt magn.

Til dæmis er hægt að panta 10 reiðhjól og reikna með að það komi á morgun. Þess vegna getur þú sent inn breytingaráætlun um lagerbirgðir sem hefur magnið 10 og er dagsett fyrir morgundaginn. Þegar pöntunin berst næsta dag bætir þú reiðhjólunum við efnislegar lagerbirgðir. Þú verður þá að framkvæma breytingu á kerfinu þínu til að uppfæra raunverulegar lagerbirgðir. Til að gera breytinguna sendir þú inn breytingartilvik á lager sem hefur magn á innleið sem nemur 10. Þú afturkallar síðan áætlaða breytingu með því að senda inn breytingaráætlun á lager sem hefur innflutt magn -10.

Þegar þú sendir fyrirspurn til Inventory Visibility fyrir magn á lager og ATP-magn, skilar það eftirfarandi upplýsingum fyrir hvern dag á áætlunartímabilinu:

Dagsetning – Dagsetningin sem niðurstaðan á við. Tímabeltið er Samræmdur heimstími (UTC).
Magn á lager – Raunverulegt magn á lager fyrir tilgreinda dagsetningu. Þessi útreikningur er gerður í samræmi við ATP reiknaða mælikvarða sem er stilltur fyrir Birgðasýnileika.
Áætlað framboð – Samtala alls áætlaðs magns á heimleið sem hefur ekki orðið efnislega tiltækt til tafarlausrar neyslu eða sendingar frá tilgreindri dagsetningu.
Áætluð eftirspurn – Samtala alls áætlaðs útgangsmagns sem hefur ekki verið neytt eða sent frá tilgreindri dagsetningu.
ATP magn – Lágmarks áætluð magn af birgðum sem er tiltækt frá tilgreindri dagsetningu til loka áætlunartímabilsins. Þetta magn inniheldur allar áætlaðar magnleiðréttingar. Það er hámarksmagnið sem hægt er að lofa á þeim degi sem afhending eða notkun á sér stað þann daginn.

Ef núverandi dagsetning er t.d. 1. febrúar 2022 og áætlað tímabil er 7. geta notendur sent inn áætlaðar breytingar á lager sem gert er ráð fyrir að verði frá 1. febrúar til og með 7. febrúar 2022. Í þessu tilviki er ATP-magnið fyrir t.d. 3. febrúar reiknað út frá magni á lager þann dag og áætluðu magni frá 3. febrúar til og með 7. febrúar.

Dæmi

Eftirfarandi dæmi sýnir hvernig röð breytinga á áætluðu magni hefur áhrif á magn á lager og ATP sem Inventory Visibility greinir frá. Hún sýnir einnig hvernig á að gera áætlaða breytingu, hvaða áhrif staðfest breyting hefur á niðurstöðurnar og hvað getur átt sér stað ef þú gerir ekki áætlaða breytingu.

Niðurstöður í þessu dæmi sýna ávísað á hendi gildi. Þetta gildi felur í sér allar áætlaðar uppfærslur til skýringar en er í raun ekki tilkynnt þegar þú sendir fyrirspurn til Inventory Visibility.

Eftirfarandi stillingar eru stilltar fyrir kerfið þitt á ATP stillingum síðunni í Inventory Visibility appinu í Power Apps:
- Áætlunarráðstafanir – Hér er bætt við reiknuðum mælikvarða sem heitir Á hendi . Það er reiknað sem Veitt = Framboð – eftirspurn.
- Hámarksáætlunartímabil (dagar) – Gildið er stillt á 7.
- ATP vísitölustillingar – ColorId og SizeId er bætt við hér.
Eftirfarandi skilyrði gilda einnig:
- Núverandi dagsetning er 1. febrúar 2022.
- Núverandi magn á lager er 20.

Fyrir núverandi dagsetningu (1. febrúar 2022) sendir þú áætlað magn eftirspurnar upp á 3 til Inventory Visibility. Þess vega er áætlað magn á lager 17. Eftirfarandi tafla sýnir niðurstöðuna.

Dagsetning	Á lager	Áætluð eftirspurn	Áætluð lagerstaða	ATP
02-01-2022	20	3	17	17
02-02-2022	20		17	17
02-03-2022	20		17	17
02-04-2022	20		17	17
02-05-2022	20		17	17
02-06-2022	20		17	17
02-07-2022	20		17	17

Á núverandi degi (1. febrúar 2022) leggur þú fram áætlaðan birgðamagn upp á 10 fyrir 3. febrúar 2022. Eftirfarandi tafla sýnir niðurstöðuna.

Dagsetning	Á lager	Áætlað framboð	Áætluð eftirspurn	Áætluð lagerstaða	ATP
02-01-2022	20		3	17	17
02-02-2022	20			17	17
02-03-2022	20	10		27	27
02-04-2022	20			27	27
02-05-2022	20			27	27
02-06-2022	20			27	27
02-07-2022	20			27	27

Á núverandi dagsetningu (1. febrúar 2022) sendir þú inn eftirfarandi breytingar á áætluðu magni:

Eftirspurnarmagn 15 fyrir 4. febrúar 2022
Framboðsmagn 1 fyrir 5. febrúar 2022
Framboðsmagn 3 fyrir 6. febrúar 2022

Eftirfarandi tafla sýnir niðurstöðuna.

Dagsetning	Á lager	Áætlað framboð	Áætluð eftirspurn	Áætluð lagerstaða	ATP
02-01-2022	20		3	17	12
02-02-2022	20			17	12
02-03-2022	20	10		27	12
02-04-2022	20		sept	12	12
02-05-2022	20	1		13	13
02-06-2022	20	3		16	16
02-07-2022	20			16	16

Á núverandi degi (1. febrúar 2022) sendir þú áætlað magn eftirspurnar 3. Þess vegna verður þú að skuldbinda þig til að gera þessa breytingu þannig að hún endurspeglist í raunverulegu magni lagerbirgða. Til að gera breytinguna sendir þú inn breytingartilvik á lager sem hefur magn á útleið sem nemur 3. Þú afturkallar síðan áætlaða breytingu með því að senda inn breytingaráætlun á lager sem hefur útflutt magn -3. Eftirfarandi tafla sýnir niðurstöðuna.

Dagsetning	Á lager	Áætlað framboð	Áætluð eftirspurn	Áætluð lagerstaða	ATP
02-01-2022	17		0	17	12
02-02-2022	17			17	12
02-03-2022	17	10		27	12
02-04-2022	17		sept	12	12
02-05-2022	17	1		13	13
02-06-2022	17	3		16	16
02-07-2022	17			16	16

Næsta dag (2. febrúar 2022) færist áætlunartímabilið fram um einn dag. Eftirfarandi tafla sýnir niðurstöðuna.

Dagsetning	Á lager	Áætlað framboð	Áætluð eftirspurn	Áætluð lagerstaða	ATP
02-02-2022	17			17	12
02-03-2022	17	10		27	12
02-04-2022	17		sept	12	12
02-05-2022	17	1		13	13
02-06-2022	17	3		16	16
02-07-2022	17			16	16
02-08-2022	17			16	16

Tveimur dögum síðar (4. febrúar 2022) hefur framboðsmagnið af 10 sem áætlað var að yrði 3. febrúar hins vegar enn ekki borist. Eftirfarandi tafla sýnir niðurstöðuna.

Dagsetning	Á lager	Áætlað framboð	Áætluð eftirspurn	Áætluð lagerstaða	ATP
02-04-2022	17		sept	2	2
02-05-2022	17	1		3	3
02-06-2022	17	3		6	6
02-07-2022	17			6	6
02-08-2022	17			6	6
02-09-2022	17			6	6
02-10-2022	17			6	6

Eins og sjá má hafa áætlaðar (en ekki skuldbundnar) breytingar á lagerbirgðum ekki áhrif raunverulegt magn lagerbirgða.

Sendu breytingaráætlanir, breyttu atburði og ATP fyrirspurnir í gegnum API

Hægt er að nota eftirfarandi forritaskil (API) til að senda inn vefslóðir til að senda inn breytingaráætlanir á lager, breyta tilvikum og fyrirspurnum.

Slóð	Aðferð	Lýsing
`/api/environment/{environmentId}/onhand/changeschedule`	`POST`	Stofna eina áætlaða lagerbreytingu.
`/api/environment/{environmentId}/onhand/changeschedule/bulk`	`POST`	Stofna margar áætlaðar lagerbreytingar.
`/api/environment/{environmentId}/onhand`	`POST`	Stofna eitt tilvik lagerbreytinga.
`/api/environment/{environmentId}/onhand/bulk`	`POST`	Stofna mörg tilvik breytinga.
`/api/environment/{environmentId}/onhand/indexquery`	`POST`	Fyrirspurn með því að nota `POST` aðferðina.
`/api/environment/{environmentId}/onhand`	`GET`	Fyrirspurn með því að nota `GET` aðferðina.
`/api/environment/{environmentId}/onhand/exactquery`	`POST`	Nákvæm fyrirspurn með því að nota `POST` aðferðina.

Fyrir frekari upplýsingar, sjá Opinber API birgðasýnileiki.

Stofna breytingaráætlun á lager

Staðbundin breytingaáætlun er búin til með því að senda inn POST beiðni á viðkomandi vefslóð birgðasýnileikaþjónustu (sjá Senda breytingaáætlanir, breytingartilvik og ATP fyrirspurnir í gegnum API kafla). Einnig er hægt að senda inn magnbeiðnir.

Aðeins er hægt að búa til breytta áætlun á lager ef áætluð dagsetning er frá núverandi dagsetningu til loka yfirstandandi áætlunar. Datetime sniðið ætti að vera ár-mánuður-dagur (til dæmis 2022-02-01). Tímasniðið verður aðeins að vera nákvæmt til dagsins í dag.

Þetta API býr til eina breytingaráætlun á lager.

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

Eftirfarandi dæmi sýnir sýnishorn af efnisinnihaldi án dimensionDataSource.

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

Stofna margar áætlanir lagerbreytinga

Þetta API getur búið til margar færslur samtímis. Eini munurinn á þessu API og forritaskilum fyrir einn viðburð eru Path og Body gildin. Fyrir þetta API býður Body upp á fjölda skráa. Hámarksfjöldi skráa í hverri runu er 512. Því getur breytingaráætlun á lager fyrir magnútgáfu API stutt allt að 512 áætlaðar breytingar í einu.

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

Eftirfarandi dæmi sýnir sýnishorn um efni meginmáls.

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

Stofna tilvik lagerbreytinga

Breytingartilvik eru gerðar með því að senda inn POST beiðni á viðkomandi vefslóð birgðasýnileikaþjónustu (sjá Senda breytingaáætlanir, breytingartilvik og ATP fyrirspurnir í gegnum API kafla). Einnig er hægt að senda inn magnbeiðnir.

Nóta

Breytingatilvik á lager eru ekki einkvæmir fyrir eiginleika ATP en eru hluti af hinu hefðbundna API Inventory Visibility. Þetta dæmi hefur verið tekið með vegna þess að tilvik skipta máli þegar unnið er með ATP. Viðburðir breytinga á staðnum líkjast pöntunum fyrir breytinga á hendi, en viðburðarskilaboð verða að vera send á aðra API vefslóð og viðburðir nota quantities í stað quantityByDate í meginmáli skilaboðanna. Fyrir frekari upplýsingar um breytingatilvik og aðra eiginleika Inventory Visibility API, sjá Inventory Visibility public APIs.

Eftirfarandi dæmi sýnir meginmál beiðni sem inniheldur eitt breytingartilvik á lager.

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

Senda fyrirspurn um breytingar á lager og ATP niðurstöður

Hægt er að spyrjast fyrir um tímabundnar breytingar og ATP niðurstöður með því að senda annaðhvort POST beiðni eða GET beiðni á viðeigandi API vefslóð (sjá Senda inn breytingu) áætlanir, breytingar á atburðum og ATP fyrirspurnir í gegnum API hlutann).

Í beiðni þinni skaltu stilla QueryATP á true ef þú vilt spyrjast fyrir um tímabundnar breytingar og ATP niðurstöður. Sjálfgefið er að fyrirspurnin skilar öllum ATP-tengdum gögnum frá deginum í dag. Þú getur tilgreint ATPFromDate og ATPToDate til að þrengja niðurstöðurnar. („Til“ og „frá“ dagsetningar sía bara niðurstöðuna. Þær hafa ekki áhrif á hvernig ATP er reiknað út.)

Ef þú ert að senda inn beiðnina með því að nota GET aðferðina skaltu stilla þessa færibreytu í vefslóðinni.
Ef þú ert að senda inn beiðnina með því að nota POST aðferðina skaltu stilla þessa færibreytu í meginmáli beiðninnar.

Nóta

Óháð því hvort returnNegative færibreytan er stillt á true eða false í meginmáli beiðninnar, mun niðurstaðan innihalda neikvæð gildi þegar þú biður um áætlaðar breytingar á hendi og ATP niðurstöður. Þessi neikvæðu gildi verða tekin með vegna þess að ef aðeins eftirspurnarpöntun er áætluð, eða ef framboðsmagn er minna en eftirspurnarmagn, verður áætluð breyting á lager neikvæð. Ef neikvæð gildi væru ekki tekin með væru niðurstöðurnar ruglingslegar. Frekari upplýsingar um þennan valmöguleika og hvernig hann virkar fyrir aðrar gerðir fyrirspurna er að finna í Inventory Visibility public APIs.

Senda fyrirspurn með POST-aðferðinni

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

Eftirfarandi dæmi sýnir hvernig á að búa til meginmál vísitölufyrirspurnar sem hægt er að senda inn í Birgðasýnileika með því að nota POST aðferðina.

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

Senda fyrirspurn með GET-aðferðinni

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]

Eftirfarandi dæmi sýnir hvernig á að búa til vefslóð vísitölufyrirspurnarbeiðni sem GET beiðni.

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

Niðurstaðan úr þessari GET beiðni er nákvæmlega sú sama og niðurstaða POST beiðnarinnar í fyrra dæmi.

Nákvæm fyrirspurn með POST-aðferðinni

Til að setja upp nákvæma fyrirspurn skaltu bæta ATP-tengdum reitum við meginmál fyrirspurnarinnar. Fyrir frekari upplýsingar, sjá Nákvæm fyrirspurn með því að nota póstaðferðina.

{
    // Exact query fields
    // ...

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

Dæmi um niðurstöðu fyrirspurnar

Hvert og eitt af dæmum um fyrirspurn hér á undan gæti leitt til eftirfarandi svars. Þetta kerfi er til dæmis stillt með eftirfarandi stillingum:

ATP reiknaður mælikvarði:iv.onhand = pos.inbound – pos.outbound
Dagskrártímabil:7

Hér er dæmi um svarhlutann.

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

Deila með