Retornar o produto por id

Request

Traz todos os detalhes de um produto específico (estoque, fiscal, e-commerce, variações, pesos, unidades, etc.). Ideal para consultar dados completos antes de exibir para usuário ou para sincronização.

Security

BearerAuth

Path

idstringrequired

id do produto

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/produtos/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

OK

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
}