Agora no Bluesoft ERP, é possível incluir validação de total de pagamentos x total do pedido em pedidos e-commerce via API

Para garantir maior integridade nas integrações de pedidos via API e evitar problemas futuros no faturamento de notas fiscais, implementamos uma nova validação de segurança no cadastro de e-commerce.

O que mudou?

Anteriormente, ao integrar um pedido externo via API (venda/pedidovenda/e-commerce), o sistema aceitava pedidos onde a soma dos pagamentos não batia exatamente com a soma dos itens e frete. Isso gerava problemas na hora de emitir a NF-e, resultando na rejeição da SEFAZ.

A partir de agora, disponibilizamos um novo parâmetro chamado “Validar total do pagamento no e-commerce”.

Como funciona a validação?

Quando o parâmetro “Validar total do pagamento no e-commerce” estiver habilitado, o ERP aplicará uma padronização nos valores antes de comparar o total do pedido com o total dos pagamentos.

A regra funciona da seguinte forma:

  1. Cada item é calculado (Quantidade × Valor unitário – Desconto).
  2. O resultado de cada item é arredondado para 3 casas decimais.
  3. O valor do frete também é arredondado para 3 casas decimais.
  4. Todos os pagamentos informados passam pelo mesmo arredondamento.
  5. Ao final, o Total do Pedido e o Total dos Pagamentos são novamente arredondados para 3 casas decimais antes da comparação.

Como funciona o arredondamento:

  • Se o quarto número após a vírgula for maior ou igual a 5, o valor é arredondado para cima.
  • Se for menor que 5, o valor é arredondado para baixo.

Resultado:
Com o parâmetro habilitado, caso o valor total do pedido esteja divergente do valor total informado para pagamento, o pedido será automaticamente rejeitado pelo sistema.

Atenção: Esta validação é aplicada apenas para pedidos que já vêm marcados como pagos (atributo "aguardandoPagamento": false).

Como configurar?

Para ativar essa segurança e evitar divergências financeiras:

1. Acesse o menu E-commerce > Configurações > Parâmetros do módulo e-commerce.

2. Edite o e-commerce desejado.

3. Na aba do e-commerce desejado, marque a opção: Validar total do pagamento no e-commerce.

4. Clique em Salvar.

Com essa melhoria, garantimos que apenas pedidos com valores consistentes entrem no ERP, evitando retrabalho e rejeições na emissão de notas fiscais.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r364.40