Disponibilità per data

La funzione di disponibilità per data fornisce la quantità di disponibilità dell'inventario separata per un periodo di tempo. Ogni periodo è un sottoprodotto di una considerazione diversa che include le finestre di prenotazione, domanda e offerta.

Disponibilità nodo per data

Inventory Visibility pubblica sempre l'immagine di disponibilità quando l'inventario viene aggiornato in un nodo. La disponibilità per data utilizza le date / ore dell'inventario per calcolare l'intervallo di date. Le date / ore dell'inventario includono quando la nuova fornitura diventa disponibile (supplies.eta) o quando scade la fornitura (supplies.shipByDate). Per ulteriori informazioni, vedi Get Network Availability by date V2.

Ad esempio, se la data corrente è 1 ottobre 2022 e si hanno 10 ONHAND e 20 PO in arrivo il 10 ottobre 2022 senza prenotazioni. Quindi, la disponibilità del nodo restituisce le seguenti informazioni. L'output è separato da currentAvailability e futureAvailability con le date / ore associate, fromTs (data / ora di inizio inclusiva) e toTs (data / ora di fine esclusiva). Se passi requestedEndTs nella richiesta, viene restituita la disponibilità del nodo per data con fromTs precedente o inclusiva di questa data e toTs di tale disponibilità dell'ultimo nodo per data nella risposta è inferiore o uguale a requestedEndTs. Se non passi requestedEndTs nella richiesta, per impostazione predefinita requestedEndTs viene considerato come il valore impostato per la regola tenant dateBreakups.defaultLimitInDays . Il valore iniziale di requestedEndTs è impostato to15 giorni. Ovvero, il valore predefinito di requestedEndTs è current date + 15 days come mostrato nella risposta, toTs: 2022-10-15T16:42:06.942Z. È possibile sovrascrivere temporaneamente il valore predefinito inoltrando esplicitamente il valore requestedEndTs nell'input della richiesta.

Nota: se possibile, assicurati di mantenere il valore requestedEndTs inferiore a 30 giorni. Se il tuo requisito di business è giustificato, tieni presente che l'inventario calcolato dall'API di disponibilità è proporzionale all'ora di fine della richiesta. Il tempo di risposta potrebbe essere influenzato quando si imposta un orizzonte di grandi dimensioni per requestedEndTs.

Allo stesso modo, è possibile inoltrare requestedQuantity nella richiesta per limitare la risposta in base alla quantità.

{
    "availabilityType": "SELL",
    "considerFulfillmentOptions": false, 
    "considerSafetyStock": true,
    "lines": [
        {
            "itemId": "PLATE",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "shipNodes": [
                "Matrix-Store-001"
            ],
            "lineId": "1",
            "shipNodeAvailabilities": [
                {
                    "shipNode": "Matrix-Store-001",
                    "currentAvailability": {
                        "toTs": "2022-10-10T00:00:00.000Z",
                        "availableQuantity": 10.0,
                        "shortageQuantity": 0.0,
                        "thresholdLevel": 0,
                        "thresholdType": "ONHAND"
                    },
                    "futureAvailability": [
                        {
                            "toTs": "2022-10-15T16:42:06.942Z",
                            "availableQuantity": 30.0,
                            "shortageQuantity": 0.0,
                            "fromTs": "2022-10-10T00:00:00.000Z"
                        }
                    ]
                }
            ]
        }
    ]
}

Ora, si supponga che le seguenti prenotazioni siano state eseguite correttamente.

Tabella 1. Nome, quantità, ora e scadenza della prenotazione quando tutte le prenotazioni hanno esito negativo
Prenotazione	Quantità prenotazione	Orario prenotazione (rsrv_ts)	Scadenza (exp_ts)
A	1	`2022-10-01T13:10:00Z`	`2020-10-01T13:26:00Z`
B	2	`2022-10-01T13:10:00Z`	`2020-10-01T13:26:00Z`
C	3	`2022-10-01T13:10:00Z`	`2020-10-01T13:26:00Z`
D	4	`2022-10-12T13:10:00Z`	`2020-10-12T13:26:00Z`

Quando il nome della prenotazione, la quantità, l'ora e la scadenza hanno esito positivo, la disponibilità del nodo restituisce le seguenti informazioni:

{
    "availabilityType": "SELL",
    "considerSafetyStock": true,
    "lines": [
        {
            "itemId": "PLATE",
            "unitOfMeasure": "EACH",
            "productClass": "NEW",
            "deliveryMethod": "SHP",
            "segment": "ONLINE",
            "segmentType": "Channel",
            "shipNodes": [
                "Matrix-Store-001"
            ],
            "lineId": "1",
            "shipNodeAvailabilities": [
                {
                    "shipNode": "Matrix-Store-001",
                    "currentAvailability": {
                        "toTs": "2022-10-10T00:00:00.000Z",
                        "availableQuantity": 4.0,
                        "shortageQuantity": 0.0,
                        "thresholdLevel": 0,
                        "thresholdType": "ONHAND"
                    },
                    "futureAvailability": [
                        {
                            "toTs": "2022-10-15T17:48:39.490Z",
                            "availableQuantity": 20.0,
                            "shortageQuantity": 0.0,
                            "fromTs": "2022-10-10T00:00:00.000Z"
                        }
                    ]
                }
            ]
        }
    ]
}

Le prenotazioni A, B e C per il 1 ° ottobre 2022 influenzano sia la disponibilità corrente che quella futura. La prenotazione D per il 12 ottobre 2022 ha effetto solo sulla disponibilità futura.

currentAvailability = 4 (10 disponibile meno 1 dalla prenotazione A meno 2 dalla prenotazione B meno 3 dalla prenotazione C)
futureAvailability = 20 (4 attualmente disponibili più 20 dall'ordine di acquisto meno 4 dalla prenotazione D)

Ora, prendere lo stesso esempio con 10 ONHAND e 20 PO che arrivano il 10 ottobre senza prenotazioni, ma l'evasione è OFF al nodo fino all ' 8 ottobre. Le sovrascritture di evasione ordini del nodo che vengono con una data di scadenza influenzano anche la disponibilità del nodo per data. In questo esempio, la disponibilità del nodo restituisce solo la disponibilità futura quando la sovrascrittura di evasione scade l'8 ottobre. L'API di disponibilità non restituisce la disponibilità del nodo futuro per data che non ha disponibilità.

"shipNodeAvailabilities": [ {
   "shipNode": "Matrix-Store-001",
   "currentAvailability": {
   "toTs": "2022-10-08T00:00:00.000Z",
   "availableQuantity": 0.0,
   "shortageQuantity": 0.0,
   "thresholdLevel": 0,
   "thresholdType": "FUTURE"
   },
   "futureAvailability": [ {
      "toTs": "2022-10-10T00:00:00.000Z",
      "availableQuantity": 10.0,
      "shortageQuantity": 0.0,
      "fromTs": "2022-10-08T00:00:01.000Z"
      },
      {
          "toTs": "2022-10-15T20:07:45.812Z",
          "availableQuantity": 30.0,
          "shortageQuantity": 0.0,
          "fromTs": "2022-10-10T00:00:00.000Z"
      }
    ]
  }
]

Nota:

Se si specifica considerSafetyStock nella chiamata API, la scorta di sicurezza configurata viene sottratta dal valore availableQuantity. Ad esempio, se lo stock di sicurezza è 1, l'uscita cambierà in availableQuantity=29.
Se si specifica considerFulfillmentOptions come true nella chiamata API, le opzioni di adempimento specificate vengono sovrascritte al nodo e la chiamata all'elemento viene considerata. Se l'opzione considerFulfillmentOptions è falsa, la disponibilità viene calcolata senza considerare gli annullamenti dell'adempimento.
For more information, see Get Node Availability by Date V1 API.
By default, the value of considerFulfillmentOptions as vero.

Le API di disponibilità di rete e del nodo V2 hanno un attributo a livello di intestazione della richiesta noto come isAggregationNeeded con un valore predefinito di false. Se impostato su true, questa API restituisce i campi onhandAvailableQuantity, futureAvailableQuantity, futureLatestShipTse futureEarliestShipTs in risposta al livello di riga (è simile alle API di disponibilità V1 ). Tuttavia, la risposta API isAggregationNeeded non dispone delle informazioni sull'array futureAvailability .

Un esempio di isAggregationNeeded output dei parametri è il seguente.

"shipNodeAvailabilities" : [ {
   "currentAvailability" : {
      "availableQuantity" : 20.0,
      "shortageQuantity" : 0.0,
      "thresholdLevel" : 0,
      "thresholdType" : "ONHAND",
      "toTs" : "2021-06-10T00:00:00.182Z"
      },
   "futureAvailableQuantity" : 0.0,
   "futureEarliestShipTs" : "2500-01-01T00:00:00.000Z",
   "futureLatestShipTs" : "2500-01-01T00:00:00.000Z",
   "onhandAvailableQuantity" : 20.0,
   "shipNode" : "store-BostonMA"
   }
]

Per aumentare al massimo la velocità di trasmissione delle richieste di inventario, assicurarsi che la richiesta di disponibilità per le linee item - nodo sia limitata ad un massimo di 100 righe per ogni chiamata API.

Importante: il limite di riga verrà applicato alla fine di luglio 2024.

Forniture disponibili del nodo

L'API availableSupplies fornisce il quadro dell'offerta disponibile, che comprende anche le prenotazioni non scadute. L'unica differenza tra l'API availability e l'API di availableSupplies è che availableSupplies non aggrega la disponibilità per data con date sovrapposte. Ad esempio, se la data corrente è il 1 dicembre 2022 e se c'è 1 PO di 10, l'ETA è il 1 gennaio 2023 e il shipByDate è il 1 aprile 2023. Per un altro PO di 10, l'ETA è il 1 ° febbraio 2023 e il shipByDate è il 1 ° aprile 2023.

Le voci API availableSupplies sono le seguenti (senza aggregazione di quantità).

"availableSupplies": [ {
   "toTs": "2023-04-01T00:00:01.000Z",
   "availableQuantity": 10.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-01-01T00:00:00.000Z"
   },
   {
   "toTs": "2023-04-01T00:00:01.000Z",
   "availableQuantity": 10.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-02-01T00:00:00.000Z"
   }
]

L'output dell'API Availability è il seguente (con le disponibilità sovrapposte aggiunte).

"futureAvailability": [
   {
   "toTs": "2023-02-01T00:00:00.000Z",
   "availableQuantity": 10.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-01-01T00:00:00.000Z"
   },
   {
   "toTs": "2023-04-01T00:00:00.000Z",
   "availableQuantity": 20.0,
   "shortageQuantity": 0.0,
   "fromTs": "2023-02-01T00:00:00.000Z
   }
]

Disponibilità gruppo di distribuzione per data

Analogamente alla disponibilità del nodo, la disponibilità del gruppo di distribuzione fornisce anche una disponibilità del gruppo di distribuzione in base all'intervallo di date. L'immagine di disponibilità del gruppo di distribuzione è una vista aggregata di tutta la disponibilità del nodo associato per data per l'inventario disponibile per la vendita.

La disponibilità del gruppo di distribuzione per data fornisce l'immagine di disponibilità del livello di rete corrente e futuro, incluse le prenotazioni attive. La disponibilità viene restituita per il prodotto o articolo di input. Se la richiesta è un prodotto principale, la disponibilità dei relativi elementi secondari viene restituita anche dal prodotto di disponibilità di rete per data API.

Quando si verifica una modifica in una data / ora di inventario tramite una nuova offerta o domanda con date diverse dalla disponibilità esistente per date, la disponibilità per data viene calcolata e pubblicata. Una modifica all'intervallo di registrazione data / ora può verificarsi quando viene determinata una nuova data di fornitura o di spedizione. La disponibilità dell'inventario del gruppo di distribuzione viene calcolata solo per le prenotazioni di ordini aperte.

Ad esempio, si supponga di avere un gruppo di distribuzioni US_Group con due nodi di spedizione Matrix-Store-001 e Matrix-Store-002e ID elemento PROD1. In questo esempio, un elemento è disponibile come ONHAND. Inoltre, due articoli arrivano il 7 febbraio 2020 e tre articoli arrivano il 14 febbraio 2020 (senza prenotazione) per ogni singolo nodo di spedizione. Pertanto, il gruppo di distribuzione ha il doppio della disponibilità di ciascun nodo di spedizione per l'intervallo di tempo. La disponibilità del gruppo di distribuzione restituisce le seguenti informazioni. Si noti che l'output è separato da currentAvailability e futureAvailability con le date / ore associate, fromTs (data / ora di inizio inclusiva) e toTs (data / ora di fine esclusiva).

{
   "considerSafetyStock": true,
   "considerFulfillmentOptions": false, 
   lines: [ {
      itemId: "PROD1",
      lineId: "0",
      productClass: "NEW",
      unitOfMeasure: "EACH",
      deliveryMethod: "SHP",
      networkAvailabilities: [
      {
         distributionGroupId: "US_Group",
         currentAvailability: {
         availableQuantity: 2.0,
         shortageQuantity: 0.0,
         toTs:"2020-02-07T05:00:00Z”,
         thresholdLevel: 3,
         thresholdType: "ONHAND",
         thresholdQuantity: 5.5,
      },
      futureAvailability: [ {
         fromTs: "2020-02-07T05:00:00Z",
         toTs:"2020-02-14T05:00:00Z",
         availableQuantity: 6.0,
         shortageQuantity: 0.0
      },
      {
         fromTs: "2020-02-14T05:00:00Z",
         toTs:"2500-01-01T00:00:00Z",
         availableQuantity: 12.0,
         shortageQuantity: 0.0
      }
      ]
      }
      ]
    }
  ]
}

Consideriamo un altro esempio di gruppo di distribuzione con due nodi e un elemento, come segue:

Nodo A - 10 offerte, 1 domanda e 9 disponibili, 0 carenze
Nodo B - 5 offerta, 7 domanda e 0 disponibile, 2 carenza

Una richiesta di disponibilità di rete per questo gruppo di distribuzione mostra 9 quantità disponibili e 2 quantità insufficienti, poiché si tratta della somma delle quantità disponibili e insufficienti tra i nodi.

Fai riferimento al seguente frammento di codice JSON:

currentAvailability: {
  availableQuantity: 9.0,
  shortageQuantity: 2.0,
  toTs:"2025-12-30T05:00:00Z",
  thresholdLevel: 3,
  thresholdType: "ONHAND",
  thresholdQuantity: 5.5,
}

Per ulteriori informazioni, consultare la documentazione relativa all'API REST del prodotto Network Availability Product by Date.