Grupo de personalização disponível no PATCH de Produtos

Foi adicionado o array grupoPersonalizacaoIds no corpo da requisição do endpoint PATCH /produtos/{identificador} no qual agora é possível adicionar ou remover produtos de um ou mais grupos der personalização. Cada valor do array deve corresponder ao ID de um grupo de personalização previamente cadastrado na plataforma, podendo ter um ou mais IDs.

🧾 Como era antes?

Somente era possível incluir através do endpoint POST /grupospersonalizacao/{grupoPersonalizacaoId}/produtos, onde a relação é 1 grupo para vários produtos (relação 1:N). Caso fosse necessário associar o mesmo produto a outro grupo de personalização, era preciso realizar chamadas adicionais.

✅ O que mudou?

Agora, foi adicionado ao corpo da requisição o novo campo grupoPersonalizacaoIds, no endpoint PATCH /produtos/{identificador} que é um array de IDs numéricos que representa os grupos de personalização cadastrados na plataforma.

Com isso, é possível:

• Adicionar ou remover o produto de um ou mais grupos de personalização em uma única requisição;
• Evitar múltiplas chamadas para vincular o produto a diferentes grupos de personalização;

🧪 Exemplo de payload com o array grupoPersonalizacaoIds

{
  "grupoPersonalizacaoIds": [10, 12, 14]
}

Neste exemplo, o produto será vinculado aos grupos de personalização de ID 10, 12 e 14. Caso o produto já esteja associado a outros grupos de personalização, que não estejam listados no array, esses vínculos serão removidos.

📘

Nota técnica

Para que as atualizações parciais reflitam de acordo no produto, atenção aos seguintes cenários

Cenário 1: Não é possível enviar um campo com valor null, nesse caso é preciso excluir o campo da requisição. Sendo assim, se o campo não for enviado será mantido o valor existente no banco de dados.

Cenário 2: Se for enviado um campo vazio, todos os itens/valores existentes no banco serão excluídos.

Cenário 3: Se for enviado um campo com valores, as novas informações serão salvas. Os valores que estiverem no banco e não estiverem no array, serão excluídos.

📚 Documentação

Confira como utilizar essa funcionalidade na Atualizando parcialmente um produto.