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.

📥 Exemplo de requisição

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:

{
  "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:

{
  "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
        }
      }
    ]
  }
}

Consulte a descrição de cada campo retornado na referência:

Swagger UIapi.toplojas.com.br