## Visión general

Cada contacto guarda de forma nativa su **identidad fiscal** — tipo (**Persona Física** o
**Jurídica**), **documento fiscal** (CPF/CNPJ) y **país fiscal** — además de la **dirección
completa** (código postal, calle, número, complemento, barrio, ciudad, estado y país).
Opcionalmente, una **dirección de facturación** distinta de la principal.

Estos datos alimentan automáticamente los módulos que los necesitan: **Pagos** completa el
pagador (documento y dirección) al crear cobros y suscripciones, las plantillas y automatizaciones
ganan variables como `{{contact.address_city}}`, y la IA de la cuenta ve la dirección como
contexto. El documento se muestra **completo para tu equipo** en el panel y el formulario; solo se
enmascara cuando un rol de acceso lo indica, para bots/integraciones y en las salidas externas
(webhooks, exportación CSV y variables de mensaje).

## Requisitos previos

- Permiso para editar contactos.
- Para el autocompletado de cobros: una conexión de gateway activa en **Pagos**.

## Paso a paso

1. Abre el contacto (página de Contactos o panel de la conversación) y haz clic en **Editar**.
2. Completa el **Tipo** (Persona Física o Jurídica), el **documento** y el **país fiscal** (p.
   ej. BR). Un documento guardado viene con su valor real: edítalo para corregirlo, o vacía el
   campo para eliminarlo.
3. En la sección **Dirección**, ingresa el **código postal (CEP)**: calle, barrio, ciudad y
   estado se autocompletan para códigos brasileños. Completa número y complemento.
4. Si la facturación va a otra dirección, marca **Dirección de facturación diferente**. Usa el
   botón **Copiar de la dirección principal** para traer todo con un clic y ajustar solo lo que
   cambia.
5. Guarda. Desde entonces, los cobros y suscripciones creados para ese contacto vienen con el
   documento y la dirección completados.

## Configuración y opciones

- **Visibilidad del documento**: el documento se valida al guardar (dígitos verificadores) y es
  visible para tu equipo. Para ocultarlo a parte del equipo, usa **Funciones y accesos** y define la
  regla del campo `tax_id` como *enmascarado* (muestra `***.***.***-09`) u *oculto*. El valor siempre
  se guarda cifrado.
- **Dirección de facturación**: al desmarcar la opción, la facturación vuelve a usar la dirección
  principal.
- **Importación CSV**: las columnas `legal_type`, `tax_id`, `tax_country`, `address_zip`,
  `address_street`, `address_number`, `address_complement`, `address_neighborhood`,
  `address_city`, `address_state` y `address_country` completan los campos nativos.
- **Exportación**: el documento siempre se exporta enmascarado; la dirección sale en columnas
  aplanadas (`address_*`).
- **Variables**: `{{contact.masked_tax_id}}`, `{{contact.legal_type}}`, `{{contact.tax_country}}`
  y `{{contact.address_zip}}` … `{{contact.address_country}}` funcionan en respuestas
  predefinidas, macros, automatizaciones, follow-ups y el FlowBuilder.

## Casos de uso

- Emitir un boleto de Mercado Pago sin pedir la dirección de nuevo: el contacto ya la tiene.
- Una empresa con sede (principal) facturada en otra unidad (facturación).
- Segmentar por ciudad/país — la dirección alimenta los filtros de ubicación del contacto.
- Segmentar por tipo de persona (física/jurídica), tipo de documento, país fiscal y dirección (código postal, ciudad, estado, país) en los filtros avanzados y segmentos de contactos.
- Automatizar: la acción "Definir campo del contacto (fiscal/dirección)" en automatizaciones, macros y flujos escribe tipo de persona, documento y dirección directamente en los campos nativos — por ejemplo, un flujo que pregunta el CPF/CNPJ y guarda la respuesta en el contacto.
- Condicionar: las automatizaciones disparadas por contacto pueden filtrar por tipo de persona, tipo de documento, país fiscal y dirección; en los flujos, el nodo de condición usa las mismas variables del contacto.

## Consejos, límites y buenas prácticas

- Los documentos brasileños se validan por dígito verificador; un documento inválido no se guarda
  en el campo nativo (el cobro aún puede crearse con el valor escrito — el gateway decide).
- Las cuentas que usaban los atributos personalizados de pago (`payment_document`,
  `payment_address_*`) no pierden nada: esos valores se siguen leyendo como respaldo hasta la
  migración automática, y los cobros pasan a escribir solo en los campos nativos.
- El autocompletado por código postal cubre direcciones de Brasil; para otros países, completa
  manualmente.

## Solución de problemas

- **"El documento no se guardó"**: revisa los dígitos — los documentos con dígito verificador
  inválido se rechazan para proteger el cobro.
- **El cobro pide documento aunque el contacto lo tenga**: confirma que el documento aparece
  completo en el panel del contacto; si está vacío, guárdalo de nuevo.
- **El código postal no autocompletó la dirección**: el servicio de CEP puede no estar disponible
  — completa manualmente; nada se sobrescribe.

## Ver también

- [Contactos: crear, importar (CSV) y segmentos](/hc/ajuda/articles/contacts-crm-contatos-import-segmentos-es)
- [Crear un cobro y enviarlo en la conversación](/hc/ajuda/articles/payments-criar-cobranca-enviar-na-conversa-es)
- [Suscripciones y planes](/hc/ajuda/articles/payments-assinaturas-planos-es)