Problemas frequentes e limitações atuais

Esta página reúne diagnóstico operacional e diferenças verificadas entre interface e backend em 08/10/2026. Não é uma lista de recursos já corrigidos.

Cadastro ou edição não salva

Sintoma	O que conferir
Não avança	Tipo, unidade, nome, quantidade e empresa obrigatórios.
Erro em links	URL completa nos campos Thumbnail, Link e Landing Page.
Endereço digital inválido	Cada linha precisa de valor; remova linhas vazias.
Empresa não encontrada	Selecione novamente o perfil empresarial e reabra o formulário.
Sem autorização	Use a operação do proprietário e as permissões de Produtos do perfil/colaborador.
Salvamento sem alteração aparente	Reabra a ficha para atualizar os dados; confira a resposta de sucesso e erros da API.

Preço, quantidade e alguns campos textuais têm validação diferente no formulário e na API. Campos opcionais vazios ou enviados como null podem ser rejeitados, especialmente no cadastro. Em caso de erro, registre a mensagem e os campos envolvidos para diagnóstico técnico; não suponha que o item foi gravado só porque a etapa final foi aberta.

Produto não aparece

Local	Verificações
Catálogo administrativo	Empresa, busca, filtro de tipo e primeira página carregada.
Catálogo do afiliado	Documento do parceiro coincide com CPF/CNPJ do cadastro empresarial; status Ativa/Em andamento.
Marketplace	Produto público; empresa/página pública correta; afiliação elegível para produtos de parceiro.
Área/app	Associação salva na área correta; status; vínculo do app com essa área.

Na listagem administrativa, rolar a página carrega e acumula as páginas seguintes (corrigido depois de 08/10). A busca e os contadores de públicos/afiliados valem para os itens já carregados; role até o fim para incluir o catálogo inteiro.

Afiliação

“Já existe uma afiliação…”: edite o registro existente para o mesmo produto e documento.

Parceiro não recebeu o produto: confira o documento do cadastro empresarial e não apenas o documento pessoal do usuário. A consulta usa o CPF/CNPJ do negócio ligado ao perfil empresarial.

Status alterado, mas produto continua na área: mudar a afiliação afeta a descoberta no catálogo, sem remover associações existentes. Gerencie a área separadamente.

Comissão não foi paga: cadastrar o percentual e obter uma estimativa no CRM não executa um repasse. O modal também não gera ou rastreia automaticamente o link afiliado.

Lotes e saldo

Lote com zero não bloqueou: a consulta só considera capacidades positivas. Use o status da associação para suspender na área.

Lote terminou, mas oferta continua disponível: o sistema pode usar outro lote, limite de afiliação ou ausência de limite. Não há fechamento automático apenas pelo vencimento do lote.

Saldo diferente do número de pedidos: o saldo das áreas usa registros de aquisições reservadas/confirmadas, não todas as unidades dos pedidos.

Vários afiliados/lotes: há ambiguidades de seleção e escopo. Consulte lotes e disponibilidade antes de tratar os limites como estoque.

Clonagem, exclusão e carregamento

• A clonagem gera “Cópia de…” no backend e preserva o campo de publicação. Renomeie e confira a visibilidade.
• O controle de exclusão de produtos com pedidos é executado depois da remoção no controlador; não há limpeza completa de dependências nessa operação.
• As abas Afiliações, Lotes e Vendas transformam erros de consulta em listas vazias. Uma lista vazia não diferencia ausência de dados de falha de carregamento.
• Afiliações consultam apenas a primeira página de até 100 registros na ficha do produto.
• Os contadores de Lotes/Vendas são preenchidos sob demanda e o resumo do catálogo mistura total da API com contagens locais.

Checkout

O checkout público grava os pedidos e gera a cobrança (revisão de 08/11/2026). Erros que podem aparecer:

Código	Significado
CHECKOUT_DISABLED	A empresa não habilitou o checkout.
PAYMENTS_NOT_CONFIGURED	A empresa não tem conta principal nem subconta ATLA Pay ativa.
BELOW_MINIMUM_VALUE	Valor abaixo do mínimo da cobrança.
DIGITAL_REQUIRES_ACCOUNT	Produto digital comprado sem login.
PRODUCT_NOT_AVAILABLE	Item afiliado, privado ou indisponível.

Frete (cotação por vendedor, entrega ou retirada) existe na API (POST /public/checkout/quote), mas ainda não há tela de cotação no checkout web, nem campos de peso e medidas no cadastro de produto. Confira o fluxo atual.

Informações úteis para suporte

Registre a empresa selecionada, nome/código do produto, aba utilizada, horário, passos realizados e mensagem exata do erro. Para um produto afiliado, informe também o status e se o documento corresponde ao cadastro empresarial. Evite compartilhar documentos pessoais completos ou credenciais em capturas de suporte.

Os arquivos, métodos e prioridades de correção estão na referência técnica.