> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versão 3.1.16

*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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.