Calculateur GST

Un taux GST négatif est rejeté avec invalid_input au lieu d'inventer un remboursement. Le chemin est de l'arithmétique déterministe pure —sans réseau, sans table de juridiction, sans graine aléatoire, sans dépendance à l'horloge— de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après l'arrondi monétaire à deux décimales à chaque appel.

Ce que signifient le montant GST et le prix brut sur une facture fiscale

Un taux GST négatif n'est pas une entrée légale ni comptable dans ce modèle ; il transformerait la taxe en subvention, aussi la tâche échoue avec invalid_input plutôt que de renvoyer un montant GST négatif qui confondrait le logiciel de facturation.

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

Le taux GST doit être non négatif ; les valeurs négatives sont rejetées. Préférez les nombres aux chaînes formatées en monnaie ; les nombres en chaîne ne sont acceptés que s'ils correspondent à un motif numérique fini strict, sans signes dollar, marques de roupie ni séparateurs de milliers. Envoyez un corps JSON avec deux nombres finis obligatoires : net_price (alias net, price, amount, exclusive), le montant non négatif hors GST, et gst_rate (alias rate, percent, gst_percent, tax_rate), le taux GST en pourcentage, par exemple dix pour dix pour cent. Les valeurs absolues de net_price doivent rester dans un billion et gst_rate dans mille pour cent afin que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. En cas de succès, la réponse répète net_price arrondi aux cents, gst_rate et rate_percent comme le même pourcentage, rate_decimal comme le taux divisé par cent, gst_amount comme la taxe arrondie, gross_price comme net plus GST, et formula comme l'identité documentée. Une validation échouée —champs manquants, nombres non finis, valeurs hors limites absolues, un prix net négatif, un taux GST négatif, ou un montant GST ou un brut calculé non fini— renvoie invalid_input et n'est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec unité item. Associez un cas classique à dix pour cent, un cas à l'indienne à dix-huit pour cent et un gst_rate délibérément négatif pour couvrir le chemin dur d'invalid_input dans vos propres tests.

Où un calculateur GST gagne sa place

Les boutiques qui vendent dans des pays à GST et cotent des prix hors taxe peuvent envoyer le net du panier et le pourcentage applicable, puis afficher gst_amount et gross_price sans réimplémenter le calcul de pourcentage dans chaque client. Les suites d'assurance qualité pour bibliothèques de facturation peuvent figer cent à dix pour cent en GST dix et brut cent dix, plus un net fractionnaire tel que quarante-neuf virgule quatre-vingt-dix-neuf pour les contrôles d'arrondi au centime, et un taux délibérément négatif pour prouver le chemin dur d'invalid_input. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires peu coûteux lorsque les développeurs envoient exprès un taux négatif. Les contrôles aller-retour sont simples : recalculez à la main le net multiplié par le taux divisé par cent, confirmez l'égalité avec le gst_amount publié au même arrondi à deux décimales, puis confirmez que le net plus gst_amount égale le gross_price publié au tarif d'automatisation $0.002.