Criar um novo produto

Produtos

Request

Permite criar um novo produto, informando dados como nome, código interno, unidade de medida, categoria, preço, estoque inicial, entre outros parâmetros. Ideal para automatizar o cadastro de itens novos no sistema.

Security

BearerAuth

Bodyapplication/jsonrequired

Dados do produto a ser criado

ativoboolean

Indica se o produto está ativo

Example:true

categoriaobject(CriacaoGrupoProduto)

Grupo ou categoria do produto

codigo_eanstring

Código EAN do produto

Example:"EAN123"

codigo_skustring, <= 20 characters

Código SKU do produto

Example:"SKU123"

conversoes_unidade_medidaArray of objects(CriacaoConversaoUnidadeMedidaProduto)

Conversões de unidade de medida do produto, depende da unidade de medida das informações fiscais

descricaostring, <= 400 characters

Descrição do produto

Example:"Descrição do produto"

detalhe_kitobject(CriacaoDetalheKitProduto)

Detalhes do kit de produto

ecommerceobject(CriacaoEcommerceProduto)

Informações de e-commerce do produto

estoqueobject(CriacaoEstoqueProduto)

Informações de estoque do produto

fiscalobject(CriacaoFiscalProduto)

Informações fiscais do produto

formatostring(FormatoDoProduto)

Formato do produto (SIMPLES ou VARIACAO)

Enum:"SIMPLES""VARIACAO"

id_centro_custostring

ID do centro de custo associado ao produto

Example:"9aa9af47-a539-40fc-9005-85c70e757fcf"

nomestring, <= 100 charactersrequired

Nome do produto

Example:"nome do produto"

pesos_dimensoesobject(CriacaoDimensoesPesosProduto)

Dimensões e pesos do produto

statusstring(StatusDoProduto)

Status do produto (ATIVO ou INATIVO)

Enum:"ATIVO""INATIVO"

unidade_medidaobject(CriacaoUnidadeMedidaFiscalProduto)

Unidade de medida fiscal do kit de produto

variacaoobject(CriacaoVariacaoProduto)

Informações de variação do produto

curl -i -X POST \
  https://api-v2.contaazul.com/v1/produtos \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "ativo": true,
    "categoria": {
      "id": 1
    },
    "codigo_ean": "EAN123",
    "codigo_sku": "SKU123",
    "conversoes_unidade_medida": [
      {
        "fator": 1000,
        "id_fornecedor": [
          "string"
        ],
        "unidade_medida": {
          "id": 1
        }
      }
    ],
    "descricao": "Descrição do produto",
    "detalhe_kit": {
      "itens": [
        {
          "id_produto": "0e9b442a-3af0-45f1-9c5c-415473084092",
          "quantidade": 1,
          "valor_total": 100,
          "valor_unitario": 100
        }
      ],
      "valor_venda": 100
    },
    "ecommerce": {
      "categoria_ecommerce": {
        "id": "0e9b442a-3af0-45f1-9c5c-415473084092"
      },
      "condicao": "NOVO",
      "descricao_adicional": "Descrição adicional do produto",
      "descricao_seo": "Descrição SEO do produto",
      "integracao_ativa": true,
      "marca": {
        "id": "0e9b442a-3af0-45f1-9c5c-415473084092"
      },
      "titulo_seo": "Título SEO do produto",
      "url_seo": "https://www.exemplo.com/produto"
    },
    "estoque": {
      "custo_medio": 80,
      "estoque_disponivel": 50,
      "estoque_maximo": 100,
      "estoque_minimo": 10,
      "valor_venda": 100
    },
    "fiscal": {
      "cest": {
        "id": 1
      },
      "ncm": {
        "id": 1
      },
      "origem": "NACIONAL",
      "tipo_produto": "MERCADORIA_PARA_REVENDA",
      "unidade_medida": {
        "id": 1
      }
    },
    "formato": "SIMPLES",
    "id_centro_custo": "9aa9af47-a539-40fc-9005-85c70e757fcf",
    "nome": "nome do produto",
    "pesos_dimensoes": {
      "altura": 10,
      "largura": 10,
      "peso_bruto": 10,
      "peso_liquido": 10,
      "profundidade": 10,
      "volumes": 10
    },
    "status": "ATIVO",
    "unidade_medida": {
      "id": 1
    },
    "variacao": {
      "produtos": [
        {
          "codigo_ean": "EAN123",
          "codigo_sku": "SKU123",
          "nome": "pacote 5kg",
          "opcoes": [
            {
              "id": "0e9b442a-3af0-45f1-9c5c-415473084092"
            }
          ],
          "saldo": 10,
          "valor_venda": 99.99
        }
      ],
      "tipos": [
        {
          "descricao": "pacote 5kg",
          "opcoes": [
            {
              "descricao": "5kg",
              "id": "0e9b442a-3af0-45f1-9c5c-415473084092"
            }
          ]
        }
      ]
    }
  }'

Responses

Created

Bodyapplication/json

ativoboolean

Indica se o produto está ativo

Example:true

categoriaobject(CategoriaDoProduto)

Grupo ou categoria do produto

codigo_eanstring

Código de barras do produto

Example:"EAN123"

codigo_skustring

Código interno do produto

Example:"SKU123"

conversao_unidade_medidaArray of objects(ConversaoDeUnidadeDeMedidaDoProduto)

Conversões de unidade de medida do produto

descricaostring

Descrição detalhada do produto

Example:"Descrição do produto"

detalhe_kitobject(DetalheDoKitDeProdutos)

Detalhes do kit de produtos

ecommerceobject(EcommerceDoProduto)

Informações de e-commerce do produto

estoqueobject(EstoqueDoProduto)

Informações de estoque do produto

fiscalobject(FiscalDoProduto)

Informações fiscais do produto

formatostring(FormatoDoProduto)

Formato do produto

Enum:"SIMPLES""VARIACAO"

Example:"SIMPLES"

idstring

ID do produto no sistema legado

Example:"9aa9af47-a539-40fc-9005-85c70e757fcf"

id_centro_custostring

ID do centro de custo associado ao produto

Example:"9aa9af47-a539-40fc-9005-85c70e757fcf"

id_legadointeger

ID do produto no sistema legado

Example:78305

imagensArray of objects(ImagemDoProduto)

Lista de imagens do produto

nomestring

Nome do produto

Example:"nome do produto"

pesos_dimensoesobject(DimensoesDoProduto)

Dimensões e pesos do produto

statusstring(StatusDoProduto)

Status atual do produto

Enum:"ATIVO""INATIVO"

Example:"ATIVO"

ultima_atualizacaostring

Data da última atualização do produto

Example:"2025-07-22T17:47:35.825004839Z"

unidade_medidaobject(FiscalUnidadeDeMedidaDoProduto)

Unidade de medida fiscal do produto

variacaoobject(VariacaoDoProduto)

Informações de variação do produto

versaointeger

Versão do produto

Example:1

Response

{
  "ativo": true,
  "categoria": {
    "descricao": "Categoria do produto",
    "id": 1,
    "uuid": "9aa9af47-a539-40fc-9005-85c70e757fcf"
  },
  "codigo_ean": "EAN123",
  "codigo_sku": "SKU123",
  "conversao_unidade_medida": [
    { … }
  ],
  "descricao": "Descrição do produto",
  "detalhe_kit": {
    "items": [ … ],
    "valor_venda_kit": 40
  },
  "ecommerce": {
    "categoria_ecommerce": { … },
    "condicao": "NOVO",
    "descricao_adicional": "Descrição adicional do produto",
    "descricao_seo": "Descrição SEO do produto",
    "integracao_ativa": true,
    "marca": { … },
    "titulo_seo": "Título SEO do produto",
    "url_seo": "https://www.exemplo.com/produto"
  },
  "estoque": {
    "custo_medio": 10,
    "maximumStock": 10,
    "minimumStock": 10,
    "quantidade_disponivel": 10,
    "quantidade_reservada": 10,
    "quantidade_total": 10,
    "valor_venda": 10
  },
  "fiscal": {
    "cest": { … },
    "ncm": { … },
    "origem": "NACIONAL",
    "tipo_produto": "EMBALAGEM",
    "unidade_medida": { … }
  },
  "formato": "SIMPLES",
  "id": "9aa9af47-a539-40fc-9005-85c70e757fcf",
  "id_centro_custo": "9aa9af47-a539-40fc-9005-85c70e757fcf",
  "id_legado": 78305,
  "imagens": [
    { … }
  ],
  "nome": "nome do produto",
  "pesos_dimensoes": {
    "altura": 10,
    "largura": 15,
    "peso_bruto": 1.5,
    "peso_liquido": 1,
    "profundidade": 5,
    "volumes": 10
  },
  "status": "ATIVO",
  "ultima_atualizacao": "2025-07-22T17:47:35.825004839Z",
  "unidade_medida": {
    "descricao": "Descrição da unidade de medida fiscal",
    "id": 1
  },
  "variacao": {
    "produtos": [ … ],
    "tipos": [ … ]
  },
  "versao": 1
}