Inserir Preço

Permite a criação do preço associado a um SKU, definindo o valor de venda do produto em um canal de publicação específico. Com essa funcionalidade, o vendedor pode estabelecer o preço de comercialização de acordo com a estratégia de vendas e as condições de mercado para cada canal.

Escopo requerido

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

Endpoint

Verbo	URL
POST	/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, USD	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 POST --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