Atualizar parcialmente o SKU

Permite a realização de uma atualização parcial nos dados de um SKU previamente cadastrado pelo vendedor, mantendo inalterado o código único do SKU. Esse código serve como identificador exclusivo do produto dentro do portfólio, garantindo sua consistência e rastreabilidade ao longo de todas as modificações. Essa funcionalidade torna o processo de edição mais ágil e eficiente, facilitando ajustes rápidos em atributos específicos do SKU

Escopo requerido

Valor	Descrição
open:portfolio-skus-seller:write	Permite gerenciar os SKUs

Endpoint

Verbo	URL
PATCH	/seller/v1/portfolios/skus/{sku}

Parâmetros da URL

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

Chamada:

Parâmetros da chamada

Propriedade	Tipo	Descrição	Obrigatório	Tamanho
title	string	Título do produto	Não	Min 1 carácter Max 150 caracteres
description	string	Descrição do produto	Não	Min 1 carácter Max 7000 caracteres
condition	string	ENUM: "NEW"(DEFAULT), "USED", "REMANUFACTURED"	Não	n/a
perishable	boolean	ENUM: True, False	Não	n/a
brand	string	Marca do produto	Não	Min 1 carácter Max 100 caracteres
group	object	Dados do agrupamento das variações	Não	n/a
group.{id}	string	Código de agrupamento das variações	Não	Min 1 carácter Max 50 caracteres
group.{main_variation}	boolean	true, false	Não	n/a
channels	list	Informações dos canais de venda do SKU. Indica em qual(s) canal(is) o SKU deve ser vendido	Não	n/a
channels[].id	string	IDs dos canais nos quais o produto será submetido para publicação	Sim	UUID
identifiers	list	Parâmetros para identificação do SKU	Não	n/a
identifiers[].type	string	ENUM: “ean” , ”isbn”	Não	n/a
identifiers[].value	string	Inserir o número de EAN, ISBN	Não	Min 8 carácter Max 14 caracteres
has_ean	boolean	Valores: true, false. Se existir a informação de EAN para o produto, enviar valor true.	Não	n/a
datasheet	list	Lista de atributos de ficha técnica	Não	n/a
datasheet[].name	string	Atributo de ficha técnica. Ex.: Garantia	Não	Min 1 carácter Max 50 caracteres
datasheet[].value	string	Valor de atributo de ficha técnica. Ex.: 12 meses	Não	Min 1 carácter Max 50 caracteres
attributes	list	Lista de atributos de variação	Não	n/a
attributes[].name	string	Atributo de variação. Ex.: Tamanho	Não	Min 1 carácter Max 20 caracteres
attributes[].value	string	Valor de atributo de variação. Ex.: P	Não	Min 1 carácter Max 50 caracteres
dimensions	list	Lista de dimensões do SKU	Não	Min 1 Max 2
dimensions[].height.value	float	Dimensão do produto - Altura - unidade: cm	Não	Min: 0.001 (cm) Max:1000000 (cm)
dimensions[].height.unit	string	Unidade da dimensão. ENUM: cm	Não	cm
dimensions[].width.value	float	Dimensão do produto - Largura - unidade: cm	Não	Min: 0.001 (cm) Max:1000000 (cm)
dimensions[].width.unit	string	Unidade da dimensão. ENUM: cm	Não	cm
dimensions[].length.value	float	Dimensão do produto - Comprimento - unidade: cm	Não	Min: 0.001 (cm) Max:1000000 (cm)
dimensions[].length.unit	string	Unidade da dimensão. ENUM: cm	Não	cm
dimensions[].weight.value	float	Dimensão do produto - Peso - unidade: g	Não	Min: 1 (g) Max: 1510000 (g)
dimensions[].weight.unit	string	Unidade da dimensão. ENUM: g	Não	g
images	list	Imagens do SKU. A primeira imagem enviada será a de capa	Sim	Min (Items): 1 Max (Items): 30
images[].type	string	Mime type da imagem	Não	Aceito somente “image/jpeg”
images[].reference	string	URL da imagem	Sim	Min (chars): 10 Max (chars): 1000
videos	list	Lista de vídeos do SKU	Não	Min (Items): 0 Max (Items): 3
videos[].type	string	Tipo do vídeo	Sim	Aceito somente “embedded”
videos[].reference	string	URL de vídeo, aceito somente link do YouTube	Sim	Min (chars): 10 Max (chars): 1000
podcasts	string	Lista de podcasts sobre o SKU	Não	Min (Items): 0 Max (Items): 3
podcasts[].type	string	Tipo do podcast	Sim	Aceito somente “embedded”
podcasts[].reference	string	URL de arquivo de áudio	Sim	Min (chars): 10 Max (chars): 1000
fulfillment	boolean	Valores: true ou false. Marcação serve para enviar o produto para o fluxo de aprovação para armazenamento do produto em um CD do Magalu quando a ORG possuir o serviço ativo.	Não	n/a
active	boolean	Valores: true ou false. True significa que deseja submeter o produto para publicação e False significa que deseja despublicar um produto.	Não	n/a
podcasts	string	URL de arquivo de áudio	Não	Min (Items): 0 Max (Items): 3
type	string	ENUM: "product", "service", "digital product"	Não	n/a
origin	string	ENUM: "national", "imported”	Não	n/a
extra_data	list	Lista de informações extra do SKU	Não	Max (itens): 20
extra_data[].name	string	Nome da propriedade. Exemplos: ncm, tax_replacement	Não	Min 1 caracteres Max 50 caracteres
extra_data[].value	string	Valor da propriedade.	Não	Min 1 caracteres Max 50 caracteres

Chamadas:

Atualizando título, descrição, marca

 curl --location --request PATCH 'https://api.magalu.com/v1/portfolios/skus/{sku}'\
--header 'X-Language: por' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{ token_account_staging }}' \
--data '{
    "title": "Chuteira Campo Umbro Orbit Unissex",
    "description": "Os boleiros vão dominar as quatro linhas e garantir a vitória com a Chuteira ...",
    "brand": "Umbro",
}
'

Atualizando apenas a descrição

 curl --location --request PATCH 'https://api.magalu.com/v1/portfolios/skus/{sku}'\
--header 'X-Language: por' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{ token_account_staging }}' \
--data '{
    "description": "Os boleiros vão dominar as quatro linhas e garantir a vitória com a Chuteira ...",
}
'

Atualizando imagens

 curl --location --request PATCH 'https://api.magalu.com/v1/portfolios/skus/{sku}'\
--header 'X-Language: por' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{ token_account_staging }}' \
--data '{
 "images": [
        {
            "type": "image/jpeg",
            "reference": "https://files-product.magalu.com/65ef5538b65bd5399bce2017.jpeg"
        }
    ],
}
'

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