Bloco de Disponibilidade: Estoque, Entrega e Atendimento

Um bloco de disponibilidade responde à última pergunta operacional do comprador: posso obter este item, por qual método e quando? Ele mantém fatos sobre estoque, entrega, retirada, pré-venda e descontinuidade em uma unidade extraível, em vez de espalhá-los entre um selo, uma dica no checkout e uma página de política de envio.

Por que este elemento é importante

Disponibilidade não é texto de reassurance. É uma restrição de compra. Um comprador que escolheu um produto ainda pode abandonar a decisão se a página não puder responder se a variante selecionada é vendável, se a entrega alcança o local necessário ou se chega antes de um prazo real. A disponibilidade precisa reduz a incerteza no momento em que a incerteza é mais custosa.

A psicologia é sobre controle, não urgência artificial. “Apenas 2 restantes” pode ajudar alguém a avaliar o risco quando o número é verdadeiro e atual. A mesma mensagem prejudica a confiança quando persiste por dias, reseta após atualização ou se refere a um armazém que não pode atender o comprador. Um bloco útil fornece ao leitor os fatos necessários para agir: status atual, destino, método, prazo, condições e a próxima ação disponível.

A extraibilidade por máquina significa que um rastreador, agente de compra, feed ou tecnologia assistiva pode preservar a relação entre uma variante e seus fatos de atendimento. Um ponto verde ao lado de “Disponível” é semanticamente fraco: disponível para qual cor, local, método e horário? Um bloco rotulado pode reter a resposta completa.

A atualidade importa porque o inventário é volátil. O sistema de conteúdo deve recuperar o status da fonte de verdade do comércio, enquanto o carimbo de data/hora visível e a política de fallback tornam detectáveis dados desatualizados ou indisponíveis. Mecanismos de busca e sistemas de IA devem ver o mesmo estado material que um comprador vê; dados estruturados não podem reparar uma página contraditória.

Quando usar

Use um bloco de disponibilidade quando o estoque ou o atendimento alterar se o leitor pode concluir a ação pretendida. Ele pertence a páginas de produto físico, listagens de produto onde o estoque afeta a seleção, ingressos ou ofertas com estoque limitado, e endpoints de dados comerciais projetados para agentes. Também funciona para retirada, entrega local, prazos de produção sob encomenda, pré-vendas, encomendas e produtos descontinuados.

Renderize o bloco por variante comprável quando tamanho, cor, pacote, condição, vendedor ou localização alterar a resposta. “Em estoque” para a família de produtos é enganoso quando o tamanho selecionado está indisponível. Se um marketplace tem vários vendedores, cada oferta precisa de seu próprio preço, disponibilidade, promessa de entrega e identidade do vendedor.

Erros comuns próximos devem ficar fora deste elemento:

• O próximo agendamento de uma equipe de serviço é um horário de reserva, não disponibilidade de estoque.
• Horários de funcionamento pertencem a horários e informações de contato; “aberto agora” não significa que um item está presente.
• O status de lançamento de um recurso de software pertence à documentação do produto ou de lançamento, a menos que o acesso seja genuinamente limitado por capacidade.
• O prazo de validade de uma promoção é uma condição de oferta, não um estado de inventário.
• Uma política geral de envio explica regras entre pedidos; o bloco de disponibilidade aplica essas regras a este item, destino e momento.
• Uma alegação de marketing de um varejista como “envia rápido” não é uma estimativa e não deve ocupar um campo de entrega.

As regras de escrita de elementos têm precedência: escolha o bloco pelo propósito, não pelo seu selo, cartão ou estilo de acordeão. Se o trabalho principal é informar se e como o item selecionado pode ser obtido, é um bloco de disponibilidade.

Onde posicionar

Coloque o bloco principal na região de compra, após o comprador ter selecionado cada variante que afeta o estoque e imediatamente antes do controle de quantidade e da ação de compra. Esta ordem permite que a página calcule um estado verdadeiro antes de apresentar “Adicionar ao carrinho”. Se os controles de variante ficam acima do preço, coloque o bloco após esses controles e atualize seu nome acessível com a seleção.

Em uma página de categoria ou listagem, use um status compacto diretamente dentro do cartão de produto correspondente. Vincule à página de detalhes para datas específicas do destino, a menos que o cartão possa calculá-las com precisão. Em um guia de compra ou avaliação, coloque um status qualificado editorialmente ao lado do comerciante e do horário de verificação; não insinue que o publicador controla o inventário.

O bloco pode ficar ao lado do preço quando ambos se referem à mesma variante e vendedor. Não pode ficar ao lado de um selo conflitante, um botão de compra habilitado para um item indisponível, um cronômetro de contagem regressiva não relacionado ou uma alegação de entrega baseada em outro destino. Não coloque um depoimento, carrossel promocional ou venda cruzada entre o status e sua próxima ação. Não esconda o status de descontinuado abaixo das avaliações enquanto mantém o antigo controle de compra visível.

A ordem mobile deve permanecer: variante selecionada, estado do estoque, opções de entrega ou retirada, condições, depois ação. Uma barra de compra fixa pode repetir um estado resumido, mas deve derivar da mesma fonte e nunca contradizer o bloco completo.

Anatomia

1. Contexto: identifica o produto exato, variante, vendedor e local aos quais os fatos se aplicam.
2. Status do estoque: usa um estado controlado como Em estoque, Estoque baixo, Fora de estoque, Pré-venda, Encomenda ou Descontinuado.
3. Indicação de quantidade: fornece uma contagem verificada ou um rótulo de limite não numérico; nunca fabrica escassez.
4. Destino: nomeia o país, região, código postal ou loja selecionada usada para a estimativa.
5. Método de atendimento: separa envio, entrega local, retirada e entrega digital.
6. Janela de entrega ou prontidão: mostra uma data absoluta ou intervalo delimitado, não “em breve”.
7. Prazo limite e condições: informa o fuso horário, prazo do pedido, suposição de dia útil, exigência de associação ou pedido mínimo quando relevante.
8. Política e ação para indisponibilidade: explica reposição, substituição, pré-venda, notificação ou comportamento de arquivamento.
9. Atualidade e fonte: registra quando o estado foi resolvido e qual serviço autoritativo o forneceu.
10. Ação comercial: corresponde ao estado: compra, encomenda, entrar na lista de espera, encontrar outra loja ou ver sucessor.

Exemplos de design

Cada variante usa texto além de cor, preserva o contexto do item selecionado e expõe um carimbo de data/hora ou contrato de fonte ao vivo.

Em estoque com opções de atendimento. Use quando o item está vendável agora. Separe o estoque online do estoque da loja e mostre uma estimativa por método elegível.

Estoque baixo. Use apenas quando um limite governado for ultrapassado. Mostre uma contagem exata somente se for segura e suficientemente atual; caso contrário, diga “Estoque baixo” e mantenha o carimbo de data/hora.

Fora de estoque, com reposição esperada. Desabilite a ação de compra imediata a menos que pré-vendas sejam aceitas. Informe o intervalo esperado apenas quando os dados de merchandising ou fornecimento o suportarem.

Pré-venda ou encomenda. Mantenha esses estados distintos. Informe quando o pagamento é autorizado ou capturado, a data prevista de envio ou lançamento, os termos de cancelamento e se carrinhos mistos são enviados separadamente.

Descontinuado. Remova controles de compra ativos e marcação de oferta ativa. Preserve especificações úteis e informações de suporte, então identifique um sucessor oficial apenas quando a relação for verificada.

Retirada na loja. Nomeie a loja, horário de prontidão, duração da reserva e qualquer exigência de identificação. “Disponível nas proximidades” não é suficiente quando o comprador precisa se deslocar.

Parâmetros

“Fonte” abaixo significa de onde o renderizador obtém o valor. Os sistemas de comércio permanecem responsáveis pela afirmação subjacente.

O status controlado mapeia para a verdade do comércio, não para a apresentação: in-stock, limited, out-of-stock, backorder, preorder ou discontinued. Um valor específico de canal como collection-only pertence a method, porque um item pode estar em estoque enquanto disponível apenas para retirada.

Sintaxe e exemplos de código

As três formas codificam o mesmo SKU selecionado, estado, intervalo de entrega, fonte e ação. Um projeto deve registrar o adaptador Hugo ou WordPress correspondente antes de usar essa sintaxe em produção.

Diretiva 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"}
## Disponibilidade

Em estoque online e pronto para envio.
Ação: [Adicionar Trail Jacket azul marinho, tamanho M ao carrinho](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" >}}
## Disponibilidade

Em estoque online e pronto para envio.
Ação: [Adicionar Trail Jacket azul marinho, tamanho M ao carrinho](https://example.com/cart/add/TJ-NV-M)
{{< /availability >}}

Todos os parâmetros são nomeados. O exemplo evita intencionalmente misturar parâmetros posicionais e nomeados.

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"]
Em estoque online e pronto para envio.
Ação: <a href="https://example.com/cart/add/TJ-NV-M">Adicionar Trail Jacket azul marinho, tamanho M ao carrinho</a>
[/availability]

Um bloco nativo do WordPress deve armazenar esses valores como atributos tipados em vez de um único bloco de rich text. A renderização no lado do servidor é preferida para o estado inicial; a personalização no lado do cliente pode refinar o destino e a estimativa após consentimento ou entrada.

Exemplos bons e ruins

Bom

Trail Jacket azul marinho, tamanho M — em estoque online. A entrega para 10001 está estimada para 31 de agosto–1 de setembro com frete padrão. Peça até as 14:00 ET de 28 de agosto. A disponibilidade para retirada na loja é verificada separadamente. Inventário e estimativa de entrega verificados às 09:42 ET de 27 de agosto de 2026.

Isso funciona porque vincula o estado a uma variante selecionada, destino, método, intervalo de datas, fuso horário e horário de verificação. O leitor pode agir sem interpretar um ícone ou abrir uma política genérica.

Ruim

🟢 Depressa! Disponível agora — vendendo rápido. Entrega em breve. Apenas alguns restantes!

Isso falha porque “disponível” não tem variante, vendedor ou canal; “em breve” não tem destino ou datas; “alguns” não tem limite governado; e a urgência não pode ser auditada. O ícone verde também carrega significado que está ausente no texto. Substituir o ícone por um vermelho não corrigiria os fatos ausentes.

Marcação de esquema e acessibilidade

Para um item genuinamente comprável, o bloco pode alimentar Product.offers através de uma Offer ou AggregateOffer. Mapeie o estado visível controlado para a URL de disponibilidade do Schema.org correspondente, como InStock, OutOfStock, BackOrder, PreOrder, Discontinued ou LimitedAvailability. Preço, moeda, vendedor, condição do item e URL devem descrever a mesma oferta. Não use InStock apenas porque outra variante ou vendedor tem inventário.

Os fatos de entrega podem alimentar OfferShippingDetails: destino, tempo de manuseio, tempo de trânsito, taxa e método elegível devem concordar com a promessa visível. Não emita uma Offer ativa para um item descontinuado nem deixe marcação de oferta desatualizada quando a ação visível se tornar uma lista de espera.

Dados estruturados são uma saída do estado do comércio, não um segundo banco de dados de inventário. Gere o bloco visível, feed e JSON-LD a partir da mesma oferta resolvida sempre que possível. Se não puderem ser atualizados no mesmo cronograma, publique o estado defensável menos permissivo até que a sincronização seja concluída.

A acessibilidade exige um rótulo de texto para cada status; cor, animação e ícones podem reforçar, mas nunca definir. Associe atualizações à variante selecionada. Quando uma alteração de variante ou destino atualizar o bloco de forma assíncrona, não mova o foco nem o leitor inesperadamente; anuncie um resultado conciso através de uma região ativa configurada adequadamente. Evite repetir anúncios de contagem regressiva a cada segundo.

Os controles de entrega precisam de rótulos explícitos como “CEP de entrega” e “Alterar loja de retirada”. As datas devem incluir o mês por extenso onde a ordem numérica puder ser ambígua, e os prazos limites precisam de um fuso horário. Controles de compra desabilitados precisam de texto próximo explicando o motivo e oferecendo a próxima ação válida. Mantenha o estado completo disponível sem hover e forneça um fallback renderizado no servidor quando o JavaScript falhar.

Regras de escrita

Comece com o status controlado em duas a seis palavras: “Em estoque online”, “Pré-venda disponível” ou “Descontinuado”. Siga com a consequência: pronto para envio, data de lançamento prevista ou não é mais vendido. Use um bloco por oferta selecionada, não um bloco por registro de armazém.

Use datas de entrega absolutas ou um intervalo de duas datas delimitado. Se a estimativa mudar por destino, nomeie o destino. Se nenhuma estimativa for confiável, diga o que deve acontecer antes que uma possa ser calculada. “Geralmente”, “em breve”, “rápido” e “deve chegar” não substituem um intervalo com fonte.

Mantenha o bloco principal com uma linha de status, uma a quatro linhas de atendimento, uma frase de política de 10 a 45 palavras quando necessário e uma ação principal. Um rótulo de estoque baixo precisa de um limite aprovado; uma contagem exata precisa de uma fonte atual. Revise o estado continuamente através da integração do sistema e teste seu fallback durante cada ciclo de QA de conteúdo.

Use linguagem calma e operacional. Nunca inclua escassez fabricada, alegações anônimas de popularidade, descontos não relacionados, depoimentos, detalhes de garantia, termos completos de devolução ou cópia genérica de política de envio. Nunca chame uma encomenda de “em estoque”, represente um item indisponível como “disponível para encomenda” sem dizer pré-venda, ou prometa uma data que o sistema de atendimento não pode suportar.

Para itens descontinuados, diga “Descontinuado” em vez de “Atualmente indisponível”. Explique se suporte, peças, manuais ou um sucessor oficial permanecem disponíveis.

Tipos de post que o utilizam

O campo postTypes do frontmatter é a fonte para esta matriz de implementação.

Checklist de QA

• O status se aplica ao SKU, vendedor, canal e local selecionados, não à família de produtos em geral.
• Estoque, vendabilidade, método de atendimento e prazo de entrega são campos separados e não se contradizem.
• As fontes de inventário e atendimento são autoritativas, monitoradas e nomeadas no contrato do componente.
• O horário de verificação está presente, inclui um fuso horário e atende à tolerância de atualidade do negócio.
• Contagens exatas e rótulos de estoque baixo usam regras governadas em vez de urgência promocional.
• Cada estimativa de entrega nomeia ou herda um destino visível e usa uma data absoluta ou intervalo delimitado.
• Estados de pré-venda e encomenda explicam o prazo de pagamento, envio ou lançamento previsto e condições de cancelamento.
• Estados de fora de estoque e descontinuado removem ou substituem a ação de compra imediata.
• Conteúdo visível, dados de feed, comportamento de checkout e dados estruturados de Oferta descrevem o mesmo estado.
• O status é transmitido em texto, mudanças dinâmicas são anunciadas adequadamente e os controles têm rótulos explícitos.
• O bloco permanece significativo sem cor, hover, animação, personalização ou JavaScript.
• Tratamentos móveis e de compra fixa derivam da mesma fonte e preservam a ordem de leitura correta.
• Todos os três exemplos de sintaxe mapeiam para os mesmos campos tipados sem perder dados de fonte ou atualidade.

FAQ

Um bloco de disponibilidade deve mostrar uma contagem exata de estoque?

Apenas quando o sistema de inventário é autoritativo, a contagem é atualizada com rapidez suficiente e expô-la não cria risco operacional ou de segurança. Caso contrário, use um status controlado como Em estoque, Estoque baixo, Pré-venda ou Fora de estoque. Nunca invente urgência com uma contagem não verificada.

O que o bloco deve dizer quando um item está fora de estoque?

Informe Fora de estoque, explique se há reposição esperada, forneça uma data ou intervalo verificado quando existir e ofereça uma ação relevante como um alerta de reabastecimento. Não mostre uma Oferta comprável ou um botão ativo de Adicionar ao carrinho quando o checkout não puder aceitar o pedido.

Como os pedidos em pré-venda e as encomendas devem diferir?

Uma pré-venda é um item estabelecido temporariamente indisponível para atendimento imediato; uma encomenda é um item ainda não lançado para venda normal. Rotule o estado com precisão, informe quando o pagamento é cobrado e forneça a data prevista de envio ou lançamento com qualquer incerteza.

Um bloco de disponibilidade exige esquema de Oferta?

Não. O bloco visível deve ser preciso mesmo sem dados estruturados. Quando a página descreve uma oferta genuinamente comprável, seu estado visível deve estar alinhado com o valor de disponibilidade da Oferta e quaisquer detalhes de envio. Menções editoriais e registros de catálogo indisponíveis não devem ser marcados como ofertas ativas.

As estimativas de entrega podem ser personalizadas por localização?

Sim, se o destino for identificado e uma alternativa não personalizada permanecer disponível. Anuncie mudanças dinâmicas para tecnologia assistiva, evite usar localização por IP como certeza e mantenha o estado do estoque renderizado no servidor preciso para rastreadores e usuários sem JavaScript.