Changelog
Back to All
Added

Atualização de Preços de Kits via API

3 days ago by Suelen

Para trazer mais autonomia e escala para operações com alto volume de produtos, implementamos uma evolução na nossa API de Kits. A partir de agora, o lojista tem total controle para definir e atualizar um preço específico para cada item que compõe um kit de forma 100% automatizada.

Anteriormente, o sistema utilizava um cálculo automático baseado no preço padrão dos produtos para compor o valor final do kit. Com essa atualização, liberamos a flexibilidade de personalizar esses valores diretamente pelas integrações, eliminando a necessidade de ajustes manuais ponto a ponto e garantindo total sincronia entre a plataforma e ferramentas externas (como ERPs).


O que mudou na API?
Os endpoints de KitProdutos agora aceitam e processam o campo precoNoKit nas operações de criação e atualização (POST, PUT e PATCH). O valor enviado é salvo e passa a ser usado diretamente no cálculo do preço final do kit.

Endpoints:

POST /kitprodutos
PUT /kitprodutos/{kitId}/itens
PATCH /kitprodutos


Principais Benefícios

  • Precificação Estratégica por Item: Defina o preço exato de cada produto dentro do kit, sem depender exclusivamente das regras automatizadas da plataforma.
  • Gestão e Escala: Atualização de preços de kits em massa via API ou planilha, otimizando o tempo de operações com grandes catálogos de SKUs.
  • Sincronia entre Sistemas: Garanta que seu ERP, plataforma e canais de venda operem com a mesma informação de preço de ponta a ponta.


Regras de Negócio e Funcionamento Técnico
Para garantir a consistência dos dados e a segurança das integrações, a funcionalidade segue as seguintes diretrizes:

  • Composição do Desconto (Preço "De/Por"): O campo precoNoKit define o Preço Por (o valor que entra no subtotal). Para que o percentual de desconto seja exibido corretamente na vitrine, o Preço De (valor original) continuará sendo consultado na API de pricing. Caso a API de pricing não retorne dados para um item específico, o desconto dele será considerado zero.
  • Precedência do Preço Fixo: Se o kit contiver itens duplicados com o mesmo SKU e um deles possuir um valor definido em precoNoKit, esse preço fixo terá prioridade total na exibição. Isso assegura que o preço unitário mostrado na tela seja sempre condizente com o subtotal cobrado do cliente.
  • Campos Permitidos e Validação (HTTP 422): O campo precoNoKit é o único parâmetro de valor aceito no payload de itens do kit. Para proteger a integridade das regras fiscais e de cálculo da plataforma, o envio de outros campos de preço ou subtotal no payload disparará um erro de validação (HTTP 422).
  • Retorno ao Padrão Automatizado (Valores Nulos): O comportamento dinâmico foi mantido. Quando o campo precoNoKit receber um valor numérico válido, ele substitui o cálculo padrão. Se o campo for enviado como null, o sistema volta a utilizar o preço calculado automaticamente pela plataforma de forma transparente.