Visibilità dell'inventario con programmazioni di modifiche scorte disponibili e available-to-promise

Questo articolo descrive come impostare la funzionalità Programmazione delle modifiche scorte disponibili per programmare le modifiche future delle scorte disponibili e calcolare le quantità available-to-promise (ATP). ATP è la quantità di un articolo disponibile e che può essere promessa a un cliente nel prossimo periodo. L'uso di questo calcolo può aumentare notevolmente la capacità di evasione degli ordini.

Per molti produttori, rivenditori o venditori, non è sufficiente solo sapere cosa è attualmente disponibile. Devono avere piena visibilità sulla disponibilità futura. Questa disponibilità futura deve considerare l'offerta futura, la domanda futura e l'ATP.

Misure calcolate per le quantità ATP

La Misura calcolata ATP è una misura calcolata predefinita che viene in genere utilizzata per trovare la quantità di scorte attualmente disponibile. La quantità di fornitura è la somma delle quantità per le misure fisiche che hanno il tipo di modificatore addizione, e la quantità richiesta è la somma delle quantità per le misure fisiche che hanno il tipo di modificatore sottrazione.

Puoi aggiungere più misure calcolate per calcolare le diverse quantità ATP. Tuttavia, il numero totale delle misure fisiche distinte in tutte le misure calcolate ATP deve essere inferiore a nove.

Importante

Una misura calcolata è una composizione di misure fisiche. La formula può includere solo misure fisiche senza duplicati, non misure calcolate.

È ad esempio possibile impostare la seguente misura calcolata:

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

La somma (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) rappresenta l'offerta e la somma (ReservPhysical + SoftReservePhysical + Outbound) rappresenta la domanda. Pertanto, la misura calcolata può essere intesa nel modo seguente:

Scorte disponibili = OffertaDomanda

È possibile aggiungere un'altra misura calcolata per calcolare la quantità ATP Fisico disponibile.

Fisico disponibile = (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) – (Outbound)

Esistono otto misure fisiche distinte in queste due misure calcolate ATP: PhysicalInvent, OnHand, Unrestricted, QualityInspection, Inbound, ReservPhysical, SoftReservePhysical, e Outbound.

Per ulteriori informazioni sulle misure calcolate, vedi Misure calcolate.

Attivare e configurare la pianificazione delle modifiche alle scorte disponibili e l'ATP nell'interfaccia utente versione 2

Questa sezione si applica quando utilizzi l'interfaccia utente di Visibilità inventario versione 2.

Prima di poter utilizzare l'ATP, è necessario impostare una o più misure calcolate per calcolare le quantità ATP. Devi anche attivare la funzione e configurare le impostazioni ATP in Microsoft Power Apps.

Segui questi passaggi per attivare la funzionalità programmazione delle modifiche scorte disponibili in Power Apps e configurare le impostazioni ATP.

  1. Accedi a Power Apps, e apri l'app Visibilità inventario.

  2. Nel riquadro di spostamento, seleziona Gestione funzionalità.

  3. Nel riquadro Available-to-promise, seleziona Gestisci.

  4. Imposta l'opzione Abilita funzionalità su Vero per attivare la funzionalità ATP.

  5. Imposta l'opzione Programmazione per 180 giorni su Vero per supportare il periodo di programmazione ATP più lungo (180 giorni).

    Importante

    Per impostazione predefinita, la funzionalità ATP è limitata a sette giorni. Le funzionalità ATP a sette giorni e ATP a 180 giorni sono separate e indipendenti l'una dall'altra. Le modifiche alla programmazione create o modificate utilizzando la funzionalità ATP di sette giorni non avranno effetto quando attivi la funzionalità ATP di 180 giorni. Se hai utilizzato la funzionalità ATP di sette giorni e desideri eseguire la migrazione alla funzionalità di 180 giorni, ti consigliamo di eliminare i vecchi dati e pubblicare nuovamente la pianificazione delle modifiche alle scorte disponibili dopo aver abilitato la funzionalità di 180 giorni.

  6. Imposta il campo Periodo di programmazione massimo (giorni) sul numero di giorni in cui gli utenti possono visualizzare e inviare le modifiche programmate per le scorte disponibili. Gli utenti che richiedono informazioni sulle scorte riceveranno la quantità disponibile, le modifiche programmate per le scorte disponibili e l'ATP per ogni giorno nel periodo definito, a partire dalla data corrente. Il valore massimo per questo campo è 180 giorni. Per impostazione predefinita, è impostato su 30 giorni. Pertanto, puoi pianificare le modifiche fino a 30 giorni a partire da oggi.

    Importante

    Il periodo di programmazione include la data corrente. Pertanto, gli utenti possono programmare le modifiche disponibili in modo che avvengano in qualsiasi momento dalla data corrente (il giorno in cui viene inviata la modifica) fino a (periodo di pianificazione - 1) giorni futuri.

  7. Nella sezione Misure programmazione, configura le misure della programmazione. È possibile utilizzare le misure calcolate esistenti come misure di programmazione oppure crearne di nuove. Quando esegui una query su Visibilità inventario, il valore ATP viene fornito per le misure calcolate definite, in base alle modifiche pianificate delle misure fisiche dei componenti. Nella sezione Misure programmazione, seleziona Nuova configurazione programmazione modifiche alle scorte disponibili 2 sulla barra degli strumenti per aggiungere una nuova associazione di misure calcolate per ATP. La misura calcolata è quello che vuoi utilizzare per trovare la quantità in giacenza attualmente disponibile. Per informazioni su come creare una misura calcolata, vedi Misure calcolate.

    Importante

    La formula calcolata ATP predefinita è di riferimento. Puoi modificare e aggiungere altre origini dati e misure fisiche per configurare il calcolo ATP corretto per la tua azienda.

  8. Nella sezione Configurazione set di indici ATP, configura il tuo indice ATP. L'indice ATP assomiglia alla gerarchia dell'indice del prodotto che ti consente di raggruppare i risultati delle query in base a dimensioni specifiche. Ad esempio, se imposti ColorId e SizeId come set di indici ATP, i risultati della query verranno raggruppati per colore e dimensione. È possibile avere più set di indici.

    Importante

    L'indice ColorId e SizeId predefinito l'indice è di riferimento. Puoi rimuovere dimensioni e aggiungere altre dimensioni.

  9. Selezionare Salva.

  10. Una volta terminata la configurazione di tutte le impostazioni obbligatorie, seleziona Aggiorna configurazione in Impostazioni di amministratore nel riquadro di spostamento.

Per ulteriori informazioni, vedere Completare e aggiornare la configurazione.

Attivare e configurare la pianificazione delle modifiche alle scorte disponibili e l'ATP nell'interfaccia utente versione 1

Questa sezione si applica quando utilizzi l'interfaccia utente di Visibilità inventario versione 1.

Segui questi passaggi per attivare la funzionalità programmazione delle modifiche scorte disponibili in Power Apps e configurare le impostazioni ATP.

  1. Accedi a Power Apps, e apri l'app Visibilità inventario.

  2. Aprire la pagina di configurazione .

  3. Nella scheda Gestione funzionalità, attiva la funzionalità Available-to-promise.

  4. Seleziona la scheda Impostazioni ATP.

  5. Quando esegui la query in Visibilità inventario, il risultato include ogni misura calcolata ATP che aggiungi qui. Seleziona Aggiungi per aggiungere una nuova misura calcolata per ATP.

  6. Impostare i seguenti campi:

    • Origine dati – Seleziona l'origine dati associata alla misura calcolata.
    • Misura calcolata – Seleziona la misura calcolata associata all'origine dati selezionata e che vuoi utilizzare per trovare la quantità di scorte attualmente disponibile.
    • Periodo di programmazione – Immetti il numero di giorni in cui gli utenti possono visualizzare e inviare le modifiche programmate per le scorte disponibili quando viene utilizzata la misura calcolata selezionata. Gli utenti che richiedono informazioni sulle scorte riceveranno la quantità disponibile, le modifiche programmate per le scorte disponibili e l'ATP per ogni giorno in questo periodo, a partire dalla data corrente. Seleziona un numero intero compreso tra 1 e 7.

    Importante

    Il periodo di programmazione include la data corrente. Pertanto, gli utenti possono programmare le modifiche disponibili in modo che avvengano in qualsiasi momento dalla data corrente (il giorno in cui viene inviata la modifica) fino a (periodo di pianificazione - 1) giorni futuri.

  7. Seleziona Salva.

  8. Ripetere i passaggi da 5 a 7 fino a quando non sono stati aggiunti tutte le misure calcolate necessarie per ATP.

  9. Al termine della configurazione di tutte le impostazioni richieste, seleziona Aggiorna configurazione.

Come funzionano la programmazione delle modifiche scorte disponibili e i calcoli ATP

La programmazione delle modifiche scorte disponibili stabilisce le date previste e le quantità di modifiche programmate per le scorte disponibili. Puoi inviare una programmazione delle modifiche scorte disponibili a Visibilità inventario, a condizione che le date rientrino nel periodo definito dall'impostazione Periodo di programmazione (vedi la sezione Abilitare e configurare le funzionalità di questo articolo). Gli utenti che richiedono informazioni sulle scorte riceveranno la quantità disponibile, le modifiche programmate per le scorte disponibili e l'ATP per ogni giorno in questo periodo.

Le modifiche programmate inizialmente non sono confermate e quindi non influiscono sulle quantità effettive di scorte disponibili nel sistema. Per confermare le modifiche, è necessario inviare un evento di modifica scorte disponibili, che aggiorna la quantità effettiva disponibile. È quindi necessario ripristinare la modifica programmata inviando una programmazione delle modifiche scorte disponibili per una quantità negativa corrispondente.

Ad esempio, effettui un ordine per 10 biciclette e prevedi che arrivi domani. Pertanto, invii una programmazione delle modifiche scorte disponibili con una quantità in entrata di 10 e datata per domani. Quando l'ordine arriva il giorno successivo, aggiungi le biciclette al tuo inventario fisico di scorte disponibili. È quindi necessario confermare la modifica nel sistema per aggiornare la quantità effettivamente disponibile. Per confermare la modifica, invii un evento di modifica scorte disponibili con una quantità in entrata di 10. Quindi ripristini la modifica programmata inviando una programmazione delle modifiche scorte disponibili per una quantità in entrata di -10.

Quando si esegue una query in Visibilità inventario per le quantità di scorte disponibili e ATP, vengono restituite le seguenti informazioni per ogni giorno del periodo di programmazione:

  • Data – La data a cui si applica il risultato. Il fuso orario è Coordinated Universal Time (UTC).
  • Quantità disponibile – La quantità effettivamente disponibile per la data specificata. Questo calcolo viene effettuato in base alla misura calcolata dall'ATP configurata per Visibilità inventario.
  • Offerta programmata – La somma di tutte le quantità in entrata programmate che non sono diventate fisicamente disponibili per il consumo o la spedizione alla data specificata.
  • Domanda programmata – La somma di tutte le quantità in uscita programmate che non sono state consumate o spedite alla data specificata.
  • Quantità ATP – La quantità minima prevista disponibile dalla data specificata fino alla fine del periodo di programmazione. Questa quantità include tutte le rettifiche di quantità programmate. È la quantità massima che può essere promessa alla data corrente per la consegna o il consumo in quel giorno.

Ad esempio, se la data corrente è il 1° febbraio 2022 e il periodo di programmazione è 7, gli utenti possono inviare modifiche programmate per scorte disponibili che devono verificarsi dal 1° febbraio al 7 febbraio 2022. In questo caso, la quantità ATP per il 3 febbraio, ad esempio, viene calcolata in base alla quantità disponibile per quel giorno e alle quantità programmate dal 3 febbraio al 7 febbraio.

Esempio

L'esempio seguente mostra come una serie di modifiche alla quantità programmata influisca sulle quantità disponibili e ATP restituite da Visibilità inventario. Mostra anche come confermare una modifica programmata, come una modifica della programmazione confermata influisce sui risultati e cosa può accadere se non si conferma una modifica programmata.

I risultati in questo esempio mostrano un valore di scorte disponibili previste. Questo valore incorpora tutti gli aggiornamenti pianificati a scopo illustrativo, ma in realtà non viene restituito quando si esegue una query in Visibilità inventario.

  1. Le seguenti impostazioni sono configurate per il tuo sistema nella pagina Impostazione ATP dell'app Visibilità inventario in Power Apps:

    • Misure programmazione – Una misura calcolata denominata Scorte disponibili viene aggiunta qui. Viene calcolata come Scorte disponibili = Offerta - Domanda.
    • Periodo di programmazione massimo (giorni) – Il valore è impostato su 7.
    • Configurazione set di indici ATPColorId e SizeId vengono aggiunti qui.
  2. Vengono applicate anche le seguenti condizioni:

    • La data corrente è il 1° febbraio 2022.
    • La quantità corrente di scorte disponibili è 20,
  3. Per la data corrente (1 febbraio 2022), invii una quantità di domanda programmata pari a 3 a Visibilità inventario. La quantità disponibile prevista è quindi 17. La seguente tabella mostra il risultato.

    Data Disponibilità Offerta programmata Domanda programmata Scorte disponibili previste ATP
    01-02-2022 20 3 17 17
    02-02-2022 20 17 17
    03-02-2022 20 17 17
    04-02-2022 20 17 17
    05-02-2022 20 17 17
    06-02-2022 20 17 17
    07-02-2022 20 17 17
  4. Alla data corrente (1 febbraio 2022), invii una quantità di offerta programmata di 10 per il 3 febbraio 2022. La seguente tabella mostra il risultato.

    Data Disponibilità Offerta programmata Domanda programmata Scorte disponibili previste ATP
    01-02-2022 20 3 17 17
    02-02-2022 20 17 17
    03-02-2022 20 10 27 27
    04-02-2022 20 27 27
    05-02-2022 20 27 27
    06-02-2022 20 27 27
    07-02-2022 20 27 27
  5. Alla data corrente (1 febbraio 2022), invii le seguenti modifiche alla quantità programmate:

    • Quantità della domanda di 15 per il 4 febbraio 2022
    • Quantità dell'offerta di 1 per il 5 febbraio 2022
    • Quantità dell'offerta di 3 per il 6 febbraio 2022

    La seguente tabella mostra il risultato.

    Data Disponibilità Offerta programmata Domanda programmata Scorte disponibili previste ATP
    01-02-2022 20 3 17 12
    02-02-2022 20 17 12
    03-02-2022 20 10 27 12
    04-02-2022 20 15 12 12
    05-02-2022 20 1 13 13
    06-02-2022 20 3 16 16
    07-02-2022 20 16 16
  6. Alla data corrente (1 febbraio 2022), spedisci la quantità della domanda programmata di 3: Pertanto, devi confermare questa modifica in modo che si rifletta sulla quantità effettiva disponibile. Per confermare la modifica, invii un evento di modifica scorte disponibili con una quantità in uscita di 3. Quindi ripristini la modifica programmata inviando una programmazione delle modifiche scorte disponibili per una quantità in uscita di -3. La seguente tabella mostra il risultato.

    Data Disponibilità Offerta programmata Domanda programmata Scorte disponibili previste ATP
    01-02-2022 17 0 17 12
    02-02-2022 17 17 12
    03-02-2022 17 10 27 12
    04-02-2022 17 15 12 12
    05-02-2022 17 1 13 13
    06-02-2022 17 3 16 16
    07-02-2022 17 16 16
  7. Il giorno successivo (2 febbraio 2022), il periodo di programmazione si sposta in avanti di un giorno. La seguente tabella mostra il risultato.

    Data Disponibilità Offerta programmata Domanda programmata Scorte disponibili previste ATP
    02-02-2022 17 17 12
    03-02-2022 17 10 27 12
    04-02-2022 17 15 12 12
    05-02-2022 17 1 13 13
    06-02-2022 17 3 16 16
    07-02-2022 17 16 16
    08-02-2022 17 16 16
  8. Tuttavia, due giorni dopo (4 febbraio 2022), la quantità di offerta di 10 prevista per il 3 febbraio non è ancora arrivata. La seguente tabella mostra il risultato.

    Data Disponibilità Offerta programmata Domanda programmata Scorte disponibili previste ATP
    04-02-2022 17 15 2 2
    05-02-2022 17 1 3 3
    06-02-2022 17 3 6 6
    07-02-2022 17 6 6
    08-02-2022 17 6 6
    09-02-2022 17 6 6
    10-02-2022 17 6 6

    Come puoi vedere, le modifiche alle scorte disponibili programmate (ma non confermate) non influiscono sulla quantità disponibile effettiva.

Inviare programmazioni di modifica, eventi di modifica e query ATP tramite l'API

È possibile utilizzare i seguenti URL API (Application Programming Interface) per inviare le programmazioni delle modifiche scorte disponibili, eventi di modifica e query.

Percorso Metodo Description
/api/environment/{environmentId}/onhand/changeschedule POST Crea una modifica scorte disponibili programmata.
/api/environment/{environmentId}/onhand/changeschedule/bulk POST Crea più modifiche scorte disponibili programmate.
/api/environment/{environmentId}/onhand POST Creare un evento di modifica scorte disponibili.
/api/environment/{environmentId}/onhand/bulk POST Creare più eventi di modifica scorte disponibili.
/api/environment/{environmentId}/onhand/indexquery POST Esegui la query utilizzando il metodo POST.
/api/environment/{environmentId}/onhand GET Esegui la query utilizzando il metodo GET.
/api/environment/{environmentId}/onhand/exactquery POST Query esatta utilizzando il metodo POST.

Per maggiori informazioni, vedi API pubbliche di Visibilità inventario.

Creare una programmazione delle modifiche alle scorte

Per creare un programma di modifiche disponibili, inviare una richiesta all'URL servizio di visibilità inventario pertinente. POST Puoi anche inviare richieste in blocco.

È possibile creare una programmazione delle modifiche delle scorte disponibili solo se la data pianificata è compresa tra la data corrente e la fine del periodo di programmazione corrente. Il formato data e ora deve essere giorno mese anno (ad esempio, 01-02-2022). Il formato dell'ora deve essere accurato solo per il giorno.

Questa API crea una singola programmazione di modifiche alle scorte disponibili.

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

Il seguente esempio mostra un esempio di contenuto del corpo senza 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
            }
        }
    }
}

Creare più programmazioni di modifiche alle scorte disponibili

Questa API può creare più record allo stesso tempo. Le uniche differenze tra questa API e l' API a evento singolo sono i valori Path e Body. Per questa API, Body fornisce un array di record. Il numero massimo di record è 512. Pertanto, l'API della programmazione delle modifiche in blocco delle scorte disponibili può supportare fino a 512 modifiche programmate alla volta.

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

L'esempio seguente mostra un esempio di contenuto del corpo.

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

Creare eventi di cambiamento a portata di mano

Gli eventi di modifica a portata di mano vengono effettuati inviando una POST richiesta all'URL servizio di visibilità inventario pertinente (vedere l'inizio della sezione Invia pianificazioni di modifica, eventi di modifica e query ATP tramite l'API ).

Nota

Gli eventi di modifica delle scorte disponibili non sono univoci nella funzionalità ATP ma fanno parte dell'API di visibilità inventario standard. Questo esempio è stato incluso perché gli eventi sono rilevanti quando si lavora con ATP. Gli eventi di modifica delle scorte disponibili assomigliano alle prenotazioni di modifica delle scorte disponibili, ma i messaggi di evento devono essere inviati a un URL API diverso e gli eventi utilizzano quantities invece di quantityByDate nel corpo del messaggio. Per ulteriori informazioni sugli eventi di modifica delle scorte disponibili e altre funzionalità dell'API di visibilità inventario, vedi API pubbliche di Visibilità inventario.

Il seguente esempio mostra un corpo della richiesta che contiene un singolo evento di modifica delle scorte disponibili.

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

Eseguire query per le modifiche scorte disponibili programmate e i risultati ATP

Puoi eseguire query per le modifiche scorte disponibili programmate e i risultati ATP inviando una richiesta POST o una richiesta GET all'URL dell'API appropriato (vedi la sezione Inviare programmazioni di modifica, eventi di modifica e query ATP tramite l'API).

Nella richiesta, imposta QueryATP su vero se vuoi eseguire query per le modifiche scorte disponibili programmate e i risultati ATP. Per impostazione predefinita, la query restituisce tutti i dati relativi all'ATP a partire da oggi. Puoi specificare ATPFromDate e ATPToDate per restringere i risultati. (Le date "a" e "da" filtrano semplicemente il risultato. Non influiscono sul modo in cui viene calcolato l'ATP.)

  • Se stai inviando la richiesta utilizzando il metodo GET, imposta questo parametro nell'URL.
  • Se stai inviando la richiesta utilizzando il metodo POST, imposta questo parametro nel corpo della richiesta.

Nota

Indipendentemente dal fatto che il parametro returnNegative è impostato su vero o falso nel corpo della richiesta, il risultato includerà valori negativi quando esegui una query per le modifiche scorte disponibili programmate e i risultati ATP. Questi valori negativi verranno inclusi perché, se sono programmati solo ordini di domanda o se le quantità di offerta sono inferiori alle quantità di domanda, le quantità di modifiche programmate per le scorte disponibili saranno negative. Se i valori negativi non fossero inclusi, i risultati sarebbero imprecisi. Per ulteriori informazioni su questa opzione e su come funziona per altri tipi di query, vedi API pubbliche di Visibilità inventario.

Eseguire la query utilizzando il metodo POST

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

L'esempio seguente mostra come creare un corpo della richiesta di query indice che può essere inviato a Visibilità inventario utilizzando il metodo POST.

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

Eseguire la query utilizzando il metodo GET

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]

L'esempio seguente mostra come creare un URL di richiesta della query indice come richiesta GET.

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

Il risultato di questa GET richiesta è esattamente lo stesso risultato della POST richiesta nell'esempio precedente.

Query esatta utilizzando il metodo POST

Per configurare una query esatta, aggiungi i campi relativi ad ATP al corpo della query. Per ulteriori informazioni, vedi Query esatta utilizzando il metodo post.

{
    // Exact query fields
    // ...

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

Esempio di risultato di query

Uno qualsiasi degli esempi di query precedenti possono produrre la seguente risposta. Per questo esempio, il sistema è configurato con le seguenti impostazioni:

  • Misura calcolata ATP:iv.onhand = pos.inbound – pos.outbound
  • Periodo programmazione:7

Di seguito è riportato un esempio di corpo della richiesta.

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