Vincular lojas e produtos à campanha

Cadastrar uma loja ou um produto não os coloca em campanha nenhuma. O vínculo é uma operação separada, feita nas abas Lojas e Produtos dentro da campanha — ou pelos itens Gerenciar lojas e Gerenciar produtos do menu Campanhas, que pedem para escolher a campanha primeiro. É nesse vínculo que vivem as configurações que valem só naquela campanha: a chance extra da loja e do produto, a rede do produto e os pontos por unidade.

A aba Lojas tem duas listas: Participantes e Não participantes (os bloqueios de loja). As duas usam as mesmas permissões.

Vincular um ou vários

A tela lista o catálogo global e permite vincular um item por vez ou vários de uma vez. Existem atalhos: "Todas as lojas", "Adicionar todas de uma rede" e "Todos os produtos".

Esses atalhos preenchem a seleção, eles não são um modo de envio. O atalho da rede acrescenta as lojas disponíveis daquela rede ao que já estava marcado, sem tirar nada. O painel sempre manda a lista concreta que o operador viu na tela — assim um cadastro feito depois que a tela carregou não entra calado no vínculo. Acima de um item, a tela confirma a contagem antes de enviar.

O lote é tudo ou nada: um item inexistente recusa o lote inteiro e nada é gravado. Item já vinculado não é erro — conta como ignorado, o que torna inofensivo reenviar depois de um erro de rede. A tela mostra o resultado como aviso de sucesso com a contagem, por exemplo: 2.980 produtos vinculados e 177 que já estavam vinculados. A lista aceita até dez mil itens por vez.

Inativo não é recusado no vínculo — o filtro de inativo é critério de seleção, não validação. Por isso a tela continua listando só os ativos ainda não vinculados.

Remover o vínculo é feito item a item, pelo botão "Remover vínculo" da linha. O cadastro da loja ou do produto continua existindo e pode ser vinculado de novo depois.

Participante e não participante não se misturam

Uma loja que está na lista de não participantes não pode ser vinculada como participante: a tela destaca o conflito e pede para remover o bloqueio antes. O contrário também vale — para bloquear uma loja que já participa, é preciso remover o vínculo antes.

A chance extra

A chance extra vale por campanha e mora no vínculo, não no cadastro global. A mesma loja pode dar chance extra numa campanha e não dar em outra. Isso vale para lojas e para produtos.

São três campos ligados entre si: a chave que liga a chance extra nesta campanha, o fator (um número inteiro maior que zero, obrigatório quando a chave está ligada) e o tipo do fator, que é soma ou multiplicação (também obrigatório quando a chave está ligada). Desligar a chave zera os três.

A configuração acontece no momento de vincular — e vale para todos os itens selecionados — e no modal "Editar vínculo" de cada item.

O formulário de não participante não oferece esses campos: bloqueio nasce sem chance extra, e editar o motivo de um bloqueio mantém o valor gravado em vez de apagá-lo. Uma loja bloqueada pode, portanto, ter chance extra gravada — ela não recebe nota, então o valor fica inerte até a loja voltar a participar.

A rede no vínculo do produto

No vínculo de produtos, a rede é parâmetro do próprio vínculo: o produto só vale naquela rede. A opção "Todas as redes" não restringe o produto. No vínculo de lojas não existe nada equivalente — ali a rede é apenas um atalho de seleção. São coisas diferentes, e os nomes na tela são diferentes por isso.

O seletor de rede na aba Produtos da campanha desaparece para quem não tem permissão de ler redes.

Pontos por unidade

O vínculo do produto tem também o campo "Pontos por unidade". Ele alimenta a regra "Pontos por produto" da modalidade Pontos: cada unidade daquele produto na nota vale esses pontos. Vazio quer dizer que o produto não soma pontos. Quando informado, tem de ser um número inteiro maior que zero.

Por que a aba Lojas aparece sempre

A campanha tem a opção "Seleciona loja". Mesmo com ela desligada, a aba Lojas continua visível, de propósito: o atendimento por WhatsApp continua oferecendo as lojas vinculadas ao participante. Com a opção desligada, a tela mostra um aviso: no hotsite o cadastro de nota não pede nem confere a loja, mas a lista precisa continuar correta por causa do WhatsApp.

Alterações não salvas

Se o operador alterar o modal "Editar vínculo" e tentar fechar sem salvar, a tela pergunta se quer sair sem salvar.

Permissões

Vincular, editar o vínculo e remover seguem a permissão de editar campanhas — tanto nas lojas participantes quanto nas não participantes.

Cadastrar não é vincular. Essa é a confusão mais comum: o cliente cadastra duas mil lojas e estranha que a campanha não as reconheça. O vínculo é feito nas abas Lojas e Produtos da campanha, e existem os atalhos de vincular todas de uma vez.

Quatro orientações:

A chance extra é por campanha. A mesma loja ou o mesmo produto pode ter chance extra numa campanha e não ter em outra. Se o cliente mudou a chance extra e ela não valeu na outra campanha, é esse o motivo — e é intencional.

Quando a chance extra está ligada, o fator e o tipo (soma ou multiplicação) são obrigatórios. Desligar limpa os três.

Vincular em lote é tudo ou nada. Se um item do lote não existir, nada é gravado — e reenviar depois é seguro, porque o que já estava vinculado é apenas ignorado.

Uma loja não pode estar nas duas listas da campanha. Para passar de bloqueada a participante, ou o contrário, é preciso tirar a loja da lista em que ela está antes.

• Falha: a loja está cadastrada e a campanha não a reconhece.
• Possivel causa: a loja foi cadastrada no catálogo global, mas nunca foi vinculada à campanha.
• Como orientar: abra a aba Lojas da campanha e vincule a loja. Existe o atalho de vincular todas as lojas ou todas as de uma rede.
• Quando escalar: se a loja estiver vinculada e a campanha continuar sem reconhecê-la, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a tela não deixa vincular uma loja e fala em não participantes.
• Possivel causa: a loja está na lista de não participantes da campanha. Uma loja não pode estar nas duas listas.
• Como orientar: confirme com o cliente se o bloqueio deve sair. Se sim, remova a loja da lista de não participantes e vincule de novo.
• Quando escalar: não é falha.

• Falha: a chance extra configurada não valeu em outra campanha.
• Possivel causa: a chance extra é do vínculo com cada campanha, e não do cadastro global.
• Como orientar: explique que a configuração é por campanha e oriente a configurar a chance extra no vínculo daquela outra campanha.
• Quando escalar: não é falha.

• Falha: não dá para salvar a chance extra.
• Possivel causa: a chave está ligada sem o fator ou sem o tipo do fator. Os dois são obrigatórios quando a chance extra está ligada.
• Como orientar: informe o fator inteiro maior que zero e escolha o tipo entre soma e multiplicação. Desligando a chave, os três campos são zerados.
• Quando escalar: se o fator e o tipo estiverem informados e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o produto não está somando pontos na campanha de pontos.
• Possivel causa: o campo Pontos por unidade do vínculo está vazio, ou a modalidade Pontos não tem a regra Pontos por produto.
• Como orientar: edite o vínculo do produto na aba Produtos e informe os pontos por unidade. Confira também a regra da modalidade Pontos no formulário da campanha.
• Quando escalar: se os pontos e a regra estiverem configurados e a nota não somar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o vínculo em lote foi recusado e nada entrou.
• Possivel causa: algum item da seleção não existe mais. O lote é tudo ou nada.
• Como orientar: recarregue a tela para atualizar a lista e tente de novo. Reenviar é seguro, porque item já vinculado é apenas ignorado.
• Quando escalar: se a lista estiver atualizada e o lote continuar sendo recusado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o seletor de rede não aparece no vínculo de produtos.
• Possivel causa: o papel do usuário não tem a permissão de ler redes. O seletor é opcional e desaparece nesse caso.
• Como orientar: confira com o Master do cliente a permissão de ler redes no papel do usuário.
• Quando escalar: se o papel tiver a permissão e o seletor continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.