Preço¶

Um preço representa um valor de venda do produto. Contém informações básicas e essenciais, incluido o SKU, valor, moeda, normalizador e canal de publicação.

Criar um novo preço¶

Cria um novo preço para a venda desse produto em um canal de publicação.

Alerta

Para atualizar, basta criar um novo preço para que o mesmo seja atualizado.

Escopo requerido

Valor	Descrição
`open:portfolio:write`	Permite gerenciar os preços

Parâmetros da chamada

Propriedade	Tipo	Descrição	Obrigatório
`type`	string	Identifica o tipo do preço do SKU especificado. Valores permitidos `list` e `sell`	Sim
`sku`	string	O SKU exclusivo do item	Sim
`value`	int	Valor do SKU, desnormalizado em relação ao código da moeda	Sim
`currency`	string	Código da moeda, de acordo à ISO-4217	Sim
`normalizer`	int	Valor normalizador de `value` para unidade de `currency`. Valor padrão `100`. Para maiores informações consulte	Sim
`extras`	object	Informações adicionais sobre o preço. Quando não houver um valor você poderá enviar `{}`.	Sim
`channel`	object	Canal para publicação do preço	Sim
`channel.id`	uuid	Identificação do canal, para visualizar a lista de canais, consulte aqui	Sim
`channel.extras`	object	Informações adicionais sobre o canal. Quando não houver um valor você poderá enviar `{}`.	Sim

Chamada:

curl -X 'POST' \
  'https://api.magalu.com/v0/portfolios/prices' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <Access Token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "list",
  "value": 5990,
  "currency": "BRL",
  "normalizer": 100,
  "sku": "abc",
  "extras": {},
  "channel": {
    "id": "1aba5746-1d52-48a1-a7a7-c1307db5e262",
    "extras": {}
  }
}'

Resposta:

{
  "id": "f00ffabc-5af5-47a8-9626-31d0359c87e2",
  "type": "list",
  "value": 5990,
  "currency": "BRL",
  "normalizer": 100,
  "sku": "abc",
  "extras": {},
  "channel": {
    "id": "1aba5746-1d52-48a1-a7a7-c1307db5e262",
    "extras": {}
  },
  "created_at": "2022-06-15T14:25:37Z"
}

Códigos de retorno

Nota

Para maiores informações sobre códigos de retorno, Código de retorno.

Código	Descrição
201	Created
401	Unauthorized
409	Conflict
403	Forbidden
422	Unprocessable Entity
500	Internal Server Error
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout

Recuperar uma lista de preços¶

Retorna todos os registros de preços disponíveis.

Nota

Este endpoint implementa paginação, ordenação e filtros. Para saber mais, consulte Fazer solicitações paginadas e parâmetros de consulta.

Escopo requerido

Valor	Descrição
`open:portfolio:read`	Permite listar os preços

Parâmetros de consulta

Campo	Tipo	Descrição	Obrigatório
`sku`	string	Retorna os preços do SKU especificado	Não
`type`	string	Retorna os tipos de preços do SKU especificado. Valores permitidos `list` e `sell`	Não
`channel.id__in`	array	Retornar os preços dos canais especificados	Não

Parâmetros de ordenação

Campo	Descrição	Obrigatório
`created_at`	Ordernar por data de criação dos preços.	Não

Chamada:

curl -X 'GET' \
  'https://api.magalu.com/v0/portfolios/prices' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <Access Token>' \
  -H 'Content-Type: application/json' \

Resposta:

Códigos de retorno href="#__codelineno-3-1">{ "meta": { ... }, "results": [ { "id": "f00ffabc-5af5-47a8-9626-31d0359c87e2", "type": "list", "value": 5990, "currency": "BRL", "normalizer": 100, "sku": "abc", "extras": {}, "channel": { "id": "1aba5746-1d52-48a1-a7a7-c1307db5e262", "extras": {} }, "created_at": "2022-06-15T14:25:37Z" } ] }

Nota

Para maiores informações sobre códigos de retorno, Código de retorno.

Código	Descrição
200	Ok
400	Bad Request
401	Unauthorized
403	Forbidden
422	Unprocessable Entity
500	Internal Server Error
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout

Recuperar um preço¶

Retorna um preço específico.

Escopo requerido

Valor	Descrição
`open:portfolio:read`	Permite acessar um preço específico

Parâmetros da URL

Campo	Tipo	Descrição	Obrigatório
`id`	uuid	Identificação do preço	Sim

Chamada:

curl -X 'GET' \
  'https://api.magalu.com/v0/portfolios/prices/{id}' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <Access Token>' \
  -H 'Content-Type: application/json' \

Resposta:

{
  "type": "list",
  "value": 5990,
  "currency": "BRL",
  "normalizer": 100,
  "sku": "abc",
  "extras": {},
  "channel": {
    "id": "1aba5746-1d52-48a1-a7a7-c1307db5e262",
    "extras": {}
  },
  "id": "f00ffabc-5af5-47a8-9626-31d0359c87e2",
  "created_at": "2022-06-15T14:25:37Z"
}

Códigos de retorno

Nota

Para maiores informações sobre códigos de retorno, Código de retorno.

Código	Descrição
200	OK
401	Unauthorized
403	Forbidden
404	Not Found
422	Unprocessable Entity
500	Internal Server Error
502	Bad Gateway
503	Service Unavailable
504	Gateway Timeout