Calculadora GST

Uma alíquota GST negativa é rejeitada com invalid_input em vez de inventar um reembolso. O caminho é aritmética determinística pura —sem rede, sem tabela de jurisdição, sem semente aleatória, sem dependência de relógio— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento monetário a duas casas sempre que você a chama.

O que significam o valor GST e o preço bruto numa fatura fiscal

Uma alíquota GST negativa não é uma entrada legal nem contábil neste modelo; transformaria o imposto em um subsídio, então a tarefa falha com invalid_input em vez de devolver um valor GST negativo que confundiria o software de faturamento.

Contrato de entrada, forma da resposta e comportamento de erro

A alíquota GST deve ser não negativa; valores negativos são rejeitados. Prefira números a strings formatadas como moeda; números em string só são aceitos quando batem com um padrão numérico finito estrito sem cifrões, marcas de rúpia nem separadores de milhar. Envie um corpo JSON com dois números finitos obrigatórios: net_price (aliases net, price, amount, exclusive), o valor não negativo exclusivo de GST, e gst_rate (aliases rate, percent, gst_percent, tax_rate), a alíquota GST como porcentagem, por exemplo dez para dez por cento. Os valores absolutos de net_price devem permanecer dentro de um trilhão e gst_rate dentro de mil por cento para que produtos intermediários permaneçam finitos em precisão dupla IEEE no Worker e no navegador. Em caso de sucesso a resposta ecoa net_price arredondado a centavos, gst_rate e rate_percent como a mesma porcentagem, rate_decimal como a alíquota sobre cem, gst_amount como o imposto arredondado, gross_price como líquido mais GST, e formula como a identidade documentada. Validação falha —campos ausentes, números não finitos, valores fora dos limites absolutos, um preço líquido negativo, uma alíquota GST negativa, ou um valor GST ou bruto calculado não finito— retorna invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item. Combine um caso clássico a dez por cento com um caso ao estilo da Índia a dezoito por cento e um gst_rate deliberadamente negativo para cobrir o caminho duro de invalid_input nos seus próprios testes.

Onde uma calculadora GST ganha o lugar

Lojas que vendem em países com GST e cotam preços exclusivos podem enviar o líquido do carrinho e a porcentagem aplicável, e então exibir gst_amount e gross_price sem reimplementar a matemática percentual em cada cliente. Conjuntos de garantia de qualidade para bibliotecas de faturamento podem fixar cem a dez por cento em GST dez e bruto cento e dez, mais um líquido fracionário como quarenta e nove ponto noventa e nove para checagens de arredondamento a centavos, e uma alíquota deliberadamente negativa para provar o caminho duro de invalid_input. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando desenvolvedores enviam de propósito uma alíquota negativa. Checagens de ida e volta são fáceis: recalcule à mão o líquido vezes a alíquota sobre cem, confirme que iguala o gst_amount publicado com o mesmo arredondamento a duas casas, e depois confirme que o líquido mais gst_amount iguala o gross_price publicado na tarifa de automação US$ 0,002.