Consultar estoque

Permite consultar a quantidade de estoque disponível para a venda de um produto, além de verificar se existem reservas ativas associadas a ele. Essa funcionalidade oferece uma visão detalhada do status de disponibilidade do item, facilitando o controle e planejamento de vendas.

Escopo requerido

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

Endpoint

Verbo	URL
GET	/seller/v1/portfolios/stocks/{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/stocks/{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/stocks?_limit=10&_offset=0",
                "next": "/seller/v1/portfolios/stocks?_limit=10&_offset=10",
                "self": "/seller/v1/portfolios/stocks?_limit=10&_offset=0"
            }
        },
        "results": [
            {
                "type": "AVAILABLE",
                "quantity": 5,
                "channel": {
                    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                },
                "created_at": "2024-06-15T16:55:34Z",
                "updated_at": "2024-08-14T11:23:12Z"
            },
            {
                "type": "RESERVED",
                "quantity": 1,
                "channel": {
                    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                },
                "created_at": "2024-06-15T16:55:34Z",
                "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