MarketplacePortfólio de produtosProdutosRecuperar uma posição ou lista de produtos

Recuperar produto

Recuperar um produto

Retorna os detalhes de um produto específico.

Escopo necessário

Valor do escopoDescrição
portfolio:readPermite acessar um SKU.

Parâmetros da URL

CampoTipoDescriçãoObrigatório
idObjectIdIdentificação gerada pelo Eu Preciso quando da criação do SKU.Sim

Chamada:

GET /v1.0/marketplace/portfolios/{id} \
Host: apps.eupreciso.com.br \
Authorization: Bearer {access_token} \
Content-Type: application/json \

Resposta:

{
  "id": "6712a764c37c38e9039093e4",
  "created_at": "2024-10-18T18:22:28.307+00:00",
  "code": "CAMISETA_BRANCA_P",
  "title": {
    "pt_BR": "Camiseta Branca P",
    "en_US": "White T-shirt S"
  },
  "variation_key": "CAMISETAS_PMG",
  "condition": "new",
  "brand": "Marca Exemplo",
  "tags": ["camiseta", "branca", "algodão"],
  "available": true,
  "origin": "national",
  "datasheet": {
    "reference": "https://www.exemplo.com/ficha-tecnica"
  },
  "dimensions": [
    {
      "name": "product",
      "height": {
        "value": 70.5,
        "unit": "cm"
      },
      "width": {
        "value": 45,
        "unit": "cm"
      },
      "length": {
        "value": 1,
        "unit": "cm"
      },
      "weight": {
        "value": 300,
        "unit": "g"
      }
    },
    {
      "name": "package",
      "height": {
        "value": 80,
        "unit": "cm"
      },
      "width": {
        "value": 50,
        "unit": "cm"
      },
      "length": {
        "value": 5,
        "unit": "cm"
      },
      "weight": {
        "value": 350,
        "unit": "g"
      }
    }
  ],
  "description": {
    "pt_BR": {
      "verbose_value": "Camiseta branca de algodão, tamanho pequeno, confortável para o dia a dia.",
      "simplified_value": "Camiseta branca P de algodão"
    },
    "en_US": {
      "verbose_value": "White cotton t-shirt, small size, comfortable for everyday wear.",
      "simplified_value": "White t-shirt S cotton"
    }
  },
  "identifiers": [
    {
      "type": "EAN",
      "value": "1234567890123"
    }
  ],
  "attributes": {
    "variant": [
      {
        "name": "cor",
        "value": "branca",
        "display": {
          "pt_BR": {
            "name": "Cor",
            "value": "Branca",
            "simplified_value": "Branca"
          }
        }
      }
    ],
    "optional": [
      {
        "name": "composição",
        "value": "100% algodão",
        "display": {
          "pt_BR": {
            "name": "Composição",
            "value": "100% algodão",
            "simplified_value": "Algodão"
          }
        }
      }
    ]
  },
  "medias": [
    {
      "name": "Imagem Principal",
      "type": "image",
      "reference": "https://www.exemplo.com/imagem-camiseta-branca.jpg"
    }
  ],
  "extras": {
    "observacao": "Produto recomendado para dias quentes."
  }
}

Recuperar uma lista de produtos

Retorna todos os produtos disponíveis.

Nota: Este endpoint implementa paginação, ordenação e filtros. Para saber mais, consulte Paginação, filtros e ordenação.

Escopo requerido

Valor do escopoDescrição
portfolio:readPermite listar os SKUs.

Parâmetros de consulta

CampoTipoDescriçãoObrigatório
code__instringRetorna os produtos com os códigos listados.Não
variation_keystringRetorna as variações de produto de uma amarração.Não
variation_key__instringRetorna as variações de produto de várias amarrações.Não

Parâmetros de ordenação

CampoDescriçãoObrigatório
created_atOrdenar por data de criação dos SKUs.Não

Chamada:

GET /v1.0/marketplace/portfolios/skus?_limit=10&_offset=0 \
Host: apps.eupreciso.com.br \
Authorization: Bearer {access_token} \
Content-Type: application/json \

Resposta:

{
  "meta": {
    "page": {
      "limit": 10,
      "offset": 0,
      "count": 10,
      "max_limit": 50
    }
  },
  "results": [
    {
      "id": "6712a764c37c38e9039093e4",
      "created_at": "2024-10-18T18:22:28.307+00:00",
      "code": "CAMISETA_BRANCA_P",
      "title": {
        "pt_BR": "Camiseta Branca P",
        "en_US": "White T-shirt S"
      },
      "variation_key": "CAMISETAS_PMG",
      "condition": "new",
      "brand": "Marca Exemplo",
      "tags": ["camiseta", "branca", "algodão"],
      "available": true,
      "origin": "national",
      "datasheet": {
        "reference": "https://www.exemplo.com/ficha-tecnica"
      },
      "dimensions": [
        {
          "name": "product",
          "height": {
            "value": 70.5,
            "unit": "cm"
          },
          "width": {
            "value": 45,
            "unit": "cm"
          },
          "length": {
            "value": 1,
            "unit": "cm"
          },
          "weight": {
            "value": 300,
            "unit": "g"
          }
        },
        {
          "name": "package",
          "height": {
            "value": 80,
            "unit": "cm"
          },
          "width": {
            "value": 50,
            "unit": "cm"
          },
          "length": {
            "value": 5,
            "unit": "cm"
          },
          "weight": {
            "value": 350,
            "unit": "g"
          }
        }
      ],
      "description": {
        "pt_BR": {
          "verbose_value": "Camiseta branca de algodão, tamanho pequeno, confortável para o dia a dia.",
          "simplified_value": "Camiseta branca P de algodão"
        },
        "en_US": {
          "verbose_value": "White cotton t-shirt, small size, comfortable for everyday wear.",
          "simplified_value": "White t-shirt S cotton"
        }
      },
      "identifiers": [
        {
          "type": "EAN",
          "value": "1234567890123"
        }
      ],
      "attributes": {
        "variant": [
          {
            "name": "cor",
            "value": "branca",
            "display": {
              "pt_BR": {
                "name": "Cor",
                "value": "Branca",
                "simplified_value": "Branca"
              }
            }
          }
        ],
        "optional": [
          {
            "name": "composição",
            "value": "100% algodão",
            "display": {
              "pt_BR": {
                "name": "Composição",
                "value": "100% algodão",
                "simplified_value": "Algodão"
              }
            }
          }
        ]
      },
      "medias": [
        {
          "name": "Imagem Principal",
          "type": "image",
          "reference": "https://www.exemplo.com/imagem-camiseta-branca.jpg"
        }
      ],
      "extras": {
        "observacao": "Produto recomendado para dias quentes."
      }
    }
  ]
}