Dados fiscais e endereço do contato (CPF/CNPJ, cobrança)

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em Jul 27, 2026

Visão geral

Cada contato guarda, de forma nativa, a identidade fiscal — tipo (Pessoa Física ou Pessoa Jurídica), CPF/CNPJ e país fiscal — e o endereço completo (CEP, rua, número, complemento, bairro, cidade, UF e país). Opcionalmente, um endereço de cobrança diferente do principal.

Esses dados alimentam automaticamente os módulos que precisam deles: Pagamentos preenche o pagador (documento e endereço) ao criar cobranças e assinaturas, os modelos de mensagem e automações ganham variáveis como {{contact.address_city}}, e a IA da conta enxerga o endereço para dar contexto. O documento aparece por extenso para a equipe no painel e no formulário; ele só é mascarado quando um papel de acesso manda mascarar, para bots/integrações e nas saídas externas (webhooks, exportação CSV e variáveis de mensagem).

Pré-requisitos

Permissão para editar contatos.
Para o preenchimento automático de cobranças: uma conexão de gateway ativa em Pagamentos.

Passo a passo

Abra o contato (página de Contatos ou painel da conversa) e clique em Editar.
Preencha o Tipo (Pessoa Física ou Jurídica), o CPF/CNPJ e o país fiscal (ex.: BR). Um documento já salvo vem preenchido com o valor real: basta editá-lo para corrigir, ou apagar o campo para removê-lo.
Na seção Endereço, informe o CEP: rua, bairro, cidade e UF são preenchidos automaticamente. Complete número e complemento.
Se a cobrança deve ir para outro endereço, marque Endereço de cobrança diferente. Use o botão Copiar do endereço principal para trazer tudo com um clique e ajustar só o que muda.
Salve. A partir daí, cobranças e assinaturas criadas para esse contato já vêm com documento e endereço preenchidos.

Configurações & opções

Visibilidade do documento: o CPF/CNPJ é validado ao salvar (dígitos verificadores) e fica visível para a equipe. Para escondê-lo de parte do time, use Funções & acessos e defina a regra do campo tax_id como mascarado (mostra ***.***.***-09) ou oculto. O valor é sempre guardado criptografado.
Endereço de cobrança: desmarcar a opção volta a usar o endereço principal na cobrança.
Importação CSV: as colunas legal_type, tax_id, tax_country, address_zip, address_street, address_number, address_complement, address_neighborhood, address_city, address_state e address_country preenchem os campos nativos.
Exportação: o documento sai sempre mascarado; o endereço sai em colunas achatadas (address_*).
Variáveis: {{contact.masked_tax_id}}, {{contact.legal_type}}, {{contact.tax_country}} e {{contact.address_zip}} … {{contact.address_country}} funcionam em respostas prontas, macros, automações, follow-ups e no FlowBuilder.

Casos de uso

Emitir boleto no Mercado Pago sem pedir endereço de novo: o contato já tem tudo.
PJ com sede (principal) e faturamento em outra unidade (cobrança).
Segmentar por cidade/país — o endereço alimenta os filtros de localização do contato.
Segmentar por tipo de pessoa (PF/PJ), tipo de documento, país fiscal e endereço (CEP, cidade, estado, país) nos filtros avançados e segmentos de contatos.
Automatizar: a ação "Definir campo do contato (fiscal/endereço)" em automações, macros e fluxos grava tipo de pessoa, documento e endereço direto nos campos nativos — por exemplo, um fluxo que pergunta o CPF/CNPJ e salva a resposta no contato.
Condicionar: automações disparadas por contato podem filtrar por tipo de pessoa, tipo de documento, país fiscal e endereço; nos fluxos, o nó de condição usa as mesmas variáveis do contato.

Dicas, limites e boas práticas

Documentos brasileiros são validados por dígito verificador; um documento inválido não é salvo no campo nativo (a cobrança ainda pode ser criada com o valor digitado — o gateway decide).
Quem já usava os atributos personalizados de pagamento (payment_document, payment_address_*) não perde nada: os valores continuam sendo lidos como reserva até a migração automática, e as cobranças passam a gravar somente nos campos nativos.
O CEP com preenchimento automático cobre endereços do Brasil; para outros países, preencha manualmente.

Solução de problemas

"O CPF/CNPJ não foi salvo": confira os dígitos — documentos com dígito verificador inválido são rejeitados para proteger a cobrança.
A cobrança pede documento mesmo com o contato preenchido: verifique se o documento aparece preenchido no painel do contato; se estiver vazio, salve-o novamente.
Endereço não preencheu pelo CEP: o serviço de CEP pode estar indisponível — preencha manualmente; nada é sobrescrito.