API: Carga de Preços por Canal de Venda – Consulta de Itens por Canal

Agora no Bluesoft ERP, é possível consultar os itens da carga de preços considerando um canal de venda específico via API

Objetivo

O objetivo da melhoria é permitir maior controle na distribuição de preços entre diferentes canais de venda, garantindo que cada integração consuma os valores corretos conforme o canal informado. A consulta também permite retornar o preço normal da carga para produtos sem preço específico por canal, quando esse comportamento for necessário para a operação.

O processo ocorre conforme o fluxo abaixo:

1. Os preços são cadastrados ou atualizados no ERP.
2. É gerada uma nova carga de preços.
3. É realizada a consulta da API de itens por canal.
4. A API retorna os preços específicos do canal

Endpoint

Para consultar os itens da carga de preços por canal de venda, utilize o endpoint:

GET /pricing/cargapreco/{cargaPrecoKey}/itens-por-canal

Onde:

• cargaPrecoKey corresponde ao identificador da carga de preços.

Como funciona o parâmetro retornaPrecoNormal

Este parâmetro define como a API deve tratar produtos que não possuem preço específico para o canal informado.

Quando retornaPrecoNormal=false: A API retorna apenas os produtos que possuem preço configurado para o canal de venda

O Produto C não será retornado, pois não possui preço específico para o canal.

Quando retornaPrecoNormal=true: Além dos produtos com preço por canal, a API também retorna aqueles que possuem apenas preço normal.

Essa opção é recomendada quando o sistema consumidor deve trabalhar com um catálogo completo de produtos.

***Os campos retornados dependerão das configurações existentes no ERP para cada produto e canal.***

Comportamento da carga parcial ao utilizar promoções por canal de venda

Quando a diferenciação de preços entre canais é realizada exclusivamente por promoções ou ofertas do ERP, sem que o produto possua uma precificação específica por canal de venda, existe um comportamento importante que deve ser considerado durante a sincronização dos preços.

Como funciona

Considere o seguinte cenário:

1. O produto não possui preço normal configurado para o canal de venda.
2. Existe uma promoção ou oferta vigente associada a esse canal.
3. É gerada uma carga de preços por canal.

Enquanto a promoção estiver ativa, o produto será retornado normalmente pela API de carga de preços por canal.

Entretanto, quando essa promoção é inativada ou sua vigência é encerrada, o comportamento dependerá do tipo de carga gerada.

Carga total

Ao gerar uma carga total, o produto continuará sendo retornado quando a consulta utilizar o parâmetro: retornaPrecoNormal=true

Nesse caso, a API utilizará o preço normal do produto como fallback, permitindo que ele continue sendo sincronizado.

Carga parcial

Na carga parcial, o comportamento é diferente.

Se o produto não possuir uma precificação por canal de venda e utilizar apenas promoções ou ofertas para diferenciar o preço entre canais, após a inativação da promoção o produto não será retornado pela API de carga por canal, mesmo quando o parâmetro retornaPrecoNormal=true estiver informado.

Isso ocorre porque a carga parcial considera apenas os itens alterados. Como o produto não possui um preço normal específico para aquele canal, não existe um registro de precificação por canal que possa ser retornado como fallback.

Como atualizar o preço nesse cenário

Para garantir que o sistema consumidor identifique corretamente a remoção da promoção e obtenha o preço vigente do produto, recomenda-se consultar o endpoint:

GET /api/vendas/precos/ultimas-alteracoes

Utilizando os parâmetros:

• dataAlteracaoInicio
• canalVendaKey

Essa consulta retornará as alterações de preços ocorridas para o canal informado, permitindo que a integração atualize o preço do produto após o encerramento da promoção.

Importante: Essa recomendação aplica-se apenas aos produtos que não possuem precificação por canal de venda e utilizam exclusivamente promoções ou ofertas do ERP para diferenciar os preços entre canais.

Configuração do Canal de Venda

Antes de consumir a API, verifique se o canal de venda está corretamente configurado no ERP.

O cadastro pode ser acessado em:

Vendas > Cadastros > Canal de Venda

Caso sejam utilizadas ofertas e promoções específicas por canal, o canal deverá estar habilitado para participação nessas configurações.

Após a configuração, uma nova carga de preços deve ser gerada para que as alterações sejam disponibilizadas pela API.

Permissão necessária

Para consultar os itens da carga de preços por canal é necessário possuir a permissão:

4213 – Consultar itens da carga de preço por canal

Boas práticas

Para garantir uma integração consistente, recomendamos:

• gerar uma nova carga sempre que houver alterações de preços;
• consultar sempre a carga mais recente disponível;
• utilizar paginação para grandes volumes de dados;
• utilizar retornaPrecoNormal=true quando o sistema consumidor precisar receber todos os produtos da carga;
• informar canalVendaKey sempre que o objetivo for sincronizar um canal específico.

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.