Novo campo "Preço De" nos endpoints de pedidos

Implementamos uma atualização essencial em nossa API Pública de Pedidos para oferecer maior transparência sobre os valores transacionados. Esta atualização permite o acesso ao preço original do produto diretamente no fluxo de pedidos, eliminando a necessidade de consultas extras ao catálogo e garantindo uma visão fiel do "Preço De / Por" praticado no ato da compra.

Como era antes:

Anteriormente, os endpoints de pedidos retornavam apenas o preço final de venda. Para realizar análises de descontos, auditorias de faturamento ou relatórios de performance de campanhas, era preciso realizar chamadas adicionais à API de produtos para buscar o preço de tabela. Esse processo consumia mais recursos de rede e podia apresentar divergências, caso o preço no cadastro do produto fosse alterado após a conclusão do pedido.

O que mudou?

Otimizamos os endpoints GET/pedidos e GET/pedidos/pedidoId para incluir dados financeiros mais robustos. Agora, o payload de resposta conta com um novo campo estratégico:

Campo PrecoDe no item do Pedido: Dentro do objeto de cada item/variante do pedido, agora é retornado o valor original do produto (Preço De) antes da aplicação de promoções ou descontos.

Disponibilidade: Este dado é extraído diretamente do histórico do pedido, garantindo que o valor exibido seja exatamente o que estava configurado na vitrine no momento em que o cliente finalizou a compra.

Benefícios e Ganhos

Gestão de Dados eficiente: Redução drástica no número de requisições necessárias para compor relatórios financeiros, já que os dados de "De/Por" agora estão centralizados em uma única chamada.
Precisão em Auditorias: Facilita o trabalho de conciliação fiscal e auditoria, permitindo identificar com precisão o montante de descontos aplicados em cada item vendido.
Inteligência de BI: Integradores de Business Intelligence podem calcular o markup real e o ROI de promoções de forma automatizada e retroativa, utilizando apenas a base de pedidos.

JSON exemplo:

  "itens": [
    {
      "produtoVarianteId": 0,
      "sku": "string",
      "ean": "string",
      "nome": "string",
      "quantidade": 0,
      "precoCusto": 0,
      "precoVenda": 0,
      "isBrinde": true,
      "valorAliquota": 0,
      "isMarketPlace": true,
      "precoPor": 0,
      "precoDe": 0,
      "desconto": 0,
      "totais": {}
    }
  ]