Novo endpoint de consulta de categorias por produto em lote

Foi desenvolvido o novo endpoint GET /produtos/categorias para permitir a consulta em massa das categorias vinculadas aos produtos em uma única chamada. Essa implementação visa otimizar a integração de grandes catálogos, eliminando a necessidade de consultas individuais por item.

Como era antes?

As informações de categoria não eram retornadas no endpoint de recuperação de produtos. Devido a essa limitação, agências e lojistas precisavam consultar a API produto por produto, o que gerava um alto tempo de processamento e frequentemente atingia o limite de requisições por minuto (rate limit), tornando a integração inviável para grandes operações.

O que mudou?

Agora, através de um endpoint dedicado dentro da controller de Produtos, é possível extrair a árvore completa de categorias de diversos itens simultaneamente:

Consulta em Lote: O lojista pode recuperar a lista de produtos e suas respectivas categorias em uma única requisição.
Controle de Paginação: Inclusão de parâmetros de _pagina _e _quantidadeRegistros _para facilitar o gerenciamento de grandes volumes de dados.
Filtro por Status: Possibilidade de filtrar o retorno para exibir apenas as categorias que estão marcadas como ativo.
Dados Completos: O retorno inclui informações detalhadas como id, nome, e se a categoria é a principal.

Benefícios e Ganhos

Redução de chamadas à API: Otimiza o consumo da banda e recursos do servidor ao consolidar diversas consultas em uma única requisição, evitando bloqueios por rate limit.
Paginação e filtros combinados: Oferece maior flexibilidade no consumo dos dados, permitindo que o integrador utilize filtros (como o status ativo) em conjunto com a paginação para buscas precisas.
**Hierarquia completa de categorias: **Entrega a estrutura detalhada de cada categoria

Exemplo de payload do GET

[
  {
    "produtoId": 83528,
    "variantes": [
      {
        "sku": " TEN-NIK-0001-0786-1",
        "produtoVarianteId": 338667
      },
      {
        "sku": "TEN-NIK-0001-0692",
        "produtoVarianteId": 338673
      }
    ],
    "categorias": [
      {
        "id": 1138,
        "nome": "Coca Cola",
        "categoriaPaiId": 0,
        "categoriaERPId": "",
        "ativo": false,
        "isReseller": false,
        "exibirMatrizAtributos": "Neutro",
        "quantidadeMaximaCompraUnidade": 0,
        "valorMinimoCompra": 0,
        "exibeMenu": false,
        "urlHotSite": "coca-cola",
        "caminhoHierarquia": "Coca Cola",
        "ordem": null,
        "categoriaPrincipal": false,
        "categoriaGoogle": null
      },
      {
        "id": 1260,
        "nome": "Heritage Basketball",
        "categoriaPaiId": 1144,
        "categoriaERPId": "",
        "ativo": false,
        "isReseller": false,
        "exibirMatrizAtributos": "Neutro",
        "quantidadeMaximaCompraUnidade": 0,
        "valorMinimoCompra": 0,
        "exibeMenu": false,
        "urlHotSite": "converse-all-star/linha/heritage-basketball",
        "caminhoHierarquia": "Converse All Star > Linha > Heritage Basketball",
        "ordem": null,
        "categoriaPrincipal": false,
        "categoriaGoogle": null
      }
    ]
  }
]