Agora no Bluesoft ERP, é possível consultar informações de equivalência nas promoções via API.

O objetivo desta melhoria é permitir que sistemas externos de pricing e aplicativos tenham uma visão mais rica e detalhada dos itens que compõem uma promoção, identificando automaticamente produtos vinculados por equivalência.

Como Era o Processo Antes?

Anteriormente, embora a API permitisse a inclusão de promoções replicando o preço para itens equivalentes (via atributo replicarEquivalentes no POST), os endpoints de consulta não retornavam esses dados técnicos dos produtos.

  • Falta de Visibilidade: Sistemas externos não conseguiam identificar, via GET, quais produtos unitários ou caixas estavam relacionados ao grupo de preço da promoção.
  • Inconsistência na Integração: Aplicativos de pricing precisavam realizar consultas adicionais em outras APIs de cadastro de produto para montar o cenário de equivalência, tornando a integração mais complexa.

Como Irá Funcionar a Partir de Agora?

Os endpoints de consulta de promoções foram enriquecidos para retornar dados de equivalência diretamente no bloco precos[].

  1. Endpoints Impactados:
    • GET /api/vendas/promocoes
    • GET /api/vendas/promocoes/{promocaoKey}
  2. Novos Campos no Retorno: O sistema passará a retornar quatro novos campos técnicos em cada item do array de preços:
    • grupoEquivalenciaKey: Chave que identifica o grupo de equivalência.
    • produtoCaixa: Valor booleano indicando se o item é um produto do tipo caixa.
    • produtoUnitarioKey: Código do produto unitário vinculado ao item.
    • fatorPrecoCadastro: Valor numérico decimal do fator de preço do cadastro do produto.
  3. Retrocompatibilidade: Todos os campos atuais da API foram preservados, garantindo que integrações existentes continuem funcionando sem necessidade de alteração imediata nos contratos de consumo.

Observações / Validações

  • Permissões: Para visualizar os novos campos, o usuário da API deve possuir a permissão 3577 - Consultar Promoção via API.
  • Regra de Exibição: O produto “pai” (origem) não retorna o grupoEquivalenciaKey preenchido, enquanto os produtos “filhos” (equivalentes) retornam a chave referenciando o pai para facilitar a identificação da hierarquia.

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 r367.47