Gere uma fatura com totais e imposto calculados

Informe vendedor, comprador, itens, quantidades, preços unitários e uma alíquota percentual. O gerador calcula o total de cada item, subtotal, imposto e total geral, e devolve os dados fornecidos e calculados em um objeto previsível que você pode armazenar, revisar, renderizar ou encaminhar para outro fluxo de trabalho.

Prepare todos os dados da fatura

Comece identificando as duas partes da transação. Os campos de vendedor e comprador aceitam nomes junto com endereço, registro ou contato que o processo posterior precise preservar. Em seguida, adicione pelo menos um item. Cada linha exige uma descrição clara, uma quantidade numérica e um preço unitário numérico. A alíquota é expressa como porcentagem: informe 8.25 para aplicar 8.25 por cento, e não 0.0825. Quantidades fracionárias são permitidas em trabalhos medidos por horas, peso, distância ou outra unidade divisível, e os preços também podem ter decimais. Quantidades e preços negativos são recusados porque normalmente representam uma fatura inválida ou um crédito que deveria ser registrado em um fluxo específico de nota de crédito. Use zero somente quando um item realmente gratuito precisar aparecer. Descrições precisas ajudam você a conciliar o documento final com pedidos, entregas e contratos. A solicitação não contém data nem identificador gerado; por isso, chamadas repetidas com a mesma entrada sempre produzem a mesma saída.

Entenda o cálculo de cada valor

Para cada linha, o gerador multiplica a quantidade pelo preço unitário e arredonda o total resultante para duas casas decimais. Depois, soma esses totais já arredondados para obter o subtotal. O imposto é calculado multiplicando esse subtotal pela alíquota percentual informada e também é arredondado para duas casas. Por fim, o imposto arredondado é adicionado ao subtotal para gerar o total geral. Essa ordem é explícita e determinística, o que importa porque sistemas contábeis podem divergir quando arredondam em outra etapa. A saída preserva cada descrição e quantidade enviada, apresenta preços unitários como valores monetários e adiciona line_total a cada item. No nível do documento, ela inclui subtotal, tax_rate, tax e grand_total, além de vendedor e comprador. Não há conversão nem inferência de moeda: todos os preços devem estar na mesma moeda escolhida por você. A resposta estruturada funciona como registro de cálculo e dados, pronta para um modelo, banco de dados, aprovação ou integração API; ela não é um PDF nem uma imagem.

Integre com segurança ao faturamento

Use esta capacidade no ponto em que dados editáveis de um pedido se tornam um registro de fatura. Primeiro, confirme o contexto comercial: partes, moeda, jurisdição tributária e necessidade de descontos, retenções, várias alíquotas ou créditos. Em seguida, envie as linhas normalizadas e armazene o objeto retornado como resultado do cálculo. Como o algoritmo não usa rede, valores aleatórios, relógio nem estado oculto, a mesma solicitação pode ser repetida com segurança e comparada em auditorias. Campos obrigatórios ausentes, valores não numéricos, lista vazia ou excessiva, alíquota negativa e, principalmente, quantidade ou preço negativo geram erros. Resolva esses problemas antes de atribuir um número à fatura ou enviá-la ao cliente. O resultado pode alimentar um modelo HTML, uma importação contábil, um gerador de anexos ou uma fila de aprovação, mas essas ações continuam separadas. Isso mantém a aritmética testável e impede que a apresentação altere os totais silenciosamente. Solicitações via API custam US$ 0,002; o navegador utiliza a mesma lógica pura, portanto as verificações interativas e as chamadas automatizadas concordam.