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
- Abre el contacto (página de Contactos o panel de la conversación) y haz clic en Editar.
- 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.
- 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.
- 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.
- 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_idcomo 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_stateyaddress_countrycompletan 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.