calc
pj

Calculadora de Margem de Contribuição e CMV

Calcule a Margem de Contribuição do seu negócio a partir do faturamento bruto, custos variáveis e custos fixos. Descubra o resultado operacional, o ponto de equilíbrio em receita e a folga financeira do mês.

post/api/v1/calc/margem-contribuicao

Request

  • Base URL: https://api.calculas.com.br
  • URL: https://api.calculas.com.br/api/v1/calc/margem-contribuicao
  • Auth: HTTP bearer

Request body

receitaBrutaCentsinteger required

Receita bruta total do período (faturamento bruto antes de deduções). Valor em centavos. Ex: R$ 50.000 → 5000000.

custosVariaveisCentsinteger required

Total agregado de custos variáveis do período: CMV/CPV (custo de mercadoria ou serviço vendido), comissões, impostos sobre faturamento (PIS, COFINS, ISS, ICMS), embalagem, frete de entrega, taxa de maquininha. Valor em centavos. Ex: R$ 20.000 → 2000000. Quando "custosVariaveisDetalhados" tem itens, este campo é IGNORADO e o engine usa a soma das categorias.

custosFixosCentsinteger

Total de custos fixos do período (aluguel, salários, contador, energia, seguros, pró-labore). Valor em centavos. Ex: R$ 10.000 → 1000000. Opcional: se informado, calcula o resultado operacional e o ponto de equilíbrio em receita.

deducoesCentsinteger

Deduções da receita bruta: devoluções de mercadorias, cancelamentos, descontos incondicionais na nota fiscal e abatimentos. Valor em centavos. Ex: R$ 1.000 → 100000. Opcional: se informado, a base de cálculo da margem é a receita líquida (receita bruta − deduções).

currentDatestring date-time

ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

Response

OK

oktrue required
dataobject required

Resultado dependente da calc — ver schema individual

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.