Skip to main content
Atualização de Novembro de 2026 A versão 3.1.16 traz novos endpoints para incluir, atualizar e excluir registros do histórico de custos de produtos e variações, e para consultar o histórico de custos de uma variação.

​
Melhorias

​
Produtos

  • POST /produtos/{idProduto}/custos - Inclui um ou mais registros no histórico de custos do produto. precoCusto e custoMedio são obrigatórios; data (formato AAAA-MM-DD), saldoAtual, saldoAnterior, impostosRecuperaveis e precoVenda são opcionais. Sem data, é usada a data do dia. Retorna 201 com os registros criados.
  • POST /produtos/custos - Inclui custos para produtos diferentes numa mesma requisição, informando o idProduto em cada item. Retorna 201 com os registros criados e o idProduto de cada um.
  • PUT /produtos/{idProduto}/custos - Atualiza um ou mais registros do histórico. Só o id do registro é obrigatório: os campos enviados são alterados e os demais continuam como estão. Retorna 200.
  • DELETE /produtos/{idProduto}/custos/{idCusto} - Exclui um registro do histórico de custos. Retorna 204.

​
Variações

  • GET /produtos/{idProduto}/variacoes/{idVariacao}/custos - Novo endpoint que lista o histórico de custos de uma variação.
  • POST, PUT e DELETE /produtos/{idProduto}/variacoes/{idVariacao}/custos - Incluem, atualizam e excluem custos de uma variação, com os mesmos campos e regras dos endpoints de produto.
  • POST /produtos/{idProduto}/variacoes/custos - Inclui o mesmo precoCusto e custoMedio em todas as variações ativas do produto de uma só vez, como a ação “Atualizar custo das variações” da tela. Retorna 201 com os registros criados e o idVariacao de cada um.
Toda gravação fica registrada no histórico de alterações do produto. Se algum item da requisição tiver erro, nenhum registro é salvo. Ponto de atenção: cada requisição aceita até 100 registros. Produto com variações não recebe custo direto: use os endpoints de variação. Variação inativa ou excluída retorna 400, e produto, variação ou registro de custo inexistente retorna 404. O usuário do aplicativo precisa do módulo DRE e das permissões de preço de custo (incluir, editar, remover ou ver histórico). Para incluir, atualizar e excluir custos de um produto ou de uma variação específica, também precisa da permissão de editar produto; a inclusão em todas as variações de uma vez não exige essa permissão.