Del via


Tidsplaner for lagerendringer i Lagersynlighet og leveringskapasitet

Denne artikkelen beskriver hvordan du konfigurerer funksjonen Tidsplan for lagerendring for å planlegge fremtidige endringer i lagerbeholdning og beregne ATP-antall (tilgjengelig for ordre). ATP er antallet av en vare som er tilgjengelig og kan loves til en kunde i løpet av den neste perioden. Bruk av denne beregningen kan øke kapasiteten for innfrielse av bestillinger betydelig.

For mange produsenter, forhandlere eller selgere er det ikke nok bare å vite hva som er i varebeholdningen for øyeblikket. De må ha full oversikt over fremtidig tilgjengelighet. Denne fremtidige tilgjengeligheten bør vurdere fremtidig forsyning, fremtidig etterspørsel og ATP.

Beregnede mål for ATP-antall

Beregnet ATP-mål er et forhåndsdefinert beregnet mål som vanligvis brukes til å finne lagerbeholdningen som for øyeblikket er tilgjengelig. Forsyningsantallet er summen av antall for de fysiske målene som har modifikatortypen tillegg, og behovsmengde er summen av antall for de fysiske målene som har typen subtraksjon.

Du kan legge til flere beregnede mål for å beregne flere ATP-antall. Det totale antallet distinkte fysiske mål i alle beregnede ATP-mål må imidlertid være mindre enn ni.

Viktig

Et beregnet mål er en sammensetning av fysiske mål. Formelen kan bare inneholde fysiske mål uten duplikater, ikke beregnede mål.

Du kan for eksempel sette opp følgende beregnede mål:

On-hand-available = (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) – (ReservPhysical + SoftReservePhysical + Outbound)

Summen av (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) representerer forsyning, og summen av (ReservPhysical + SoftReservePhysical + Outbound) representerer behov. Derfor kan det beregnede målet forstås på følgende måte:

On-hand-available = SupplyDemand

Du kan legge til et annet beregnet mål for å beregne det disponible fysiske ATP-antallet.

On-hand-physical = (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) – (Outbound)

Det finnes åtte atskilte, fysiske mål fordelt på de to ATP-beregnede målene: PhysicalInvent, OnHand, Unrestricted, QualityInspection, Inbound, ReservPhysical, SoftReservePhysical og Outbound.

Hvis du vil ha mer informasjon om beregnede mål, kan du se Beregnede mål.

Slå på og konfigurer endringsplanlegging av beholdning og ATP i grensesnittversjon 2

Denne delen gjelder når du bruker Lagersynlighet, grensesnittversjon 2.

Før du kan bruke ATP, må du definere ett eller flere beregnede mål for å beregne ATP-antallene. Du må også aktivere funksjonen og konfigurere ATP-innstillinger i Microsoft Power Apps.

Følg denne fremgangsmåten for å aktivere funksjonen Tidsplan for lagerendring i Power Apps og konfigurere ATP-innstillingene.

  1. Logg deg på Power Apps, og åpne Lagersynlighet-appen.

  2. I navigasjonsruten velger du Funksjonsbehandling.

  3. På flisen Tilgjengelig for ordre velger du Administrer.

  4. Sett Aktiver funksjon-alternativet til Sann for å slå på ATP-funksjonen.

  5. Sett Tidsplan for 180 dager-alternativet til Sann for å støtte den lengre ATP-tidsplanperioden (180 dager).

    Viktig

    Som standard er ATP-funksjonen begrenset til syv dager. Funksjonene for syv-dagers ATP og 180-dagers ATP er separate og uavhengige av hverandre. Planleggingsendringer som du oppretter eller endrer ved å bruke syv-dagers ATP-funksjonen, trer ikke i kraft når du slår på 180-dagers ATP-funksjonen. Hvis du har brukt syv-dagers ATP-funksjonen og ønsker å migrere til 180-dagers funksjonen, anbefaler vi at du sletter de gamle dataene og legger ut den tilgjengelige endringsplanen på nytt etter at du har aktivert 180-dagers funksjonen.

  6. Angi feltet Maks tidsplanperiode (dager) til antallet dager brukerne kan vise og sende inn planlagte endringer i lagerbeholdningen. Brukere som spør etter lagerinformasjon, vil få lagerbeholdningen, planlagte lagerbeholdningsendringer og ATP for hver dag i den definerte perioden, fra gjeldende dato. Maksimumsverdien for dette feltet er 180 dager. Som standard er det satt til 30 dager. Derfor kan du planlegge endringer i opptil 30 dager fra i dag.

    Viktig

    Tidsplanperioden inkluderer den gjeldende datoen. Derfor kan brukere planlegge at lagerbeholdningsendringer skal skje når som helst fra gjeldende dato (dagen når endringen sendes) til og med (tilsplanperioden – 1) dager i fremtiden.

  7. I delen Planlegg mål, sett opp planleggingsmål. Du kan bruke eksisterende beregnede mål som tidsplanmål, eller du kan opprette nye. Når du spør Lagersynlighet, oppgis ATP-verdien for definerte beregnede mål, basert på de planlagte endringene av komponentens fysiske mål. I delen Planlegg mål velger du Ny konfigurasjon for endringsplan for lagerbeholdning V2 på verktøylinjen for å legge til en ny beregnet målbinding for ATP. Det beregnede målet er det du ønsker å bruke for å finne tilgjengelig tilgjengelig antall. Hvis du vil ha informasjon om hvordan du oppretter et beregnet mål, kan du se Beregnede mål.

    Viktig

    Standard ATP-beregnet formel er til referanse. Du kan endre og legge til andre datakilder og fysiske mål for å sette opp riktig ATP-beregning for virksomheten din.

  8. I delen Indekssettkonfigurasjon for tilgjengelig for ordre, sett opp ATP-indeksen din. ATP-indeksen ligner på produktindekshierarkiet, der du kan gruppere søkeresultater etter spesifikke dimensjoner. For eksempel hvis du setter ColorId og SizeId som ATP-indekssett, vil søkeresultatene bli gruppert etter farge og størrelse. Du kan ha flere indekssett.

    Viktig

    Standard ColorId- og SizeId-indeks er for referanse. Du kan fjerne dimensjoner og legge til andre dimensjoner.

  9. Velg Lagre.

  10. Når du er ferdig med å konfigurere alle de nødvendige innstillingene, velger du Oppdater konfigurasjon under Administratorinnstillinger i navigasjonsruten.

Hvis du vil ha mer informasjon, kan du se Fullfør og oppdater konfigurasjonen.

Slå på og konfigurer endringsplanlegging av beholdning og ATP i grensesnittversjon 1

Denne delen gjelder når du bruker Lagersynlighet, grensesnittversjon 1.

Følg denne fremgangsmåten for å aktivere funksjonen Tidsplan for lagerendring i Power Apps og konfigurere ATP-innstillingene.

  1. Logg deg på Power Apps, og åpne Lagersynlighet-appen.

  2. Åpne Konfigurasjon-siden.

  3. På fanen Funksjonsbehandling aktiverer du funksjonen Tilgjengelig for ordre.

  4. Velg fanen ATP-innstillinger.

  5. Når spør Lagersynlighet, vil du få et resultat som inkluderer hvert beregnede ATP-mål som du legger til her. Velg Legg til for å legge til et nytt beregnet mål for ATP.

  6. Angi følgende felter:

    • Datakilde – Velg datakilden som er knyttet til det beregnede målet.
    • Beregnet mål – Velg det beregnede målet som er tilknyttet den valgte datakilden, og som du vil bruke til å finne tilgjengelig beholdningsantall.
    • Tidsplanperiode – Angi antallet dager brukerne kan vise og sende inn planlagte endringer i lagerbeholdningen når det valgte beregnede målet brukes. Brukere som spør etter lagerinformasjon, vil få lagerbeholdningen, planlagte lagerbeholdningsendringer og ATP for hver dag i denne perioden, og begynner med gjeldende dato. Velg et heltall mellom 1 og 7.

    Viktig

    Tidsplanperioden inkluderer den gjeldende datoen. Derfor kan brukere planlegge at lagerbeholdningsendringer skal skje når som helst fra gjeldende dato (dagen når endringen sendes) til og med (tilsplanperioden – 1) dager i fremtiden.

  7. Velg Lagre.

  8. Gjenta trinn 5 til 7 til du har lagt til alle de beregnede målene du trenger for ATP.

  9. Når du er ferdig med å konfigurere alle de nødvendige innstillingene, velger du Oppdater konfigurasjon.

Slik fungerer tidsplanen for lagerbeholdningsendring og ATP-beregninger fungerer

En endringsplan for lagerbeholdning fastsetter forventede datoer og antall for planlagte endringer i lagerbeholdning. Du kan sende inn en endringsplan for lagerbeholdning til Lagersynlighet, forutsatt at datoene er innenfor perioden som er definert av innstillingen Tidsplanperiode (se delen Aktiver og konfigurer funksjonene i denne artikkelen). Brukere som spør etter lagerinformasjon, vil få lagerbeholdningen, planlagte lagerbeholdningsendringer og ATP for hver dag i denne perioden.

Planlagte endringer er i utgangspunktet ikke iverksatt, og påvirker derfor ikke den faktiske lagerbeholdningen i systemet. Hvis du vil iverksette endringene, må du sende inn en lagerendringshendelse, som oppdaterer det faktiske antallet som er tilgjengelig på lager. Du må deretter tilbakeføre den planlagte endringen ved å sende inn en endringsplan for lagerbeholdning for et tilsvarende negativt antall.

Du legger for eksempel inn en ordre på 10 sykler og forventer at den kommer i morgen. Derfor sender du inn en tidsplan for lagerbeholdningsendring som har et innkommende antall på 10 og er datert for i morgen. Når ordren ankommer neste dag, legger du til syklene i den fysiske lagerbeholdningen. Deretter må du iverksette endringen i systemet for å oppdatere den faktiske lagerbeholdningen. For å iverksette endringen sender du inn en beholdningendringshendelse som har et innkommende antall på 10. Deretter tilbakefører du den planlagte endringen ved å sende inn en endringsplan som har et innkommende antall på -10.

Når spør Lagersynlighet etter beholdningsantall og ATP-antall, returneres følgende informasjon for hver dag i tidsplanperioden:

  • Dato – Datoen som resultatet gjelder for. Tidssonen er Coordinated Universal Time (UTC).
  • Antall på lager – Det faktiske beholdningsantallet for den angitte datoen. Denne beregningen foretas i henhold til det beregnede ATP-målet som er konfigurert for Lagersynlighet.
  • Planlagt forsyning – Summen av alle planlagte innkommende antall som ikke har blitt fysisk tilgjengelig for umiddelbart forbruk eller forsendelse per den angitte datoen.
  • Planlagt behov – Summen av alle planlagte utgående antall som ikke er brukt eller sendt per den angitte datoen.
  • ATP-antall – Det minste prosjekterte beholdningsantallet som er tilgjengelig fra den angitte datoen til slutten av planleggingsperioden. Dette antallet omfatter alle planlagte antallsjusteringer. Det er det maksimale antallet som kan loves på gjeldende dato for levering eller forbruk den dagen.

Hvis for eksempel gjeldende dato er 1. februar 2022 og planleggingsperioden er 7, kan brukere sende inn planlagte lagerbeholdninger som forventes å skje fra 1. februar til og med 7. februar 2022. I dette tilfellet beregnes ATP-antallet for 3. februar basert på lagerbeholdning for den dagen, og det planlagte antallet fra 3. februar til og med 7. februar.

Eksempel

Følgende eksempel viser hvordan en serie med endringer i planlagt antall påvirker lagerbeholdningen og ATP-antallet som lagersynsrapportene rapporterer. Det viser også hvordan du legger inn en planlagt endring, hvordan en igangsatt planendring påvirker resultatene og hva som kan skje hvis du ikke gjør noen planlagt endring.

Resultatene i dette eksemplet viser en prosjektert lagerbeholdning. Denne verdien inneholder alle planlagte oppdateringer til illustrasjonsformål, men vil faktisk ikke rapporteres når du spør etter lagersynlighet.

  1. Følgende innstillinger er konfigurert for systemet på siden ATP-innstilling i Lagersynlighet-appen i Power Apps:

    • Planlegg mål – Et beregnet mål som kalles Lagerbeholdning, legges til her. Det beregnes som Lagerbeholdning = ForsyningBehov.
    • Maks tidsplanperiode (dager) – Verdien er satt til 7.
    • Indekssettkonfigurasjon for tilgjengelig for ordreColorId og SizeId legges til her.
  2. Følgende betingelser gjelder også:

    • Gjeldende dato er 1. februar 2022.
    • Nåværende antall på lager er 20.
  3. For gjeldende dato (1. februar 2022) sender du inn et planlagt behovsantall på 3 til Lagersynlighet. Derfor er det prosjekterte beholdningsantallet 17. Tabellen nedenfor viser resultatet.

    Dato Beholdning Planlagt forsyning Planlagt behov Prosjektert lagerbeholdning ATP
    1. februar 2022 20 3 17 17
    2. februar 2022 20 17 17
    3. februar 2022 20 17 17
    4. februar 2022 20 17 17
    5. februar 2022 20 17 17
    6. februar 2022 20 17 17
    7. februar 2022 20 17 17
  4. På gjeldende dato (1. februar 2022) sender du inn et planlagt forsyningsantall på 10 for 3. februar 2022. Tabellen nedenfor viser resultatet.

    Dato Beholdning Planlagt forsyning Planlagt behov Prosjektert lagerbeholdning ATP
    1. februar 2022 20 3 17 17
    2. februar 2022 20 17 17
    3. februar 2022 20 10 27 27
    4. februar 2022 20 27 27
    5. februar 2022 20 27 27
    6. februar 2022 20 27 27
    7. februar 2022 20 27 27
  5. På gjeldende dato (1. februar 2022) sender du inn følgende endringer i planlagt antall:

    • Behovsantall på 15 for 4. februar 2022
    • Forsyningsantall på 1 for 5. februar 2022
    • Forsyningsantall på 3 for 6. februar 2022

    Tabellen nedenfor viser resultatet.

    Dato Beholdning Planlagt forsyning Planlagt behov Prosjektert lagerbeholdning ATP
    1. februar 2022 20 3 17 12
    2. februar 2022 20 17 12
    3. februar 2022 20 10 27 12
    4. februar 2022 20 sept. 12 12
    5. februar 2022 20 1 13 13
    6. februar 2022 20 3 16 16
    7. februar 2022 20 16 16
  6. På gjeldende dato (1. februar 2022) sender du det planlagte behovsantallet på 3. Derfor må du foreta denne endringen, slik at den gjenspeiles i det faktiske lagerbeholdningsantallet. For å iverksette endringen sender du inn en beholdningendringshendelse som har et utgående antall på 3. Deretter tilbakefører du den planlagte endringen ved å sende inn en endringsplan som har et utgående antall på -3. Tabellen nedenfor viser resultatet.

    Dato Beholdning Planlagt forsyning Planlagt behov Prosjektert lagerbeholdning ATP
    1. februar 2022 17 0 17 12
    2. februar 2022 17 17 12
    3. februar 2022 17 10 27 12
    4. februar 2022 17 sept. 12 12
    5. februar 2022 17 1 13 13
    6. februar 2022 17 3 16 16
    7. februar 2022 17 16 16
  7. Neste dag (2. februar 2022) forskyves tidsplanperioden fremover med én dag. Tabellen nedenfor viser resultatet.

    Dato Beholdning Planlagt forsyning Planlagt behov Prosjektert lagerbeholdning ATP
    2. februar 2022 17 17 12
    3. februar 2022 17 10 27 12
    4. februar 2022 17 sept. 12 12
    5. februar 2022 17 1 13 13
    6. februar 2022 17 3 16 16
    7. februar 2022 17 16 16
    8. februar 2022 17 16 16
  8. Men to dager senere (4. februar 2022) er forsyningsantallet på 10 som var planlagt for 3. februar, ennå ikke ankommet. Tabellen nedenfor viser resultatet.

    Dato Beholdning Planlagt forsyning Planlagt behov Prosjektert lagerbeholdning ATP
    4. februar 2022 17 sept. 2 2
    5. februar 2022 17 1 3 3
    6. februar 2022 17 3 6 6
    7. februar 2022 17 6 6
    8. februar 2022 17 6 6
    9. februar 2022 17 6 6
    10. februar 2022 17 6 6

    Som du ser, påvirker ikke de planlagte (men ikke igangsatte) endringene i lagerbeholdningen det faktiske beholdningsantallet.

Send inn endringsplaner, endringshendelser og ATP-spørringer via API

Du kan bruke følgende URL-adresser for API (Application Programming Interface) til å sende inn tidsplaner for lagerbeholdning, endringshendelser og spørringer.

Bane Metode Beskrivelse
/api/environment/{environmentId}/onhand/changeschedule POST Opprett én planlagt lagerendring.
/api/environment/{environmentId}/onhand/changeschedule/bulk POST Opprett flere planlagte lagerendringer.
/api/environment/{environmentId}/onhand POST Opprett én lagerendringshendelse.
/api/environment/{environmentId}/onhand/bulk POST Opprett flere endringshendelser.
/api/environment/{environmentId}/onhand/indexquery POST Spør ved å bruke POST-metoden.
/api/environment/{environmentId}/onhand GET Spør ved å bruke GET-metoden.
/api/environment/{environmentId}/onhand/exactquery POST Nøyaktig spørring ved å bruke POST-metoden.

Hvis du vil ha mer informasjon, kan du se Offentlige API-er for lagersynlighet.

Opprett én endringsplan for lagerbeholdning

Det opprettes en endringsplan for lagerbeholdning ved å sende en POST forespørsel til den lagersynlighet URL-adressen. Du kan også sende inn masseforespørsler.

En tidsplan for lagerendring kan bare opprettes hvis den planlagte datoer er mellom gjeldende dato og slutten av gjeldende tidsplanperiode. datetime-formatet skal være år-måned-dag (for eksempel 2022-02-01). Tidsformatet må bare være nøyaktig for dagen.

Denne API-en oppretter én enkelt lagerendringsplan.

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

Følgende eksempel viser eksempeltekstinnholdet uten 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
            }
        }
    }
}

Opprette flere planer for lagerendring

Denne API-en kan opprette flere poster samtidig. De eneste forskjellene mellom denne API-en og API-en for én hendelse er verdiene for Path og Body. For denne API-en inneholder Body en matrise med poster. Maksimalt antall oppføringer er 512. Derfor kan bulk-API-en for lagerbeholdningendring støtte opptil 512 planlagte endringer om gangen.

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

Følgende eksempel viser eksempeltekstinnholdet.

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

Opprett lagerendringshendelser

Endringshendelser i lagerbeholdning utføres ved å sende en forespørsel til den relevante lagersynlighet url-adressen (se starten POST på planene for å sende endringer, endringshendelser og ATP-spørringer via API-delen ).

Notat

Lagerendringshendelser er ikke unike for ATP-funksjonaliteten, men er en del av standard API for Lagersynlighet. Dette eksemplet er inkludert fordi hendelser er relevante når du arbeider med ATP. Lagerendringshendelser ligner endringer i lagerbeholdningsreservasjoner, men hendelsesmeldinger må sendes til en annen API-URL, og hendelser bruker quantities i stedet for quantityByDate i meldingsteksten. Hvis du vil ha mer informasjon om lagerendringshendelser og andre funksjoner i API-en for Lagersynlighet, kan du se Offentlige API-er for Lagersynlighet.

Følgende eksempel viser en forespørselstekst som inneholder én enkelt lagringsendringshendelse.

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

Spør de planlagte lagerbeholdningsendringene og ATP-resultatene

Du kan spørre planlagte lagerbeholdningsendringer og ATP-resultater ved å sende enten en POST-forespørsel eller en GET-forespørsel til den riktige URL-adressen for API-en (se delen Send inn endringsplaner, endringshendelser og ATP-spørringer via API).

I forespørselen setter du QueryATP til sann hvis du vil spørre etter planlagte lagerbeholdningsendringer og ATP-resultater. Som standard returnerer spørringen alle ATP-relaterte data fra i dag. Du kan spesifisere ATPFromDate og ATPToDate for å avgrense resultatene. (Datoene "til" og "fra" filtrerer bare resultatet. De påvirker ikke hvordan ATP beregnes.)

  • Hvis du sender inn forespørselen via GET-metoden, angir du denne parameteren i URL-adressen.
  • Hvis du sender inn forespørselen via POST-metoden, angir du denne parameteren i forespørselsteksten.

Notat

Uansett om parameteren returnNegative er satt til sann eller usann i forespørselsteksten, vil resultatet inneholde negative verdier når du spør om planlagte lagerbeholdninger og ATP-resultater. Disse negative verdiene vil bli inkludert, fordi hvis bare behovsordrer blir planlagt, eller hvis forsyningsantallet er mindre enn behovsantallet, vil de planlagte endringene i lagerbeholdningsantallene være negative. Hvis negative verdier ikke ble tatt med, vil resultatene være forvekslingsvis. Hvis du vil ha mer informasjon om dette alternativet og hvordan det fungerer for andre typer spørringer, kan du se Offentlige API-er for Lagersynlighet.

Spør ved å bruke POST-metoden

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

Følgende eksempel viser hvordan du oppretter en indeksspørringsforepørsel som kan sendes inn til Lagersynlighet ved hjelp av POST-metoden.

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

Spør ved å bruke GET-metoden

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]

Følgende eksempel viser hvordan du oppretter en indeksspørringsforespørsels-URL som en GET-forespørsel.

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

Resultatet til denne GET forespørselen er nøyaktig det samme som resultatet for forespørselen POST i forrige eksempel.

Nøyaktig spørring ved å bruke POST-metoden

For å sette opp et eksakt søk, legg til ATP-relaterte felt i spørringsteksten. For mer informasjon, se Nøyaktig spørring ved å bruke posteringsmetoden.

{
    // Exact query fields
    // ...

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

Eksempel på spørringsresultat

Hvilken som helst av de forrige spørringseksemplene kan gi følgende svar. For dette eksemplet er systemet konfigurert med følgende innstillinger:

  • Beregnet ATP-mål:iv.onhand = pos.inbound – pos.outbound
  • Planleggingsperiode:7

Her er et eksempel på svarteksten.

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