Custo da mão de obra

Zero horas são permitidas quando o turno ainda não começou; horas negativas não descrevem trabalho ocorrido, então falham com invalid_input em vez de imprimir um crédito que uma proposta poderia tratar como dinheiro.

O que o custo da mão de obra carregado cobre e o que deixa de fora

A identidade que esta ferramenta usa é a que essas planilhas já implicam: total_cost é igual a hours_worked vezes hourly_rate vezes um mais payroll_burden_percent dividido por cem. A resposta também devolve direct_wages, burden_amount e fully_loaded_rate para que um revisor veja a linha salarial, a linha de encargos e o custo horário verdadeiro lado a lado, sem uma célula escondida. Horas negativas não descrevem timesheet passado nem bloco planejado, então falham com invalid_input em vez de imprimir um crédito que um formulário poderia tratar como dinheiro já pago. Como não há consulta de calendário nem sorteio aleatório, duas chamadas com as mesmas entradas devolvem sempre o mesmo JSON, que é o contrato que um exemplo de certificação e um script de custeio precisam.

Contrato de entrada, formato da resposta e comportamento de erro

Envie por POST um corpo JSON que traga hours_worked, hourly_rate e payroll_burden_percent. hours_worked são as horas já registradas ou as que um plano de obra cobre, número finito não negativo, com aliases hours, hrs, total_hours e time_worked. Horas fracionárias são aceitas para que um timesheet em décimos não precise ser completado até a hora cheia. hourly_rate é o salário bruto por hora em uma única unidade monetária, número finito não negativo, com aliases rate, wage, hourly e pay_rate. payroll_burden_percent é o acréscimo do empregador por impostos e benefícios como porcentagem dos salários diretos — trinta significa trinta por cento, não um multiplicador de 1.3 — com aliases burden, burden_percent, payroll_burden, burden_rate e benefits_percent. Cada campo numérico pode chegar como número JSON ou como string numérica. Faltar hours_worked, faltar hourly_rate, faltar payroll_burden_percent, strings vazias, valores não finitos, tarifa horária negativa, encargo negativo ou magnitude acima do limite declarado falham com invalid_input nomeando o campo e não são cobrados. hours_worked negativo é o erro que esta página existe para pegar: a mensagem contém hours_worked e must not be negative para que um formulário destaque esse controle em vez de um alerta global. Em caso de sucesso o corpo ecoa as três entradas, direct_wages como tarifa vezes horas, burden_amount como salários vezes o percentual de encargo sobre cem, fully_loaded_rate como o custo horário verdadeiro com encargos, total_cost como o valor a cargo do empregador e uma string formula que reafirma a identidade carregada. Exemplo: quarenta horas a vinte e cinco por hora com trinta por cento de encargo produz direct_wages de mil, burden_amount de trezentos, fully_loaded_rate de trinta e dois ponto cinco e total_cost de mil e trezentos. Combine o total com a sua própria tabela fiscal se também precisar do líquido do trabalhador; este endpoint calcula apenas o custo da mão de obra do empregador.

Onde uma calculadora de custo da mão de obra agrega valor

Aplicativos de orçamento doméstico e de pequeno negócio podem guardar o total_cost devolvido como saída programada de um auxiliar contratado e depois empilhar materiais, em vez de reconstruir uma cifra misturada. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Quando citar o preço da API em textos de produto, use o marcador de catálogo US$ 0,002 para que as páginas publicadas fiquem alinhadas com o piso de preço vigente.