Implementación: cuenta y cartera

Primera mitad de la implementación: dejar la cuenta con tu identidad y poner la cartera dentro del sistema. Al final de esta página tendrás estructura, marca y clientes listos — la regla y los canales vienen después.

1. Estructura la cuenta

Tu operación se organiza en cuatro niveles: Organización → Workspace → Empresa (acreedora) → Sucursal. La jerarquía se gestiona en la página Estructura del menú lateral, y el recorte activo se elige en el selector de contexto en la parte superior de la pantalla.

• Operación simple (una empresa, sin sucursales): no crees nada — el contexto predeterminado lo resuelve todo, y nunca necesitas tocar el selector.
• Grupo con varias marcas u operaciones: crea un workspace por operación y una empresa por acreedora, con su CNPJ. Los clientes pertenecen a la empresa; cobros, reglas, clasificaciones y plantillas pertenecen a la sucursal (o a la matriz).

Detalles en Estructura organizacional.

2. Viste el producto con tu marca

En Configuración → Empresa, completa razón social, nombre de fantasía, CNPJ, contactos y el logo. No es decoración del registro: la barra lateral de la app y el portal del deudor muestran tu marca — el deudor que abre el enlace de negociación nunca ve la nuestra.

Para los correos de cobranza, configura un layout de correo: el sobre HTML con tu encabezado y pie. La resolución es en cascada (sucursal → empresa → organización → layout incorporado), lo que permite que cada marca del grupo envíe con la identidad correcta. Incluye en el pie la razón social y los datos de contacto del acreedor — identificar claramente al cobrador es buena práctica y reduce la marcación como spam.

3. Invita al equipo

En Configuración → Usuarios, invita a los operadores y asigna roles. Los permisos siguen el catálogo dunning.dashboard.<recurso>.<acción> — dale a cada persona lo que su función exige, y nada más. Ver Miembros y permisos.

4. Importa la cartera

Dos caminos, que pueden convivir:

Por hoja de cálculo — en la página Importaciones, sube un CSV de clientes primero, cobros después (la fila de cobro referencia al cliente por documento o external_id; cliente inexistente = fila rechazada). El formato es el CSV brasileño común: ; o ,, montos como 1.234,56, fechas DD/MM/AAAA. El botón Descargar modelo genera el archivo de ejemplo. Las filas con error no tumban al resto — el enlace "Ver errores" lista, fila por fila, qué corregir y reimportar. Terminado el procesamiento, el contenido del archivo se borra (LGPD); quedan los metadatos. Todo en Importación por hoja de cálculo.

Por la API — POST /people y POST /charges, cubiertos en la guía del integrador.

Tres cuidados que valen oro en el go-live:

• external_id siempre: es la clave de deduplicación. Reimportar o reenviar con el mismo external_id actualiza en vez de duplicar.
• Contacto en todo cliente: sin correo o teléfono, la regla no tiene adónde enviar — el canal simplemente se salta.
• Dirección con estado (UF): la ventana legal de contacto se resuelve por el estado del deudor; sin uno válido, aplica la regla nacional conservadora.

5. Clasifica (opcional, pero poderoso)

Las clasificaciones etiquetan el perfil de pagador (Nuevo, Bueno, Regular, Malo...) — manualmente o de forma automática a partir del historial. Las reglas pueden vincularse a clasificaciones: así tratas carteras distintas con reglas distintas (clientes estratégicos con una regla más suave, por ejemplo).

Cómo saber que esta etapa terminó

• La estructura refleja tu operación real y el selector de contexto muestra los recortes esperados.
• Logo y nombre de fantasía aparecen en la barra lateral; el layout de correo lleva tu marca y un pie con los datos del acreedor.
• La importación de clientes y cobros terminó con cero errores pendientes (o los errores conocidos fueron descartados deliberadamente).
• Muestra de clientes verificada: documento, correo/teléfono, dirección con estado, external_id.

Próximo paso: diseñar y publicar la regla, y encender los canales.