---
title: "Calculadora de Banco de Horas CLT"
method: POST
path: "/api/v1/calc/banco-de-horas"
tags: ["calc", "trabalhistas"]
---

# Calculadora de Banco de Horas CLT

`POST /api/v1/calc/banco-de-horas`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/banco-de-horas`
- Auth: HTTP bearer

Calcule o saldo do banco de horas CLT: horas credoras (empresa deve), devedoras (empregado deve), valor em dinheiro se compensado em folga (1:1) ou pago com adicional quando o prazo vencer. Baseado na CLT art. 59 §2° e Reforma Trabalhista (Lei 13.467/2017).

## Request body

- object
  - `salarioBrutoCents` integer, required: Salário bruto mensal em centavos. Ex: R$ 4.400 → 440000
  - `divisorHoras` integer: Divisor mensal de horas usado para calcular o valor da hora normal. Padrão 220 para jornada de 44 horas semanais. Use 200 para 40h semanais ou 180 para 36h semanais.
  - `horasCredoras` number, required: Total de horas extras que o empregado realizou e estão depositadas no banco de horas (empresa deve ao empregado). Ex: 20 horas acumuladas.
  - `horasDevedoras` number: Total de horas que o empregado deve à empresa (trabalhou menos que o contratado e precisa compensar). Padrão 0. Ex: 5 horas a compensar.
  - `adicionalPercent` number: Percentual de adicional aplicado quando o banco de horas vence e as horas são pagas em dinheiro. Padrão 50 (50%, mínimo legal pela CLT). Convenções coletivas podem prever percentual maior.
  - `prazoVencido` boolean: Se verdadeiro (true), indica que o prazo do banco de horas já venceu (6 meses por acordo individual ou 1 ano por convenção coletiva) e as horas credoras devem ser pagas com adicional em vez de compensadas em folga. Se falso (false), o banco está dentro do prazo e a compensação em folga é 1:1 sem adicional. Padrão false.
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)