Documentação
Cálculo trabalhistaVerbas e situações

Entrada da calculadora trabalhista

Campos do contrato, cartão de ponto, parcelas habituais, multas, acessórios, seguro-desemprego e salário-família, com exemplo fictício existente.

Ver Markdown

Os dados de entrada são um objeto JSON com contrato e, quando necessário, a lista parcelas_habituais. O uso atual é pela CLI, no comando peticao.

Formatos e dados básicos

DadoFormato
DatasTexto no formato AAAA-MM-DD
Valores e percentuaisStrings decimais com ponto, preservando a precisão informada
Campos de escolhaIdentificadores em maiúsculas, conforme as listas abaixo
Dados básicoscontrato.data_admissao e contrato.salario
Rescisãodata_demissao e o tipo em tipo_dispensa
Contrato vigenteSem data_demissao, com data_termino_calculo

Não envie data_demissao e data_termino_calculo juntas.

Com peticao --permissivo, os campos desconhecidos são ignorados, e cada um é indicado em avisos. Esse comportamento só vale quando a opção permissiva é escolhida.

Se houver data_demissao e tipo_dispensa for omitido, o motor continua assumindo SEM_JUSTA_CAUSA, mas agora registra essa escolha em avisos. Informe o tipo de dispensa expressamente e leia os avisos antes de usar o resultado.

Escolhas padrão que alteram o resultado

  • Férias. Sem quadro informado, o motor presume gozados os períodos vencidos e não aplica dobra. Para tratar férias como não concedidas, informe ferias_periodos, com a dobra quando cabível, ou ative ferias_presumir_cumprimento com ferias_nao_concedidas.
  • Base da multa do FGTS. O padrão de base_multa_fgts é DIFERENCA. Uma base diferente deve ser escolhida expressamente.
  • Multa do art. 477. Entra por padrão nas dispensas que a admitem. O motor não verifica se houve atraso no pagamento.
  • Parcelas habituais. São tratadas como salariais, com incidência de FGTS, INSS e imposto de renda. Em verbas_adicionais, as incidências de FGTS, INSS e imposto de renda dependem das escolhas em incidencias. Veja o alcance das verbas adicionais.

Exemplo de entrada

Entrada completa de exemplos/seguro-desemprego.json, com dados fictícios:

{
  "contrato": {
    "data_admissao": "2022-03-15",
    "data_demissao": "2024-06-30",
    "seguro_desemprego": {
      "solicitacao": "PRIMEIRA"
    },
    "tipo_dispensa": "SEM_JUSTA_CAUSA",
    "salario": "3000.00"
  }
}

A resposta correspondente é apresentada em Saída e em Seguro-desemprego.

Campos do contrato

GrupoCamposUso
Vínculodata_admissao, data_demissao, data_termino_calculo, tipo_dispensa, salarioDefine o vínculo e o corte do cálculo
Reajusteshistorico_salarialLista de faixas com de, ate e valor; o salário do contrato continua informado
Jornadacarga_horaria_mensal, horas_trabalhadas_por_competencia, cartao_de_pontoDivisor mensal ou por competência e horários diários
Insalubridadesalario_minimoObrigatório para parcela cuja base seja SALARIO_MINIMO
Fériasferias_periodos, ferias_presumir_cumprimento, ferias_nao_concedidasQuadro informado ou presunção de cumprimento
FaltasfaltasAusências com inicio, fim, justificada, reiniciar_periodo_aquisitivo e justificativa
13ºdecimo_terceiro_presumir_cumprimento, decimo_terceiro_anos_nao_pagosPermite informar cumprimento e anos não pagos
FGTSfgts_nao_depositado, fgts_por_mes, base_multa_fgts, saldo_ou_saque_fgtsDepósitos e base da multa
Multasmulta_467, multa_477Verbas escolhidas para o art. 467 e controle da multa do art. 477
Multas e indenizaçõesmultas_indenizacoesLista de valores informados ou percentuais sobre o principal
Transporte e calendáriovale_transporte, sabado_dia_util, pontos_facultativos_desativadosTarifas por vigência e parâmetros do calendário
Seguro-desempregoseguro_desempregoObjeto de apuração da indenização, somente com demissão
Salário-famíliasalario_familiaApuração por competência, com demissão ou em contrato vigente
Acessórioscustas, honorarios_sucumbenciais_percentualSolicitação das custas e percentual dos honorários
Atualizaçãoatualizacao_monetariaCorreção monetária e juros
Outros valoresvalores_pagos, verbas_adicionaisAbatimentos por nome de verba e valores informados, com incidências escolhidas
Imposto de rendanumero_dependentes_irpf, pensao_alimenticia_irpf_mensalDados para as deduções

Escolhas aceitas

CampoValores
tipo_dispensaSEM_JUSTA_CAUSA, JUSTA_CAUSA, PEDIDO_DEMISSAO, RESCISAO_INDIRETA, CULPA_RECIPROCA, ACORDO
base_multa_fgtsDIFERENCA, DEVIDO, SALDO_OU_SAQUE, DEVIDO_MAIS_SALDO_OU_SAQUE, DEVIDO_MENOS_SALDO_OU_SAQUE
multa_467Nomes exatos: Saldo de Salário, Aviso Prévio Indenizado, 13º Salário, Férias + 1/3
pontos_facultativos_desativadosCARNAVAL, CORPUS_CHRISTI, SEXTA_FEIRA_SANTA

DIFERENCA é a base padrão da multa do FGTS. As opções com saldo ou saque exigem saldo_ou_saque_fgts. O modo fgts_por_mes informa competencia e valor_depositado; não combina com fgts_nao_depositado nem com base de multa diferente de DIFERENCA.

Quadro de férias

ferias_periodos lista os períodos aquisitivos. Cada item aceita aquisitivo_inicio, situacao, ativo, prazo, dobra, gozos, abono e dias_abono. Cada gozo tem de, ate e dobra.

As situações descritas são GOZADAS, GOZADAS_PARCIALMENTE, INDENIZADAS, PERDIDAS e NAO_GOZADAS. Com o quadro informado, a dobra deve ser indicada em dobra. O quadro não deve ser enviado junto com as opções de presunção de férias.

Sem ferias_periodos, o motor presume gozados os períodos vencidos e não aplica dobra. Para informar férias não concedidas, use o quadro com a indicação de dobra, quando cabível, ou ative ferias_presumir_cumprimento e identifique os períodos em ferias_nao_concedidas.

O abono pecuniário é informado com abono e dias_abono. Só é aceito nas situações GOZADAS e GOZADAS_PARCIALMENTE; nas demais, o motor devolve erro.

  • Em GOZADAS, o abono não muda o valor calculado.
  • Em GOZADAS_PARCIALMENTE, as bases das linhas consideram o prazo menos os dias de abono. O restante não gozado é calculado com a dobra informada em dobra.

Multas e indenizações

contrato.multas_indenizacoes aceita itens com valor e vencimento informados ou com base e alíquota para cálculo percentual. Cada item também identifica o credor e o devedor. Veja os campos, as regras e o exemplo completo em Multas e indenizações.

Salário-família

contrato.salario_familia aceita competencia_inicial, competencia_final, filhos_menores_14, variacao_filhos, salario_pago, maior_remuneracao, salarios_devidos e nao_compor_principal. Cada variação de filhos tem a_partir_de e quantidade; cada salário devido tem verba e integralizar.

salario_pago aceita MAIOR_REMUNERACAO (padrão), HISTORICO_SALARIAL e NENHUM. Veja as regras e a entrada completa em Salário-família.

Verbas adicionais

contrato.verbas_adicionais recebe uma lista de verbas com nome e valor informados. O alcance conferido em 11/10/2026 é o de valor informado no desligamento, com as incidências que o usuário marcar. Foram conferidos os casos de "valor pago não tributável" e "valor pago tributável".

CampoUso no alcance conferido
nomeNome da verba informada
valorValor único informado no desligamento, como string decimal
incidenciasObjeto com as escolhas fgts, inss e irpf
incidencias.fgtsMarca a incidência de FGTS
incidencias.inssMarca a incidência de INSS
incidencias.irpfMarca a incidência de imposto de renda

O motor aplica as incidências marcadas; a escolha da natureza da verba exige análise do caso. A existência de incidencias não confirma a cobertura de todas as verbas que possam receber esses encargos.

Campos mensais: a confirmar

O esquema também lista valor_mensal (texto), competencia_inicial e competencia_final (textos) e proporcional_nos_meses_das_pontas (booleano). O alcance do uso desses campos em verbas adicionais permanece a confirmar nesta documentação. O alcance confirmado aqui é o de valor único informado no desligamento.

"Acordo (verbas remuneratórias)" permanece fora do alcance confirmado. Não use a existência desses campos como confirmação desse cálculo. Veja Limites.

Parcelas habituais

Cada parcela tem nome e uma forma de informar o valor ou as horas:

FormaCampos
Percentual da basepercentual com base: SALARIO_MINIMO ou ULTIMA_REMUNERACAO
Valor mensalvalor_mensal
Valor variável por mêsvariacao: VARIAVEL e valores_por_competencia
Horas informadashoras ou horas_por_competencia, com percentual como multiplicador
Horas apuradas pelo motorhoras_do_cartao, com percentual e contrato.cartao_de_ponto

As tabelas por competência usam objetos com competencia e valor. horas_do_cartao substitui as horas fixas ou por competência. Para a apuração por hora, informe o divisor por carga_horaria_mensal ou horas_trabalhadas_por_competencia.

Outros campos da parcela são inicio, variacao (FIXA ou VARIAVEL), valor_pago_mensal, meses_nao_devidos, sem_reflexos, gerar_repouso_semanal, rsr_por_competencia, reflexos_incidem_fgts e reflexos_do_repouso.

Não informe percentual e valor_mensal juntos. meses_nao_devidos retira competências em que a parcela não era devida; não representa apenas falta de pagamento. A combinação de repouso e seus reflexos por data está a confirmar.

Veja Cartão de ponto, Reclamatória completa e Correção e juros.