Novas APIs para Gestão de Grupos de Produtos

Implementamos um conjunto completo de APIs para a criação e gestão de grupos de produtos. Esta atualização permite a organização do catálogo de forma centralizada diretamente via API, com suporte a regras dinâmicas por critérios ou seleção estática por lista, e a reutilização dessas lógicas em diferentes módulos da plataforma como Mídias e Merchant e Promoções.

Como usar?

Liberamos a nova controller GrupoProdutos com um conjunto completo de endpoints para criação, consulta e atualização de grupos:

• POST/grupos-produtos — Cria um novo grupo (por critérios dinâmicos ou lista estática de IDs)

• GET/grupos-produtos — Lista todos os grupos com suporte a ordenação por data ou nome

• GET/grupos-produtos/id — Retorna detalhes e metadados de um grupo específico

• PUT/grupos-produtos/id — Atualiza total ou parcialmente um grupo existente

O payload diferencia claramente duas modalidades de agrupamento: Via Critérios, com filtros dinâmicos de Categoria, Marca, Atributo e operadores de inclusão/exclusão; e Via Lista Rápida, com seleção direta de IDs de produtos.

Atenção: Grupos com nomes duplicados para a mesma loja são bloqueados por validação, e os endpoints de listagem de produtos utilizam paginação por cursor para garantir performance em catálogos extensos.

Benefícios e Ganhos

• Centralização do Catálogo: Um único ponto na API para criar e gerenciar grupos reutilizáveis em outros módulos da plataforma como Mídias e Merchant e Promoções.

• Flexibilidade de Agrupamento: Suporte a grupos dinâmicos (regras por critérios) e estáticos (lista de IDs), cobrindo diferentes estratégias operacionais.

• Escalabilidade: Paginação por cursor nos endpoints de produtos garante performance mesmo em lojas com catálogos de grande volume.

• Integridade dos Dados: Validação de duplicidade impede a criação de grupos com nomes idênticos para a mesma loja, evitando inconsistências.