> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/produtos/detalhes-do-produto.md).

# Detalhes do Produto

Retorna os **dados completos** de um produto específico, identificado pelo seu **Código**.

```
GET /produtos/{Codigo}/
```

O `{Codigo}` é o código do produto, obtido na [listagem de produtos](/produtos/listar-produtos.md).

## 📥 Exemplo de requisição

```bash
curl -X GET "https://api.toplojas.com.br/produtos/1287407/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

## 📤 O que é retornado

Os detalhes de um produto incluem, entre outros:

| Grupo             | Conteúdo                                                  |
| ----------------- | --------------------------------------------------------- |
| **Identificação** | Nome, SKU, GTIN, EAN, Código de Importação                |
| **Preços**        | Preço normal, promocional e de custo                      |
| **Dimensões**     | Peso, altura, largura e comprimento                       |
| **Departamentos** | Departamento principal e demais departamentos             |
| **Estoque**       | Tipo (`P` produto / `V` variação) e quantidade disponível |
| **Variações**     | Campos e listagem de variações (quando houver)            |
| **Fotos**         | Imagens do produto (com indicação da capa)                |
| **Atributos**     | Grupos e itens de atributos (composição, gênero etc.)     |

Exemplo de um produto **sem variação** retornado:

```json
{
  "Nome": "Teste1",
  "SKU": "T1",
  "Status": "A",
  "PrecoNormal": 234.56,
  "PrecoPromocional": 120.2,
  "PrecoCusto": 100.96,
  "Tags": "Teste1 Teste1 Teste1 Teste1 Teste1",
  "Fabricante": "TesteFabricante1",
  "Marca": "TesteMarca1",
  "Dim_Altura": 1.548,
  "Dim_Largura": 2.323,
  "Dim_Comprimento": 4.323,
  "Peso": 12.34,
  "DepartamentoPrincipal": "Livros > Aventura",
  "Departamentos": [
    "Livros",
    "Livros > Aventura",
    "Livros > Romance",
    "Escolar",
    "Escolar > Livros"
  ],
  "GTIN": "TesteGTIN1",
  "EAN": "TesteEAN1",
  "CodigoImportacao": "IMP100",
  "LinkSlug": "https://www.teste.com.br/conjuntos/teste1/",
  "Estoque": {
    "Tipo": "P",
    "Disponivel": 125
  },
  "Descricao": {
    "Texto": "TesteDescricao1"
  },
  "Relacionados": [
    1188323,
    1187878,
    1187877
  ],
  "Fotos": [
    {
      "Foto": "data:image/png;base64,XXXXXXX",
      "IsCapa": true
    }
  ],
  "Atributos": [
    {
      "Grupo": "Composicao",
      "Item": "Exemplo de Composicao 1"
    },
    {
      "Grupo": "Genero",
      "Item": "Exemplo de Genero 1"
    },
    {
      "Grupo": "Mataria Prima",
      "Item": "Exemplo de Mataria Prima 1"
    }
  ]
}
```

Quando o produto **tem variação**, o `Estoque.Tipo` vem como `V` e as variações são listadas em `Variacoes.Listagem`, cada uma com seu próprio SKU, GTIN, EAN, preço e estoque:

```json
{
  "Nome": "Teste1",
  "SKU": "T1",
  "Status": "A",
  "Estoque": {
    "Tipo": "V"
  },
  "Variacoes": {
    "CampoAIs": true,
    "CampoA": "Cor",
    "CampoBIs": false,
    "CampoB": "",
    "Listagem": [
      {
        "CampoA": "Azul",
        "CampoB": "",
        "SKU": "Azul_SKU",
        "GTIN": "Azul_GTIN",
        "EAN": "Azul_EAN",
        "PrecoTipo": "N",
        "PrecoValor": 0,
        "PesoTipo": "N",
        "PesoValor": 0,
        "Estoque": {
          "Disponivel": 100
        }
      },
      {
        "CampoA": "Preto",
        "CampoB": "",
        "SKU": "Preto_SKU",
        "GTIN": "Preto_GTIN",
        "EAN": "Preto_EAN",
        "PrecoTipo": "F",
        "PrecoValor": 250.26,
        "PesoTipo": "F",
        "PesoValor": 2.32,
        "Estoque": {
          "Disponivel": 200
        }
      }
    ]
  }
}
```

{% hint style="info" %}
Consulte a descrição de cada campo retornado na referência:

{% embed url="<https://api.toplojas.com.br/doc/#/Produtos>" %}
{% endhint %}