PT

Como integrar com marketplace

Catálogo

Cadastrar Especificações de SKU

Atualizado por último
12/12/2019

Há três formas de cadastrar suas especificações de SKU: por meio do admin, por
planilha ou por ERP. Siga o passo a passo abaixo para cadastrar as
especificações:

Admin
Para cadastrar as especificações sua loja precisa ter departamentos, categorias e
subcategorias já criados. Depois disso, siga os passos abaixo:

1. Clique em Catálogo

2. Clique em Categorias

3. Clique na categoria que deseja adicionar especificações

4. Um pequeno retângulo azul vai aparecer na tela. Clique em Ações

5. Clique em Campo SKU

6. Clique em Novo Campo

 7. Preencha os campos do formulário de especificações. No caso dos SKUs, a
flag de campo obrigatório sempre está selecionada por default. Para
entender melhor o significado de cada campo, acesse nosso artigo sobre
como preencher campos de especificações de SKU

8. Clique em Salvar

Para adicionar valores à especificação de SKU, siga os passos abaixo:

1. Clique em Catálogo

2. Clique em Categorias

3. Clique na categoria que deseja adicionar os valores das especificações

4. Um pequeno retângulo azul vai aparecer na tela. Clique em Ações

5. Clique em Campo SKU

6. Na especificação desejada, passe o mouse na seta para baixo, ao lado do

botão Alterar

7. Clique em Valores

8. Clique em Novo Valor

9. Escreva o Nome do valor desejado e clique em Salvar

Vincular as especificações a um SKU
Depois de cadastrar as especificações, você poderá vincular seus valores a um
SKU.

Para incluir as especificações em um SKU siga os seguintes passos:

1. Clique em Catálogo,

2. Clique em Produtos e SKUs

3. No produto com o SKU desejado, clique na seta azul, ao lado do botão

Alterar, do lado direito da página

4. Clique em SKU

5. No SKU desejado, clique em Alterar

6. Clique na aba Especificações e escolha o valor da especificação para esse

SKU

7. Clique em Salvar
Planilha
Para cadastrar suas especificações por planilha é necessário primeiro exportar a
planilha padrão VTEX. Para fazer isso, siga o passo a passo abaixo:

1. Clique em Catálogo

2. Clique em Importação e Exportação

3. Clique na aba Especificação de SKU

4. Clique com o botão direito em cima da categoria desejada

5. Clique em Export

6. Um retângulo verde aparecerá na tela.

7. Clique em Clique aqui para baixar o arquivo para exportar a planilha

Ao receber a planilha, preencha as linhas com os dados da especificação do

SKU.

Apenas altere a coluna "ValoreEspecificaCao" da planilha. As demais colunas

deverão permanecer inalteradas pois seus valores serão utilizados para validação
dos dados.

Para entender melhor o significado de cada campo, acesse nosso artigo sobre
como preencher campos da planilha de importação de produtos e SKUs

Depois de preencher os dados da planilha, siga o passo a passo para Importar

suas especificações:

1. Clique em Catálogo
 2. Clique em Importação e Exportação

3. Clique na aba Especificação de SKU

4. Desça a página até Upload de Arquivo para Importação

5. Clique em Select para selecionar a planilha preenchida

6. Clique em Importar

ERP
As autenticações para as chamadas de API REST do módulo de Catálogo
devem ser feitas via AppKey e AppToken. Para entender mais, acesse nosso
artigo sobre como gerar um Appkey e um AppToken para autenticar suas
integrações

Specifications Insert Field

Para cadastrar um novo campo de SKU em uma categoria por ERP, você precisa
enviar um POST para o seguinte endpoint:

https://{{accountName}}.
{{environment}}.com.br/api/catalog_system/pvt/specification/field
 • O objeto do request tem as seguintes propriedades:

Propriedades Tipos Descrição

Nome do campo de
Name string
especificação

Id da categoria onde será

CategoryId integer
cadastrado o campo de SK

Id do campo de
FieldId integer
especificação

Insira o valor
IsActive boolean o campo de especificação
fique ativo

Insira o valor
IsRequired boolean o campo de especificação
seja obrigatório no SKU

Id do tipo de campo de
FieldTypeId integer
especificação*

ID do valor do campo de
FieldValueId integer
especificação

Descrição do campo de
Description string
especificação

IsStockKeepingUnit boolean Se for marcado como

será cadastrado como um
campo de especificação de
SKU. Se for marcado como
false , será cadastrado
 
Propriedades Tipos Descrição

como campo de
especificação de produto.

Insira o valor
o campo de especificação
IsFilter boolean
seja utilizado como filtro na
navegação do site

Se estiver visível na Página

IsOnProductDetails boolean do produto, o valor padrão
false

IsTopMenuLinkActive
Insira o valor
o campo de especificação
boolean
fique visível no menu
superior da loja

Insira o valor
IsSideMenuLinkActive boolean o campo de especificação
fique visível no link do men

Id do grupo de campos de
FieldGroupId integer
especificação

 

*FieldTypeIds: 

5 - Combo
6 - Radio 

• O objeto do response tem as seguintes propriedades:

Propriedades Tipos Descrição

Name string 
 
 
Propriedades Tipos Descrição

Nome do campo de
especificação

Id da categoria onde será

CategoryId integer
cadastrado o campo de SK

Id do campo de
FieldId integer
especificação

Insira o valor
IsActive boolean o campo de especificação
fique ativo

Insira o valor
IsRequired boolean o campo de especificação
seja obrigatório no SKU

Id do tipo de campo de
FieldTypeId integer
especificação

ID do valor do campo de
FieldValueId integer
especificação

Descrição do campo de
Description string
especificação

Se for marcado como

será cadastrado como um
campo de especificação de
IsStockKeepingUnit boolean SKU. Se for marcado como
false , será cadastrado
como campo de
especificação de produto.

IsFilter boolean 
 
Propriedades Tipos Descrição

Insira o valor
o campo de especificação
seja utilizado como filtro na
navegação do site

Se estiver visível na Página

IsOnProductDetails boolean do produto, o valor padrão
false

IsTopMenuLinkActive
Insira o valor
o campo de especificação
boolean
fique visível no menu
superior da loja

Insira o valor
IsSideMenuLinkActive boolean o campo de especificação
fique visível no link do men

Id do grupo de campos de
FieldGroupId integer
especificação

 

• Abaixo, temos um exemplo de Header e Body a serem passados no request

Headers

Header Value

Accept application/json

Content-Type application/json

X-VTEX-API-AppKey {{X-VTEX-API-AppKey}}

Header Value

X-VTEX-API-AppToken {{X-VTEX-API-AppToken}}

Body

{ 

"Name": "Tamanho",
"CategoryId": 10,
"IsActive": true,
"IsRequired": false,
"FieldTypeId": 5,
"IsStockKeepingUnit": false,
"IsFilter": true,
"IsOnProductDetails": true,
"IsTopMenuLinkActive": false,
"IsSideMenuLinkActive": false,
"FieldGroupId": 7
} 

Specifications Insert Field Value

Para cadastrar um novo valor de um campo de SKU por ERP, você precisa enviar
um POST para o seguinte endpoint:

https://{{accountName}}.
{{environment}}.com.br/api/catalog_system/pvt/specification/fieldValue

• O objeto do request tem as seguintes propriedades:

Propriedades Tipos Descrição

ID do campo de
FieldId integer
especificação

 
Propriedades Tipos Descrição

Name string Nome do valor do campo d

especificação

Insira o valor ´true´ para qu

IsActive boolean o campo de especificação
fique ativo

Posição de exibição do
campo de especificação em
Position integer
relação aos outros campos
do mesmo grupo

 

• O objeto do response tem as seguintes propriedades:

Propriedades Tipos Descrição

ID do valor do campo de
FieldValueId integer
especificação

ID do campo de
FieldId integer
especificação

Nome do valor do campo d

Name string
especificação

Insira o valor ´true´ para qu

IsActive boolean o campo de especificação
fique ativo

Position integer Posição de exibição do

campo de especificação em

 
Propriedades Tipos Descrição

relação aos outros campos

do mesmo grupo

 

• Abaixo, temos um exemplo de Header e Body a serem passados no request

Headers

Header Value

Content-Type application/json

X-VTEX-API-AppKey {{X-VTEX-API-AppKey}}

X-VTEX-API-AppToken {{X-VTEX-API-AppToken}}

Body

{ 

"FieldId": 34,
"Name": "Rubine Red",
"IsActive": true,
"Position": 1
} 

ANTERIOR PRÓXIMO
Ainda possui dúvidas?

Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade
VTEX.

JUNTE-SE À NOSSA COMUNIDADE

Fale com nossos experts

Entre em contato caso você tenha algo específico a
perguntar sobre a plataforma.

ENTRAR EM CONTATO

PT VTEX website