Clientes

Clientes são usados como referência em projetos, orçamentos, planos de mídia e documentos financeiros.

Pesquisar e abrir um cliente

Na listagem, use a pesquisa para localizar registros pelo texto disponível na tela. Abra o cadastro para consultar ou editar os dados. Ao criar um cliente, preencha a identificação principal e salve antes de incluir informações complementares. A situação inicia como Ativo e pode ser definida como Ativo ou Inativo.

Exportar a listagem

Na toolbar da listagem, use Exportar PDF ou Exportar Excel. O arquivo inclui todos os clientes que correspondem à pesquisa, aos filtros e à ordenação atuais, com as colunas visíveis na ordem configurada. O limite é de 500 clientes para PDF e 5.000 para Excel. Se a busca ultrapassar o limite, refine os filtros antes de exportar; o sistema não baixa uma lista incompleta.

Criar e editar

Na seção Dados da empresa, informe documento, tipo de documento, nome, situação, razão social, prefixo, inscrições estadual e municipal, grupos, apelido, tipo de cliente e agência. Inscrição estadual é opcional. Os campos Grupo 1, Grupo 2 e Tipo de cliente permitem pesquisar e selecionar uma opção dos cadastros correspondentes.

O cadastro também aceita contatos e endereços. Os endereços principal e de cobrança ficam na aba Endereços. Para incluir outros endereços, use Adicionar endereço, informe um nome ou descrição e preencha os mesmos campos disponíveis nos endereços principal e de cobrança. Cada endereço adicional pode ser recolhido, editado ou removido pelo menu de ações do cartão. Ao editar um cliente, os endereços cadastrados são carregados para revisão e atualização.

Na aba Contatos, cada contato adicional fica em um cartão recolhível. Use Adicionar contato e informe uma descrição para identificar o cartão; depois, preencha nome, e-mail, telefone, celular e cargo. O menu do cartão permite alterar a descrição ou remover o contato. As alterações são gravadas ao salvar o cadastro do cliente.

Os endereços principal e de cobrança usam os mesmos campos. Para endereços no Brasil, ao sair de um CEP válido, o cadastro consulta o ViaCEP e preenche os campos de endereço que ainda estiverem vazios. A consulta funciona ao criar e editar o cliente e também nos endereços adicionais.

Regras e dependências

• O cliente pertence à conta selecionada; um cadastro de outra conta não deve aparecer como opção.
• Clientes podem ser escolhidos por projetos, orçamentos, planos de mídia e faturamento. A seleção preenche a referência do documento, mas não copia automaticamente todos os dados do cliente para sempre.
• Dados de contato e endereço ficam associados ao cliente e devem ser atualizados no próprio cadastro quando mudarem.
• O campo Tipo de cliente usa o catálogo Tipos de cliente. A descrição e o código são exibidos; o cadastro salva a referência do tipo.
• Grupo 1 e Grupo 2 usam opções do cadastro de grupos da conta atual e salvam suas referências. Tipos de cliente também precisam estar disponíveis para a conta atual.
• Valores antigos de grupo ou tipo sem correspondência no catálogo ficam sem referência; o texto existente é mantido durante a transição dos dados.
• Situações antigas diferentes de INATIVO são tratadas como Ativo.

Excluir

Antes de excluir, confira se o cliente já é usado por projetos ou documentos. O backend pode bloquear a operação quando existem referências que preservam a integridade dos dados. Nesse caso, mantenha o cadastro e inative ou corrija o uso conforme a ação disponível na tela.

Cuidados

Use nomes consistentes e revise contatos e endereços antes de reutilizar o cliente em um novo documento. Não crie duplicatas para corrigir uma informação que pode ser editada no cadastro original.

Importar clientes

Na listagem, abra o menu de Adicionar e escolha Importar. Selecione um arquivo XLSX ou CSV de até 10 MB, com no máximo 1.000 linhas de dados não vazias. Para XLSX, escolha a aba; para CSV, a aba não é necessária. Se o cabeçalho não estiver na primeira linha, selecione a linha correta.

Para testar, baixe a planilha de exemplo com 100 companhias abertas. Escolha a aba Clientes, mantenha o cabeçalho na primeira linha e associe Nome, Razão social, Tipo de documento e Documento aos campos de mesmo nome. A aba Instruções registra a origem dos dados. Use uma conta de teste: os CNPJs são reais e cadastros existentes podem gerar alertas de duplicidade.

Os nomes, razões sociais e CNPJs vêm do cadastro aberto da CVM, com referência em 26/09/2026. As 100 companhias foram selecionadas entre as de maior participação na carteira IBrA da B3 de 28/09/2026. O recorte da base da CVM é disponibilizado sob a Open Database License (ODbL). Os dados cadastrais podem mudar depois dessas datas.

Associe as colunas aos campos individuais do cadastro e clique em Validar. O importador sugere o cabeçalho mesmo quando o relatório começa com títulos. Revise a linha sugerida e as associações antes de continuar. Relatórios do Publi reconhecem CNPJ/CPF, Município, WhatsApp, grupos e os campos próprios de cobrança; o endereço de cobrança não é preenchido a partir do endereço principal. Estados brasileiros escritos por extenso são convertidos para UF, e o tipo de documento é identificado pela quantidade de dígitos quando não houver uma coluna específica. Telefones brasileiros válidos são normalizados para o formato internacional. Percentuais com formato % no Excel são convertidos para o valor exibido: uma célula que mostra 20% será importada como 20, respeitando a precisão do campo (duas casas decimais nos percentuais de clientes). Números sem esse formato mantêm seu valor. Código, Id e datas de inclusão do sistema de origem não substituem os identificadores e datas gerados pelo BlueBox. Você pode salvar esse mapeamento com um nome e reutilizá-lo neste navegador, para esta conta e este cadastro. O salvamento é manual e guarda os nomes das colunas, sem armazenar os dados da planilha. Se uma coluna mudar ou desaparecer, revise o mapeamento antes de validar.

Na importação, Grupo 1 e Grupo 2 são vinculados pelo nome aos grupos da conta. Grupos que ainda não existem são criados ao confirmar a importação; essa criação exige também a permissão Adicionar grupos. A prévia não cria grupos, e um lote inválido não grava clientes nem grupos. Nomes repetidos no lote reutilizam o mesmo grupo. O tipo de cliente aceita o código do catálogo e o formato código-descrição, como CL-Cliente, vinculado ao código CL. Quando houver uma personalização do tipo na conta, ela é utilizada.

A prévia mostra os dados interpretados e a linha original da planilha. Clique numa célula destacada para ler o motivo. Erros vermelhos impedem a importação; alertas amarelos permitem continuar. Você pode remover uma linha da prévia, desfazer a remoção e revalidar. Só a prévia oferece Importar. O envio mostra o progresso real do upload e, depois, o processamento no servidor. Os registros são criados juntos: se a validação final encontrar erro ou a gravação falhar, nenhuma linha do lote é gravada.

A importação de clientes inclui somente campos individuais. Contatos, endereços adicionais, anexos e código gerado ficam fora do arquivo. Um CPF/CNPJ já usado aparece como alerta para sua revisão.

Acesso e consulta

Quem tem apenas Visualizar pode abrir o registro em modo consulta, com campos somente leitura e sem Salvar. Criar, editar, excluir e importar exigem suas próprias permissões. Consultar, enviar ou excluir anexos também são ações independentes; enviar um anexo não exige editar os dados do cadastro.

Faturamento para mídia

Na aba Financeiro, a seção Faturamento para mídia apresenta os campos em Table 2, com Forma de faturamento ocupando as duas colunas. A forma de faturamento começa em 1 - Bruto contra o cliente e oferece quatro opções:

• 1 - Bruto contra o cliente.
• 2 - Comissão contra o cliente.
• 3 - Comissão contra o veículo.
• 4 - Não recebe comissão.

Desconto sobre comissão e Acrescentar encargos começam em 0.00%. Sob o título Percentuais a serem faturados, Comissão e Líquido começam em 100.00%. Os quatro campos usam ponto decimal, duas casas decimais e o símbolo % à direita. Os valores aceitos vão de 0 a 100. A digitação preenche as casas da direita para a esquerda: 1 mostra 0.01%, 12 mostra 0.12% e 123 mostra 1.23%, sem precisar digitar o ponto.

Esses dados pertencem à configuração de mídia do cliente e ficam separados dos campos de faturamento para produção. As permissões de visualizar, adicionar e editar clientes continuam controlando consulta e gravação.

Faturamento para produção

Na aba Financeiro, a seção Faturamento para produção usa o mesmo layout em tabela da mídia. Forma de faturamento oferece as mesmas quatro opções numeradas e começa em 1 - Bruto contra o cliente.

Desconto sobre honorários e Acrescentar encargos começam em 0.00%. Sob o título Percentuais a serem faturados, Honorários, Serviços internos e Líquido começam em 100.00%. Os cinco percentuais aceitam valores de 0 a 100, com ponto decimal, duas casas e % à direita. A digitação preenche da direita para a esquerda, como nos percentuais de mídia.

Encargo sobre começa em R - Receita (internos + honorários) e oferece:

• R - Receita (internos + honorários).
• H - Honorários.
• A - Terceiros + internos + honorários.
• T - Terceiros.
• I - Terceiros + internos.
• O - Internos.

Esses campos configuram o cadastro de produção do cliente. As permissões de visualizar, adicionar, editar e importar clientes continuam controlando o acesso.

Comissão da agência e honorários de produção

Na aba Opções, logo após Financeiro, as seções Comissão da agência e Honorários de produção apresentam os campos em Table 2, com o percentual ocupando a linha inteira e os dois switches lado a lado:

• Comissão da agência: Percentual Comissão padrão de 20.00%, Sobre o líquido desmarcado e Usar % do veículo desmarcado.
• Honorários de produção: Percentual Honorários padrão de 15.00%, Sobre o líquido marcado e Usar % do fornecedor desmarcado.

Ao marcar Usar % do veículo ou Usar % do fornecedor, o campo percentual da respectiva seção fica oculto. Ao desmarcar, ele reaparece com o valor anterior. Sobre o líquido permanece visível e independente. Sobre o líquido e Usar % do veículo/fornecedor são campos separados com switches booleanos. As opções e os percentuais são persistidos ao salvar o cliente. Os percentuais usam duas casas decimais, ponto decimal e símbolo à direita, com digitação da direita para a esquerda.

Prazo de recebimento antes do pagamento

Na seção Opções de faturamento, Número de dias úteis para recebimento antes do pagamento inicia em zero e aceita um número inteiro a partir de zero. Informe a quantidade de dias úteis aplicável ao cliente e salve o cadastro.

Faturamento IR

Na aba Financeiro, a seção Faturamento IR oferece Tipo de cliente com Cliente Privado (padrão), Prefeituras e Governo Estadual. O campo % IR inicia em 0.00%, com o mesmo input percentual das demais seções. Base de cálculo IR oferece Cálculo sobre receita (padrão) e Cálculo sobre total da fatura. Não calcular IR e Reter IR são switches independentes, inicialmente desativados. Salve o cadastro para persistir essas configurações.

Faturamento ISS

As seções Faturamento IR e Faturamento ISS usam layout Table 2. Tipo de cliente ocupa as duas colunas em IR. Em ISS, selecione Cálculo sobre receita (padrão), Cálculo sobre total da fatura ou Cálculo sobre total de produção. Base de cálculo mínimo para retenção inicia em 0.00 e aceita um valor não negativo, com duas casas decimais e sem símbolo, usando digitação da direita para a esquerda. Não é um campo percentual.

Adiciona ISS na mídia, Adiciona ISS na produção, Não calcula ISS e Reter ISS são switches independentes, todos inicialmente desativados. Salve o cadastro para persistir os campos.

Faturamento Impostos Federais

A seção usa Table 2. Impostos Federais oferece Cálculos sobre receita (padrão), Cálculo sobre total fatura e Cálculo sobre total (governo). O select SPED PIS/COFINS indicador de natureza da retenção pode ficar vazio ou usar os códigos:

• 1 - Retenção por órgãos, autarquias e fundações federais.
• 2 - Retenção por outras entidades da administração pública federal.
• 3 - Retenção por pessoas jurídicas de direito privado.
• 4 - Recolhimento por sociedade cooperativa.
• 5 - Retenção por fabricante de máquinas e veículos.
• 99 - Outras retenções.

Optante pelo Simples usa um switch em uma linha que ocupa as duas colunas. Em seguida, cada linha apresenta Não calcular e Reter, nesta ordem: COFINS, PIS e CSLL. Os novos campos de retenção começam desativados; os switches existentes preservam os valores salvos.

ISS específico, Não calcular IR, Não calcular INSS e Reter INSS deixam de aparecer nesta seção. As configurações próprias de IR e ISS continuam em suas seções. Salve o cadastro para persistir as alterações.

As seções de mídia e produção exibem Percentuais a serem faturados como título em uma linha inteira, seguido dos percentuais em duas colunas. Em produção, Forma de faturamento e Encargo sobre ocupam a linha inteira; Encargo sobre aparece após Acrescentar encargos e antes do título dos percentuais. A seção separada Impostos retidos foi removida; use os controles de retenção nas seções de cada imposto.

A seção Condições foi removida da aba Financeiro. Os campos de comissão e honorários foram realocados para Opções, mantendo valores e padrões existentes.

Descontos

Na aba Opções, a seção Descontos usa Table 2 e contém apenas os dois percentuais abaixo.

% desconto no plano de mídia e % desconto sobre serviços internos começam em 0.00%. Aceitam percentuais de 0 a 100, com duas casas decimais, ponto decimal e símbolo à direita, usando digitação da direita para a esquerda. Salve o cliente para persistir as configurações.

Contabilidade

A aba Contabilidade fica após Financeiro. Conta cliente, Recuperação de custos, Recuperação de veiculação e Recuperação de produção selecionam registros do Plano de Contas. Centro de custos seleciona um Centro de Custos. Use os lookups para buscar por código ou descrição e limpar seleções opcionais. A pesquisa respeita o acesso aos catálogos da conta.

Capital social começa em 0,00, usa ponto para milhares e vírgula para decimais, com duas casas e sem símbolo. Data capital social é opcional. Salve o cliente para persistir os valores.