Integrações e API
Conectar a VTEX
Conecte sua loja VTEX com uma chave de aplicação só para a Krew.
Nesta página
Antes de começar
No painel da marca (brand.bekrew.com), abra Configurações da marca → Integrações. Só o dono e os gestores conectam, testam e desconectam lojas.
Você precisa de acesso ao License Manager da VTEX para criar chaves e dar permissões.
Crie uma chave de aplicação só para a Krew
- 1No admin da VTEX, abra Configurações da conta → Chaves de aplicação e gere uma chave nova.
- 2Dê a ela um perfil de acesso com Pedidos (OMS) e Promoções e cupons.
- 3Copie a AppKey e o AppToken. O AppToken só aparece uma vez.
- 4Na Krew, clique em Conectar no cartão da VTEX e cole o nome da conta (o minhaloja de minhaloja.myvtex.com), a AppKey e o AppToken.
A VTEX aceita um só hook de pedidos por chave. Se a chave já envia pedidos para outro sistema, a Krew recusa a conexão para não substituir esse hook. Por isso a chave precisa ser só da Krew.
Como os cupons funcionam na VTEX
A Krew cria uma promoção para a regra de cupom da comunidade e um cupom por creator ligado a ela. Você vê essas promoções no módulo de Promoções da VTEX. Não as edite por lá: mude a regra na aba Cupom da comunidade.
Quais vendas contam
- Venda: pedido com pagamento aprovado.
- Estorno: pedido cancelado estorna a venda inteira.
- Atribuição: pelo cupom do pedido ou pelo clique no link rastreado, que a VTEX guarda como campanha interna (utmi_cp).
Depois de conectar
- 1Confira em Integrações se a conexão aparece como conectada e no ambiente certo (teste ou produção).
- 2Em cada comunidade, abra a aba Cupom e defina o desconto e o destino do link rastreado. A Krew cria um cupom por creator aprovado.
- 3Acompanhe o contador de cupons da conexão: ativos, pendentes e com erro. Pendente vira ativo em até um minuto.
- 4Faça uma compra de teste com o cupom de um creator e depois estorne. O pedido aparece em Vendas e o estorno ajusta a comissão.