Configuração do Shopify
Este guia explica como ativar as permissões de que a BS necessita para consultar o stock em tempo real e criar a finalização de compra segura da Shopify.
Loja ligada
Domínio permanente da Shopify: radiant-beauty-boutique-t2qz2-qvfreywy.myshopify.com
A ligação OAuth está ativa. O token da Storefront API já funciona para o catálogo e a finalização da compra. Só falta a permissão de inventário se quiser saber o número exato de unidades.
Âmbitos de acesso da Storefront API
Estas são as permissões de que a aplicação 'Lovable Storefront' necessita. A que está assinalada como pendente é a única que requer ativação manual.
Leer productos públicos
unauthenticated_read_product_listingsPermite mostrar catálogo, precios e imágenes.
Crear checkouts
unauthenticated_write_checkoutsNecesario para el botón 'Comprar' y el carrito.
Leer inventario en tiempo real
unauthenticated_read_product_inventoryMuestra 'disponible', 'agotado' y unidades exactas. Es el que falta activar.
Leer planes de venta
unauthenticated_read_selling_plan_groupsOpcional: solo si usas suscripciones o planes de pago.
Passo a passo: ativar o stock em tempo real
1. Abrir a aplicação Storefront
No painel de administração da Shopify, aceda a Definições → Aplicações e canais de vendas. Encontre a aplicação com a integração da Storefront API (normalmente 'Lovable Storefront' ou a sua aplicação privada) e abra-a.
2. Editar os âmbitos
Na aplicação, abra Configuração → Âmbitos de acesso à API Storefront. Verá a lista de permissões.
3. Assinale a permissão de inventário
Encontrar e ativar
unauthenticated_read_product_inventory. Guarde as alterações.4. Voltar ao site
O site verifica o inventário a cada 30 segundos. Assim que a permissão estiver ativa, os cartões de produto mostrarão 'disponível', 'esgotado' ou o número exato de unidades, conforme previsto.
E se precisar de gerar novamente o token?
Se criar uma nova aplicação ou gerar novamente o token de acesso à Storefront API, avise-me aqui no chat e eu atualizo-o no código. Não o cole em comentários públicos: utilize o formulário seguro, ou peça-me para abrir o campo secreto.
O token ativo mantém-se protegido na configuração da loja e nunca é apresentado publicamente.
Finalização segura da compra
Todos os pagamentos e dados de envio e fiscais são tratados no checkout nativo da Shopify. A BS não guarda dados de cartões nem moradas de faturação. O carrinho é sincronizado com a Shopify e o checkout oficial abre num novo separador.