---
title: "Cadastrar produto"
method: POST
path: "/produtos"
tags: ["Produtos"]
---

# Cadastrar produto

`POST /produtos`

## Request

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

Método utilizado para cadastrar novos produtos. Vale ressaltar que
apenas com a `descricao` já é possível inserir um produto.

## Request body

- ProdutoCreate
  - `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 `201`

Produto criado com sucesso (com ou sem erros parciais).

- union
  - IdResponse
    - `id` string
  - IdComErrosResponse
    - `id` string
    - `erros` 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)