Bloques de Disponibilidad: Stock, Entrega y Cumplimiento

Un bloque de disponibilidad responde la última pregunta operativa del comprador: ¿puedo obtener este artículo, por qué método y cuándo? Mantiene los datos de stock, entrega, recogida, pedidos pendientes y productos descontinuados en una unidad extraíble en lugar de dispersarlos entre una insignia, un tooltip de pago y una página de política de envío.

Por qué importa este elemento

La disponibilidad no es texto de tranquilidad. Es una restricción de compra. Un comprador que ha elegido un producto puede abandonar la decisión si la página no puede responder si la variante seleccionada es vendible, si la entrega llega a la ubicación requerida o si llega antes de una fecha límite real. La disponibilidad precisa reduce la incertidumbre en el momento en que la incertidumbre es más costosa.

La psicología tiene que ver con el control, no con la urgencia artificial. «Solo quedan 2» puede ayudar a alguien a evaluar el riesgo cuando el número es verdadero y actual. El mismo mensaje daña la confianza cuando persiste durante días, se reinicia al actualizar la página o se refiere a un almacén que no puede servir al comprador. Un bloque útil proporciona al lector los datos necesarios para actuar: estado actual, destino, método, plazo, condiciones y la siguiente acción disponible.

La extraíbilidad por máquina significa que un rastreador, agente de compras, feed o tecnología de asistencia puede preservar la relación entre una variante y sus datos de cumplimiento. Un punto verde junto a «Disponible» es semánticamente débil: ¿disponible para qué color, ubicación, método y momento? Un bloque etiquetado puede retener la respuesta completa.

La actualización importa porque el inventario es volátil. El sistema de contenido debe recuperar el estado desde la fuente de veracidad del comercio, mientras que la marca de tiempo visible y la política de respaldo hacen detectable la información desactualizada o no disponible. Los motores de búsqueda y los sistemas de IA deben ver el mismo estado material que ve un comprador; los datos estructurados no pueden reparar una página contradictoria.

Cuándo usarlo

Usa un bloque de disponibilidad cuando el stock o el cumplimiento cambien si el lector puede completar la acción prevista. Pertenece a páginas de producto físico, listados de productos donde el stock afecta la selección, entradas u ofertas con inventario limitado, y puntos finales de datos comerciales diseñados para agentes. También funciona para recogida, entrega local, plazos de fabricación bajo pedido, pedidos pendientes, preventas y productos descontinuados.

Renderiza el bloque por variante comprable cuando el tamaño, color, paquete, condición, vendedor o ubicación cambien la respuesta. «En stock» para la familia de productos es engañoso cuando la talla seleccionada no está disponible. Si un marketplace tiene varios vendedores, cada oferta necesita su propio precio, disponibilidad, promesa de entrega e identidad del vendedor.

Errores comunes cercanos deben permanecer fuera de este elemento:

• La próxima cita de un equipo de servicio es un espacio de reserva, no disponibilidad de stock.
• Los horarios de apertura pertenecen a información de contacto y horarios; «abierto ahora» no significa que un artículo esté presente.
• El estado de lanzamiento de una funcionalidad de software pertenece a la documentación del producto o versión, a menos que el acceso esté genuinamente limitado por capacidad.
• La caducidad de una promoción es una condición de oferta, no un estado de inventario.
• Una política general de envío explica reglas entre pedidos; el bloque de disponibilidad aplica esas reglas a este artículo, destino y momento.
• Una afirmación de marketing de un minorista como «envía rápido» no es una estimación y no debe ocupar un campo de entrega.

Las reglas de escritura de elementos tienen prioridad: elige el bloque por su propósito, no por su estilo de insignia, tarjeta o acordeón. Si la función principal es indicar si y cómo se puede obtener el artículo seleccionado, es un bloque de disponibilidad.

Dónde colocarlo

Coloca el bloque principal en la zona de compra, después de que el comprador haya seleccionado cada variante que afecte al stock e inmediatamente antes del control de cantidad y la acción de compra. Este orden permite que la página calcule un estado veraz antes de presentar «Añadir al carrito». Si los controles de variante están por encima del precio, coloca el bloque después de esos controles y actualiza su nombre accesible con la selección.

En una página de categoría o listado, usa un estado compacto directamente dentro de la tarjeta de producto correspondiente. Enlaza a la página de detalle para obtener fechas específicas del destino, a menos que la tarjeta pueda calcularlas con precisión. En una guía de compra o reseña, coloca un estado editorialmente calificado junto al comerciante y la hora de verificación; no impliques que el publicador controla el inventario.

El bloque puede situarse junto al precio cuando ambos se refieren a la misma variante y vendedor. No puede situarse junto a una insignia contradictoria, un botón de compra habilitado para un artículo no disponible, un temporizador de cuenta regresiva no relacionado o una afirmación de entrega basada en otro destino. No coloques un testimonio, carrusel promocional ni venta cruzada entre el estado y su siguiente acción. No ocultes el estado de descontinuado debajo de las reseñas mientras dejas visible el antiguo control de compra.

El orden en móvil debe mantenerse: variante seleccionada, estado de stock, opciones de entrega o recogida, condiciones, luego acción. Una barra de compra adhesiva puede repetir un estado breve, pero debe derivar de la misma fuente y nunca contradecir al bloque completo.

Anatomía

1. Contexto: identifica el producto exacto, variante, vendedor y ubicación a los que aplican los datos.
2. Estado de stock: usa un estado controlado como En stock, Stock bajo, Agotado, Pedido pendiente, Preventa o Descontinuado.
3. Declaración de cantidad: proporciona un recuento verificado o una etiqueta de umbral no numérica; nunca fabrica escasez.
4. Destino: nombra el país, región, código postal o tienda seleccionada utilizada para la estimación.
5. Método de cumplimiento: separa envío, entrega local, recogida y entrega digital.
6. Ventana de entrega o preparación: muestra una fecha absoluta o un rango acotado, no «pronto».
7. Plazo y condiciones: indica la zona horaria, fecha límite de pedido, suposición de días hábiles, requisito de membresía o pedido mínimo cuando sea relevante.
8. Política y acción para no disponible: explica reposición, sustitución, pedido pendiente, notificación o comportamiento de archivo.
9. Actualidad y fuente: registra cuándo se resolvió el estado y qué servicio autoritativo lo proporcionó.
10. Acción comercial: coincide con el estado: compra, preventa, unirse a lista de espera, buscar otra tienda o ver sucesor.

Ejemplos de diseño

Cada variante usa texto además de color, preserva el contexto del artículo seleccionado y expone una marca de tiempo o un contrato de fuente en vivo.

En stock con opciones de cumplimiento. Úsalo cuando el artículo se pueda vender ahora. Separa el stock online del stock en tienda y muestra una estimación por método elegible.

Stock bajo. Úsalo solo cuando se supere un umbral gobernado. Muestra un recuento exacto solo si es seguro y suficientemente actual; de lo contrario, di «Stock bajo» y conserva la marca de tiempo.

Agotado, con reposición esperada. Deshabilita la acción de compra inmediata a menos que se acepten pedidos pendientes. Indica el rango esperado solo cuando los datos de comercialización o suministro lo respalden.

Pedido pendiente o preventa. Mantén estos estados distintos. Indica cuándo se autoriza o cobra el pago, la fecha esperada de envío o lanzamiento, los términos de cancelación y si los carritos mixtos se envían por separado.

Descontinuado. Elimina los controles activos de compra y el marcado de oferta activa. Conserva las especificaciones útiles y la información de soporte, luego identifica un sucesor oficial solo cuando la relación esté verificada.

Recogida en tienda. Nombra la tienda, la hora de preparación, la duración de la reserva y cualquier requisito de identificación. «Disponible cerca» no es suficiente cuando el comprador debe viajar.

Parámetros

«Fuente» a continuación indica dónde obtiene el valor el renderizador. Los sistemas comerciales siguen siendo responsables de la afirmación subyacente.

El estado controlado se asigna a la verdad comercial, no a la presentación: in-stock, limited, out-of-stock, backorder, preorder o discontinued. Un valor específico de canal como collection-only pertenece a method, porque un artículo puede estar en stock pero disponible solo mediante recogida.

Sintaxis y ejemplos de código

Las tres formas codifican el mismo SKU seleccionado, estado, rango de entrega, fuente y acción. Un proyecto debe registrar el adaptador Hugo o WordPress correspondiente antes de usar esa sintaxis en producción.

Directiva Markdown portátil

:::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"}
## Disponibilidad

En stock online y listo para enviar.
Acción: [Añadir Chaqueta Trail azul marino, talla M al carrito](https://example.com/cart/add/TJ-NV-M)
:::

Shortcode de 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" >}}
## Disponibilidad

En stock online y listo para enviar.
Acción: [Añadir Chaqueta Trail azul marino, talla M al carrito](https://example.com/cart/add/TJ-NV-M)
{{< /availability >}}

Todos los parámetros son nombrados. El ejemplo evita intencionadamente mezclar parámetros posicionales y nombrados.

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"]
En stock online y listo para enviar.
Acción: <a href="https://example.com/cart/add/TJ-NV-M">Añadir Chaqueta Trail azul marino, talla M al carrito</a>
[/availability]

Un bloque nativo de WordPress debe almacenar estos valores como atributos tipificados en lugar de un único blob de texto enriquecido. Se prefiere el renderizado del lado del servidor para el estado inicial; la personalización del lado del cliente puede refinar el destino y la estimación tras el consentimiento o la entrada.

Ejemplos buenos y malos

Bueno

Chaqueta Trail azul marino, talla M — en stock online. La entrega a 10001 está estimada para el 31 de agosto–1 de septiembre con envío estándar. Pide antes de las 14:00 ET del 28 de agosto. La disponibilidad de recogida en tienda se verifica por separado. Inventario y estimación de entrega verificados a las 09:42 ET del 27 de agosto de 2026.

Esto funciona porque vincula el estado a una variante seleccionada, destino, método, rango de fechas, zona horaria y hora de verificación. El lector puede actuar sin interpretar un icono ni abrir una política genérica.

Malo

🟢 ¡Date prisa! Disponible ahora — se vende rápido. Entrega pronto. ¡Solo quedan unos pocos!

Esto falla porque «disponible» no tiene variante, vendedor ni canal; «pronto» no tiene destino ni fechas; «unos pocos» no tiene un umbral gobernado; y la urgencia no puede auditarse. El icono verde también transmite un significado que está ausente en el texto. Reemplazar el icono por uno rojo no solucionaría los datos faltantes.

Marcado de esquema y accesibilidad

Para un artículo genuinamente comprable, el bloque puede alimentar Product.offers a través de un Offer o AggregateOffer. Asigna el estado visible controlado a la URL de disponibilidad de Schema.org correspondiente, como InStock, OutOfStock, BackOrder, PreOrder, Discontinued o LimitedAvailability. El precio, la moneda, el vendedor, el estado del artículo y la URL deben describir la misma oferta. No uses InStock simplemente porque otra variante o vendedor tenga inventario.

Los datos de entrega pueden alimentar OfferShippingDetails: destino, tiempo de manipulación, tiempo de tránsito, tarifa y método elegible deben coincidir con la promesa visible. No emitas un Offer activo para un artículo descontinuado ni dejes un marcado de oferta obsoleto cuando la acción visible pase a ser una lista de espera.

Los datos estructurados son una salida del estado comercial, no una segunda base de datos de inventario. Genera el bloque visible, el feed y el JSON-LD a partir de la misma oferta resuelta siempre que sea posible. Si no pueden actualizarse con la misma frecuencia, publica el estado defendible menos permisivo hasta que se complete la sincronización.

La accesibilidad requiere una etiqueta de texto para cada estado; el color, la animación y los iconos pueden reforzarlo pero nunca definirlo. Asocia las actualizaciones con la variante seleccionada. Cuando un cambio de variante o destino actualice el bloque de forma asíncrona, no muevas el foco ni al lector inesperadamente; anuncia un resultado conciso a través de una región en vivo configurada adecuadamente. Evita repetir anuncios de cuenta regresiva cada segundo.

Los controles de entrega necesitan etiquetas explícitas como «Código postal de entrega» y «Cambiar tienda de recogida». Las fechas deben incluir el mes en palabras cuando el orden numérico pueda ser ambiguo, y los plazos necesitan una zona horaria. Los controles de compra deshabilitados necesitan texto cercano que explique por qué y ofrezca la siguiente acción válida. Mantén el estado completo disponible sin necesidad de pasar el ratón y proporciona una alternativa renderizada en servidor cuando JavaScript falle.

Reglas de escritura

Comienza con el estado controlado en dos a seis palabras: «En stock online», «Pedido pendiente disponible» o «Descontinuado». Continúa con la consecuencia: listo para enviar, fecha de lanzamiento esperada o ya no se vende. Usa un bloque por oferta seleccionada, no un bloque por registro de almacén.

Usa fechas de entrega absolutas o un rango acotado de dos fechas. Si la estimación cambia según el destino, nombra el destino. Si ninguna estimación es fiable, di qué debe suceder antes de que se pueda calcular una. «Generalmente», «pronto», «rápido» y «debería llegar» no son sustitutos de un rango con fuente.

Mantén el bloque principal con una línea de estado, de una a cuatro filas de cumplimiento, una oración de política de 10 a 45 palabras cuando sea necesario y una acción principal. Una etiqueta de stock bajo necesita un umbral aprobado; un recuento exacto necesita una fuente actual. Revisa el estado continuamente mediante integración de sistema y prueba su respaldo durante cada ciclo de control de calidad de contenido.

Usa un lenguaje calmado y operativo. Nunca incluyas escasez fabricada, afirmaciones anónimas de popularidad, descuentos no relacionados, testimonios, detalles de garantía, términos completos de devolución ni copia genérica de política de envío. Nunca llames «en stock» a una preventa, representes un artículo no disponible como «disponible para pedido» sin decir pedido pendiente, ni prometas una fecha que el sistema de cumplimiento no pueda respaldar.

Para artículos descontinuados, di «Descontinuado» en lugar de «No disponible actualmente». Explica si el soporte, las piezas, los manuales o un sucesor oficial siguen disponibles.

Tipos de publicación que lo usan

El campo postTypes del frontmatter es la fuente de esta matriz de implementación.

Lista de verificación de QA

• El estado aplica al SKU, vendedor, canal y ubicación seleccionados, no a la familia de productos en general.
• El stock, la vendibilidad, el método de cumplimiento y el plazo de entrega son campos separados y no se contradicen entre sí.
• Las fuentes de inventario y cumplimiento son autoritativas, están monitoreadas y nombradas en el contrato del componente.
• La hora de verificación está presente, incluye una zona horaria y cumple con la tolerancia de actualización del negocio.
• Los recuentos exactos y las etiquetas de stock bajo usan reglas gobernadas, no urgencia promocional.
• Cada estimación de entrega nombra o hereda un destino visible y usa una fecha absoluta o un rango acotado.
• Los estados de pedido pendiente y preventa explican el momento del pago, el envío o lanzamiento esperado y las condiciones de cancelación.
• Los estados de agotado y descontinuado eliminan o reemplazan la acción de compra inmediata.
• El contenido visible, los datos del feed, el comportamiento del pago y los datos estructurados de Offer describen el mismo estado.
• El estado se transmite en texto, los cambios dinámicos se anuncian adecuadamente y los controles tienen etiquetas explícitas.
• El bloque sigue siendo significativo sin color, hover, animación, personalización ni JavaScript.
• Los tratamientos móvil y de compra adhesiva derivan de la misma fuente y preservan el orden de lectura correcto.
• Los tres ejemplos de sintaxis se asignan a los mismos campos tipificados sin perder datos de fuente o actualidad.

FAQ

¿Debería un bloque de disponibilidad mostrar un número exacto de existencias?

Solo cuando el sistema de inventario es autoritativo, el recuento se actualiza con la suficiente rapidez y su exposición no genera ningún riesgo operativo o de seguridad. De lo contrario, usa un estado controlado como En stock, Stock bajo, Pedido pendiente o Agotado. Nunca inventes urgencia con un recuento no verificado.

¿Qué debería decir el bloque cuando un artículo está agotado?

Indica Agotado, explica si se espera reposición, proporciona una fecha o rango verificado cuando exista, y ofrece una acción relevante como una alerta de reposición. No muestres una Oferta comprable ni una acción de Añadir al carrito activa cuando el proceso de pago no pueda aceptar el pedido.

¿En qué deberían diferenciarse los pedidos pendientes y los preventas?

Un pedido pendiente (backorder) es un artículo establecido temporalmente no disponible para cumplimiento inmediato; una preventa (pre-order) es un artículo aún no lanzado para venta normal. Etiqueta el estado con precisión, indica cuándo se realiza el cobro y proporciona la fecha esperada de envío o lanzamiento con cualquier incertidumbre.

¿Requiere un bloque de disponibilidad el esquema Offer?

No. El bloque visible debe ser preciso incluso sin datos estructurados. Cuando la página describe una oferta comprable genuina, su estado visible debe alinearse con el valor de disponibilidad de Offer y cualquier detalle de envío. Las menciones editoriales y los registros de catálogo no disponibles no deben marcarse como ofertas activas.

¿Pueden personalizarse las estimaciones de entrega por ubicación?

Sí, si el destino está identificado y hay disponible una alternativa no personalizada. Anuncia los cambios dinámicos a la tecnología de asistencia, evita usar la ubicación IP como certeza y mantén el estado de stock renderizado en servidor preciso para rastreadores y usuarios sin JavaScript.