Consultar preço

Permite consultar o preço cadastrado para a venda de um produto específico, fornecendo informações detalhadas sobre o valor. Essa funcionalidade facilita o acompanhamento de preços, permitindo ao vendedor verificar rapidamente o valor definido para o produto.

Escopo requerido

Valor	Descrição
open:portfolio-prices-seller:read	Permite a leitura dos preços do SKU

Endpoint

Verbo	URL
GET	/seller/v1/portfolios/prices/{sku}

Parâmetros da URL

Propriedade	Tipo	Descrição	Obrigatório
sku	string	Identificação do produto	Sim

Parâmetros de ordenação

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/prices/{sku} \
--header 'accept: application/json' \
--header 'X-Language: por' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <Access Token>'

Resposta:

200 OK
{
    "meta": {
        "page": {
            "limit": 10,
            "offset": 0,
            "count": 10,
            "max_limit": 100
        },
        "links": {
            "previous": "/seller/v1/portfolios/prices?_limit=10&_offset=0",
            "next": "/seller/v1/portfolios/prices?_limit=10&_offset=10",
            "self": "/seller/v1/portfolios/prices?_limit=10&_offset=0"
        }
    },
    "results": [
        {
            "list_price": 9999,
            "price": 9990,
            "currency": "BRL",
            "normalizer": 100,
            "channel": {
                "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            },
            "created_at": "2024-06-15T16:55:34Z",
            "updated_at": "2024-08-14T11:23:12Z"
        }
    ]
}

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