Feriados

Os feriados são os dias em que os bancos não funcionam. Servem a dois propósitos:

• Achar o vencimento efetivo: uma fatura que vence em fim de semana ou feriado pode ser paga no próximo dia útil sem multa nem juros.
• Contar dias úteis quando a política de juros e multa cobra juros por dia útil em vez de por dia corrido.

Cada organização tem sua própria lista. Um feriado municipal move o dia útil para um cliente e não para outro, e remover um feriado na sua conta não afeta nenhuma outra.

Onde configurar

Sistema → Feriados.

A tela mostra os feriados do ano selecionado, com o dia da semana e a origem de cada linha.

Importação automática

Toda organização criada na plataforma já vem com os feriados nacionais do ano corrente e dos dois seguintes, importados da BrasilAPI.

Para trazer outro ano, ou preencher o que faltou, use Importar nacionais com o ano selecionado.

A importação inclui Carnaval, Sexta-feira Santa, Páscoa e Corpus Christi. Tecnicamente Carnaval e Corpus Christi são pontos facultativos, não feriados nacionais — mas os bancos fecham neles, e é o fechamento do banco que interessa para contar dia útil.

:::note A importação não desfaz uma remoção Se você remover um feriado, importar os nacionais de novo não o traz de volta. A linha removida fica registrada exatamente para que a importação saiba respeitar a sua decisão. Quando isso acontece, a tela avisa quantos feriados removidos ficaram de fora. :::

Cadastrar à mão

Use Novo feriado para feriados estaduais, municipais, pontos facultativos da sua operação ou datas próprias.

Campo	Descrição
Data	O dia no calendário. Sem hora — um feriado é uma data, não um instante
Nome	Junto com a data, identifica a linha. Um municipal e um nacional podem cair no mesmo dia
Abrangência	Nacional, estadual, municipal, ponto facultativo ou próprio
Observações	Texto livre — a cidade de um feriado municipal, por exemplo

Um feriado que cai em sábado ou domingo não muda nada na contagem: aqueles dias já não eram úteis. A tela sinaliza isso para poupar a dúvida.

Como afeta os juros

Na política de juros e multa, o campo Contagem de dias decide o que conta:

• Dias corridos — todos os dias, incluindo fins de semana e feriados.
• Dias úteis — só os dias em que o banco funciona, segundo esta lista.

Com R$ 1.000,00 a 1% ao mês vencidos numa quinta-feira e olhados na segunda seguinte:

Contagem	Dias	Juros
Corridos	4	R$ 1,33
Úteis	2 (sexta e segunda)	R$ 0,67
Úteis, com a sexta feriado	1 (segunda)	R$ 0,33

A multa não é afetada: ela incide uma vez, contada em dias corridos. O registro bancário também trata a multa assim — não existe instrução de "dias úteis para multa".

:::caution Sem feriados cadastrados, a conta fica errada Se a política cobra por dia útil e a lista está vazia, o cálculo desconta apenas os fins de semana. O banco desconta os feriados também, então ele vai recolher menos do que apuramos — e a diferença aparece como crédito na conta do cliente, junto com o evento invoice.late_charges_unexplained. Importe os nacionais antes de ligar a cobrança por dia útil. :::

Vencimento em fim de semana ou feriado

Um boleto que vence num dia sem expediente bancário pode ser pago no próximo dia útil sem encargos — é a regra da Febraban, e o boleto já é registrado com essa data. A multa e os juros seguem o vencimento do boleto: contam a partir do próximo dia útil, qualquer que seja a contagem de dias da política.

Uma fatura que vence no sábado e é paga na segunda não paga multa nem juros. Paga na terça, conta um dia de atraso, a partir de segunda.

Para que a própria fatura já mostre essa data — e não só o boleto —, ligue Vencimento sempre em dia útil em Configurações → Faturamento. Com a opção ligada, todo vencimento que cair em fim de semana ou feriado passa para o próximo dia útil: o calculado pelo prazo de pagamento, o digitado à mão e o de cada parcela. Faturas importadas mantêm a data do arquivo.

Pela API

O recurso é /v1/holidays. As datas são dias civis (YYYY-MM-DD), nunca instantes.

# Listar os feriados de um ano
curl "https://api.kobana.com.br/billing/v1/holidays?year=2026" \
  -H "Authorization: Bearer $TOKEN"

# Cadastrar um 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 os nacionais
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]}'

A resposta da importação traz created, existing e skipped_removed — o último conta os feriados que estavam removidos e foram deixados de fora.

Perguntas frequentes

Preciso cadastrar feriados se cobro juros por dia corrido? Sim. Mesmo com dias corridos, um vencimento que cai em feriado passa para o dia útil seguinte, e só a lista diz quais dias são feriados. Sem ela, apenas os fins de semana movem o vencimento.

Os feriados valem para todas as minhas empresas? A lista é por organização, então vale para todas as empresas dentro dela. Se uma empresa fica num município com feriado próprio, cadastre-o com abrangência municipal e anote a cidade nas observações.

Por que a Páscoa aparece na lista, se cai sempre num domingo? A BrasilAPI a devolve, e guardá-la é inofensivo: um feriado em fim de semana não altera a contagem.

Quem pode editar? Quem tem permissão de atualizar configurações — a mesma de Configurações.