Painel AdminIntermediarioAtualizado em 30 de out. de 2026

Cadastros de lojas redes e produtos

Os catálogos globais do cliente e as regras de documento e chave que o painel exige

O que e?

São três cadastros globais do cliente, no grupo Cadastros do menu: lojas, redes de lojas e produtos. Globais quer dizer que eles existem independentemente de campanha e são reutilizados entre campanhas. Ligar um deles a uma campanha é outra operação, com tela própria.

Os três têm listagem, cadastro e edição, ativar e inativar, importação por arquivo com modelo para download ("Importar arquivo"), histórico de importações abaixo da listagem e opção de desfazer o lote.

Como funciona?

Lojas

Loja é sempre pessoa jurídica. Não há campo de tipo de pessoa na tela: o CNPJ é obrigatório e validado na criação, e CPF é recusado.

Na edição, o documento só é conferido quando é alterado. Reenviar o mesmo documento que a loja já tem, sem mudança, não passa pela conferência — é isso que mantém funcionando uma loja antiga cadastrada antes da regra. Alterando, só aceita CNPJ válido: não dá para apagar o documento nem trocá-lo por CPF.

A rede da loja é um seletor que lê o cadastro de redes, e o estado é um seletor do catálogo de estados (as vinte e sete UFs, com busca por nome ou sigla). A tabela mostra cidade e UF.

A chance extra não é do cadastro global da loja: ela é do vínculo com cada campanha, e tem artigo próprio.

A importação de lojas tem o layout de nome, documento, logradouro, bairro, cidade e UF, com endereço e UF opcionais — a linha pode trazer só nome e documento. A rede vem do formulário e vale para o arquivo inteiro: o seletor começa vazio de propósito, lista só redes ativas e tem a opção explícita "Sem rede". A UF é a sigla do catálogo; desconhecida recusa a linha. CNPJ é obrigatório também na importação, porque é a chave de "já cadastrada": linha com CPF é recusada. Loja já cadastrada, ou repetida no arquivo, é ignorada; a inativa gera aviso e não é reativada. A linha do layout antigo, com oito colunas, é recusada com erro que indica o layout atual.

Redes

Rede tem só dois campos: nome e CNPJ. O nome é único no cliente, conferido sem espaços nas pontas e sem diferenciar maiúsculas. O motivo é evitar duas redes com o mesmo nome, que na lista, nos seletores e nos relatórios apareceriam idênticas.

O CNPJ é opcional no cadastro manual e obrigatório na importação, porque na importação ele é a chave de "já cadastrada" — sem ele, a rede seria criada de novo a cada reenvio. É pelo cadastro manual que entra a rede que não tem CNPJ. Na importação, CNPJ já cadastrado é ignorado e nome já cadastrado recusa a linha.

A tela permite consultar as lojas de uma rede pelo modal "Visualizar lojas". A troca de rede de uma loja é feita pelo próprio cadastro da loja.

A tela de redes não tem botão de excluir: o caminho é inativar, porque a rede é referenciada por lojas, produtos e prêmios. A única situação em que uma rede é apagada de fato é desfazer a importação que a criou, e isso só acontece depois de conferir que nenhuma delas está em uso — em loja, campanha, prêmio, produto de campanha, posição premiada, nota fiscal, usuário ou outra importação.

Produtos

A chave do produto é o EAN e, na falta dele, o código. O EAN é único quando informado; o código só precisa ser único entre os produtos sem EAN — tendo EAN, é ele que identifica, e a mesma referência interna pode valer para embalagens diferentes. Produto sem os dois continua aceito no cadastro manual, mas não na importação.

O EAN, quando informado, é só os números do código de barras, com oito, doze, treze ou quatorze dígitos. Fora disso, ou já cadastrado em outro produto, o servidor recusa com a mensagem explicando.

O botão de remover produto inativa em vez de excluir quando ele está em uso — em campanha, em item de nota ou exigido por uma regra de geração de base produto.

A importação de produtos tem o layout de código, nome, EAN, unidade, família e variações, com os três últimos opcionais. Cada linha precisa do nome e de EAN ou código; sem chave, a linha é recusada. Produto já cadastrado é ignorado e conta nas ignoradas; o inativo gera aviso e não é reativado.

Um caso específico merece atenção: a linha cuja chave é nova mas cujo outro campo já é de um produto cadastrado é recusada com a instrução do que fazer — informar o EAN na linha, ou editar o produto cadastrado para incluir o EAN.

O relatório da importação de produtos traz, além das contagens comuns, quantos entraram por EAN e quantos por código. Esses dois números denunciam um arquivo trocado: o layout do sistema anterior tem a quantidade de chances onde hoje fica o EAN, e tem o mesmo número de colunas do layout novo. As três barreiras são o modelo para download, o formato escrito na tela e esses dois contadores.

A campanha, a rede, a chance extra e os pontos não vão no arquivo de produtos: eles são do vínculo com a campanha, em outra tela.

Como explicar ao cliente?

Esses três cadastros são o trabalho de preparação que o cliente faz uma vez e reaproveita em todas as campanhas. Cinco orientações:

Loja é sempre pessoa jurídica. O cliente não cadastra loja com CPF — nem na tela, nem por arquivo.

Rede com CNPJ pode ser importada; rede sem CNPJ entra pela tela, uma a uma. Isso não é limitação arbitrária: sem o CNPJ, cada reenvio do arquivo criaria a rede de novo.

Produto é identificado pelo EAN, e pelo código só quando não há EAN. Se o cliente quer rastrear embalagens diferentes com a mesma referência interna, é o EAN que separa as duas.

As chances, a chance extra e os pontos não ficam nesses cadastros. Eles são da campanha: ficam no vínculo da loja e do produto com cada campanha.

Se o cliente vai reaproveitar arquivos do sistema antigo, avise antes. Os layouts mudaram, o painel tem modelo para download em cada tela, e o relatório da importação de produtos mostra quantos entraram por EAN e quantos por código — números que ajudam a perceber um arquivo trocado.

Possiveis falhas, causas e solucoes

Falha: o cadastro da loja é recusado com mensagem sobre o documento.
Possivel causa: o documento informado é um CPF. Loja aceita somente CNPJ, e com dígitos verificadores válidos.
Como orientar: informe o CNPJ da loja. Se o cliente só tem CPF, a loja não pode ser cadastrada como está, e o caso precisa ser tratado com o time.
Quando escalar: se o CNPJ estiver válido e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

Falha: a importação de redes recusa linhas por falta de CNPJ.
Possivel causa: o CNPJ é obrigatório na importação de redes, porque é a chave de "já cadastrada".
Como orientar: complete o CNPJ das redes no arquivo ou cadastre pela tela as redes que não têm CNPJ.
Quando escalar: não é falha. Só escalar se a linha com CNPJ válido também for recusada.

Falha: a importação de produtos recusa uma linha dizendo que o outro campo já é de um produto cadastrado.
Possivel causa: a chave da linha é nova, mas o código ou o EAN dela já pertence a um produto existente.
Como orientar: a própria mensagem traz a instrução. Informe o EAN na linha ou edite o produto cadastrado para incluir o EAN.
Quando escalar: se a instrução foi seguida e a linha continuar recusada, abrir issue no Jira (projeto DEV) com as evidências.

Falha: a importação recusou linhas dizendo que o layout está errado.
Possivel causa: o arquivo está no layout do sistema anterior. O painel reconhece pelo conteúdo e recusa.
Como orientar: baixe o modelo na própria tela de importação e remonte o arquivo no layout atual.
Quando escalar: se o arquivo estiver no layout do modelo e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências e o arquivo.

Falha: o cliente quer apagar uma rede e não encontra o botão de excluir.
Possivel causa: a tela de redes não exclui. A rede é referenciada por lojas, produtos e prêmios, e o caminho é inativar.
Como orientar: explique que a rede inativa sai dos seletores de cadastro novo, mas continua na lista. A única situação em que uma rede é apagada é desfazer a importação que a criou, se nenhuma delas estiver em uso.
Quando escalar: não é falha.

Falha: remover o produto não o apaga.
Possivel causa: o produto está em uso em campanha, em item de nota ou exigido por uma regra de geração de base produto. Nesse caso ele é inativado.
Como orientar: explique que produto em uso é inativado em vez de excluído. Se o cliente precisa tirá-lo da campanha, o caminho é remover o vínculo na aba Produtos da campanha.
Quando escalar: não é falha.

Falha: a loja importada não recebeu a rede esperada.
Possivel causa: a rede vem do formulário da importação e vale para o arquivo inteiro. Se foi escolhida a opção "Sem rede", todas as lojas entram sem rede.
Como orientar: confira a rede escolhida no formulário antes de importar. O seletor começa vazio de propósito e aceita somente redes ativas.
Quando escalar: se a rede estiver selecionada e as lojas entrarem sem rede, abrir issue no Jira (projeto DEV) com as evidências.

Exemplo de resposta pronta

Olá! Lojas, redes e produtos ficam no grupo Cadastros do menu e são globais: você cadastra uma vez e reaproveita em todas as campanhas. Três pontos que costumam gerar dúvida: loja é sempre pessoa jurídica, com CNPJ obrigatório e válido; rede sem CNPJ só entra pela tela, porque na importação o CNPJ é a chave que evita recriar a rede a cada reenvio; e produto é identificado pelo EAN, usando o código apenas quando não há EAN. Em cada uma dessas telas há o botão "Importar arquivo", com um modelo para download, e o histórico de importações fica abaixo da listagem, com a opção de desfazer o lote.

Quando escalar?

Acione o time de desenvolvimento urgentemente e abra issue no Jira (projeto DEV) com as evidências quando uma importação válida pelo modelo for recusada, quando o cadastro aparecer duplicado, quando um registro ativo não aparecer nos seletores, quando o inativar não surtir efeito, quando a importação travar a tela ou quando o problema impedir a montagem dos catálogos de uma campanha que vai entrar no ar. Anexe prints, o arquivo usado quando houver e a mensagem exibida.