Calculateur d'honoraires de conseil

L'identité est simple et auditable : total_fee égale hourly_rate fois hours_worked plus retainer. Zéro heure est admis lorsque la mission n'est que forfaitaire ; des heures négatives ne décrivent pas un travail accompli, elles échouent donc avec invalid_input au lieu d'imprimer un avoir qu'une proposition pourrait traiter comme de l'argent.

Ce que couvre l'identité de l'honoraire de conseil, et ce qu'elle laisse de côté

L'identité qu'utilise cet outil est celle que ces documents impliquent déjà : total_fee égale hourly_rate fois hours_worked plus retainer. hourly_subtotal est la composante temps à elle seule, pour qu'un relecteur voie si le forfait ou les heures dominent avant de signer.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Envoyez par POST un corps JSON qui fournit hourly_rate et hours_worked. hourly_rate est le taux facturable convenu dans une seule unité monétaire, un nombre fini non négatif, avec les alias rate, hourly, bill_rate, consulting_rate et hourly_fee. hours_worked sont les heures déjà enregistrées ou celles que le cahier des charges prévoit de couvrir, un nombre fini non négatif, avec les alias hours, hrs, billed_hours et time_worked. Les heures fractionnaires sont acceptées afin qu'une feuille de temps en dixièmes n'ait pas à être complétée jusqu'à l'heure entière. retainer est optionnel : un montant fini non négatif dû indépendamment des heures, valant zéro s'il est omis, avec les alias fixed_retainer, retainer_fee, fixed_fee et retainer_amount. Chaque champ numérique peut arriver comme nombre JSON ou comme chaîne numérique. L'absence de hourly_rate, l'absence de hours_worked, des chaînes vides, des valeurs non finies, un taux horaire négatif, un retainer négatif ou une magnitude au-dessus de la limite déclarée échouent avec invalid_input en nommant le champ et ne sont pas facturés. hours_worked négatif est l'erreur que cette landing existe pour attraper : le message contient hours_worked et must not be negative afin qu'un formulaire mette en évidence ce contrôle plutôt qu'une alerte globale. En cas de succès le corps répète les trois entrées après arrondi, hourly_subtotal comme taux fois heures, total_fee comme le montant à payer, et une chaîne formula qui reformule l'identité. Exemple : hourly_rate de cent cinquante, hours_worked de dix et retainer de cinq cents donnent hourly_subtotal mille cinq cents et total_fee deux mille. Exemple : hourly_rate de soixante-quinze point cinq avec huit point cinq heures et sans retainer donne six cent quarante-et-un et soixante-quinze. Associez le total à votre propre barème fiscal si la facture doit être nette de retenues ; ce endpoint calcule uniquement l'honoraire de conseil.

Où un calculateur d'honoraires de conseil gagne sa place

Les applications de budget familial et de petite entreprise peuvent stocker le total_fee renvoyé comme une sortie planifiée, puis superposer impôt et dépenses plutôt que de reconstruire un chiffre mélangé. Les cabinets juridiques et de marketing peuvent appeler le même module pur depuis le navigateur pour un aperçu gratuit et depuis l'API lorsqu'ils persistent un scénario, garantissant que le nombre vu sur une landing est celui stocké après enregistrement. Comme l'implémentation est parse pure de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.