# Regla de Cobranza — Kobana > Documentação completa: carteira de clientes, régua de cobrança multicanal, compliance de contato, acordos, disputas, webhooks e API. ## es Regla de Cobranza: motor de reglas de cobranza multicanal para recuperar cuentas en mora con compliance de contacto, acuerdos, disputas y auditoría. - [Regla de Cobranza](https://docs.dunning.com.br/es/index.md): Regla de Cobranza: motor de reglas de cobranza multicanal para recuperar cuentas en mora con compliance de contacto, acuerdos, disputas y auditoría. ### search - [Search the documentation](https://docs.dunning.com.br/es/search.md) ### acordos - [Acuerdos](https://docs.dunning.com.br/es/acordos.md) #### documentos Documentos generados en PDF: el término de acuerdo y la carta de finiquito, armados con los datos de la operación y obtenidos por la API. - [Documentos generados (PDF)](https://docs.dunning.com.br/es/acordos/documentos.md): Documentos generados en PDF: el término de acuerdo y la carta de finiquito, armados con los datos de la operación y obtenidos por la API. #### negociacao Negociación y acuerdos: cómo un acuerdo consolida deudas en cuotas, el ciclo de vida del acuerdo y la validación server-side del portal. - [Negociación y acuerdos](https://docs.dunning.com.br/es/acordos/negociacao.md): Negociación y acuerdos: cómo un acuerdo consolida deudas en cuotas, el ciclo de vida del acuerdo y la validación server-side del portal. #### parcelas-e-quebra Cuotas e incumplimiento del acuerdo: cómo se generan las cuotas, el registro de pagos y qué pasa cuando el acuerdo se incumple. - [Cuotas e incumplimiento](https://docs.dunning.com.br/es/acordos/parcelas-e-quebra.md): Cuotas e incumplimiento del acuerdo: cómo se generan las cuotas, el registro de pagos y qué pasa cuando el acuerdo se incumple. ### api Referencia de la API de la Regla de Cobranza: contratos completos de los endpoints v1, generados a partir del OpenAPI. - [Referencia de la API](https://docs.dunning.com.br/es/api.md): Referencia de la API de la Regla de Cobranza: contratos completos de los endpoints v1, generados a partir del OpenAPI. ### carteira - [Cartera](https://docs.dunning.com.br/es/carteira.md) #### classificacoes Las clasificaciones segmentan la cartera según el comportamiento de pago: Nuevo, Buen, Regular, Mal pagador — o cualquier otra división que tenga sentido para tu operación. La página Clasificaciones del menú lateral lista cada una con nombre, prioridad, si es autoasignada, cuántas personas están en ella y cuántas reglas la usan. - [Clasificaciones](https://docs.dunning.com.br/es/carteira/classificacoes.md): Las clasificaciones segmentan la cartera según el comportamiento de pago: Nuevo, Buen, Regular, Mal pagador — o cualquier otra división que tenga sentido para tu operación. La página Clasificaciones del menú lateral lista cada una con nombre, prioridad, si es autoasignada, cuántas personas están en ella y cuántas reglas la usan. #### clientes Los clientes son las personas (físicas o jurídicas) de tu cartera — en la interfaz, la página Clientes del menú lateral. Todo lo demás en el sistema gira en torno a ellos: cobros, acuerdos, notificaciones y el portal del deudor siempre apuntan a un cliente. - [Clientes](https://docs.dunning.com.br/es/carteira/clientes.md): Los clientes son las personas (físicas o jurídicas) de tu cartera — en la interfaz, la página Clientes del menú lateral. Todo lo demás en el sistema gira en torno a ellos: cobros, acuerdos, notificaciones y el portal del deudor siempre apuntan a un cliente. #### exportacao Dunning exporta clientes y cobros en CSV de dos formas: descarga inmediata (síncrona), para recortes de hasta 10 mil filas, y exportación en segundo plano (página Exportaciones), para bases grandes. - [Exportación](https://docs.dunning.com.br/es/carteira/exportacao.md): Dunning exporta clientes y cobros en CSV de dos formas: descarga inmediata (síncrona), para recortes de hasta 10 mil filas, y exportación en segundo plano (página Exportaciones), para bases grandes. #### importacao La página Importaciones sube tu cartera por archivo CSV: primero los clientes, después los cobros. El procesamiento corre en segundo plano, fila por fila — las filas con error no tumban el resto del archivo. - [Importación por hoja de cálculo](https://docs.dunning.com.br/es/carteira/importacao.md): La página Importaciones sube tu cartera por archivo CSV: primero los clientes, después los cobros. El procesamiento corre en segundo plano, fila por fila — las filas con error no tumban el resto del archivo. ### cobrancas - [Cobros](https://docs.dunning.com.br/es/cobrancas.md) #### ciclo-de-vida El ciclo de vida del cobro: los estados, la máquina de estados y las transiciones del día a día, de pendiente a baja y recuperación. - [Ciclo de vida](https://docs.dunning.com.br/es/cobrancas/ciclo-de-vida.md): El ciclo de vida del cobro: los estados, la máquina de estados y las transiciones del día a día, de pendiente a baja y recuperación. #### encargos Cargos del cobro: multa, intereses de mora, corrección y descuento, calculados de forma idempotente en centavos y en la zona horaria de la organización. - [Recargos y ajustes](https://docs.dunning.com.br/es/cobrancas/encargos.md): Cargos del cobro: multa, intereses de mora, corrección y descuento, calculados de forma idempotente en centavos y en la zona horaria de la organización. #### origens Orígenes del cobro: el campo que registra la procedencia de cada título — manual, planilla, API o integración — para filtrar y diagnosticar. - [Orígenes del cobro](https://docs.dunning.com.br/es/cobrancas/origens.md): Orígenes del cobro: el campo que registra la procedencia de cada título — manual, planilla, API o integración — para filtrar y diagnosticar. #### pagamento-e-baixa Pago y baja: cómo entra el pago, qué ocurre en la baja, la verificación de ya pagué y el bloqueo jurídico. - [Pago y baja](https://docs.dunning.com.br/es/cobrancas/pagamento-e-baixa.md): Pago y baja: cómo entra el pago, qué ocurre en la baja, la verificación de ya pagué y el bloqueo jurídico. #### valores-e-vencimento Los importes de un cobro: original, actual, pagado y saldo, y cómo el vencimiento define cuándo entra la regla de cobranza. - [Montos y vencimiento](https://docs.dunning.com.br/es/cobrancas/valores-e-vencimento.md): Los importes de un cobro: original, actual, pagado y saldo, y cómo el vencimiento define cuándo entra la regla de cobranza. ### configuracoes - [Configuración](https://docs.dunning.com.br/es/configuracoes.md) #### chaves-de-api Las claves de API autentican integraciones con la API v1. Se crean en Configuración → Seguridad, solo por administradores. - [Claves de API](https://docs.dunning.com.br/es/configuracoes/chaves-de-api.md): Las claves de API autentican integraciones con la API v1. Se crean en Configuración → Seguridad, solo por administradores. #### conta-e-marca La pantalla Configuración concentra la administración de la cuenta en cinco pestañas: Empresa, Usuarios, Notificaciones, Integraciones y Seguridad. - [Cuenta y marca](https://docs.dunning.com.br/es/configuracoes/conta-e-marca.md): La pantalla Configuración concentra la administración de la cuenta en cinco pestañas: Empresa, Usuarios, Notificaciones, Integraciones y Seguridad. #### layouts-de-email El layout de email es el sobre HTML que envuelve todo mensaje de cobro enviado por email: encabezado con tu marca, pie con tus datos, y en el medio el contenido de la plantilla de la etapa. La plantilla dice qué dice el mensaje; el layout dice cómo se viste. - [Layouts de email](https://docs.dunning.com.br/es/configuracoes/layouts-de-email.md): El layout de email es el sobre HTML que envuelve todo mensaje de cobro enviado por email: encabezado con tu marca, pie con tus datos, y en el medio el contenido de la plantilla de la etapa. La plantilla dice qué dice el mensaje; el layout dice cómo se viste. #### preferencias-de-notificacao Las preferencias de notificación son el interruptor por tipo × canal de los mensajes que el sistema envía al deudor. Responden a preguntas como "quiero recordatorios por email, pero no por SMS" sin tocar ninguna regla de cobranza. - [Preferencias de notificación](https://docs.dunning.com.br/es/configuracoes/preferencias-de-notificacao.md): Las preferencias de notificación son el interruptor por tipo × canal de los mensajes que el sistema envía al deudor. Responden a preguntas como "quiero recordatorios por email, pero no por SMS" sin tocar ninguna regla de cobranza. ### desenvolvedores - [Desarrolladores](https://docs.dunning.com.br/es/desenvolvedores.md) #### comece-aqui Todo lo que el dashboard hace en la operación de cobro existe en la API v1: clientes, cobros, reglas de cobranza, acuerdos, disputas, tareas, importaciones, webhooks. Esta sección trae el camino práctico; los contratos completos están en la Referencia de la API, generada del OpenAPI (nunca escrita a mano). - [Comienza aquí](https://docs.dunning.com.br/es/desenvolvedores/comece-aqui.md): Todo lo que el dashboard hace en la operación de cobro existe en la API v1: clientes, cobros, reglas de cobranza, acuerdos, disputas, tareas, importaciones, webhooks. Esta sección trae el camino práctico; los contratos completos están en la Referencia de la API, generada del OpenAPI (nunca escrita a mano). #### erros Todo error de la API v1 vuelve en el mismo envelope: - [Errores y códigos](https://docs.dunning.com.br/es/desenvolvedores/erros.md): Todo error de la API v1 vuelve en el mismo envelope: #### exemplos El flujo esencial de una integración, de punta a punta, en curl - [Ejemplos prácticos](https://docs.dunning.com.br/es/desenvolvedores/exemplos.md): El flujo esencial de una integración, de punta a punta, en curl #### postman-e-sdks No necesitas armar solicitudes desde cero: la colección Postman y el spec OpenAPI se generan de la misma fuente que la Referencia de la API y siempre están en sincronía con ella. - [Postman y SDKs](https://docs.dunning.com.br/es/desenvolvedores/postman-e-sdks.md): No necesitas armar solicitudes desde cero: la colección Postman y el spec OpenAPI se generan de la misma fuente que la Referencia de la API y siempre están en sincronía con ella. ### disputas - [Disputas](https://docs.dunning.com.br/es/disputas.md) #### contestacoes Cuando el deudor contesta un cobro — "ya pagué", "no lo reconozco", "el valor está equivocado" — seguir cobrando es el peor movimiento posible abrir una disputa pausa la regla de cobranza de inmediato y congela todo envío pendiente, antes de cualquier análisis. - [Contestaciones](https://docs.dunning.com.br/es/disputas/contestacoes.md): Cuando el deudor contesta un cobro — "ya pagué", "no lo reconozco", "el valor está equivocado" — seguir cobrando es el peor movimiento posible abrir una disputa pausa la regla de cobranza de inmediato y congela todo envío pendiente, antes de cualquier análisis. #### resolucao Resolver una disputa es responder dos preguntas: ¿el deudor tiene razón? (decisión) y ¿qué hacer con el cobro? (efecto). La pantalla de la disputa pide las dos, más una decisión fundamentada por escrito — obligatoria, porque va a la pista de auditoría. - [Resolución](https://docs.dunning.com.br/es/disputas/resolucao.md): Resolver una disputa es responder dos preguntas: ¿el deudor tiene razón? (decisión) y ¿qué hacer con el cobro? (efecto). La pantalla de la disputa pide las dos, más una decisión fundamentada por escrito — obligatoria, porque va a la pista de auditoría. ### guia - [Guías](https://docs.dunning.com.br/es/guia.md) #### go-live-checklist Checklist de go-live: la revisión final de cartera, regla, canales, compliance e integraciones antes de cobrar a deudores reales. - [Checklist de go-live](https://docs.dunning.com.br/es/guia/go-live-checklist.md): Checklist de go-live: la revisión final de cartera, regla, canales, compliance e integraciones antes de cobrar a deudores reales. #### guia-do-integrador Guía del integrador: clave de API, primera llamada, primer cliente y cobro, webhooks y reintentos seguros para conectar ERP o gateway a Dunning. - [Guía del integrador](https://docs.dunning.com.br/es/guia/guia-do-integrador.md): Guía del integrador: clave de API, primera llamada, primer cliente y cobro, webhooks y reintentos seguros para conectar ERP o gateway a Dunning. #### implantacao-conta-e-carteira Implantación, parte 1: estructurar la cuenta, aplicar tu marca y cargar la cartera de clientes antes de diseñar la regla. - [Implementación: cuenta y cartera](https://docs.dunning.com.br/es/guia/implantacao-conta-e-carteira.md): Implantación, parte 1: estructurar la cuenta, aplicar tu marca y cargar la cartera de clientes antes de diseñar la regla. #### implantacao-regua-e-canais Implantación, parte 2: diseñar la regla, publicarla y activar los canales de envío para convertir la cuenta en una operación de cobranza. - [Implementación: regla y canales](https://docs.dunning.com.br/es/guia/implantacao-regua-e-canais.md): Implantación, parte 2: diseñar la regla, publicarla y activar los canales de envío para convertir la cuenta en una operación de cobranza. #### o-produto-em-5-minutos El producto en 5 minutos: qué hace Dunning, con qué piezas y bajo qué promesa, para decidir bien en las guías de implantación. - [El producto en 5 minutos](https://docs.dunning.com.br/es/guia/o-produto-em-5-minutos.md): El producto en 5 minutos: qué hace Dunning, con qué piezas y bajo qué promesa, para decidir bien en las guías de implantación. #### operacao-dia-a-dia La rutina del operador con la regla en marcha: atender las excepciones que el sistema separa y leer los números para ajustar la máquina. - [Operación en el día a día](https://docs.dunning.com.br/es/guia/operacao-dia-a-dia.md): La rutina del operador con la regla en marcha: atender las excepciones que el sistema separa y leer los números para ajustar la máquina. ### integracoes #### bling Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión vía OAuth - [Bling](https://docs.dunning.com.br/es/integracoes/bling.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión vía OAuth #### conta-azul Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión vía OAuth - [Conta Azul](https://docs.dunning.com.br/es/integracoes/conta-azul.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión vía OAuth #### faturamento-automatico Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conciliación en tiempo real por webhook - [Faturamento Automático](https://docs.dunning.com.br/es/integracoes/faturamento-automatico.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conciliación en tiempo real por webhook #### financeiro-inteligente Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda - [Financeiro Inteligente](https://docs.dunning.com.br/es/integracoes/financeiro-inteligente.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda #### gateway-kobana Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conciliación en tiempo real por webhook - [Gateway da Kobana](https://docs.dunning.com.br/es/integracoes/gateway-kobana.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conciliación en tiempo real por webhook #### olist Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión vía OAuth - [Olist (Tiny)](https://docs.dunning.com.br/es/integracoes/olist.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión vía OAuth #### omie Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión por clave estática - [Omie](https://docs.dunning.com.br/es/integracoes/omie.md): Integración nativa · Solo lectura (pull) · Sincroniza automáticamente cada 60 min (configurable) + bajo demanda · Conexión por clave estática #### visao-geral Las integraciones conectan el Dunning a los sistemas donde tus cobros ya nacen — el Gateway da Kobana, los productos hermanos de Faturamento y Financeiro, y ERPs del mercado como Bling, Conta Azul, Omie y Olist/Tiny. En vez de volver a registrar títulos a mano, conectas el origen una vez y el Dunning pasa a traer los cobros y los clientes desde allí para cobrarlos con la regla, el portal y los acuerdos. - [Integraciones](https://docs.dunning.com.br/es/integracoes/visao-geral.md): Las integraciones conectan el Dunning a los sistemas donde tus cobros ya nacen — el Gateway da Kobana, los productos hermanos de Faturamento y Financeiro, y ERPs del mercado como Bling, Conta Azul, Omie y Olist/Tiny. En vez de volver a registrar títulos a mano, conectas el origen una vez y el Dunning pasa a traer los cobros y los clientes desde allí para cobrarlos con la regla, el portal y los acuerdos. ### metricas - [Métricas](https://docs.dunning.com.br/es/metricas.md) #### dashboard El panel es la home del Dunning: la foto de la cartera arriba, la línea operativa en el medio y los detalles abajo. Todas las tarjetas son cliqueables y llevan a la pantalla filtrada correspondiente. - [Panel](https://docs.dunning.com.br/es/metricas/dashboard.md): El panel es la home del Dunning: la foto de la cartera arriba, la línea operativa en el medio y los detalles abajo. Todas las tarjetas son cliqueables y llevan a la pantalla filtrada correspondiente. #### recuperacao Las métricas de recuperación responden a la pregunta que justifica el producto: ¿qué hizo la regla por ti? La respuesta se construye con atribución honesta — el sistema solo llama "recuperado" a lo que de verdad estaba en recuperación, y dice qué etapa y canal tocaron al deudor por última vez antes de que el dinero entrara. - [Recuperación](https://docs.dunning.com.br/es/metricas/recuperacao.md): Las métricas de recuperación responden a la pregunta que justifica el producto: ¿qué hizo la regla por ti? La respuesta se construye con atribución honesta — el sistema solo llama "recuperado" a lo que de verdad estaba en recuperación, y dice qué etapa y canal tocaron al deudor por última vez antes de que el dinero entrara. ### negativacao-e-protesto - [Negativación y Protesto](https://docs.dunning.com.br/es/negativacao-e-protesto.md) #### remocao-e-cancelamento Registrar en el buró de crédito o protestar es la mitad del trabajo; la otra mitad es retirar el registro en el momento correcto. Un deudor que pagó y sigue negativado es un pasivo jurídico — la baja oportuna es obligación del acreedor, no cortesía. - [Remoción y cancelación](https://docs.dunning.com.br/es/negativacao-e-protesto/remocao-e-cancelamento.md): Registrar en el buró de crédito o protestar es la mitad del trabajo; la otra mitad es retirar el registro en el momento correcto. Un deudor que pagó y sigue negativado es un pasivo jurídico — la baja oportuna es obligación del acreedor, no cortesía. #### workflow La negativación (SPC/Serasa/Boa Vista) y el protesto en notaría (cartório, la notaría de protesto brasileña) no son "canales de la regla de cobranza" — mandar un CPF al buró de crédito no es como mandar un e-mail. Son actos jurídicos con consecuencias serias para el deudor y responsabilidad real para tu empresa la regla de cobranza puede iniciarlos, pero nada se registra en el buró ni en la notaría sin la aprobación de un humano. - [Workflow jurídico](https://docs.dunning.com.br/es/negativacao-e-protesto/workflow.md): La negativación (SPC/Serasa/Boa Vista) y el protesto en notaría (cartório, la notaría de protesto brasileña) no son "canales de la regla de cobranza" — mandar un CPF al buró de crédito no es como mandar un e-mail. Son actos jurídicos con consecuencias serias para el deudor y responsabilidad real para tu empresa la regla de cobranza puede iniciarlos, pero nada se registra en el buró ni en la notaría sin la aprobación de un humano. ### operacao - [Operación](https://docs.dunning.com.br/es/operacao.md) #### auditoria La pantalla Auditoría es la pista inmutable de todo lo que ocurrió en la cuenta el registro que presentas cuando un deudor, un abogado o un juez pregunta "¿por qué hicieron esto?". - [Auditoría](https://docs.dunning.com.br/es/operacao/auditoria.md): La pantalla Auditoría es la pista inmutable de todo lo que ocurrió en la cuenta el registro que presentas cuando un deudor, un abogado o un juez pregunta "¿por qué hicieron esto?". #### estrutura-organizacional La pantalla Estructura organiza la cuenta en tres niveles: workspaces, empresas y sucursales. Esta jerarquía es la que separa carteras, delimita reportes y define en nombre de quién salen las comunicaciones. - [Estructura organizacional](https://docs.dunning.com.br/es/operacao/estrutura-organizacional.md): La pantalla Estructura organiza la cuenta en tres niveles: workspaces, empresas y sucursales. Esta jerarquía es la que separa carteras, delimita reportes y define en nombre de quién salen las comunicaciones. #### membros-e-permissoes La pantalla Miembros responde "quién accede a la cuenta y qué puede hacer cada uno". Cada miembro tiene uno o más roles; cada role es un conjunto de permisos del catálogo del producto. - [Miembros y permisos](https://docs.dunning.com.br/es/operacao/membros-e-permissoes.md): La pantalla Miembros responde "quién accede a la cuenta y qué puede hacer cada uno". Cada miembro tiene uno o más roles; cada role es un conjunto de permisos del catálogo del producto. #### tarefas-e-equipe La pantalla Tareas es la fila de trabajo de los operadores: todo lo que la regla de cobranza no resuelve sola (o que decidiste tratar manualmente) se convierte en una tarea con tipo, prioridad y vencimiento. - [Tareas y equipo](https://docs.dunning.com.br/es/operacao/tarefas-e-equipe.md): La pantalla Tareas es la fila de trabajo de los operadores: todo lo que la regla de cobranza no resuelve sola (o que decidiste tratar manualmente) se convierte en una tarea con tipo, prioridad y vencimiento. ### portal-do-devedor - [Portal del Deudor](https://docs.dunning.com.br/es/portal-do-devedor.md) #### autoatendimento El portal del deudor es donde el cliente resuelve su propia pendencia: consulta las deudas, paga por boleto o PIX, simula un plan de cuotas y cierra un acuerdo — sin hablar con nadie de tu equipo, a cualquier hora. - [Autoservicio](https://docs.dunning.com.br/es/portal-do-devedor/autoatendimento.md): El portal del deudor es donde el cliente resuelve su propia pendencia: consulta las deudas, paga por boleto o PIX, simula un plan de cuotas y cierra un acuerdo — sin hablar con nadie de tu equipo, a cualquier hora. #### conta-do-devedor Además del acceso rápido por link, el portal ofrece una cuenta persistente: el deudor crea un login con e-mail y contraseña y vuelve cuando quiera — en /conta — para acompañar las deudas, los acuerdos, el historial y el perfil a lo largo del tiempo, sin depender de un link nuevo cada vez. - [Cuenta del deudor](https://docs.dunning.com.br/es/portal-do-devedor/conta-do-devedor.md): Además del acceso rápido por link, el portal ofrece una cuenta persistente: el deudor crea un login con e-mail y contraseña y vuelve cuando quiera — en /conta — para acompañar las deudas, los acuerdos, el historial y el perfil a lo largo del tiempo, sin depender de un link nuevo cada vez. #### seguranca El portal expone datos de deuda en internet abierta — en el acceso por link, sin siquiera un login — por eso cada capa de protección importa. Esta página documenta el modelo de seguridad del acceso por link para que respondas con precisión a auditorías y consultas de clientes. La cuenta persistente (e-mail y contraseña) tiene sus propias protecciones, descritas en su página. - [Seguridad](https://docs.dunning.com.br/es/portal-do-devedor/seguranca.md): El portal expone datos de deuda en internet abierta — en el acceso por link, sin siquiera un login — por eso cada capa de protección importa. Esta página documenta el modelo de seguridad del acceso por link para que respondas con precisión a auditorías y consultas de clientes. La cuenta persistente (e-mail y contraseña) tiene sus propias protecciones, descritas en su página. #### white-label El deudor debe negociar con tu marca — no con un sistema de cobro genérico. Un cobro que llega con la identidad del acreedor tiene más legitimidad, genera menos desconfianza ("¿esto es una estafa?") y convierte más. - [White-label](https://docs.dunning.com.br/es/portal-do-devedor/white-label.md): El deudor debe negociar con tu marca — no con un sistema de cobro genérico. Un cobro que llega con la identidad del acreedor tiene más legitimidad, genera menos desconfianza ("¿esto es una estafa?") y convierte más. ### primeiros-passos #### checklist-de-onboarding La tarjeta Primeros pasos: los cuatro pasos, marcados a partir de tus datos reales, que llevan una cuenta vacía a una regla cobrando. - [Checklist de onboarding](https://docs.dunning.com.br/es/primeiros-passos/checklist-de-onboarding.md): La tarjeta Primeros pasos: los cuatro pasos, marcados a partir de tus datos reales, que llevan una cuenta vacía a una regla cobrando. #### conceitos El glosario de Dunning en una página: cliente, cobro, regla, etapa, acuerdo, disputa y demás términos tal como aparecen en la interfaz. - [Conceptos](https://docs.dunning.com.br/es/primeiros-passos/conceitos.md): El glosario de Dunning en una página: cliente, cobro, regla, etapa, acuerdo, disputa y demás términos tal como aparecen en la interfaz. #### primeira-cobranca Paso a paso para crear el primer cliente, registrar un cobro y ver la regla de cobranza asumir el trabajo, en cinco minutos. - [Tu primer cobro](https://docs.dunning.com.br/es/primeiros-passos/primeira-cobranca.md): Paso a paso para crear el primer cliente, registrar un cobro y ver la regla de cobranza asumir el trabajo, en cinco minutos. #### visao-geral Visión general de Dunning: cómo la regla acompaña cada cobro del vencimiento al pago y qué queda a cargo del operador. - [Visión general](https://docs.dunning.com.br/es/primeiros-passos/visao-geral.md): Visión general de Dunning: cómo la regla acompaña cada cobro del vencimiento al pago y qué queda a cargo del operador. ### regua-de-cobranca - [Regla de Cobranza](https://docs.dunning.com.br/es/regua-de-cobranca.md) #### campanhas-de-negociacao Una campaña de negociación es un descuento reutilizable que el portal del deudor ofrece automáticamente — sin que el operador tenga que crear propuesta por propuesta. Tú defines el descuento, el máximo de cuotas y, opcionalmente, el rango de atraso en el que la campaña aplica; el portal hace el resto. - [Campañas de negociación](https://docs.dunning.com.br/es/regua-de-cobranca/campanhas-de-negociacao.md): Una campaña de negociación es un descuento reutilizable que el portal del deudor ofrece automáticamente — sin que el operador tenga que crear propuesta por propuesta. Tú defines el descuento, el máximo de cuotas y, opcionalmente, el rango de atraso en el que la campaña aplica; el portal hace el resto. #### como-funciona Una regla de cobranza es una secuencia de etapas ancladas en el vencimiento del cobro: un recordatorio 3 días antes, un aviso el mismo día, un correo firme 5 días después, una oferta de acuerdo a los 15, y así sucesivamente. Diseñas la secuencia una vez y el motor la ejecuta para cada cobro, todos los días, sin que nadie tenga que acordarse de nada. - [Cómo funciona](https://docs.dunning.com.br/es/regua-de-cobranca/como-funciona.md): Una regla de cobranza es una secuencia de etapas ancladas en el vencimiento del cobro: un recordatorio 3 días antes, un aviso el mismo día, un correo firme 5 días después, una oferta de acuerdo a los 15, y así sucesivamente. Diseñas la secuencia una vez y el motor la ejecuta para cada cobro, todos los días, sin que nadie tenga que acordarse de nada. #### compliance-de-contato Esta es la garantía central del producto dependiendo del estado (UF) de Brasil, es una infracción legal. - [Compliance de contacto](https://docs.dunning.com.br/es/regua-de-cobranca/compliance-de-contato.md): Esta es la garantía central del producto dependiendo del estado (UF) de Brasil, es una infracción legal. #### etapas-e-canais Cada etapa de la regla de cobranza responde tres preguntas: cuándo disparar (disparador), qué hacer (acción) y por dónde hablar (canales). Esta página detalla las opciones de cada una. - [Etapas y canales](https://docs.dunning.com.br/es/regua-de-cobranca/etapas-e-canais.md): Cada etapa de la regla de cobranza responde tres preguntas: cuándo disparar (disparador), qué hacer (acción) y por dónde hablar (canales). Esta página detalla las opciones de cada una. #### templates-e-variaveis Las plantillas son los mensajes que envían las etapas de la regla de cobranza. Cada plantilla pertenece a un canal (correo electrónico, SMS, WhatsApp, voz), tiene una categoría, un tono y un cuerpo con variables que el motor sustituye por los datos reales del cobro al momento del envío. - [Plantillas y variables](https://docs.dunning.com.br/es/regua-de-cobranca/templates-e-variaveis.md): Las plantillas son los mensajes que envían las etapas de la regla de cobranza. Cada plantilla pertenece a un canal (correo electrónico, SMS, WhatsApp, voz), tiene una categoría, un tono y un cuerpo con variables que el motor sustituye por los datos reales del cobro al momento del envío. #### versoes-e-publicacao Una regla de cobranza cambia: ajustas un texto, agregas una etapa, cambias un offset. Lo que no puede cambiar es el plan de quien ya está en medio del flujo — ni tu capacidad de probar, meses después, exactamente qué secuencia estaba vigente cuando ese deudor fue cobrado. Para eso existen las versiones. - [Versiones y publicación](https://docs.dunning.com.br/es/regua-de-cobranca/versoes-e-publicacao.md): Una regla de cobranza cambia: ajustas un texto, agregas una etapa, cambias un offset. Lo que no puede cambiar es el plan de quien ya está en medio del flujo — ni tu capacidad de probar, meses después, exactamente qué secuencia estaba vigente cuando ese deudor fue cobrado. Para eso existen las versiones. ### webhooks #### entregas-e-retry Ninguna entrega es "dispara y olvida". Cada evento × endpoint se convierte en un registro de entrega con estado, intentos y la captura completa de request y response — lo que transforma "el webhook no llegó" de misterio en consulta. - [Entregas y reintentos](https://docs.dunning.com.br/es/webhooks/entregas-e-retry.md): Ninguna entrega es "dispara y olvida". Cada evento × endpoint se convierte en un registro de entrega con estado, intentos y la captura completa de request y response — lo que transforma "el webhook no llegó" de misterio en consulta. #### eventos Catálogo completo de los eventos emitidos. El nombre sigue el patrón .; el campo data del payload trae el recurso serializado en el formato de la API v1 o un objeto de referencia compacto (documentado por evento). Un endpoint con la lista de eventos vacía recibe todos, incluidos los eventos futuros. - [Eventos](https://docs.dunning.com.br/es/webhooks/eventos.md): Catálogo completo de los eventos emitidos. El nombre sigue el patrón .; el campo data del payload trae el recurso serializado en el formato de la API v1 o un objeto de referencia compacto (documentado por evento). Un endpoint con la lista de eventos vacía recibe todos, incluidos los eventos futuros. - [Eventos de acuerdo (agreement.*)](https://docs.dunning.com.br/es/webhooks/eventos/agreement.md): Hechos del ciclo de vida de los acuerdos de negociación. En los eventos de entidad, data es el acuerdo con el cliente resumido (person) y, cuando ya se generaron, las cuotas (installments). - [Eventos de cobro (charge.*)](https://docs.dunning.com.br/es/webhooks/eventos/charge.md): Hechos del ciclo de vida de los cobros. En los eventos de entidad, data es el cobro serializado en el formato de la API v1, con person y collectionRule completos embebidos. En los eventos de hecho (paid, overdue), data es un objeto de referencia compacto. - [Eventos de clasificación (classification.*)](https://docs.dunning.com.br/es/webhooks/eventos/classification.md): Categorías de cliente (ej.: buen pagador, atraso recurrente) que direccionan las reglas de cobranza. En los eventos de entidad, data es la clasificación completa con contadores de uso (_count). - [Eventos de regla de cobranza (collection_rule.*)](https://docs.dunning.com.br/es/webhooks/eventos/collection-rule.md): Configuración de las reglas de cobranza. En los eventos de entidad, data es la regla con la classification vinculada y los steps ordenados por posición. - [Eventos de disputa (dispute.*)](https://docs.dunning.com.br/es/webhooks/eventos/dispute.md): Reclamos abiertos por el deudor (o registrados por el operador). Abrir una disputa pausa la regla de cobranza del cobro al instante. En todos los eventos, data es la disputa completa. - [Eventos de interacción (interaction.*)](https://docs.dunning.com.br/es/webhooks/eventos/interaction.md): Registros de la línea de tiempo de contacto con el cliente (llamadas, correos, notas). data es la interacción completa con person, user (quien la registró) y charge resumidos. - [Eventos de negativación (negativation.*)](https://docs.dunning.com.br/es/webhooks/eventos/negativation.md): Registro del deudor en los burós de crédito. Toda negativación disparada por la regla de cobranza pasa por revisión humana obligatoria antes de hacerse efectiva. data es siempre un objeto de referencia compacto. - [Eventos de notificación (notification.*)](https://docs.dunning.com.br/es/webhooks/eventos/notification.md): Ciclo de vida de los mensajes enviados al deudor por la regla de cobranza (correo, SMS, WhatsApp...). El data es siempre un objeto de referencia compacto — el recurso completo está en GET /api/v1/notifications/. - [Eventos de cliente (person.*)](https://docs.dunning.com.br/es/webhooks/eventos/person.md): Hechos del registro de clientes (deudores). En los eventos de entidad, data es el cliente serializado en el formato de la API v1 de clientes, con la clasificación resumida embebida. - [Eventos de protesto (protest.*)](https://docs.dunning.com.br/es/webhooks/eventos/protest.md): Protesto de títulos en notaría. Como en la negativación, todo protesto disparado por la regla de cobranza pasa por revisión humana obligatoria antes de enviarse. data es siempre un objeto de referencia compacto. - [Eventos de tarea (task.*)](https://docs.dunning.com.br/es/webhooks/eventos/task.md): Tareas manuales de la operación (creadas por operadores o por la regla de cobranza — ej.: revisión de negativación/protesto). En los eventos de entidad, data es la tarea con person, assignedTo y charge resumidos. - [Eventos de plantilla (template.*)](https://docs.dunning.com.br/es/webhooks/eventos/template.md): Plantillas de mensaje usadas por los pasos de la regla de cobranza. En los eventos de entidad, data es la plantilla completa (sin relaciones). - [Evento de prueba (webhook.test)](https://docs.dunning.com.br/es/webhooks/eventos/webhook-test.md): Disparado bajo demanda vía POST /api/v1/webhook-endpoints//test — no es suscribible y no aparece en el catálogo de suscripción. La entrega recorre el pipeline real (cola, firma HMAC, captura de request/response, reintento) y se envía solo al endpoint objetivo, independientemente de la lista de eventos suscritos. #### seguranca Dos capas protegen la comunicación: la firma HMAC (prueba que el payload vino del Dunning y no fue adulterado) y la autenticación del request (credenciales que el Dunning presenta a tu endpoint). La primera va siempre; la segunda es opcional. - [Seguridad](https://docs.dunning.com.br/es/webhooks/seguranca.md): Dos capas protegen la comunicación: la firma HMAC (prueba que el payload vino del Dunning y no fue adulterado) y la autenticación del request (credenciales que el Dunning presenta a tu endpoint). La primera va siempre; la segunda es opcional. #### visao-geral Visión general de webhooks: recibe los hechos de negocio de Dunning como POST JSON, con firma HMAC, entrega persistida y reintento automático. - [Visión general](https://docs.dunning.com.br/es/webhooks/visao-geral.md): Visión general de webhooks: recibe los hechos de negocio de Dunning como POST JSON, con firma HMAC, entrega persistida y reintento automático.