Feriados
Los feriados son los días en que los bancos no operan. Sirven a dos propósitos:
- Encontrar el vencimiento efectivo: una factura que vence en fin de semana o feriado puede pagarse el siguiente día hábil sin multa ni intereses.
- Contar días hábiles cuando la política de intereses y multas cobra intereses por día hábil en lugar de por día corrido.
Cada organización tiene su propia lista. Un feriado municipal mueve el día hábil para un cliente y no para otro, y eliminar un feriado en su cuenta no afecta a ninguna otra.
Dónde configurar
Sistema → Feriados.
La pantalla muestra los feriados del año seleccionado, con el día de la semana y el origen de cada fila.
Importación automática
Toda organización creada en la plataforma ya viene con los feriados nacionales del año corriente y los dos siguientes, importados de BrasilAPI.
Para traer otro año, o completar lo que faltó, use Importar nacionales con el año seleccionado.
La importación incluye Carnaval, Viernes Santo, Pascua y Corpus Christi. Técnicamente Carnaval y Corpus Christi son puntos facultativos, no feriados nacionales — pero los bancos cierran en ellos, y es el cierre del banco lo que importa para contar un día hábil.
:::note La importación no deshace una eliminación Si usted elimina un feriado, importar los nacionales de nuevo no lo trae de vuelta. La fila eliminada queda registrada precisamente para que la importación respete su decisión. Cuando eso ocurre, la pantalla avisa cuántos feriados eliminados quedaron fuera. :::
Registrar a mano
Use Nuevo feriado para feriados estatales, municipales, puntos facultativos de su operación o fechas propias.
| Campo | Descripción |
|---|---|
| Fecha | El día en el calendario. Sin hora — un feriado es una fecha, no un instante |
| Nombre | Junto con la fecha identifica la fila. Un municipal y un nacional pueden caer el mismo día |
| Alcance | Nacional, estatal, municipal, punto facultativo o propio |
| Observaciones | Texto libre — la ciudad de un feriado municipal, por ejemplo |
Un feriado que cae en sábado o domingo no cambia nada en el conteo: esos días ya no eran hábiles. La pantalla lo señala para ahorrarle la duda.
Cómo afecta los intereses
En la política de intereses y multas, el campo Conteo de días decide qué cuenta:
- Días corridos — todos los días, incluidos fines de semana y feriados.
- Días hábiles — solo los días en que el banco opera, según esta lista.
Con R$ 1.000,00 al 1% mensual vencidos un jueves y revisados el lunes siguiente:
| Conteo | Días | Intereses |
|---|---|---|
| Corridos | 4 | R$ 1,33 |
| Hábiles | 2 (viernes y lunes) | R$ 0,67 |
| Hábiles, con el viernes feriado | 1 (lunes) | R$ 0,33 |
La multa no se ve afectada: incide una vez, contada en días corridos. El registro bancario también la trata así — no existe instrucción de "días hábiles para la multa".
:::caution Sin feriados registrados la cuenta queda mal
Si la política cobra por día hábil y la lista está vacía, el cálculo descuenta solo los fines de semana. El banco descuenta los feriados también, así que recaudará menos de lo que calculamos — y la diferencia aparece como crédito en la cuenta del cliente, junto con el evento invoice.late_charges_unexplained. Importe los nacionales antes de activar el cobro por día hábil.
:::
Vencimiento en fin de semana o feriado
Un boleto que vence en un día sin atención bancaria puede pagarse el siguiente día hábil sin cargos — es la regla de la Febraban, y el boleto ya se registra con esa fecha. La multa y los intereses siguen el vencimiento del boleto: cuentan a partir del siguiente día hábil, sea cual sea el conteo de días de la política.
Una factura que vence el sábado y se paga el lunes no paga multa ni intereses. Pagada el martes, cuenta un día de atraso, a partir del lunes.
Para que la propia factura ya muestre esa fecha — y no solo el boleto —, active Vencimiento siempre en día hábil en Configuraciones → Facturación. Con la opción activa, todo vencimiento que caiga en fin de semana o feriado pasa al siguiente día hábil: el calculado por el plazo de pago, el ingresado a mano y el de cada cuota. Las facturas importadas mantienen la fecha del archivo.
Por la API
El recurso es /v1/holidays. Las fechas son días civiles (YYYY-MM-DD), nunca instantes.
# Listar los feriados de un año
curl "https://api.kobana.com.br/billing/v1/holidays?year=2026" \
-H "Authorization: Bearer $TOKEN"
# Registrar un feriado municipal
curl -X POST https://api.kobana.com.br/billing/v1/holidays \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"date": "2026-01-25",
"name": "Aniversário de São Paulo",
"type": "municipal",
"notes": "São Paulo, SP"
}'
# Importar los nacionales
curl -X POST https://api.kobana.com.br/billing/v1/holidays/sync \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"years": [2026, 2027]}'
La respuesta de la importación trae created, existing y skipped_removed — el último cuenta los feriados que estaban eliminados y quedaron fuera.
Preguntas frecuentes
¿Necesito registrar feriados si cobro intereses por día corrido? Sí. Incluso con días corridos, un vencimiento que cae en feriado pasa al siguiente día hábil, y solo la lista dice qué días son feriados. Sin ella, solo los fines de semana mueven el vencimiento.
¿Los feriados valen para todas mis empresas? La lista es por organización, así que vale para todas las empresas dentro de ella. Si una empresa está en un municipio con feriado propio, regístrelo con alcance municipal y anote la ciudad.
¿Por qué aparece la Pascua, si siempre cae en domingo? BrasilAPI la devuelve, y guardarla es inofensivo: un feriado en fin de semana no altera el conteo.
¿Quién puede editar?
Quien tenga permiso de actualizar configuraciones — el mismo de Configuración.