---
title: "Criar produto"
method: POST
path: "/{alias}/catalog/products"
tags: ["Catálogo - Produtos"]
---

# Criar produto

`POST /{alias}/catalog/products`

Cria um novo produto

## Path parameters

- `alias` string, required

## Request body

- ProductRequest — Representa os dados necessários para criar ou atualizar um produto
  - `simple` boolean, required — Produto possui ou não variações
  - `brand_id` integer, required — ID da marca
  - `erp_id` integer — ID de ERP
  - `active` boolean, required — Indica se o produto está ativo
  - `searchable` boolean — Indica se o produto é buscável
  - `is_digital` boolean — Indica se o produto é digital
  - `buy_similars` boolean — Sugerir carrossel de produtos similares na compra
  - `priority` integer — Nível de relevância (1 ->Padrão, 2 -> Média, 3 -> Alta)
  - `rating` integer — Nota de avaliação do produto definida manualmente (quando não calculada a partir das avaliações de clientes).
  - `ncm` string — Código NCM
  - `name` string, required — Nome do produto. O valor é sanitizado e normalizado automaticamente.
  - `slug` string — Utilizado em URL e listagens
  - `video` string — Vídeo do produto
  - `description` string — Descrição do produto. O valor é sanitizado e normalizado automaticamente.
  - `specifications` string — Especificações do produto. O valor é sanitizado e normalizado automaticamente.
  - `measures` string — Medidas do produto (ex: 10x20x30 cm). O valor é sanitizado e normalizado automaticamente.
  - `gift_value` number, float — Valor de presente associado ao produto
  - `seo_title` string — Título do produto para SEO
  - `seo_description` string — Descrição do produto para SEO
  - `seo_keywords` string — Palavras-chave para SEO
  - `canonical_url` string — URL canônica do produto
  - `google_category` string — Categoria Google do produto
  - `search_terms` string — Termos extras de busca do produto
  - `categories_ids` integer[] — IDs das categorias vinculadas
  - `flags_ids` integer[] — IDs das flags vinculadas
  - `filters_values_ids` integer[] — IDs dos valores de filtros vinculados
  - `variations_ids` integer[] — IDs das variações do produto
  - `similars_ids` integer[] — IDs de produtos similares
  - `collections_ids` integer[] — IDs das coleções vinculadas
  - `skus` object[]
    - `sku` string — Código identificador principal do produto
    - `erp_id` integer — ID do SKU no sistema ERP
    - `barcode` string — Código de barras do SKU
    - `price_cost` number, float — Preço de custo
    - `price_sale` number, float — Preço de venda
    - `price_discount` number, float — Preço com desconto
    - `weight` number, float — Peso do SKU em kg
    - `height` number, float — Altura do SKU em cm
    - `width` number, float — Largura do SKU em cm
    - `length` number, float — Comprimento do SKU em cm
    - `quantity_managed` boolean — Controle de estoque habilitado
    - `availability` integer — Disponibilidade do SKU em estoque
    - `availability_soldout` integer — Disponibilidade após esgotar
    - `blocked_sale` boolean — Bloqueia a venda deste SKU
    - `images` object[] — Imagens do SKU
      - `url` string, uri — URL da imagem do SKU.
  - `create_redirect` object — Se presente na requisição, cria um redirect junto com a atualização. A presença do nó é o que sinaliza a intenção — o conteúdo descreve o redirect.
    - `url_from` string, required — URL de origem do redirect (path relativo iniciando com /).
    - `url_to` string, required — URL de destino do redirect (path relativo iniciando com /). Deve ser diferente de url_from.

## Response `200`

Produto criado com sucesso

- Product — Representa um produto do catálogo
  - `id` integer — Identificador único do produto.
  - `merchant_id` integer — ID da loja
  - `affiliation_id` integer — ID de afiliação do produto
  - `erp_id` integer — ID do produto no ERP
  - `seller_id` integer — ID do vendedor
  - `active` boolean — Indica se o produto está ativo
  - `searchable` boolean — Indica se o produto é buscável
  - `is_digital` boolean — Indica se o produto é digital
  - `rating` integer — Nota média de avaliação do produto.
  - `priority` integer — Nível de relevância (1 -> Padrão, 2 -> Média, 3 -> Alta)
  - `ncm` string — Código NCM do produto
  - `name` string — Nome do produto
  - `slug` string — Slug (URL amigável) do produto
  - `warranty` integer — Garantia em meses
  - `custom_shipping` boolean — Indica se o Frete é customizado
  - `shipping_price` number, float — Valor do frete customizado em reais
  - `gift_value` number, float — Valor de presente (se aplicável)
  - `simple` boolean — Indica se o produto é simples

## Other responses

- `400` — Requisição inválida
- `422` — Dados inválidos. Pode ocorrer quando campos obrigatórios estão ausentes, o formato é incorreto, ou quando o valor enviado resulta em uma string vazia após sanitização e normalização.

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) · [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)