Added
Novas APIs para Gestão de Kit de Produtos
2 days ago by Angela Santos
Implementamos um conjunto completo de APIs para a Gestão de Kit de Produtos. Esta atualização permite a criação de Kits enviando um array de SKUs e suas respectivas quantidades, consultas com preço final calculado dinamicamente pelo motor de preços, atualização de componentes e inativação de um kit — preservando o histórico de pedidos já finalizados.
Como usar?
- GET/kitprodutos - Retorna a lista paginada de kits com o preço final calculado dinamicamente.
- POST/kitprodutos - Cria um novo kit de produtos a partir de um array de SKUs e quantidades. Retorna o identificador do kit recém-criado.
- GET/kitprodutos/kitId - O preço final é calculado dinamicamente no momento da requisição, considerando promoções e ajustes vigentes.
- PUT/kitprodutos/kitId - Substitui integralmente os dados do kit. Para atualizações parciais utilize o endpoint PATCH.
- PATCH/kitprodutos/kitId - Apenas os campos informados serão atualizados. Se a lista de itens for informada, ela substitui a atual.
- DELETE/kitprodutos/kitId - Inativa um kit de produtos, que não é removido — apenas sinalizado como inativo, preservando vínculos com pedidos anteriores.
Benefícios e Ganhos
- Autonomia para Parceiros: Integradores gerenciam Kits diretamente via API, sem depender de acesso ao Admin.
- Precificação Dinâmica: O preço final do Kit é sempre calculado em tempo real respeitando tabelas de preço e descontos — sem valores estáticos ou divergências entre sistemas externos.
- Integridade no Checkout: Kits chegam ao carrinho com metadados que garantem que os itens sejam tratados como uma unidade indivisível.
- Rastreabilidade: A inativação lógica via DELETE preserva o histórico de pedidos já finalizados.