Consultar SKUs

Retorna a lista completa de produtos disponíveis para o vendedor, organizando os resultados em páginas para facilitar a navegação e otimizar o desempenho em consultas de grandes volumes de dados.

Escopo requerido

Valor	Descrição
open:portfolio-skus-seller:read	Permite a leitura de dados do SKU

Endpoint

Verbo	URL
GET	/seller/v1/portfolios/skus

Parâmetros de consulta

Campo	Tipo	Descrição	Obrigatório
_limit	Inteiro	Determina a quantidade de registros a serem retornados. Valor padrão 50.	Nāo
_offset	Inteiro	Posição de registro de referência, a partir dele serão retornados os próximos N registros. Valor padrão 0.	Nāo

Chamada:

curl -X GET --location 'https://api.magalu.com/seller/v1/portfolios/skus' \
--header 'accept: application/json' \
--header 'X-Language: por' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <Access Token>'

Resposta:

{
    "meta": {
        "page": {
            "limit": 10,
            "offset": 0,
            "count": 10,
            "max_limit": 100
        },
        "links": {
            "previous": "/seller/v1/portfolios/skus?_limit=10&_offset=0",
            "next": "/seller/v1/portfolios/skus?_limit=10&_offset=10",
            "self": "/seller/v1/portfolios/skus?_limit=10&_offset=0"
        }
    },
  "results": [
   {
      "sku": "2024-1508-001",
      "title": "Chuteira Campo Umbro Orbit Unissex",
      "description": "Os boleiros vão dominar as quatro linhas e garantir a vitória com a Chuteira ...",
      "status": "PUBLISHED",
      "url_marketplace": [
          {
              "channel": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
              "url": "https://www.magazineluiza.com.br/chuteira-futsal-umbro-orbit-unissex/p/jgfegcg92g/es/cutr/"
          }
      ],
      "condition": "NEW",
      "perishable": false,
      "brand": "Umbro",
      "group": {
          "id": "66bcbb1c5d918c40185b817d",
          "main_variation": true
      },
      "channels": [
          {
              "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          }
      ],
      "identifiers": [
          {
              "type": "isbn",
              "value": "1234567890111"
          },
          {
              "type": "ean",
              "value": "7890078279087"
          }
      ],
      "has_ean": true,
      "datasheet": [
          {
              "name": "Tipo",
              "value": "Society"
          },
          {
              "name": "Material",
              "value": "Sintetico"
          }
      ],
      "attributes": [
          {
              "name": "Cor",
              "value": "Azul+Laranja"
          },
          {
              "name": "Tamanho",
              "value": "42"
          }
      ],
      "dimensions": [
          {
              "name": "package",
              "height": {
                  "value": 24,
                  "unit": "cm"
              },
              "width": {
                  "value": 24,
                  "unit": "cm"
              },
              "length": {
                  "value": 35,
                  "unit": "cm"
              },
              "weight": {
                  "value": 690,
                  "unit": "g"
              }
          },
          {
              "name": "product",
              "height": {
                  "value": 15,
                  "unit": "cm"
              },
              "width": {
                  "value": 18,
                  "unit": "cm"
              },
              "length": {
                  "value": 28,
                  "unit": "cm"
              },
              "weight": {
                  "value": 279,
                  "unit": "g"
              }
          }
      ],
      "images": [
          {
              "type": "image/jpeg",
              "reference": "https://files-product.magalu.com/65ef5538b65bd5399bce2017.jpeg"
          }
      ],
      "videos": [
          {
              "type": "embedded",
              "reference": "https://www.youtube.com/watch?v=CFft8R3sdcg"
          }
      ],
      "podcasts": [
          {
              "type": "embedded",
              "reference": "https://www.youtube.com/watch?v=CFft8R3sdcg"
          }
      ],
      "fulfillment": false,
      "active": true,
      "type": "product",
      "extra_data": [
          {
              "name": "ncm",
              "value": "8517.61.30"
          }
      ],
      "creator": "creator",
      "created_at": "2024-06-15T16:55:34Z",
      "updater": "updater",
      "updated_at": "2024-08-16T12:32:21Z"
    }
  ]
}

Códigos de retorno

Código	Descrição
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Internal Server Error
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout