Blocchi di disponibilità: giacenze, consegna e evasione ordini
Costruisci un blocco di disponibilità che renda chiari a acquirenti, motori di ricerca e agenti AI i dati su giacenze, consegna, evasione ordini, preordini e prodotti fuori produzione, oggi.
Un blocco di disponibilità risponde all’ultima domanda operativa dell’acquirente: posso ottenere questo articolo, con quale metodo e quando? Raccoglie dati su giacenze, consegna, ritiro, preordini e prodotti fuori produzione in un’unica unità estraibile, invece di sparpagliarli tra un badge, un suggerimento nel checkout e una pagina della politica di spedizione.
Perché questo elemento è importante
La disponibilità non è un testo rassicurante. È un vincolo all’acquisto. Un acquirente che ha scelto un prodotto potrebbe comunque abbandonare la decisione se la pagina non risponde se la variante selezionata è vendibile, se la consegna raggiunge la località richiesta o se arriva entro una scadenza reale. Una disponibilità precisa riduce l’incertezza nel momento in cui l’incertezza costa di più.
La psicologia riguarda il controllo, non l’urgenza artificiale. “Solo 2 rimasti” può aiutare qualcuno a valutare il rischio quando il numero è vero e aggiornato. Lo stesso messaggio danneggia la fiducia quando persiste per giorni, si azzera dopo un aggiornamento della pagina o si riferisce a un magazzino che non può servire l’acquirente. Un blocco utile fornisce al lettore i fatti necessari per agire: stato corrente, destinazione, metodo, tempistiche, condizioni e la prossima azione disponibile.
L’estraibilità automatica significa che un crawler, un agente di acquisto, un feed o una tecnologia assistiva possono preservare la relazione tra una variante e i suoi dati di evasione. Un punto verde accanto a “Disponibile” è semanticamente debole: disponibile per quale colore, località, metodo e tempo? Un blocco etichettato può conservare la risposta completa.
La freschezza è importante perché l’inventario è volatile. Il sistema di contenuti dovrebbe recuperare lo stato dalla fonte commerciale autoritativa, mentre il timestamp visibile e la politica di fallback rendono individuabili i dati obsoleti o non disponibili. I motori di ricerca e i sistemi AI devono vedere lo stesso stato materiale che vede un acquirente; i dati strutturati non possono correggere una pagina contraddittoria.
Quando usarlo
Usa un blocco di disponibilità quando le giacenze o l’evasione ordini determinano se il lettore può completare l’azione prevista. È indicato per pagine di prodotti fisici, elenchi di prodotti dove le scorte influenzano la scelta, biglietti o offerte a inventario limitato, e endpoint di dati commerciali progettati per agenti. Funziona anche per ritiro, consegna locale, tempi di produzione su misura, ordini arretrati, preordini e prodotti fuori produzione.
Renderizza il blocco per ogni variante acquistabile quando dimensioni, colore, confezione, condizioni, venditore o località modificano la risposta. “Disponibile” per l’intera famiglia di prodotti è fuorviante quando la taglia selezionata non è disponibile. Se un marketplace ha più venditori, ogni offerta necessita del proprio prezzo, disponibilità, promessa di consegna e identità del venditore.
Gli errori comuni dovrebbero rimanere al di fuori di questo elemento:
- Il prossimo appuntamento di un team di servizio è una fascia oraria di prenotazione, non la disponibilità di un prodotto.
- Gli orari di apertura appartengono agli orari e alle informazioni di contatto; “aperto ora” non significa che un articolo sia presente.
- Lo stato di rilascio di una funzionalità software appartiene alla documentazione del prodotto o del rilascio, a meno che l’accesso non sia effettivamente limitato dalla capacità.
- La scadenza di una promozione è una condizione dell’offerta, non uno stato di inventario.
- Una politica di spedizione generale spiega le regole tra gli ordini; il blocco di disponibilità applica quelle regole a questo articolo, destinazione e momento.
- Un’affermazione di marketing come “spedizione veloce” non è una stima e non dovrebbe occupare un campo di consegna.
Le regole di scrittura degli elementi hanno la precedenza: scegli il blocco in base allo scopo, non al suo stile di badge, card o accordion. Se il compito principale è dichiarare se e come l’articolo selezionato può essere ottenuto, si tratta di un blocco di disponibilità.
Dove posizionarlo
Posiziona il blocco principale nell’area di acquisto, dopo che l’acquirente ha selezionato ogni variante che influisce sulle scorte e immediatamente prima del controllo quantità e dell’azione di acquisto. Questo ordine permette alla pagina di calcolare uno stato veritiero prima di presentare “Aggiungi al carrello”. Se i controlli delle varianti si trovano sopra il prezzo, posiziona il blocco dopo quei controlli e aggiorna il suo nome accessibile con la selezione effettuata.
In una pagina di categoria o elenco, usa uno stato compatto direttamente all’interno della scheda prodotto corrispondente. Collega alla pagina di dettaglio per date specifiche per destinazione, a meno che la scheda non possa calcolarle accuratamente. In una guida all’acquisto o recensione, posiziona uno stato qualificato editorialmente accanto al venditore e al momento della verifica; non dare a intendere che l’editore controlli l’inventario.
Il blocco può essere posizionato accanto al prezzo quando entrambi si riferiscono alla stessa variante e allo stesso venditore. Non può essere posizionato accanto a un badge in conflitto, a un pulsante di acquisto abilitato per un articolo non disponibile, a un timer di conto alla rovescia non correlato o a un’affermazione di consegna basata su un’altra destinazione. Non posizionare una testimonianza, un carosello promozionale o un cross-selling tra lo stato e la sua azione successiva. Non nascondere lo stato di fuori produzione sotto le recensioni lasciando visibile il precedente controllo di acquisto.
L’ordine mobile deve rimanere: variante selezionata, stato giacenze, scelte di consegna o ritiro, condizioni, quindi azione. Una barra di acquisto fissa può ripetere uno stato breve, ma deve derivare dalla stessa fonte e non contraddire mai il blocco completo.
Anatomia
- Contesto: identifica il prodotto esatto, la variante, il venditore e la località a cui si applicano i dati.
- Stato giacenza: utilizza uno stato controllato come Disponibile, Scorte limitate, Esaurito, Prenotabile, Preordine o Fuori produzione.
- Indicazione quantità: fornisce un conteggio verificato o un’etichetta di soglia non numerica; non crea mai scarsità artificiale.
- Destinazione: indica il paese, la regione, il codice postale o il negozio selezionato utilizzato per la stima.
- Metodo di evasione: separa spedizione, consegna locale, ritiro e consegna digitale.
- Finestra di consegna o disponibilità: mostra una data assoluta o un intervallo delimitato, non “a breve”.
- Termine e condizioni: indica il fuso orario, la scadenza dell’ordine, il presupposto di giorni lavorativi, il requisito di appartenenza o l’ordine minimo quando rilevante.
- Policy e azione per indisponibilità: spiega il comportamento per rifornimento, sostituzione, preordine, notifica o archiviazione.
- Freschezza e fonte: registra quando lo stato è stato risolto e quale servizio autorevole lo ha fornito.
- Azione commerciale: corrisponde allo stato: acquisto, preordine, iscrizione alla lista d’attesa, ricerca di un altro negozio o visualizzazione del successore.
Esempi di design
Ogni variante usa sia testo che colore, preserva il contesto dell’articolo selezionato ed espone un timestamp o un contratto di fonte in tempo reale.
Disponibile con opzioni di evasione. Da usare quando l’articolo è vendibile ora. Separa le scorte online dalle scorte in negozio e mostra una stima per ogni metodo idoneo.
Scorte limitate. Da usare solo quando viene superata una soglia governata. Mostra un conteggio esatto solo se è sicuro e sufficientemente aggiornato; altrimenti indica “Scorte limitate” e mantieni il timestamp.
Esaurito, rifornimento previsto. Disabilita l’azione di acquisto immediata a meno che i preordini non siano accettati. Indica l’intervallo previsto solo quando i dati di merchandising o fornitura lo supportano.
Ordine arretrato o preordine. Mantieni questi stati distinti. Indica quando il pagamento viene autorizzato o addebitato, la data di spedizione o rilascio prevista, i termini di cancellazione e se carrelli misti vengono spediti separatamente.
Fuori produzione. Rimuovi i controlli di acquisto attivi e il markup di offerta attiva. Preserva le specifiche utili e le informazioni di supporto, quindi identifica un successore ufficiale solo quando la relazione è verificata.
Ritiro in negozio. Indica il negozio, l’ora di pronta consegna, la durata della prenotazione e qualsiasi requisito di identificazione. “Disponibile nelle vicinanze” non è sufficiente quando l’acquirente deve recarsi sul posto.
Parametri
“Fonte” di seguito indica da dove il renderizzatore ottiene il valore. I sistemi commerciali rimangono responsabili dell’affermazione sottostante.
| Nome | Tipo | Obbligatorio | Min/max | Predefinito | Fonte |
|---|---|---|---|---|---|
| title | Stringa semplice | No | 1–5 parole | Disponibilità | Prima intestazione nel corpo |
| status | Enum controllato | Sì | Esattamente 1 stato | Nessuno | Attributo |
| sku | Identificativo semplice | Sì per varianti | 1–64 caratteri | Prodotto proprietario | Attributo |
| seller | Identificativo semplice | Sì per marketplace | 1 valore | Proprietario del sito | Attributo |
| quantity | Numero intero non negativo | No | 0–massimo di sistema | Nascosto | Attributo |
| destination | Paese, regione, codice postale o ID negozio | Sì per una stima | 1 destinazione | Mercato dichiarato del sito | Attributo |
| method | Elenco enum | Sì | 1–4 metodi | spedizione | Attributo |
| earliest | Data-ora ISO 8601 | Condizionale | 1 valore | Nessuno | Attributo |
| latest | Data-ora ISO 8601 | Condizionale | 1 valore; non prima di earliest | Uguale a earliest | Attributo |
| cutoff | Data-ora ISO 8601 con offset | No | 1 valore | Assente | Attributo |
| checked | Data-ora ISO 8601 con offset | Sì | 1 valore | Nessuno | Attributo |
| source | Nome sistema controllato | Sì | 1–2 fonti | Nessuno | Attributo |
| policy | Testo semplice | Obbligatorio se non disponibile | 10–45 parole | Nessuno | Corpo |
| action | Etichetta e URL o destinazione controllo | Sì | 2–6 parole; 1 destinazione | Derivato dallo stato | Corpo |
Lo stato controllato corrisponde alla verità commerciale, non alla presentazione: in-stock, limited, out-of-stock, backorder, preorder o discontinued. Un valore specifico del canale come collection-only appartiene a method, perché un articolo può essere disponibile ma solo tramite ritiro.
Sintassi ed esempi di codice
Le tre forme codificano lo stesso SKU selezionato, stato, intervallo di consegna, fonte e azione. Un progetto deve registrare l’adattatore Hugo o WordPress corrispondente prima di utilizzare quella sintassi in produzione.
Direttiva Markdown portabile
:::availability{status=in-stock sku="TJ-NV-M" destination="US-10001" method="shipping,collection" earliest="2026-08-31" latest="2026-09-01" cutoff="2026-08-28T14:00:00-04:00" checked="2026-08-27T09:42:00-04:00" source="inventory-api,fulfilment-api"}
## Disponibilità
Disponibile online e pronto per la spedizione.
Azione: [Aggiungi Giacchetta Trail blu, taglia M al carrello](https://example.com/cart/add/TJ-NV-M)
:::
Shortcode Hugo
{{< availability status="in-stock" sku="TJ-NV-M" destination="US-10001" method="shipping,collection" earliest="2026-08-31" latest="2026-09-01" cutoff="2026-08-28T14:00:00-04:00" checked="2026-08-27T09:42:00-04:00" source="inventory-api,fulfilment-api" >}}
## Disponibilità
Disponibile online e pronto per la spedizione.
Azione: [Aggiungi Giacchetta Trail blu, taglia M al carrello](https://example.com/cart/add/TJ-NV-M)
{{< /availability >}}
Tutti i parametri sono nominati. L’esempio evita intenzionalmente di mescolare parametri posizionali e nominati.
WordPress
[availability status="in-stock" sku="TJ-NV-M" destination="US-10001" method="shipping,collection" earliest="2026-08-31" latest="2026-09-01" cutoff="2026-08-28T14:00:00-04:00" checked="2026-08-27T09:42:00-04:00" source="inventory-api,fulfilment-api"]
Disponibile online e pronto per la spedizione.
Azione: <a href="https://example.com/cart/add/TJ-NV-M">Aggiungi Giacchetta Trail blu, taglia M al carrello</a>
[/availability]
Un blocco WordPress nativo dovrebbe memorizzare questi valori come attributi tipizzati piuttosto che come un unico blob di testo ricco. Il rendering lato server è preferito per lo stato iniziale; la personalizzazione lato client può perfezionare la destinazione e la stima dopo il consenso o l’inserimento.
Esempi buoni e cattivi
Buono
Giacchetta Trail blu, taglia M — disponibile online. Consegna a 10001 stimata per il 31 agosto–1 settembre con spedizione standard. Ordina entro le 14:00 ET del 28 agosto. La disponibilità per il ritiro in negozio viene verificata separatamente. Stima inventario e consegna verificata alle 09:42 ET del 27 agosto 2026.
Funziona perché lega lo stato a una variante selezionata, destinazione, metodo, intervallo di date, fuso orario e momento della verifica. Il lettore può agire senza dover interpretare un’icona o aprire una policy generica.
Cattivo
🟢 Sbrigati! Disponibile ora — in vendita veloce. Consegna a breve. Solo pochi rimasti!
Fallisce perché “disponibile” non ha variante, venditore o canale; “a breve” non ha destinazione o date; “pochi” non ha una soglia governata e l’urgenza non può essere verificata. L’icona verde inoltre porta un significato assente dal testo. Sostituire l’icona con una rossa non risolverebbe la mancanza di dati.
Marcatura Schema e accessibilità
Per un articolo genuinamente acquistabile, il blocco può alimentare Product.offers tramite un’Offerta o OffertaAggregata. Mappa lo stato visibile controllato all’URL di disponibilità Schema.org corrispondente, come InStock, OutOfStock, BackOrder, PreOrder, Discontinued o LimitedAvailability. Prezzo, valuta, venditore, condizioni dell’articolo e URL devono descrivere la stessa offerta. Non usare InStock solo perché un’altra variante o venditore ha inventario.
I dati di consegna possono alimentare OffertaDettagliSpedizione: destinazione, tempo di gestione, tempo di transito, tariffa e metodo idoneo devono concordare con la promessa visibile. Non emettere un’Offerta attiva per un articolo fuori produzione né lasciare marcature di offerta obsolete quando l’azione visibile diventa una lista d’attesa.
I dati strutturati sono un output dello stato commerciale, non un secondo database di inventario. Genera il blocco visibile, il feed e il JSON-LD dalla stessa offerta risolta quando possibile. Se non possono essere aggiornati con la stessa cadenza, pubblica lo stato difendibile meno permissivo fino al completamento della sincronizzazione.
L’accessibilità richiede un’etichetta testuale per ogni stato; colore, animazione e icone possono rafforzarlo ma mai definirlo. Associa gli aggiornamenti alla variante selezionata. Quando un cambio di variante o destinazione aggiorna il blocco in modo asincrono, non spostare il focus né il lettore in modo inaspettato; comunica un risultato conciso tramite una regione live configurata appropriatamente. Evita di ripetere annunci di conto alla rovescia ogni secondo.
I controlli di consegna necessitano di etichette esplicite come “Codice postale di consegna” e “Cambia negozio di ritiro”. Le date devono includere il mese in parole dove l’ordine numerico potrebbe essere ambiguo, e le scadenze devono avere un fuso orario. I controlli di acquisto disabilitati necessitano di testo vicino che spieghi perché e offra l’azione successiva valida. Mantieni lo stato completo disponibile senza hover e fornisci un fallback renderizzato lato server quando JavaScript fallisce.
Regole di scrittura
Inizia con lo stato controllato in due-sei parole: “Disponibile online”, “Prenotabile” o “Fuori produzione”. Segui con la conseguenza: pronto per la spedizione, data di rilascio prevista o non più venduto. Usa un blocco per offerta selezionata, non un blocco per record di magazzino.
Usa date di consegna assolute o un intervallo delimitato di due date. Se la stima cambia per destinazione, indica la destinazione. Se nessuna stima è affidabile, spiega cosa deve accadere prima che se ne possa calcolare una. “Di solito”, “a breve”, “veloce” e “dovrebbe arrivare” non sostituiscono un intervallo documentato.
Mantieni il blocco principale con una riga di stato, da una a quattro righe di evasione, una frase di policy di 10–45 parole quando necessario e un’azione principale. Un’etichetta di scorte limitate necessita di una soglia approvata; un conteggio esatto necessita di una fonte aggiornata. Verifica lo stato continuamente tramite integrazione di sistema e testa il suo fallback durante ogni ciclo di QA dei contenuti.
Usa un linguaggio calmo e operativo. Non includere mai scarsità inventata, affermazioni anonime di popolarità, sconti non correlati, testimonianze, dettagli di garanzia, termini di reso completi o copia generica della politica di spedizione. Non chiamare mai un preordine “disponibile”, rappresentare un articolo non disponibile come “disponibile su ordinazione” senza specificare preordine, né promettere una data che il sistema di evasione non può supportare.
Per gli articoli fuori produzione, dì “Fuori produzione” piuttosto che “Attualmente non disponibile”. Spiega se supporto, ricambi, manuali o un successore ufficiale rimangono disponibili.
Tipi di post che lo utilizzano
Il campo postTypes del frontmatter è la fonte per questa matrice di implementazione.
| Tipo di post | Ruolo | Posizionamento | Adattamento richiesto |
|---|---|---|---|
| Pagina prodotto | Vincolo di acquisto primario | Dopo la selezione variante, prima della quantità e dell'azione di acquisto | Risolvi per SKU, venditore, destinazione e metodo |
| Pagina categoria | Segnale di selezione compatto | All'interno di ogni scheda prodotto corrispondente | Mostra uno stato a livello di canale; rimanda la consegna precisa fino a quando la destinazione non è nota |
| Guida all'acquisto | Dato commerciale sensibile al tempo | Accanto al prodotto e venditore raccomandati | Indica il venditore e il momento della verifica; evita di far intendere il controllo da parte dell'editore |
| Pagina di recensione | Percorso di acquisto corrente | Vicino al giudizio o all'azione del venditore | Separa i dati del prodotto testato dalle scorte attuali del rivenditore |
| Dati prodotto agentici | Stato dell'offerta processabile da macchina | All'interno di ogni record di offerta | Esponi identificatori stabili, timestamp, destinazioni, metodi e schema sincronizzato |
Checklist QA
- Lo stato si applica allo SKU, venditore, canale e località selezionati, non alla famiglia di prodotti in generale.
- Giacenze, vendibilità, metodo di evasione e tempistiche di consegna sono campi separati e non si contraddicono a vicenda.
- Le fonti di inventario e evasione ordini sono autorevoli, monitorate e indicate nel contratto del componente.
- Il momento della verifica è presente, include un fuso orario e soddisfa la tolleranza di freschezza dell’azienda.
- I conteggi esatti e le etichette di scorte limitate utilizzano regole governate, non urgenza promozionale.
- Ogni stima di consegna indica o eredita una destinazione visibile e utilizza una data assoluta o un intervallo delimitato.
- Gli stati di ordine arretrato e preordine spiegano le tempistiche di pagamento, la spedizione o rilascio prevista e le condizioni di cancellazione.
- Gli stati di esaurito e fuori produzione rimuovono o sostituiscono l’azione di acquisto immediata.
- Contenuto visibile, dati del feed, comportamento del checkout e dati strutturati dell’Offerta descrivono lo stesso stato.
- Lo stato è comunicato tramite testo, le modifiche dinamiche vengono annunciate appropriatamente e i controlli hanno etichette esplicite.
- Il blocco rimane significativo senza colore, hover, animazione, personalizzazione o JavaScript.
- I trattamenti mobili e della barra di acquisto fissa derivano dalla stessa fonte e preservano l’ordine di lettura corretto.
- Tutti e tre gli esempi di sintassi mappano agli stessi campi tipizzati senza perdere dati di fonte o freschezza.
FAQ
Un blocco di disponibilità dovrebbe mostrare il numero esatto di pezzi in magazzino?
Solo se il sistema di inventario è autorevole, il conteggio si aggiorna abbastanza rapidamente e la sua esposizione non crea rischi operativi o di sicurezza. In caso contrario, usa uno stato controllato come Disponibile, Scorte limitate, Prenotabile o Esaurito. Non inventare mai urgenza con un conteggio non verificato.
Cosa dovrebbe dire il blocco quando un articolo è esaurito?
Indica Esaurito, spiega se è previsto un rifornimento, fornisci una data o un intervallo verificato quando disponibile e offri un’azione pertinente come un avviso di riassortimento. Non mostrare un’Offerta acquistabile né un pulsante Aggiungi al carrello attivo se il checkout non può accettare l’ordine.
Come dovrebbero differire preordini e ordini arretrati?
Un ordine arretrato riguarda un articolo esistente temporaneamente non disponibile per l’evasione immediata; un preordine riguarda un articolo non ancora rilasciato per la vendita normale. Etichetta lo stato correttamente, indica quando viene effettuato il pagamento e fornisci la data di spedizione o rilascio prevista con eventuali incertezze.
Un blocco di disponibilità richiede lo schema Offerta?
No. Il blocco visibile deve essere accurato anche senza dati strutturati. Quando la pagina descrive un’offerta acquistabile reale, il suo stato visivo deve allinearsi con il valore di disponibilità dell’Offerta e con eventuali dettagli di spedizione. Le menzioni editoriali e i record di catalogo non disponibili non devono essere contrassegnati come offerte attive.
Le stime di consegna possono essere personalizzate in base alla località?
Sì, se la destinazione è identificata ed è disponibile un’alternativa non personalizzata. Comunica le modifiche dinamiche alla tecnologia assistiva, evita di usare la posizione IP come certezza e mantieni accurato lo stato delle giacenze renderizzato lato server per crawler e utenti senza JavaScript.
Altri tutorial in questa sezione
Pronto a metterlo in pratica?
Verifica gratuita · Prova di 7 giorni · senza carta di credito