Horas faturáveis

Chamadas bem-sucedidas são cobradas a US$ 0,002; entrada inválida não é cobrada.

O que são horas faturáveis e como se forma o total da fatura

Horas faturáveis são as que um cliente de fato paga: o tempo do engajamento menos baixas, treinamento, administração interna e a cortesia que você decide não faturar. Exemplo: quarenta horas trabalhadas a cento e cinquenta por hora com duas horas baixadas são trinta e oito horas faturáveis e um total de fatura de cinco mil e setecentos. Uma tarifa horária zero é permitida e produz uma fatura de zero, que é como se representa uma linha de cortesia ou pro bono sem inventar outra fórmula. Horas não faturáveis não podem superar as horas trabalhadas, porque isso inventaria tempo faturável negativo. As horas podem ser fracionárias (sete e um quarto é uma planilha válida em quarto de hora) e os campos monetários são arredondados para cima a partir de cinco em duas casas decimais para que o total coincida com a moeda habitual. A identidade é uma subtração e uma multiplicação. hours_worked é tudo registrado na planilha de horas ou no relógio do engajamento, inclusive o tempo que mais tarde você pode marcar como não faturável. non_billable_hours é a fatia que deve ficar de fora da fatura. Subtraia essa fatia das horas trabalhadas e você obtém billable_hours. Multiplique as horas faturáveis por hourly_rate e você obtém invoice_total, o valor que esta calculadora devolve como resultado principal e de novo como amount para que um painel possa ligar qualquer uma das duas chaves. Quando non_billable_hours é omitido, trata-se como zero, então uma semana limpa de oito horas a setenta e cinco por hora fatura seiscentos sem nada baixado. Uma tarifa horária negativa não é desconto nem nota de crédito: é rejeitada como invalid_input para que um erro de digitação não emita uma fatura com sinal que um livro posterior lançaria como reembolso. A cadeia de fórmula da resposta reitera que invoice_total iguala hours_worked menos non_billable_hours, vezes hourly_rate, de modo que um revisor pode imprimir a identidade ao lado do número sem reconstruí-la.

Contrato de entrada, forma da resposta e comportamento de erro

Exemplo: horas trabalhadas sete ponto dois cinco, tarifa horária oitenta e cinco ponto cinco, não faturáveis zero ponto dois cinco produzem sete horas faturáveis e um total de fatura de quinhentos e noventa e oito ponto cinco. Prefira números nus a cadeias formatadas; não se analisam marcas de moeda, separadores de milhar nem rótulos de unidade no final. Este extremo não aplica imposto sobre vendas, adiantamentos, multiplicadores de hora extra nem conversão de moeda, e não emite uma fatura PDF. Emparelhe o resultado com o próprio passo fiscal ou documental se você precisar de uma fatura protocolada. Envie um corpo JSON com dois números finitos obrigatórios e um número finito opcional, todos na mesma moeda e na mesma janela de faturamento. hours_worked é o tempo total registrado e deve ser maior ou igual a zero; aceitam-se os aliases hours, total_hours, time_worked e worked_hours para que uma exportação de planilha de horas não precise de um passo de troca de nome. hourly_rate é a tarifa faturável por hora e deve ser maior ou igual a zero; aceitam-se os aliases rate, rate_per_hour, bill_rate e hourly. Uma tarifa horária negativa falha com invalid_input nomeando hourly_rate e não é cobrada. non_billable_hours é opcional, vale zero por padrão, deve ser maior ou igual a zero e não deve superar hours_worked; aceitam-se os aliases nonbillable_hours, unpaid_hours, write_off_hours e non_billable. Cada campo pode chegar como número JSON ou como cadeia numérica que coincida com um padrão decimal finito estrito. Campos obrigatórios ausentes, cadeias vazias, valores não finitos, horas acima de um milhão ou uma tarifa acima de um bilhão falham com invalid_input nomeando o campo. Em caso de sucesso o corpo ecoa hours_worked, hourly_rate e non_billable_hours arredondados, devolve billable_hours como a diferença, devolve invoice_total e amount como o mesmo produto de duas casas com arredondamento para cima a partir de cinco, e inclui uma cadeia de fórmula que você pode imprimir ao lado dos números. O preço de um item bem-sucedido é um US$ 0,002 fixo.

Onde uma calculadora de horas faturáveis ganha o seu lugar

Agências revisam a utilização antes de enviar a conta a um cliente e precisam da mesma identidade que um script financeiro chamará depois pela API. Como a implementação é código analítico parse de tier A, cada chamada bem-sucedida permanece barata a US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha as solicitações pequenas, fixe invoice_total e billable_hours nos testes, e você obtém um valor de fatura reproduzível para revisões de planilha de horas, scripts de cobrança e cadernos leves de gestão de escritório sem levantar um sistema completo de faturamento.