ForHosting KIT · Finanças e dinheiro

Gestão do valor agregado

Com 100.000 de trabalho planejado, 90.000 de valor agregado e 110.000 gastos, o projeto está 20.000 acima do orçamento e 10.000 atrasado no cronograma, com CPI de 0,818 e SPI de 0,9. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Valor planejado: 100.000
Valor agregado: 90.000
Custo real: 110.000

Você obtém

Variação de custos: -20.000
Variação de prazo: -10.000
Índice de desempenho de custos: 0,8181818182
Índice de desempenho de prazos: 0,9

A gestão do valor agregado é o método de controle de projeto que coloca o trabalho planejado, o trabalho concluído e o dinheiro gasto na mesma escala, de modo que um único recorte mostre se o projeto está acima ou abaixo do orçamento e adiantado ou atrasado no cronograma. Esta calculadora de gestão do valor agregado aceita o valor planejado (PV), o valor agregado (EV) e o custo real (AC) e devolve os quatro índices clássicos dos relatórios de status PMI: a variação de custo CV igual a EV menos AC, a variação de cronograma SV igual a EV menos PV, o índice de desempenho de custos CPI igual a EV dividido por AC e o índice de desempenho de prazo SPI igual a EV dividido por PV. Gerentes de projeto, analistas de PMO, contratantes e candidatos a exame precisam desses quatro números em cada período de relatório. Qualquer entrada negativa é rejeitada, e um valor agregado igual a zero é rejeitado, porque as razões não são um sinal útil de desempenho quando nenhum trabalho orçado foi ganho.

O que CV, SV, CPI e SPI significam na gestão do valor agregado

Na gestão do valor agregado, três cifras monetárias descrevem o mesmo recorte de um projeto em uma data de relatório. O valor planejado (PV, também chamado BCWS) é o orçamento aprovado do trabalho que deveria ter sido concluído nessa data segundo o cronograma baseline. O valor agregado (EV, também chamado BCWP) é o orçamento aprovado do trabalho que de fato foi concluído.

O custo real (AC, também chamado ACWP) é o dinheiro gasto para realizar esse trabalho concluído. A variação de custo é EV menos AC: um CV positivo significa que o trabalho concluído custou menos que o orçamento, então o projeto está abaixo do orçamento em termos de valor; um CV negativo significa que custou mais, então está acima do orçamento; e um CV zero significa que o trabalho concluído caiu exatamente no orçamento.

A variação de cronograma é EV menos PV: um SV positivo significa que se realizou mais trabalho orçado do que a baseline pedia, então o projeto está adiantado em termos de valor; um SV negativo significa menos, então está atrasado; e um SV zero significa que o trabalho ganho coincide com o plano. Os dois índices de desempenho reformulam essas lacunas como razões que viajam bem entre projetos de tamanhos diferentes.

CPI é EV dividido por AC: maior que um está abaixo do orçamento, igual a um no orçamento e menor que um acima. SPI é EV dividido por PV: maior que um é adiantado, igual a um no prazo e menor que um atrasado. Essas quatro identidades são a checagem de saúde de primeira linha de PMI e AACE usada em construção de capital, programas de software, contratos de defesa e itens de exame PMP.

Por si só não preveem dias de calendário de atraso nem uma estimativa na conclusão completa; dizem a você, a partir de três números, se custo e prazo estão saudáveis agora diante da baseline aprovada.

Quem usa os números de valor agregado

Equipes de controle de programas e escritórios de portfólio precisam de uma calculadora determinística de gestão do valor agregado que cada pacote de status, relatório ao proprietário e roll-up automatizado possam chamar sem abrir um modelo de planilha que alguém possa ter editado. Empreiteiros de construção e engenharia extraem PV, EV e AC dos sistemas de custo a cada período e devem publicar CV, SV, CPI e SPI sob linguagem contratual que já cita essas fórmulas PMI.

Gestores de produto de software e de programas de TI mapeiam o backlog concluído para valor agregado, o plano de release para valor planejado e o burn para custo real para que a liderança veja os mesmos quatro índices que já conhece de projetos de capital. Plataformas LMS e geradores de exame PMP precisam de um oráculo que marque as quatro identidades corretamente para triplas arbitrárias, inclusive as bordas em que o projeto está exatamente no orçamento ou exatamente no prazo. Validação falha não consome saldo.

Casos de uso

Pacotes de status da PMO e relatórios ao proprietário

Recalcule CV, SV, CPI e SPI a cada período a partir do valor planejado, do valor agregado e do custo real do sistema de custos, para que cada slide e cada reclamação usem as mesmas identidades PMI.

Controles de contratante e de projetos de capital

Publique o desempenho de custo e prazo frente à baseline aprovada quando o contrato já exige índices de valor agregado, sem uma planilha editada à mão.

Treinos PMP e correção automática em LMS

Corrija itens de exame de valor agregado com um oráculo determinístico que rejeita entradas negativas e um valor agregado zero em vez de inventar uma razão.

Perguntas frequentes

O que acontece se uma entrada for negativa?

Valor planejado, valor agregado e custo real são montantes orçados ou gastos e não podem ficar abaixo de zero. Entrada inválida não é cobrada.

Por que um valor agregado igual a zero é rejeitado?

Esta calculadora é um recorte de desempenho do trabalho já ganho.

O que significam CPI e SPI maiores que um?

CPI maior que um (e CV positivo) significa abaixo do orçamento: o trabalho ganho custou menos do que o gasto real sugeriria. SPI maior que um (e SV positivo) significa adiantamento de prazo em termos de valor: há mais trabalho orçado concluído do que o plano pedia.

O que mostram a variação de custo e a variação de prazo?

A variação de custo é o valor agregado menos o custo real: positiva significa que o trabalho feito custou menos que o orçado. A de prazo é o valor agregado menos o planejado: positiva significa que se fez mais trabalho do que o previsto.

Qual a diferença entre valor planejado, valor agregado e custo real?

O valor planejado é o orçamento do trabalho que deveria estar pronto na data do relatório. O valor agregado é o orçamento do trabalho realmente concluído. O custo real é o dinheiro de fato gasto para concluí-lo.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/fin/earned-value-management

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/fin/earned-value-management \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"planned_value":100000,"earned_value":90000,"actual_cost":110000}'

const res = await fetch("https://api.kit.forhosting.com/fin/earned-value-management", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "planned_value": 100000,
    "earned_value": 90000,
    "actual_cost": 110000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/earned-value-management",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "planned_value": 100000,
    "earned_value": 90000,
    "actual_cost": 110000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/earned-value-management", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"planned_value":100000,"earned_value":90000,"actual_cost":110000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"planned_value":100000,"earned_value":90000,"actual_cost":110000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/earned-value-management", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "planned_value": 100000,
  "earned_value": 90000,
  "actual_cost": 110000
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.earned_value_management",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Contrato de entrada, campos de resposta e regras de validação

Envie por POST um corpo JSON com três números finitos obrigatórios na mesma moeda do projeto. planned_value (aliases pv, bcws) é o custo orçado do trabalho programado até a data e deve ser estritamente maior que zero, porque o SPI se define como EV sobre PV e uma baseline nula ou negativa deixaria o índice indefinido ou sem sentido. earned_value (aliases ev, bcwp) é o custo orçado do trabalho realizado até a data e deve ser estritamente maior que zero: um EV negativo não é um valor orçado válido, e um EV zero é rejeitado porque a capacidade é um recorte de desempenho do trabalho já ganho, não um marcador de início de projeto. actual_cost (aliases ac, acwp) é o dinheiro gasto nesse trabalho realizado e deve ser estritamente maior que zero para que CPI igual a EV sobre AC continue um número JSON finito. Cada campo pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias, valores não finitos, qualquer entrada negativa e um valor agregado zero (ou valor planejado ou custo real zero) falham com invalid_input e não são cobrados. Em sucesso a resposta ecoa as três entradas e devolve cost_variance, schedule_variance, cost_performance_index, schedule_performance_index, um cost_status under_budget, on_budget ou over_budget, um schedule_status ahead, on_schedule ou behind, uma string formula que reafirma as identidades PMI e uma frase curta de interpretação adequada a nota de rodapé de pacote de status. Exemplo: valor planejado de cem mil, valor agregado de noventa mil e custo real de cento e dez mil produz CV de menos vinte mil, SV de menos dez mil, CPI de cerca de zero ponto oito um oito, SPI de zero ponto nove, cost_status over_budget e schedule_status behind.

Onde uma API de gestão do valor agregado vale o investimento

Este endpoint não calcula estimativa na conclusão, índice de desempenho a completar nem dias de caminho crítico; essas métricas precisam de premissas extras que esta calculadora se recusa a inventar.

Perguntas técnicas

Como se calculam CV, SV, CPI e SPI?

Envie planned_value (PV), earned_value (EV) e actual_cost (AC) finitos e positivos. A API devolve CV = EV − AC, SV = EV − PV, CPI = EV / AC e SPI = EV / PV, mais o status de custo e de prazo.

Quanto custa a calculadora de gestão do valor agregado?

A ferramenta do navegador é gratuita. Pedidos à API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis