---
title: "ProductResponse"
url: "https://devcenter.stone.com.br/apis/stone-catalog/versions/502db258-cb08-4b38-8af1-b96a688b9a9e/schemas/ProductResponse"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-catalog/versions/502db258-cb08-4b38-8af1-b96a688b9a9e.md

# ProductResponse

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Stone Catalog API
  version: 1.0.0
servers:
  - url: https://sdx.api.stone.com.br/v1/catalog
    description: Ambiente de Desenvolvimento (SDX)
  - url: https://api.stone.com.br/v1/catalog
    description: Ambiente de Produção (PRD)
components:
  schemas:
    ProductResponse:
      type: object
      required:
        - id
        - name
        - categoryPath
        - images
        - metadata
      properties:
        id:
          type: string
          format: uuid
          description: Identificador único do produto
          example: 550e8400-e29b-41d4-a716-446655440000
        barcode:
          type: string
          nullable: true
          description: Código de barras EAN-13
          pattern: ^\d{12,13}$
          example: "7891000100103"
        name:
          type: string
          description: Nome do produto
          example: Coca-Cola 2L
        shortDescription:
          type: string
          nullable: true
          description: Descrição curta do produto
          example: Refrigerante Coca-Cola 2 Litros
        longDescription:
          type: string
          nullable: true
          description: Descrição detalhada do produto
          example: Refrigerante Coca-Cola sabor original em garrafa PET de 2 litros.
            Produto ideal para toda a família.
        brand:
          type: string
          nullable: true
          description: Marca do produto
          example: Coca-Cola
        manufacturer:
          type: string
          nullable: true
          description: Fabricante do produto
          example: Coca-Cola Brasil
        categoryPath:
          type: string
          description: Caminho completo da categoria
          example: Alimentos e Bebidas > Bebidas > Refrigerantes
        images:
          type: array
          description: Lista de URLs das imagens do produto
          items:
            type: string
            format: uri
            example: https://s3.amazonaws.com/stone-catalog/products/550e8400-e29b-41d4-a716-446655440000/image1.jpg
        attributes:
          type: object
          nullable: true
          description: Atributos específicos do produto (pares chave-valor)
          additionalProperties:
            type: string
          example:
            volume: 2L
            sabor: Original
            tipo: Refrigerante
        weightKg:
          type: number
          nullable: true
          format: float
          description: Peso do produto em quilogramas
          example: 2.1
        heightCm:
          type: number
          nullable: true
          format: float
          description: Altura do produto em centímetros
          example: 32.5
        widthCm:
          type: number
          nullable: true
          format: float
          description: Largura do produto em centímetros
          example: 10.5
        depthCm:
          type: number
          nullable: true
          format: float
          description: Profundidade do produto em centímetros
          example: 10.5
        price:
          type: string
          nullable: true
          format: string
          description: Faixa de preço do produto em reais. Retorna null quando não
            disponível.
          example: R$ 7.50
        metadata:
          type: object
          required:
            - version
            - confidenceScore
            - discoveredAt
            - updatedAt
            - lastScrapedAt
          properties:
            version:
              type: integer
              description: Versão do registro do produto
              example: 1
            confidenceScore:
              type: number
              format: float
              minimum: 0
              maximum: 1
              description: Score de confiança dos dados (0.00 - 1.00)
              example: 0.95
            discoveredAt:
              type: string
              format: date-time
              description: Data/hora em que o produto foi descoberto
              example: 2024-01-15T10:30:00Z
            updatedAt:
              type: string
              format: date-time
              description: Data/hora da última atualização
              example: 2024-01-15T10:30:00Z
            lastScrapedAt:
              type: string
              format: date-time
              description: Data/hora do último scraping
              example: 2024-01-15T10:30:00Z
```