Calcular dias úteis no Brasil por API
Calcular dias úteis é contar os dias de segunda a sexta entre duas datas, tirando os
feriados que valem naquele lugar. No Brasil o “lugar” muda o resultado: feriado estadual
em SP não é o mesmo do Rio, e o municipal de um IBGE não vale para o vizinho. A MuhBianco
faz isso no endpoint /feriados/dias-uteis, com cabeçalho X-API-Key.
O que entra na conta
Sábado e domingo saem. Feriado nacional sai. Se você passou UF, sai também a data magna daquele estado. Se passou código IBGE e a cobertura daquele município está publicada, sai o feriado municipal confirmado. Ponto facultativo não entra como feriado obrigatório — a API separa os dois.
Recesso da sua empresa, “emenda” combinada com o cliente e feriado que só existe no calendário interno continuam fora. Isso não é feriado oficial.
Exemplo de chamada
curl -H "X-API-Key: SUA_CHAVE" \
"https://api.muhbianco.com.br/api/latest/feriados/dias-uteis?de=2026-09-01&ate=2026-09-30&uf=SP"
Datas em ISO (AAAA-MM-DD). Sem chave, a API responde 401. Ano fora da janela
publicada devolve erro explícito — não inventa calendário futuro sem base.
Parâmetros, formato da resposta e códigos de erro estão na documentação.
Quando checar cobertura antes
Se o seu SLA depende de município, chame /feriados/cobertura?ibge= e grave o
status. Sem dado municipal publicado, o cálculo ainda desconta nacional, estadual (se
houver UF) e fim de semana — mas não um feriado de padroeiro que a API ainda não confirmou.
Isso é limite explícito, não bug. Detalhe em
feriados municipais por IBGE.
Jornada deste produto
Não há WhatsApp neste fluxo. Conta, saldo, habilitar a API, gerar chave. Quem chega pesquisando “calcular dias úteis api” deve cair neste produto, não no assistente nem no controle financeiro.