Ir para o conteúdo

Atualizar Preço

Efetua a atualização do preço associado ao SKU, permitindo que o valor de venda do produto seja ajustado conforme as estratégias de precificação do vendedor.

Escopo requerido

Valor Descrição
open:portfolio-prices-seller:write Permite alterar preços do SKU

Endpoint

Verbo URL
PATCH /seller/v1/portfolios/prices/{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
list_price integer Preço “De”, não é o preço de venda que será exibido no marketplace Sim Min: 1 Max: 9999999
price integer Preço “Por”, preço de venda que será exibido no marketplace Sim Min: 1 Max: 9999999
currency string ENUM: BRL Sim n/a
normalizer integer Valor normalizador de list_price e price para unidade de currency. Se não informado, assumirá valor padrão 100 Não Min: 1 Max: 100
channel object Canal em que a posição de preço será publicada Sim n/a
channel.{id} string ID do canal de venda Sim UUID4

Chamada:

 curl -X PATCH --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>' \
--data '[
    {
        "list_price": 9999,
        "price": 9980,
        "currency": "BRL",
        "normalizer": 100,
        "channel": {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d422",
        },
    }
]'

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