# Criar um novo produto

Endpoint: POST /v1/produtos
Version: v1
Security: BearerAuth

## Request fields (application/json):

  - `ativo` (boolean)
    Indica se o produto está ativo
    Example: true

  - `categoria` (object)
    Grupo ou categoria do produto

  - `categoria.id` (integer, required)
    ID do grupo ou categoria do produto
    Example: 1

  - `codigo_ean` (string)
    Código EAN do produto
    Example: "EAN123"

  - `codigo_sku` (string)
    Código SKU do produto
    Example: "SKU123"

  - `conversoes_unidade_medida` (array)
    Conversões de unidade de medida do produto, depende da unidade de medida das informações fiscais

  - `conversoes_unidade_medida.fator` (number, required)
    Fator de conversão entre unidades de medida
    Example: 1000

  - `conversoes_unidade_medida.id_fornecedor` (array)
    List de IDs de fornecedores associados à conversão

  - `conversoes_unidade_medida.unidade_medida` (object, required)
    Unidade de medida de entrada para conversão

  - `conversoes_unidade_medida.unidade_medida.id` (integer, required)
    ID da unidade de medida de entrada
    Example: 1

  - `descricao` (string)
    Descrição do produto
    Example: "Descrição do produto"

  - `detalhe_kit` (object)
    Detalhes do kit de produto

  - `detalhe_kit.itens` (array, required)
    Lista de itens do kit de produto

  - `detalhe_kit.itens.id_produto` (string, required)
    ID do produto associado ao item no kit
    Example: "0e9b442a-3af0-45f1-9c5c-415473084092"

  - `detalhe_kit.itens.quantidade` (number, required)
    Quantidade do produto associado ao item no kit
    Example: 1

  - `detalhe_kit.itens.valor_total` (number, required)
    Valor total do produto associado ao item no kit
    Example: 100

  - `detalhe_kit.itens.valor_unitario` (number, required)
    Valor unitário do produto associado ao item no kit
    Example: 100

  - `detalhe_kit.valor_venda` (number, required)
    Valor de venda do kit de produto
    Example: 100

  - `ecommerce` (object)
    Informações de e-commerce do produto

  - `ecommerce.categoria_ecommerce` (object)
    Categoria do produto no e-commerce

  - `ecommerce.categoria_ecommerce.id` (string, required)
    ID da categoria do produto no e-commerce
    Example: "0e9b442a-3af0-45f1-9c5c-415473084092"

  - `ecommerce.condicao` (string)
    Condição do produto para e-commerce (NOVO ou USADO)
    Enum: "NOVO", "USADO"

  - `ecommerce.descricao_adicional` (string)
    Descrição adicional do produto para e-commerce
    Example: "Descrição adicional do produto"

  - `ecommerce.descricao_seo` (string)
    Descrição SEO do produto
    Example: "Descrição SEO do produto"

  - `ecommerce.integracao_ativa` (boolean)
    Indica se a integração de e-commerce está ativa
    Example: true

  - `ecommerce.marca` (object)
    Marca do produto

  - `ecommerce.marca.id` (string, required)
    ID da marca do produto
    Example: "0e9b442a-3af0-45f1-9c5c-415473084092"

  - `ecommerce.titulo_seo` (string)
    Título SEO do produto
    Example: "Título SEO do produto"

  - `ecommerce.url_seo` (string)
    URL SEO do produto
    Example: "https://www.exemplo.com/produto"

  - `estoque` (object)
    Informações de estoque do produto

  - `estoque.custo_medio` (number)
    Custo médio do produto
    Example: 80

  - `estoque.estoque_disponivel` (number)
    Estoque disponível do produto
    Example: 50

  - `estoque.estoque_maximo` (number)
    Estoque máximo do produto
    Example: 100

  - `estoque.estoque_minimo` (number)
    Estoque mínimo do produto
    Example: 10

  - `estoque.valor_venda` (number)
    Valor de venda do produto
    Example: 100

  - `fiscal` (object)
    Informações fiscais do produto

  - `fiscal.cest` (object)
    CEST (Código Especificador da Substituição Tributária) do produto

  - `fiscal.cest.id` (integer, required)
    ID do CEST
    Example: 1

  - `fiscal.ncm` (object)
    NCM (Nomenclatura Comum do Mercosul) do produto

  - `fiscal.ncm.id` (integer, required)
    ID do NCM
    Example: 1

  - `fiscal.origem` (string)
    Origem do produto
    Enum: "NACIONAL", "ESTRANGEIRA_IMPORTACAO_DIRETA", "ESTRANGEIRA_ADQUIRIDA_INTERNAMENTE", "NACIONAL_IMPORTACAO_SUPERIOR_40", "NACIONAL_PRODUCAO_CONFORMIDADE", "NACIONAL_IMPORTACAO_INFERIOR_40", "ESTRANGEIRA_IMPORTACAO_DIRETA_CAMEX", "ESTRANGEIRA_ADQUIRIDA_INTERNAMENTE_CAMEX", "NACIONAL_MERCDORIA_BEM_IMPORTACAO_SUPERIOR_70"

  - `fiscal.tipo_produto` (string)
    Tipo do produto
    Enum: "MERCADORIA_PARA_REVENDA", "MATERIA_PRIMA", "EMBALAGEM", "PRODUTO_EM_PROCESSO", "PRODUTO_ACABADO", "SUBPRODUTO", "PRODUTO_INTERMEDIARIO", "MATERIAL_DE_USO_E_CONSUMO", "ATIVO_IMOBILIZADO", "SERVICOS", "OUTROS_INSUMOS", "OUTRAS"

  - `fiscal.unidade_medida` (object)
    Unidade de medida fiscal do produto

  - `fiscal.unidade_medida.id` (integer, required)
    ID da unidade de medida fiscal
    Example: 1

  - `formato` (string)
    Formato do produto (SIMPLES ou VARIACAO)
    Enum: "SIMPLES", "VARIACAO"

  - `id_centro_custo` (string)
    ID do centro de custo associado ao produto
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `nome` (string, required)
    Nome do produto
    Example: "nome do produto"

  - `pesos_dimensoes` (object)
    Dimensões e pesos do produto

  - `pesos_dimensoes.altura` (number)
    Altura do produto em centímetros
    Example: 10

  - `pesos_dimensoes.largura` (number)
    Largura do produto em centímetros
    Example: 10

  - `pesos_dimensoes.peso_bruto` (number)
    Peso bruto do produto em quilogramas
    Example: 10

  - `pesos_dimensoes.peso_liquido` (number)
    Peso líquido do produto em quilogramas
    Example: 10

  - `pesos_dimensoes.profundidade` (number)
    Profundidade do produto em centímetros
    Example: 10

  - `pesos_dimensoes.volumes` (integer)
    Número de volumes do produto
    Example: 10

  - `status` (string)
    Status do produto (ATIVO ou INATIVO)
    Enum: "ATIVO", "INATIVO"

  - `unidade_medida` (object)
    Unidade de medida fiscal do kit de produto

  - `variacao` (object)
    Informações de variação do produto

  - `variacao.produtos` (array, required)
    Lista de produtos associados à variação

  - `variacao.produtos.codigo_ean` (string, required)
    Código ean do produto associado à variação
    Example: "EAN123"

  - `variacao.produtos.codigo_sku` (string, required)
    Código sku do produto associado à variação
    Example: "SKU123"

  - `variacao.produtos.nome` (string, required)
    Nome do produto associado à variação
    Example: "pacote 5kg"

  - `variacao.produtos.opcoes` (array, required)
    Lista de opções de variação do produto associado

  - `variacao.produtos.opcoes.id` (string, required)
    ID da opção de variação do produto associado à variação
    Example: "0e9b442a-3af0-45f1-9c5c-415473084092"

  - `variacao.produtos.saldo` (number, required)
    Saldo do produto associado à variação
    Example: 10

  - `variacao.produtos.valor_venda` (number, required)
    Valor de venda do produto associado à variação
    Example: 99.99

  - `variacao.tipos` (array, required)
    Lista de tipos de variação do produto

  - `variacao.tipos.descricao` (string, required)
    Descrição do tipo de variação
    Example: "pacote 5kg"

  - `variacao.tipos.opcoes` (array, required)
    Lista de opções do tipo de variação

  - `variacao.tipos.opcoes.descricao` (string, required)
    Descrição da opção de variação do tipo de variação
    Example: "5kg"

  - `variacao.tipos.opcoes.id` (string, required)
    ID da opção de variação do tipo de variação
    Example: "0e9b442a-3af0-45f1-9c5c-415473084092"

## Response 201 fields (application/json):

  - `ativo` (boolean)
    Indica se o produto está ativo
    Example: true

  - `categoria` (object)
    Grupo ou categoria do produto

  - `categoria.descricao` (string)
    Descrição do grupo ou categoria do produto
    Example: "Categoria do produto"

  - `categoria.id` (integer)
    ID do grupo ou categoria do produto
    Example: 1

  - `categoria.uuid` (string)
    UUID do grupo ou categoria do produto
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `codigo_ean` (string)
    Código de barras do produto
    Example: "EAN123"

  - `codigo_sku` (string)
    Código interno do produto
    Example: "SKU123"

  - `conversao_unidade_medida` (array)
    Conversões de unidade de medida do produto

  - `conversao_unidade_medida.fator` (number)
    Fator de conversão entre unidades
    Example: 1000

  - `conversao_unidade_medida.id_fornecedor` (array)
    Lista de IDs de fornecedores associados à conversão

  - `conversao_unidade_medida.id_unidade_conversao` (string)
    ID da conversão de unidade de medida
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `conversao_unidade_medida.unidade_medida` (object)
    Unidade de medida de entrada

  - `conversao_unidade_medida.unidade_medida.descricao` (string)
    Descrição da unidade de medida
    Example: "Unidade de Medida"

  - `conversao_unidade_medida.unidade_medida.id` (integer)
    ID da unidade de medida
    Example: 1

  - `descricao` (string)
    Descrição detalhada do produto
    Example: "Descrição do produto"

  - `detalhe_kit` (object)
    Detalhes do kit de produtos

  - `detalhe_kit.items` (array)
    Lista de itens que compõem o kit

  - `detalhe_kit.items.codigo` (string)
    Código do produto associado ao item
    Example: "SKU123"

  - `detalhe_kit.items.costCenterId` (string)
    ID do centro de custo associado ao item
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `detalhe_kit.items.id_item` (string)
    ID do item no kit
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `detalhe_kit.items.id_produto` (string)
    ID do produto associado ao item
    Example: "0e9b442a-3af0-45f1-9c5c-415473084092"

  - `detalhe_kit.items.nome` (string)
    Nome do produto associado ao item
    Example: "item do kit"

  - `detalhe_kit.items.quantidade` (number)
    Quantidade do produto no kit
    Example: 2

  - `detalhe_kit.items.valor_total` (number)
    Valor total do item no kit
    Example: 40

  - `detalhe_kit.items.valor_unitario` (number)
    Valor unitário do produto no kit
    Example: 20

  - `detalhe_kit.items.versao` (integer)
    Versão do item no kit
    Example: 1

  - `detalhe_kit.valor_venda_kit` (number)
    Valor de venda do kit
    Example: 40

  - `ecommerce` (object)
    Informações de e-commerce do produto

  - `ecommerce.categoria_ecommerce` (object)
    Categoria do produto no e-commerce

  - `ecommerce.categoria_ecommerce.descricao` (string)
    Descrição da categoria do produto no e-commerce
    Example: "Descrição da categoria do produto"

  - `ecommerce.categoria_ecommerce.id` (string)
    ID da categoria do produto no e-commerce
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `ecommerce.condicao` (string)
    Condição do produto
    Enum: "NOVO", "USADO"

  - `ecommerce.descricao_adicional` (string)
    Descrição adicional do produto para e-commerce
    Example: "Descrição adicional do produto"

  - `ecommerce.descricao_seo` (string)
    Descrição SEO do produto
    Example: "Descrição SEO do produto"

  - `ecommerce.integracao_ativa` (boolean)
    Indica se a integração de e-commerce está ativa
    Example: true

  - `ecommerce.marca` (object)
    Marca do produto

  - `ecommerce.marca.id` (string)
    ID da marca do produto
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `ecommerce.marca.nome` (string)
    Nome da marca do produto
    Example: "Marca do Produto"

  - `ecommerce.titulo_seo` (string)
    Título SEO do produto
    Example: "Título SEO do produto"

  - `ecommerce.url_seo` (string)
    URL SEO do produto
    Example: "https://www.exemplo.com/produto"

  - `estoque` (object)
    Informações de estoque do produto

  - `estoque.custo_medio` (number)
    Custo médio do produto
    Example: 10

  - `estoque.maximumStock` (number)
    Estoque máximo do produto
    Example: 10

  - `estoque.minimumStock` (number)
    Estoque mínimo do produto
    Example: 10

  - `estoque.quantidade_disponivel` (number)
    Saldo disponível do produto
    Example: 10

  - `estoque.quantidade_reservada` (number)
    Saldo reservado do produto
    Example: 10

  - `estoque.quantidade_total` (number)
    Saldo total do estoque do produto
    Example: 10

  - `estoque.valor_venda` (number)
    Valor de venda do produto
    Example: 10

  - `fiscal` (object)
    Informações fiscais do produto

  - `fiscal.cest` (object)
    CEST (Código Especificador da Substituição Tributária) do produto

  - `fiscal.cest.codigo` (string)
    Código do CEST
    Example: "1234"

  - `fiscal.cest.descricao` (string)
    Descrição do CEST
    Example: "Descrição do CEST"

  - `fiscal.cest.id` (integer)
    ID do CEST
    Example: 1

  - `fiscal.ncm` (object)
    NCM (Nomenclatura Comum do Mercosul) do produto

  - `fiscal.ncm.codigo` (string)
    Código do NCM
    Example: "1234"

  - `fiscal.ncm.descricao` (string)
    Descrição do NCM
    Example: "Descrição do NCM"

  - `fiscal.ncm.id` (integer)
    ID do NCM
    Example: 1

  - `fiscal.origem` (string)
    Origem do produto
    Enum: "NACIONAL", "ESTRANGEIRA_IMPORTACAO_DIRETA", "ESTRANGEIRA_ADQUIRIDA_INTERNAMENTE", "NACIONAL_IMPORTACAO_SUPERIOR_40", "NACIONAL_PRODUCAO_CONFORMIDADE", "NACIONAL_IMPORTACAO_INFERIOR_40", "ESTRANGEIRA_IMPORTACAO_DIRETA_CAMEX", "ESTRANGEIRA_ADQUIRIDA_INTERNAMENTE_CAMEX", "NACIONAL_MERCDORIA_BEM_IMPORTACAO_SUPERIOR_70"

  - `fiscal.tipo_produto` (string)
    Tipo do produto
    Enum: "MERCADORIA_PARA_REVENDA", "MATERIA_PRIMA", "EMBALAGEM", "PRODUTO_EM_PROCESSO", "PRODUTO_ACABADO", "SUBPRODUTO", "PRODUTO_INTERMEDIARIO", "MATERIAL_DE_USO_E_CONSUMO", "ATIVO_IMOBILIZADO", "SERVICOS", "OUTROS_INSUMOS", "OUTRAS"

  - `fiscal.unidade_medida` (object)
    Unidade de medida do produto

  - `fiscal.unidade_medida.descricao` (string)
    Descrição da unidade de medida fiscal
    Example: "Descrição da unidade de medida fiscal"

  - `fiscal.unidade_medida.id` (integer)
    ID da unidade de medida fiscal
    Example: 1

  - `formato` (string)
    Formato do produto
    Enum: "SIMPLES", "VARIACAO"

  - `id` (string)
    ID do produto no sistema legado
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `id_centro_custo` (string)
    ID do centro de custo associado ao produto
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `id_legado` (integer)
    ID do produto no sistema legado
    Example: 78305

  - `imagens` (array)
    Lista de imagens do produto

  - `imagens.descricao` (string)
    Descrição da imagem do produto
    Example: "Descrição da imagem do produto"

  - `imagens.id` (string)
    ID da imagem do produto
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `imagens.nome` (string)
    Nome da imagem do produto
    Example: "imagem do produto"

  - `imagens.tamanho` (integer)
    Tamanho da imagem do produto em bytes
    Example: 1024

  - `nome` (string)
    Nome do produto
    Example: "nome do produto"

  - `pesos_dimensoes` (object)
    Dimensões e pesos do produto

  - `pesos_dimensoes.altura` (number)
    Altura do produto em centímetros
    Example: 10

  - `pesos_dimensoes.largura` (number)
    Largura do produto em centímetros
    Example: 15

  - `pesos_dimensoes.peso_bruto` (number)
    Peso bruto do produto em quilogramas
    Example: 1.5

  - `pesos_dimensoes.peso_liquido` (number)
    Peso líquido do produto em quilogramas
    Example: 1

  - `pesos_dimensoes.profundidade` (number)
    Profundidade do produto em centímetros
    Example: 5

  - `pesos_dimensoes.volumes` (integer)
    Número de volumes do produto
    Example: 10

  - `status` (string)
    Status atual do produto
    Enum: "ATIVO", "INATIVO"

  - `ultima_atualizacao` (string)
    Data da última atualização do produto
    Example: "2025-07-22T17:47:35.825004839Z"

  - `unidade_medida` (object)
    Unidade de medida fiscal do produto

  - `variacao` (object)
    Informações de variação do produto

  - `variacao.produtos` (array)
    Lista de produtos com variações

  - `variacao.produtos.codigo_ean` (string)
    Código ean do produto com variação
    Example: "Código EAN do produto com variação"

  - `variacao.produtos.codigo_sku` (string)
    Código sku do produto com variação
    Example: "Código SKU do produto com variação"

  - `variacao.produtos.id` (string)
    ID do produto com variação
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `variacao.produtos.movido` (boolean)
    Indica se o produto com variação foi movido

  - `variacao.produtos.nome` (string)
    Nome do produto com variação
    Example: "Nome do produto com variação"

  - `variacao.produtos.opcoes` (array)
    Lista de opções do produto com variação

  - `variacao.produtos.opcoes.descricao` (string)
    Descrição da opção de variação do produto
    Example: "Descrição da opção de variação do produto"

  - `variacao.produtos.opcoes.id` (string)
    ID da opção de variação do produto
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `variacao.produtos.relacionado_manualmente` (boolean)
    Indica se o produto com variação está relacionado manualmente
    Example: true

  - `variacao.produtos.saldo` (number)
    Saldo do produto com variação
    Example: 10

  - `variacao.produtos.valor_venda` (number)
    Valor de venda do produto com variação
    Example: 100

  - `variacao.produtos.versao` (integer)
    Versão do produto com variação
    Example: 1

  - `variacao.tipos` (array)
    Lista de tipos de variação do produto

  - `variacao.tipos.descricao` (string)
    Descrição do tipo de variação
    Example: "Descrição do tipo de variação"

  - `variacao.tipos.id` (string)
    ID do tipo de variação
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `variacao.tipos.opcoes` (array)
    Lista de opções do tipo de variação

  - `variacao.tipos.opcoes.descricao` (string)
    Descrição da opção de variação
    Example: "Descrição da opção de variação"

  - `variacao.tipos.opcoes.id` (string)
    ID da opção de variação
    Example: "9aa9af47-a539-40fc-9005-85c70e757fcf"

  - `versao` (integer)
    Versão do produto
    Example: 1

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"

## Response 409 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"