Stock disponibile o quantità esatta: cosa dimostra il dato

Uno stato "disponibile" dimostra solo che una fonte presenta l'articolo come ordinabile nel momento osservato; non fornisce il numero di unità. Una quantità esatta, ad esempio 27, offre un'informazione più precisa, ma non garantisce né una prenotazione, né l'assenza di ordini concorrenti, né la consegna. Conservate quindi il valore grezzo, il suo tipo, la sua fonte e il suo timestamp. Non convertite mai InStock in 1 o in una quantità presunta. Per acquistare, applicate il minimo e lo step d'ordine a una quantità numerica recente, poi chiedete conferma se la posta in gioco supera ciò che il dato dimostra.

Cinque forme di stock da non fondere

I cataloghi usano vocabolari molto diversi. Un campo chiamato stock può contenere un intero, true, un testo come "entro 5 giorni", una classe di soglia o una data di riapprovvigionamento. Prima di qualsiasi calcolo, attribuite una categoria di prova.

Schema.org definisce ItemAvailability come un elenco di stati possibili associati a un'offerta, tra cui InStock, OutOfStock, BackOrder o PreOrder. La pagina InStock indica semplicemente che l'articolo è in stock. Non specifica una quantità. Questa convenzione è utile per interpretare un dato strutturato pubblico, ma non costituisce una garanzia commerciale del fornitore.

La quantità esatta resta un'osservazione, non una promessa

Anche quando un fornitore espone stock_quantity=27, restano aperte tre domande: a che ora è stata calcolata la quantità, per quale magazzino e quale parte è già riservata? Lo stesso numero può essere globale, locale, disponibile alla vendita o fisico prima degli impegni. La documentazione deve indicare il perimetro.

Conservate campi distinti: stock_raw, stock_type, stock_quantity, availability, warehouse_scope, source_generated_at e observed_at. Se la fonte fornisce una quantità esatta ma nessun perimetro di magazzino, non completate quest'ultimo con una supposizione. Un'informazione incompleta può restare utilizzabile con un avviso; un'informazione inventata no.

La politica di freschezza di prezzo e stock va applicata prima di ogni uso. Una quantità datata non diventa booleana: resta una quantità storica, contrassegnata come scaduta per le azioni che richiedono un'osservazione recente.

Quantità acquistabile, MOQ e step d'ordine

Stock e quantità ordinabile non sono la stessa cosa. Supponiamo, a titolo di esempio ipotetico, che una fonte mostri 27 unità, un minimo d'ordine di 10 e uno step di 5. Le quantità conformi sarebbero allora 10, 15, 20 o 25 entro il limite dello stock osservato. Una richiesta di 12 non rispetta lo step, e 30 supera lo stock mostrato. Questa logica dipende dalla definizione contrattuale del MOQ e dello step; non va dedotta da un titolo o da una foto.

Aggiungete il confezionamento: un cartone dichiarato da sei unità può significare che stock_quantity=27 conta cartoni o unità. Finché l'unità della quantità non è documentata, il calcolo d'acquisto deve restare bloccato. La lettura delle colonne del catalogo grossista permette di rilevare queste dipendenze prima dell'importazione.

Una regola sicura segue quest'ordine:

1. Identificare l'unità di vendita. 2. Verificare il contenuto del confezionamento su una prova strutturata o contrattuale. 3. Leggere il MOQ e lo step come campi separati. 4. Classificare lo stock secondo il livello di prova. 5. Applicare la freschezza all'osservazione. 6. Calcolare le quantità conformi solo se le unità sono compatibili. 7. Confermare con il fornitore appena prima dell'ordine.

I valori vuoti, zero e negativi

0 può ragionevolmente rappresentare un'assenza di quantità se la documentazione del campo lo conferma. Una cella vuota non è equivalente: può tradurre un'informazione non disponibile, un prodotto non gestito o un errore. Trattate null, stringa vuota e campo assente come stati distinti durante la diagnosi, poi mappateli solo a partire dalla documentazione.

Una quantità negativa può rappresentare un residuo in un sistema interno, ma non è una quantità disponibile per la vendita. Rifiutatela dal campo stock_quantity utilizzabile e conservatela nel valore grezzo con un motivo. Allo stesso modo, un decimale per un prodotto venduto a unità va messo in revisione; per un prodotto misurato a peso, può essere legittimo. Il contesto dell'unità decide.

Non mascherate mai un problema sostituendo tutte le anomalie con zero. Questa pratica confonde l'assenza di prova con una rottura certa e falsa le diagnosi di fonte.

Verificare uno stock su un lotto canarino

Un lotto canarino fornitore dovrebbe includere almeno stati vari: prodotto disponibile, rottura, valore vuoto, quantità bassa, eventuale riapprovvigionamento e più varianti. L'obiettivo non è esaurire il catalogo, ma confrontare il parser con i casi che cambiano la decisione.

Per ogni riga, confrontate la risposta grezza, la scheda ufficiale autorizzata e il campo normalizzato. Attendete un aggiornamento previsto o effettuate una nuova osservazione alla cadenza consentita per verificare che le transizioni siano gestite. Un prodotto che passa da InStock a OutOfStock non deve conservare una quantità proveniente da una raccolta precedente.

Checklist di prova dello stock

• ☐ Il valore grezzo è conservato.
• ☐ Booleano, quantità, soglia, tempo di consegna e sconosciuto sono separati.
• ☐ L'unità della quantità è documentata.
• ☐ Il magazzino o il perimetro è indicato se fornito.
• ☐ Il timestamp sorgente non è confuso con l'ora dello script.
• ☐ Un valore vuoto non è trasformato in zero.
• ☐ MOQ, step d'ordine e confezionamento sono distinti.
• ☐ Una quantità scaduta non innesca una decisione silenziosa.
• ☐ Una transizione di disponibilità cancella i derivati incompatibili.
• ☐ La disponibilità è confermata prima dell'acquisto.

Cosa può automatizzare ArbitragePro+ / cosa deve verificare il venditore

La specifica proposta controle-stock potrebbe tipizzare ogni valore, impedire la conversione di un booleano in quantità, applicare le regole di freschezza e segnalare le incoerenze con MOQ, step o confezionamento. Il report dovrebbe sempre mostrare la prova grezza.

Il venditore deve confermare il significato contrattuale dello stock, l'unità, il perimetro di magazzino, le eventuali prenotazioni e la quantità realmente accettata al momento dell'ordine.

Controllare la salute di un dato di stock

Aprire la salute delle fonti per esaminare le informazioni di disponibilità e raccolta disponibili.

Fonti ufficiali

• Schema.org, «ItemAvailability», https://schema.org/ItemAvailability — consultato il 2026-08-17.
• Schema.org, «InStock», https://schema.org/InStock — consultato il 2026-08-17.
• IETF, RFC 9110, «HTTP Semantics», https://www.rfc-editor.org/rfc/rfc9110.html — consultato il 2026-08-17.