---
title: "Atualizar produto"
method: PUT
path: "/produtos/{produtoId}"
tags: ["Produtos"]
---

# Atualizar produto

`PUT /produtos/{produtoId}`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/produtos/{produtoId}`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Este método é utilizado para atualizar um produto existente. Todos os
campos que forem informados na requisição serão atualizados. No caso
de `variacoes`, `imagens` e `categorias`, que são _arrays_, caso
sejam enviados, **substituirão** as atuais (caso deseje atualizar
parcialmente, veja o método **PATCH** abaixo).

**OBS:** Para excluir uma promoção de um produto, basta enviar o
campo `promocao` como `null`.

**ATENÇÃO:** No caso de enviar variações neste método, como elas
substituirão as atuais, caso o estoque do produto seja controlado
pela variação, o mesmo será zerado.

## Request body

- ProdutoUpdate
  - `descricao` string, required
  - `preco` number
  - `promocao` PromocaoInput
    - `dataHoraInicio` string, date-time: Formato: YYYY-mm-dd HH:MM:SS
    - `dataHoraFim` string, date-time
    - `percentual` number
    - `precoPromocional` number
  - `imagens` string[]: Array com Urls e/ou base64 das imagens. A primeira será a capa do produto.
  - `detalhes` string
  - `categorias` string[]
  - `variacoes` ProdutoVariacaoInput[]
    - `id` string, required
    - `obrigatoria` boolean
    - `multipla_selecao` boolean
    - `adicional` boolean
    - `qtdeMinima` number, nullable
    - `qtdeMaxima` number, nullable
    - `variaveis` ProdutoVariacaoVariavelInput[], required
      - `id` string, required
      - `preco` number
      - `imagem` integer: Índice (iniciando em 0) referente à imagem do produto que será mostrada quando essa variável for selecionada.
  - `combinacoes` CombinacaoInput[]
    - `codigo` string: Código (SKU) da combinação.
    - `preco` number
    - `ean` string: Código de barras (EAN/GTIN) da combinação. Opcional.
    - `combinacao` CombinacaoParInput[], required
      - `variacao` string, required: ID ou nome da variação.
      - `variavel` string, required: ID ou nome da variável.
  - `dimensoes` object
    - `altura` number
    - `largura` number
    - `comprimento` number
    - `peso` number
  - `unidadeVenda` 'Unidade' | 'Caixa' | 'Pacote' | 'Peça' | 'Quilo' | 'Porção' | 'Pedaço' | 'Metro' | 'Par' | 'Jogo'
  - `unidadePreco` 'Unidade' | 'Caixa' | 'Pacote' | 'Peça' | 'Quilo' | 'Porção' | 'Pedaço' | 'Metro' | 'Par' | 'Jogo'
  - `codigo` string
  - `ean` string: Código de barras (EAN/GTIN). Apenas para produto SEM variação — em produto com variação, o EAN é por combinação.
  - `qtdeMinima` number
  - `qtdeMaxima` number
  - `exibir` boolean
  - `destaque` boolean

## Response `200`

Produto atualizado.

- IdResponse
  - `id` string

## Other responses

- `400`: Erro na requisição que não foi possível ser completada. O erro é retornado em uma string (não JSON).
- `401`: Credenciais informadas inválidas.

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)