Gere uma ordem de compra com totais calculados

Informe o número da ordem, o comprador, o fornecedor e pelo menos um item com descrição, quantidade e custo unitário. O gerador valida os dados obrigatórios, calcula o total de cada item e do pedido e devolve um objeto previsível, pronto para análise interna, armazenamento, renderização, aprovação formal ou outra etapa do fluxo de compras.

Prepare todos os dados da ordem de compra

Comece com um número de ordem de compra já atribuído pelo seu sistema de compras. O gerador preserva esse valor exatamente depois de remover espaços externos; ele não inventa identificadores, consulta sequências nem reserva números. Em seguida, identifique o comprador e o fornecedor. Esses campos podem conter um nome empresarial curto ou um bloco maior com endereço e dados cadastrais, conforme a necessidade do sistema que renderizará o documento. Inclua pelo menos um item e forneça, em cada linha, uma descrição específica, uma quantidade numérica maior que zero e um custo unitário numérico não negativo. Quantidades fracionárias são aceitas para bens ou serviços comprados por peso, comprimento, tempo ou outra unidade divisível. Um custo zero é permitido para um item realmente gratuito, mas uma quantidade zero ou negativa é recusada porque não representa um pedido. Mantenha todos os custos na mesma moeda e base de preços. A capacidade não infere moedas, unidades de medida, condições de pagamento, datas de entrega, tributos, descontos nem frete; trate essas decisões comerciais antes ou depois deste cálculo, conforme necessário.

Entenda como os totais são calculados

Em cada linha, o gerador multiplica a quantidade pelo custo unitário e arredonda o total resultante para duas casas decimais. Depois, soma os totais já arredondados e arredonda a soma para produzir o subtotal da ordem de compra. Como esta capacidade não recebe tributos, frete, descontos nem outros ajustes, o total devolvido é igual ao subtotal. Essa sequência explícita é importante quando quantidades fracionárias ou custos unitários têm várias casas decimais: outro sistema que some valores intermediários não arredondados pode divergir em um centavo. A resposta preserva a descrição normalizada, a quantidade numérica original, o custo unitário arredondado e o total calculado de cada item. No nível do documento, ela devolve tipo, número informado, comprador, fornecedor, itens, subtotal e total. Todos os números devem ser finitos; textos que apenas parecem números não são convertidos silenciosamente. Custos negativos também são recusados. Essas regras expõem dados incorretos cedo e oferecem a modelos, telas de aprovação, bancos de dados e integrações um contrato de cálculo estável.

Use o documento estruturado no fluxo de compras

Use esta capacidade depois da aprovação da requisição e da atribuição do número, quando os dados editáveis estiverem prontos para virar um registro controlado. Envie nomes normalizados das partes e os itens e armazene o objeto devolvido como resultado do cálculo usado nas etapas seguintes. Um modelo pode convertê-lo em HTML ou PDF, um serviço de aprovação pode comparar o total com limites de autorização e uma integração pode transferir os itens para um ERP ou portal do fornecedor. Essas ações permanecem separadas: o gerador não envia a ordem, contata o fornecedor, cria arquivos, reserva orçamento nem atualiza estoque. Ele não usa rede, relógio, valores aleatórios, armazenamento ou estado oculto; por isso, uma solicitação idêntica sempre produz a mesma resposta. Isso facilita novas tentativas e auditorias. Corrija erros de validação antes de apresentar a ordem para assinatura, principalmente quando faltarem itens, dados das partes, número ou valores numéricos. A solicitação de API custa US$ 0,002, e o mesmo cálculo puro pode atender à experiência no navegador.