Agora no Bluesoft ERP, é possível incluir o valor da taxa de conveniência do pedido de venda via API

Como Irá Funcionar a Partir de Agora?

A partir de agora, os integradores devem atualizar suas chamadas para os endpoints de venda.

1. Inclusão de Pedido Separado (POST)

No endpoint POST /api/venda/pedidovenda/separado, foi adicionado o campo opcional taxaConveniencia no corpo da requisição.

  • Comportamento:
    • Se informado com valor maior que zero: O valor é gravado no pedido e somado ao total líquido.
    • Se não informado, null ou zero: O sistema trata como zero, mantendo o comportamento atual (compatibilidade).
    • Validação: O campo aceita valores monetários decimais e rejeita valores negativos ou formatos inválidos.

Exemplo de Payload com Taxa de Conveniência:

JSON

{
  "cliente": { ... },
  "itens": [ ... ],
  "numero_do_pedido": "EXT-461413-001",
  "cnpj_loja": "string",
  "valor_frete": 10.00,
  "forma_pagamento": "DINHEIRO",
  "taxaConveniencia": 5.90
}

Neste exemplo, o total do pedido será: (Soma dos itens) – (Descontos) + (Frete) + 5.90 (Taxa de Conveniência).

2. Inclusão de Pedido de Venda Comum (POST)

A melhoria também foi estendida para o endpoint de inclusão de pedido de venda comum (POST /api/venda/pedidovenda), que passa a aceitar o campo opcional taxaConveniencia com as mesmas regras de validação e gravação.

3. Consulta de Pedido de Venda (GET)

Para garantir a rastreabilidade, o endpoint de consulta (GET /api/venda/pedidovenda) também foi atualizado para retornar o campo valorTaxaConveniencia.

Exemplo de Retorno de Consulta:

JSON

{
  "pedidoVendaKey": 464139,
  "numeroPedidoExterno": "EXT-461413-001",
  "valorLiquido": "60.90",
  "valorFrete": "10.00",
  "valorTaxaConveniencia": "5.90",
  ...
}

Observações / Validações

  • Regra de Cálculo: A taxa de conveniência entra somando no total do pedido: Total = total dos itens - desconto + frete + seguros + taxa_de_conveniência.

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 r369.67