Heures facturables

Les appels réussis sont facturés à $0.002 ; une entrée invalide n'est pas débitée.

Ce que sont les heures facturables et comment se forme le total de facture

Les heures facturables sont celles qu'un client paie réellement : le temps de la mission moins les passages en pertes, la formation, l'administration interne et la courtoisie que vous choisissez de ne pas facturer. Exemple : quarante heures travaillées à cent cinquante de l'heure avec deux heures passées en pertes donnent trente-huit heures facturables et un total de facture de cinq mille sept cents. Un taux horaire nul est autorisé et produit une facture de zéro, ce qui représente une ligne de courtoisie ou pro bono sans inventer une autre formule. Les heures non facturables ne peuvent pas dépasser les heures travaillées, car cela inventerait du temps facturable négatif. Les heures peuvent être fractionnaires (sept et un quart est une feuille de temps valide au quart d'heure) et les champs monétaires sont arrondis au supérieur à partir de cinq à deux décimales pour que le total corresponde à la monnaie habituelle. L'identité est une soustraction et une multiplication. hours_worked est tout ce qui est enregistré sur la feuille de temps ou l'horloge de la mission, y compris le temps que vous pourrez plus tard marquer comme non facturable. non_billable_hours est la part qui doit rester hors facture. Soustrayez cette part des heures travaillées et vous obtenez billable_hours. Multipliez les heures facturables par hourly_rate et vous obtenez invoice_total, le montant que ce calculateur renvoie comme résultat principal et à nouveau comme amount afin qu'un tableau de bord puisse lier l'une ou l'autre clé. Lorsque non_billable_hours est omis, il est traité comme zéro, donc une semaine propre de huit heures à soixante-quinze de l'heure facture six cents sans rien passer en pertes. Un taux horaire négatif n'est ni une remise ni un avoir : il est rejeté comme invalid_input afin qu'une faute de frappe n'émette pas une facture signée qu'un grand livre aval comptabiliserait comme remboursement. La chaîne de formule de la réponse répète que invoice_total égale hours_worked moins non_billable_hours, fois hourly_rate, afin qu'un relecteur puisse imprimer l'identité à côté du nombre sans la reconstruire.

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

Exemple : heures travaillées sept point deux cinq, taux horaire quatre-vingt-cinq point cinq, non facturables zéro point deux cinq donnent sept heures facturables et un total de facture de cinq cent quatre-vingt-dix-huit point cinq. Préférez les nombres nus aux chaînes formatées ; les marques de monnaie, séparateurs de milliers et étiquettes d'unité en fin de chaîne ne sont pas analysés. Cet extrémité n'applique ni taxe de vente, ni acomptes, ni multiplicateurs d'heures supplémentaires, ni conversion de monnaie, et n'émet pas de facture PDF. Associez le résultat à votre propre étape fiscale ou documentaire si vous avez besoin d'une facture déposée. Envoyez un corps JSON avec deux nombres finis obligatoires et un nombre fini facultatif, tous dans la même monnaie et la même fenêtre de facturation. hours_worked est le temps total enregistré et doit être supérieur ou égal à zéro ; les alias hours, total_hours, time_worked et worked_hours sont acceptés afin qu'un export de feuille de temps n'ait pas besoin d'une étape de renommage. hourly_rate est le taux facturable à l'heure et doit être supérieur ou égal à zéro ; les alias rate, rate_per_hour, bill_rate et hourly sont acceptés. Un taux horaire négatif échoue avec invalid_input en nommant hourly_rate et n'est pas facturé. non_billable_hours est facultatif, vaut zéro par défaut, doit être supérieur ou égal à zéro et ne doit pas dépasser hours_worked ; les alias nonbillable_hours, unpaid_hours, write_off_hours et non_billable sont acceptés. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique qui correspond à un motif décimal fini strict. Champs obligatoires manquants, chaînes vides, valeurs non finies, heures au-dessus d'un million ou un taux au-dessus d'un milliard échouent avec invalid_input en nommant le champ. En cas de succès le corps répète hours_worked, hourly_rate et non_billable_hours arrondis, renvoie billable_hours comme leur différence, renvoie invoice_total et amount comme le même produit à deux décimales arrondi au supérieur à partir de cinq, et inclut une chaîne de formule que vous pouvez imprimer à côté des nombres. Le prix d'un élément réussi est un $0.002 forfaitaire.

Où un calculateur d'heures facturables justifie sa place

Les agences examinent l'utilisation avant d'envoyer la note à un client et ont besoin de la même identité qu'un script financier appellera plus tard via l'API. Parce que l'implémentation est du code analytique parse de palier A, chaque appel réussi reste bon marché à $0.002 sans jetons de modèle et sans réseau sortant. Gardez les requêtes petites, figez invoice_total et billable_hours dans les tests, et vous obtenez un montant de facture reproductible pour les revues de feuille de temps, les scripts de facturation et les carnets légers de gestion de cabinet sans dresser un système de facturation complet.