Agora no Bluesoft ERP, é possível utilizar novos filtros de busca por canal de venda, consultar múltiplos status via API

Objetivo:

O objetivo desta melhoria é otimizar a integração de dados para os parceiros integradores, reduzindo o volume de chamadas necessárias para consolidar cenários comuns de consulta, eliminando regras de classificação complexas fora do sistema e corrigindo inconsistências nas descrições da documentação da API.

Como Irá Funcionar a Partir de Agora?

1. Filtro por Canal de Venda (canalVendaKey)

  • O integrador poderá informar o parâmetro canalVendaKey na URL da requisição.
  • O sistema buscará e retornará as promoções que possuam associação direta com o canal informado.

2. Filtro com Múltiplos Status

  • O parâmetro status passa a aceitar uma lista de valores separados por vírgula (Ex: status=VIGENTE,A_VIGORAR).
  • O sistema tratará de forma resiliente eventuais espaços informados antes ou depois da vírgula pelos integradores (Ex: status=VIGENTE, A_VIGORAR).
  • A consulta tratará esses valores em formato OR, trazendo registros que atendam a qualquer um dos status indicados.
  • Comportamento Padrão Mantido: Se o parâmetro status não for explicitamente preenchido na requisição, a API continuará retornando apenas promoções com status operacional FECHADA.

3. Nova Propriedade de Retorno (statusPromocao)

  • O corpo de resposta (JSON) de cada promoção trará o novo campo statusPromocao além do campo status já existente.
  • O campo statusPromocao refletirá a situação calculada pelo ERP baseado na vigência, assumindo um dos seguintes valores do ENUM: ABERTA, FECHADA, EXCLUIDA, VIGENTE, A_VIGORAR ou EXPIRADA.

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 r368.40