[Melhoria] Pricing: Novos Endpoints para Edição de Promoções via API

Agora no Bluesoft ERP, é possível realizar a edição de vigências, inclusão ou remoção de lojas e a inativação de itens ou da promoção completa via API.

O objetivo desta novidade é conferir maior agilidade e automação à operação de Pricing, permitindo que sistemas externos sincronizem alterações promoções em tempo real, eliminando retrabalhos e gargalos operacionais.

O Que Mudou?

• Foram disponibilizados novos endpoints que permitem o ciclo de vida completo da edição. Agora, o sistema externo pode enviar comandos para antecipar o início, estender o fim, adicionar/remover lojas ou cortar itens específicos de uma promoção já existente.
• Benefícios: Autonomia para integrações, redução de erros de digitação e maior velocidade na resposta às mudanças do mercado.

Como Irá Funcionar a Partir de Agora? A integração foi expandida com as seguintes rotas e funcionalidades:

• Ajuste de Vigência:
  PUT /api/vendas/promocoes/{promocaoKey}/prorrogar: Permite estender a data final da promoção.

Exemplo de JSON:

{
    "validadeFinal": "14/05/2026"
}

• PUT /api/vendas/promocoes/{promocaoKey}/antecipar: Permite adiantar a data de início da promoção.

Exemplo de JSON:

{
    "validadeInicial": "13/03/2026"
}

Nota: O campo validadeInicial ou validadeFinal deve ser enviado no formato dd/MM/yyyy.

• Gestão de Lojas Participantes:
  PUT /api/vendas/promocoes/{promocaoKey}/lojas/incluir: Adiciona novas lojas à promoção em vigor.

Exemplo de JSON:

{
    "lojas": [
        9,
        11
    ]
}

• PUT /api/vendas/promocoes/{promocaoKey}/lojas/remover: Remove lojas da promoção em vigor.

Exemplo de JSON:

{
    "lojas": [
        1
    ]
}

• Inativação de promoções ou produtos:
  DELETE /api/vendas/promocoes/{promocaoKey}: Inativa a promoção por completo.

• DELETE /api/vendas/promocoes/{promocaoKey}/itens/{gtin}: Inativa apenas um item específico da promoção através do seu código GTIN.

Observações / Validações:

• Permissões de Acesso: Para a execução dessas operações, o usuário da API deve possuir as seguintes permissões habilitadas:
  • 4511 - API Promoção Prorrogar (Alterar)
  • 4512 - API Promoção Antecipar (Alterar)
  • 4513 - API Promoção Adicionar Lojas (Incluir)
  • 4514 - API Promoção Remover Lojas (Excluir)
  • 4515 - API Promoção Inativar (Excluir)
  • 4516 - API Promoção Remover Item (Excluir)
• Segurança: As chamadas devem utilizar autenticação via JWT ou OAuth.
• Validação de Recurso: Caso o promocaoKey (ID da promoção) ou o gtin informado não sejam encontrados, o sistema retornará erro 400 - Bad Request

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.