## 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

1. Abra o contato (página de Contatos ou painel da conversa) e clique em **Editar**.
2. 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.
3. Na seção **Endereço**, informe o **CEP**: rua, bairro, cidade e UF são preenchidos
   automaticamente. Complete número e complemento.
4. 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.
5. 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.

## Veja também

- [Contatos: criar, importar (CSV) e segmentos](/hc/ajuda/articles/contacts-crm-contatos-import-segmentos-pt-br)
- [Criar cobrança e enviar na conversa](/hc/ajuda/articles/payments-criar-cobranca-enviar-na-conversa-pt-br)
- [Assinaturas e planos](/hc/ajuda/articles/payments-assinaturas-planos-pt-br)