Intereses y Multas

Una factura vencida puede acumular multa (cobrada una sola vez) e intereses de mora (que corren por día de atraso). La política de intereses y multas define ambos, vale para toda la organización y puede cambiarse por cliente, por suscripción o por factura.

Toda organización empieza con una política que no cobra nada. Activar el cobro es una decisión comercial explícita, porque cambia lo que sus clientes deben.

Dónde configurar

Configuración → pestaña Intereses y multas.

La pantalla muestra la lista de políticas y un simulador en vivo: al editar los valores, usted ve el efecto sobre una factura de R$ 1.000,00 vencida hace quince días, antes de aplicar la regla a clientes reales.

Campos

Multa

Campo	Descripción
Tipo de multa	Sin cobro, Porcentaje del saldo o Valor fijo
Porcentaje / Valor	Solo aparece el campo que usa el tipo elegido
Días después del vencimiento	Cuándo comienza a aplicarse la multa. El valor por defecto es 1 — el día siguiente al vencimiento

La multa se cobra una sola vez, no por día.

Intereses de mora

Campo	Descripción
Tipo de intereses	Sin cobro, porcentaje por día, por mes o por año, o valor fijo por día
Porcentaje / Valor por día	Solo aparece el campo que usa el tipo elegido
Días después del vencimiento	Cuándo comienzan a correr los intereses. El valor por defecto es 1
Conteo de días	Días corridos o días hábiles. Los días hábiles vienen del registro de Feriados

El porcentaje mensual se divide pro rata die por 30, y el anual por 360 — la base que usa el registro bancario. Una tasa del 1% mensual sobre R$ 1.000,00 rinde R$ 0,33 por día de atraso.

Los intereses corren sobre el saldo, nunca sobre el saldo más la multa.

Topes

Campo	Descripción
Máximo de meses de intereses	Interrumpe la acumulación. Vacío = sin límite
Tope del cargo total	Porcentaje del saldo. Al alcanzar el tope, la multa se preserva y los intereses se recortan
Respetar los topes legales	Rechaza multa superior al 2% e intereses superiores al 1% mensual

El tope legal viene del art. 52 del Código de Defensa del Consumidor brasileño y vale para relación de consumo. Los contratos entre empresas pueden pactar por encima, y para eso la traba puede desactivarse — la decisión queda registrada en la auditoría, aparte del cambio común de política.

Comportamiento

Campo	Descripción
Un pago parcial abona primero	Intereses y multa (por defecto) o El valor de la factura
Registrar la instrucción en el banco	El boleto o Pix recauda los cargos por su cuenta después del vencimiento
Recalcular en tarjeta y reemisión	En tarjeta no existe instrucción bancaria, así que el cargo entra en el valor cobrado
Instrucciones impresas en el boleto	Texto libre

El valor por defecto Intereses y multa sigue el art. 354 del Código Civil brasileño: un pago parcial se imputa primero a los intereses, luego a la multa, y solo el resto abona el valor de la factura. Así la deuda no deja de rendir silenciosamente.

Qué política vale para una factura

La resolución es en cascada, y gana el primer nivel que indica una política:

Factura → Suscripción → Cuenta de cobro → Política por defecto de la organización

Un nivel en blanco significa heredar, nunca "sin cobro". No cobrar nada es una política explícita, con los dos tipos en Sin cobro.

Las facturas ya emitidas no cambian

Al finalizarse, la factura congela la política vigente en ese momento. Si renegocia la política en marzo, las facturas emitidas en enero siguen cobrando las reglas de enero — tanto en el cálculo como en la instrucción registrada en el banco.

Cómo se cobra el cargo

Medio	Cómo funciona
Boleto	La instrucción de multa e intereses se registra en el banco, que calcula y recauda el valor extra en la liquidación
Pix	Registrado como Pix Cobrança, con la misma lógica. Un Pix instantáneo no acepta cargos
Tarjeta	No existe instrucción bancaria: el valor cobrado se recalcula en el momento del intento

Al reemitir un boleto vencido, el vencimiento original se preserva. Cambiar la fecha del boleto a hoy pondría el atraso en cero y perdonaría el cargo que el cliente ya debe.

:::caution Los días hábiles dependen del registro de feriados Con el conteo en días hábiles y la lista de feriados vacía, el cálculo descuenta solo los fines de semana — el banco descuenta los feriados también y recaudará menos de lo que calculamos. Importe los feriados nacionales en Sistema → Feriados antes de activar esta opción. :::

:::note Bancos y el porcentaje mensual En el boleto, el tipo "porcentaje por mes" es soportado por Bradesco, BB, BTG, Caixa, Inter, Itaú, Safra, Santander, Sicoob y Sicredi. En otros bancos, prefiera el porcentaje diario. :::

Qué sucede cuando el cliente paga

El valor liquidado se descompone en tres partes:

1. Principal — abona el saldo de la factura
2. Multa e intereses — registrados aparte, como ingreso financiero
3. Excedente inexplicado — lo que la política no justifica se convierte en crédito en la cuenta del cliente, como antes

Esa separación importa en tres lugares:

• Nota fiscal: el valor de la NF-e es el valor del servicio, sin los cargos. Multa e intereses son ingreso financiero y quedan fuera de la base de cálculo del ISS y de las retenciones.
• Informes de ingresos: el ingreso por cliente cuenta solo el principal. Contar los cargos infla el LTV con dinero que no vino de la venta.
• Extracto del cliente: los cargos aparecen en línea propia, "Juros e multa — fatura X".

Cuando el valor recibido supera lo que la política explica, el sistema emite el evento invoice.late_charges_unexplained. Eso normalmente significa que nuestro cálculo y el del banco divergieron más allá del redondeo, y vale revisarlo.

Dónde hacer seguimiento

• Detalle de la factura: tarjeta "Cargos por atraso", con días de atraso, multa, intereses, total actualizado y lo ya recibido. Aparece solo en factura vencida o que ya recibió cargo.
• Morosidad: el total vencido sigue siendo solo el principal — es la métrica comparable entre períodos. Los cargos acumulados aparecen en columna separada.

Por la API

El recurso es /v1/late_fee_policies. Los porcentajes son float (2.0 para 2%) y los valores en reales.

curl -X POST https://api.kobana.com.br/billing/v1/late_fee_policies \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Estándar",
    "is_default": true,
    "fine_mode": "percentage",
    "fine_percent": 2.0,
    "interest_mode": "monthly_percentage",
    "interest_percent": 1.0
  }'

Para conciliar el cálculo antes de que una factura venza de verdad:

curl -X POST https://api.kobana.com.br/billing/v1/late_fee_policies/simulate \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "principal": 1000.0,
    "due_date": "2026-09-10",
    "reference_date": "2026-10-10",
    "policy_id": "..."
  }'

La respuesta trae days_past_due, fine, interest, total y total_due.

Preguntas frecuentes

¿Los cargos entran en el valor de la nota fiscal? No. La NF-e usa el valor del servicio. Multa e intereses son ingreso financiero, fuera de la base del ISS y de las retenciones. Si su operación necesita una nota complementaria por los cargos, se emite manualmente.

¿Qué pasa con las facturas antiguas al activar el cobro? Las facturas aún en draft heredan la política nueva al ser finalizadas. Las ya finalizadas mantienen lo que llevan — incluidas las que no tenían ninguna política.

¿Y si el cliente paga más de lo que multa e intereses justifican? La diferencia se convierte en crédito en su cuenta, y se emite el evento invoice.late_charges_unexplained para que usted lo revise.

¿Puedo cobrar intereses sin multa, o multa sin intereses? Sí. Los dos tipos son independientes; basta dejar uno en Sin cobro.