---
title: "Calculadora de Valor da Hora Freelance / MEI"
method: POST
path: "/api/v1/calc/custo-hora-freelance"
tags: ["calc", "trabalhistas"]
---

# Calculadora de Valor da Hora Freelance / MEI

`POST /api/v1/calc/custo-hora-freelance`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/custo-hora-freelance`
- Auth: HTTP bearer

Quanto cobrar por hora para alcançar a renda líquida desejada — engenharia reversa considerando regime tributário (MEI/Simples Anexo III/V/Autônomo), férias, custos fixos e margem de segurança. Comparação CLT-equivalente.

## Request body

- object
  - `rendaMensalDesejadaCents` integer, required: Renda líquida mensal desejada em centavos (o que você quer receber no bolso após impostos e custos). Mínimo R$ 500. Ex: R$ 8.000 → 800000
  - `horasUteisDia` number: Horas de trabalho faturáveis por dia útil. Padrão 8 horas. Considere apenas as horas efetivamente dedicadas a clientes — não inclua reuniões internas, prospecção ou administração. Ex: 6 horas faturáveis por dia.
  - `diasUteisMes` integer: Dias úteis trabalhados por mês. Padrão 22 dias. Ex: 20 dias se preferir folgar mais.
  - `diasFeriasAno` integer: Dias de férias que pretende tirar por ano. Padrão 30 dias. Esses dias são rateados mensalmente para calcular quantas horas faturáveis você tem no ano. Ex: 15 dias de férias por ano.
  - `custosFixosMensais` object[]: Custos fixos operacionais mensais (aluguel escritório, software, contador, marketing) agrupados por categoria. Cada item: { categoria, valorCents, descricao? }. Use "outro" + descrição livre para casos não cobertos.
    - `categoria` 'aluguel_espaco' | 'mao_de_obra' | 'materia_prima' | 'marketing' | 'software_assinaturas' | 'contador_juridico' | 'utilidades' | 'frete_logistica' | 'manutencao_equipamentos' | 'plano_saude_individual' | 'seguro_vida' | 'equipamento' | 'cursos_capacitacao' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `regimeTributario` 'mei' | 'simples_anexo_iii' | 'simples_anexo_v' | 'autonomo': Regime tributário da atividade: "mei" (Microempreendedor Individual — alíquota ~5%, faturamento até R$ 81k/ano), "simples_anexo_iii" (Simples Nacional Anexo III — alíquota efetiva real da tabela LC 123/2006, 6% a ~19,5% conforme o faturamento; serviços com fator R ≥ 28%), "simples_anexo_v" (Simples Nacional Anexo V — alíquota efetiva real, 15,5% a ~19,25%; intelectuais sem fator R como devs e consultores), "autonomo" (INSS contribuinte individual 20% até o teto + Carnê-Leão com tabela IRPF progressiva real). Padrão "mei".
  - `margemSegurancaPercent` number: Percentual de margem de segurança sobre a receita bruta necessária, de 0 a 50. Padrão 20 (20%), recomendado para cobrir inadimplência (~5%), oscilação de demanda (~10%) e imprevistos (~5%). Use 30 se está começando como freelancer. Não pode exceder 50% pois distorceria o cálculo.
  - `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)