Skip to content

Geração de variações de produtos

PUT /products/{productId}/attribute

Permite gerar variações de um produto na loja

Descrição

Endpoint responsável por gerar variações de um determinado produto na loja 🧩.

Atua em contexto administrativo, permitindo que o lojista crie diferentes versões de um mesmo produto dentro do catálogo.

Por meio desse endpoint, é possível definir variações com base em atributos específicos, como por exemplo tamanho, cor, modelo ou outras características.

Isso possibilita que um mesmo produto possua múltiplas opções de escolha para o cliente final, mantendo a organização do catálogo e facilitando a navegação e seleção dentro da loja ⚙️.

Para gerar variações é necessários antes cadastrar os atributos que essas variações devem possuir. Veja mais em cadastro de atributos.

Parâmetros

Headers Obrigatórios

HeaderValorDescrição
Content-Typeapplication/jsonTipo de conteúdo
AuthorizationBearer {userToken}Token de autenticação

Parâmetros da URL

ParâmetroTipoObrigatórioDescrição
productIdintegerSimIdentificador do produto que deve ser gerado as variações

Parâmetros do Corpo

ParâmetroTipoObrigatórioDescrição
forcebool✅Determina se deve ser forçado a geração das variações.
attributeValueIdsarray✅Lista de atributos que deve ser gerado as variações.
attributeValueIds.*integer✅Identificador do atributo que deve gerar uma variação.

Exemplo de Requisição

1curl --request PUT \
2  --url https://sua-loja-uappi.com.br/api/v3/products/{productId}/attribute \
3  --header "Authorization: Bearer SEU_TOKEN_AQUI" \
4  --data '{
5	"force": false,
6	"attributeValueIds": [
7		1, 2, 3
8	]
9}'

✅ Resposta de Sucesso

HTTP Status: 200 OK

1{
2  "1": {
3    "productVariationId": 1,
4    "attributeList": [
5      1
6    ]
7  },
8  "2": {
9    "productVariationId": 2,
10    "attributeList": [
11      2
12    ]
13  },
14  "3": {
15    "productVariationId": 3,
16    "attributeList": [
17      3
18    ]
19  }
20}

⚠️ Possíveis erros:

Atenção: a seguir estão destacados os principais erros que podem ocorrer neste endpoint.

Os cenários descritos representam os erros mais relevantes do contexto atual, servindo como referência para entendimento e tratamento das falhas.

Código InternoCódigo HttpDescrição
UAPPI_STORE_PRODUCT_IS_GIFT_CARD400O produto solicitado é configurado como cartão presente e a operação não pode continuar.
UAPPI_STORE_INVALID_ATTRIBUTE_GROUPS400O produto solicitado já possui uma lista de atributos formada; use force = true para recriar todas as variações.
UAPPI_CORE_INVALID_TRADE_POLICY_ID400Os ids de política comercial solicitados não são permitidos.
UAPPI_STORE_PRODUCT_DUPLICATED_SKU400O SKU solicitado já está sendo utilizado em outro produto.
UAPPI_STORE_BRAND_NOT_FOUND404A marca solicitada não foi encontrada.
UAPPI_STORE_DUPLICATED_URL400A url solicitada já está sendo utilizada.
UAPPI_STORE_INVALID_ENTITY_URL400A entidade solicitada para vincular à url não foi encontrada.
UAPPI_STORE_ENTITY_MAIN_URL_ALREADY_EXISTS409A url principal para a entidade solicitada já existe.
UAPPI_STORE_INVALID_DESCRIPTION_ENTITY400A entidade solicitada para criar a descrição não foi encontrada.
UAPPI_STORE_PRODUCT_NOT_FOUND404O produto solicitado não foi encontrado.
UAPPI_STORE_CARGO_TYPE_NOT_FOUND404O tipo de carga solicitado não foi encontrado.
UAPPI_STORE_STOCK_INSUFFICIENT_AVAILABLE_STOCK400A quantidade de estoque solicitada para uso não está disponível.
UAPPI_STORE_STOCK_INSUFFICIENT_RESERVED_STOCK400A quantidade de estoque para operação de reserva não está disponível.
UAPPI_STORE_STOCK_BELLOW_MINIMUM400A quantidade de estoque solicitada para o produto está abaixo do mínimo.
UAPPI_STORE_STORAGE_NOT_FOUND404O armazém solicitado não foi encontrado.
UAPPI_STORE_SALE_WITHOUT_STOCK_ACTIVE400A operação não pode continuar porque o produto está configurado para venda sem estoque.
UAPPI_STORE_STOCK_UPDATE_PRODUCT_WITH_VARIATION_STOCK400O produto possui variações e não pode receber atualização de estoque.

Uappi é a melhor opção para o crescimento da sua loja!

Institucional

;