Inserir Estoque

Permite adicionar as quantidades disponíveis de estoque para o produto especificado, facilitando o controle preciso das posições de inventário.

Escopo requerido

Valor	Descrição
open:portfolio-stocks-seller:write	Permite alterar posições de estoque do SKU

Endpoint

Verbo	URL
POST	/seller/v1/portfolios/stocks/{sku}

Parâmetros da URL

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

Chamada:

Parâmetros da chamada

Campo	Tipo	Descrição	Obrigatório	Tamanho
type	string	ENUM: "AVAILABLE", "RESERVED"	Sim	n/a
quantity	integer	Valor da posição de estoque	Sim	Min: 0 Max: 99999
channel	object	Canal em que a posição de estoque será publicada	Sim	n/a
channel.{id}	string	ID do canal de venda	Sim	UUID4

Chamada:

curl -X POST --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>' \
--data '[
    {
        "type": "AVAILABLE",
        "quantity": 1,
        "channel": {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d480",
        },
    }
]'

Resposta:

{
  "trace_id": "8576e9a4-9bd7-48f9-9263-41a6a4613fa9"
}

Uso do trace_id O trace_id é um identificador único gerado para cada requisição feita à API, permitindo que o usuário acompanhe detalhadamente o andamento da execução de suas solicitações. Todas as operações de criação e atualização realizadas na API retornam esse identificador, oferecendo transparência e visibilidade completas sobre o processamento dos dados. Com o trace_id, é possível monitorar a requisição, facilitando a resolução de possíveis problemas e o acompanhamento em tempo real.

Para mais informações, consulte a seção dedicada ao trace_id na documentação da API Trace.

Códigos de retorno

Código	Descrição
202	Accepted
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