Gere um orçamento com desconto e valores totais

Transforme uma lista de serviços ou produtos em um orçamento estruturado e consistente, sem copiar valores entre uma calculadora e um modelo. O gerador calcula cada item, o subtotal, um desconto fixo e o total final, além de registrar por quantos dias a oferta permanecerá válida. Também aceita código da moeda, nome do cliente e referência.

Prepare itens claros para o orçamento

Comece com um registro para cada serviço ou produto que o cliente estiver avaliando. Cada registro precisa de uma descrição e um preço unitário; quando a quantidade for omitida, será usado um. Prefira descrições que continuem claras depois que o orçamento sair da conversa comercial: informe a entrega, o pacote, a licença ou a etapa do trabalho em vez de depender de abreviações internas.

As quantidades podem representar unidades físicas, usuários de assinatura, dias de consultoria ou qualquer outra medida consistente. O gerador multiplica cada preço unitário pela respectiva quantidade e arredonda o total do item para duas casas decimais. Os preços devem ser iguais ou superiores a zero, e as quantidades devem ser positivas.

Um item de valor zero é útil para registrar uma entrega incluída ou um serviço de cortesia sem alterar o subtotal. Todos os itens usam o código de moeda informado para o documento. Esta capacidade identifica os valores com esse código, mas não converte moedas, adiciona impostos nem consulta preços em catálogos.

Informe valores comerciais definitivos e prontos para a proposta. Uma entrada explícita torna o documento retornado previsível, auditável e adequado para automações posteriores.

Aplique o desconto e confira os totais

O desconto opcional é um valor fixo na mesma moeda dos itens. Quando ele for omitido, o gerador usará zero. Primeiro, o sistema calcula o total de cada item, soma esses valores arredondados para formar o subtotal, arredonda o desconto para duas casas decimais e faz a subtração para obter o total final.

Essa ordem oferece resultados estáveis para faturas, sistemas de aprovação e geradores de documentos que esperam a precisão monetária convencional. O desconto não pode ser negativo nem superior ao subtotal. Se ultrapassar o subtotal, a solicitação retorna um erro de entrada inválida em vez de produzir um orçamento com total negativo.

Essa proteção é especialmente útil quando os descontos vêm de um campo do CRM ou de uma regra comercial automatizada que pode estar desatualizada após alterações nos itens. Impostos, entradas, cronogramas de pagamento e descontos percentuais não fazem parte deste cálculo. Converta uma promoção percentual no valor fixo aprovado antes de chamar o gerador, preservando a clareza do cálculo e do documento.

Use o documento estruturado e o prazo de validade

O resultado é um orçamento estruturado, e não um PDF diagramado. Ele identifica o tipo do documento, a moeda, o prazo de validade em dias corridos, os itens normalizados e um resumo dos totais. Os campos opcionais de cliente e referência só aparecem quando são fornecidos, mantendo a saída limpa para sistemas que diferenciam informações ausentes de campos vazios.

O prazo padrão é de trinta dias e pode ser configurado entre um e 3,650 dias. Como esta capacidade é determinística e nunca consulta a hora atual, a validade é expressa como duração, sem inventar uma data de emissão ou vencimento. O sistema de destino pode combinar essa duração com a data e hora reais quando enviar ou armazenar o orçamento.

Essa separação impede mudanças entre novas tentativas e permite testes de referência confiáveis. Se você precisar de um arquivo visual finalizado, envie esta estrutura validada ao seu próprio renderizador. A capacidade não realiza solicitações de rede, não armazena dados do cliente e gera o mesmo resultado sempre que recebe a mesma entrada.