{"section":"tutorials","requestedLocale":"pt","requestedSlug":"cadastrar-especificacoes-ou-campos-de-produto","locale":"pt","slug":"cadastrar-especificacoes-ou-campos-de-produto","path":"docs/pt/tutorials/catálogo/produtos-e-skus/cadastrar-especificacoes-ou-campos-de-produto.md","branch":"main","content":"A [especificação](/pt/docs/tracks/especificacoes-definicao-de-conceito) de produto é um campo no cadastro de um produto onde se incluem características que são válidas para todas as suas variações (SKUs).\n\nNa VTEX, uma especificação sempre faz parte de um [grupo de especificações](/pt/tutorial/criando-grupo-de-categoria), que é associado a uma [categoria](/pt/docs/tracks/categorias-definicao-de-conceito). Por isso, para criar uma especificação (campo) de produto, é necessário ter cadastrado previamente pelo menos uma categoria e um grupo de especificações.\n\nExemplo: considere uma loja no setor de moda. Na categoria **Camisetas**, o grupo de especificações pode receber o nome de **Informações**, o campo de produto pode se chamar **Composição** e seus valores podem ser **Algodão** e **Poliéster**.\n\nNeste artigo, explicamos como funciona a herança das especificações que você vai cadastrar, detalhamos o processo de cadastro de campos de produto e o preenchimento de especificações do produto no Admin VTEX. Confira as seguintes seções:\n\n* [Herança de especificações de produto](#heranca-de-especificacoes-de-produto)\n* [Passo a passo no Admin VTEX](#passo-a-passo-no-admin-vtex)\n    1. [Criar um campo de produto](#criar-um-campo-de-produto)\n        * [Tipos de campo de produto](#tipos-de-campo-de-produto)\n    2. [Cadastrar valores para o campo de produto](#cadastrar-valores-para-o-campo-de-produto)\n        * [Acessar ou editar valores cadastrados](#acessar-ou-editar-valores-cadastrados)\n    3. [Preencher especificações de produto](#preencher-especificacoes-de-produto)\n        * [Cadastro do produto](#cadastro-do-produto)\n        * [Planilha](#planilha)\n\n> ℹ️ Para criar uma especificação de produto utilizando a** Catalog API**, siga o guia para desenvolvedores [How to create a specification](https://developers.vtex.com/vtex-developer-docs/docs/how-to-create-a-specification).\n\n## Herança de especificações de produto\n\nAntes de criar especificações, é importante compreender que as especificações seguem uma lógica de “herança”, ou seja, ao criar uma especificação em um nível de categoria mais alto, a especificação será apresentada em todos os níveis de categoria abaixo dela. Portanto, se for necessário criar uma especificação de produto que se aplique a apenas uma categoria, esta deve ser criada no nível dessa categoria.\n\nConsidere o produto **Televisão** como exemplo. Em **Catálogo > Todos os produtos > Alterar > Especificações**, página ilustrada a seguir, podemos ver que o grupo de especificações chamado **Características** está associado à categoria da televisão. Esse grupo inclui um campo de nome **Polegadas** e um campo de nome **Faixa etária**, que são obrigatórios.\n\n![especificacoes-caracteristicas-pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/produtos-e-skus/cadastrar-especificacoes-ou-campos-de-produto_1.png)\n\nPor se tratar de uma especificação de produto, as informações selecionadas nessa página valerão para todas as variações do produto __Televisão__. Todos os produtos cadastrados na mesma categoria da televisão precisam ter essas especificações preenchidas também, visto que os campos são obrigatórios.\n\n## Passo a passo no Admin VTEX\n\nPara que as especificações apareçam no cadastro de produtos, além de ter criado anteriormente um [grupo de especificações](/pt/tutorial/criando-grupo-de-categoria) associado a uma [categoria](/pt/docs/tracks/categorias-definicao-de-conceito), é preciso criar os campos de produto e cadastrar seus valores. Em seguida, você poderá preencher essas especificações nos seus produtos.\n\nVeja o passo a passo completo nas seções a seguir.\n\n### Criar um campo de produto\n\nPara criar um campo de produto, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Catálogo__, ou digite __Catálogo__ na barra de busca no topo da página.\n2. Clique em **Categorias**.\n3. Clique na categoria associada ao grupo de especificações em que você deseja criar um campo de produto.\n\n    Observe que ao criar um campo em um nível de categoria mais alto, a especificação será apresentada em todos os níveis de categoria abaixo dela.\n\n3. Clique em `Ações` <i class=\"fas fa-angle-down\"></i>.\n4. Clique em `Campo (Produto)`.\n5. Clique em `Novo Campo`.\n6. Preencha as informações referentes ao campo que está sendo criado:\n    * **Nome**: nome da especificação (campo) de produto.\n    * **Texto**: descrição sobre o campo.\n    * **Tipo**: tipo de campo, que pode variar entre **Texto**, **Texto Grande**, **Número**, **Combo**, **Radio**, **CheckBox**, **Texto Indexado** e **Texto Grande Indexado**. Leia a seção [Tipos de campo de produto](#tipos-de-campo-de-produto) para mais informações sobre cada opção.\n    * **Valor Padrão**: valor de preenchimento já definido na criação do campo.\n    * **Grupo**: nome do [grupo de especificações](/pt/tutorial/criando-grupo-de-categoria) criado anteriormente, do qual esse campo fará parte.\n    * **Filtro**: define se a especificação será utilizada como filtro na navegação do site.\n    * **Obrigatório**: define se o valor obrigatoriamente precisa ser preenchido no cadastro do produto ou não. Caso o campo seja obrigatório, o produto só poderá ser ativado após o preenchimento desta especificação.\n    * **Exibe Especificação**: define se o campo é mostrado na página de detalhes do produto, na aba **Especificações**.\n    * **Link no Menu Superior**: define se o link para os valores do campo é mostrado no menu principal do site.\n    * **Link no Menu Lateral**: define se o link para os valores do campo é mostrado no menu lateral do site.\n    * **Ativo**: insere ou remove este campo no cadastro do produto (aba **Especificações**).\n7. Clique em `Salvar`. \n\n![product-spec-1](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/produtos-e-skus/cadastrar-especificacoes-ou-campos-de-produto_2.gif)\n\n#### Tipos de campo de produto\n\nConfira a tabela a seguir para obter detalhes sobre os tipos de campo de produto que você pode selecionar na opção **Tipo**:\n\n<table class=\"w-100 center mv7 bb b--gray\">\n<thead class=\"w-100 center mv7 bb b--gray\">\n  <tr class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">\n    <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">Tipo de campo</th>\n    <th class=\"t-body fw5 c-muted-1 bb bw1 pa2 pb3 b--muted-3 tl\">Descrição</th>\n  </tr>\n</thead>\n<tbody>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**Texto**</td>\n    <td class=\"t-body pa5\">Preenchimento do conteúdo como texto livre, indicado para textos pequenos e de formatação simples. Não é indicado para grandes estruturas de HTML.</td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**Texto Grande**</td>\n    <td class=\"t-body pa5\">Preenchimento do conteúdo como texto livre, indicado para grandes estruturas de HTML. Exemplo: tabelas de medidas, frequentemente utilizadas no segmento de moda.</td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**Número**</td>\n    <td class=\"t-body pa5\">Preenchimento do conteúdo apenas com números inteiros. Exemplo: especificar a numeração de um sapato (39, 41, 42…).</td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**Combo**</td>\n    <td class=\"t-body pa5\">Conteúdo com dois ou mais valores pré-definidos, para seleção de uma opção em uma lista suspensa (dropdown). Exemplo: voltagem de um eletrodoméstico, que pode ser 110v ou 220v.</td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**Radio**</td>\n    <td class=\"t-body pa5\">Conteúdo com dois ou mais valores pré-definidos, para marcação de uma opção a partir de uma grade de valores. Exemplo: definição de cor dos componentes de um produto (vermelho, amarelo, azul, preto…).</td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**CheckBox**</td>\n    <td class=\"t-body pa5\">Opção que tem apenas valores equivalentes a <span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">verdadeiro</span> (marcado) ou <span class=\"t-body c-on-base pa2 mw6 br2 bg-muted-4\">falso</span> (não marcado). Exemplo: um campo chamado Outlet será marcado apenas quando o produto fizer parte da seleção da loja para outlet (queima de estoque). Se ele não fizer parte dessa seleção, o campo deve permanecer desmarcado.</td>\n  </tr>\n  <tr class=\"bb b--muted-3\">\n    <td class=\"t-body pa5\">**Texto Indexado<br /> <br />Texto Grande Indexado**</td>\n    <td class=\"t-body pa5\">Seguem tecnicamente a mesma regra dos campos de Texto, com uma diferença: seus valores serão interpretados pelo [indexador](/pt/docs/tutorials/entendendo-o-funcionamento-da-indexacao) do Catálogo e influenciam nos resultados de busca dos clientes na loja. Veja mais detalhes em [Como funciona a busca da VTEX?](/pt/docs/tutorials/como-funciona-a-busca-da-vtex/).</td>\n  </tr>\n</tbody>\n</table>\n\n### Cadastrar valores para o campo de produto\n\nOs valores dos campos de produto irão variar de acordo com o tipo do campo. Para os campos de tipo de **Texto** e **Número**, não há valores pré-definidos criados – os valores serão preenchidos livremente durante o cadastro do produto, na aba **Especificações**.\n\nJá para os campos de tipo **Combo**, **Radio** e **CheckBox**, é necessário cadastrar valores pré-definidos para seleção durante o cadastro do produto. Confira as instruções a seguir:\n\n1. No Admin VTEX, acesse __Catálogo__, ou digite __Catálogo__ na barra de busca no topo da página.\n2. Clique em **Categorias**.\n3. Clique na categoria em que o campo de produto está salvo.\n4. Clique no botão **Ações** <i class=\"fas fa-angle-down\"></i>.\n5. Clique em **Campo (Produto)**.\n6. Clique na seta para baixo <i class=\"fas fa-angle-down\"></i>.\n7. Clique em **Valores**.\n\n    Nesta página é possível criar um **Novo valor** ou **Editar** os valores estabelecidos anteriormente.\n\n7. Preencha o campo **Nome** com os valores que você deseja criar para aquele campo. Insira um valor por linha e tecle `Enter` entre cada valor.\n8. Clique em `Salvar`.\n\n    Os valores criados serão exibidos na aba **Especificação** no cadastro de Produto.\n\n![product-spec-2](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/produtos-e-skus/cadastrar-especificacoes-ou-campos-de-produto_3.gif)\n\n> ℹ️ Caso esteja cadastrando os primeiros valores de um campo, é necessário voltar no formulário daquele campo específico e marcar a opção **Ativo**.\n\n#### Acessar ou editar valores cadastrados\n\nPara acessar ou editar valores cadastrados para um campo de produto, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Catálogo__, ou digite __Catálogo__ na barra de busca no topo da página.\n2. Clique em **Categorias**.\n3. Clique na categoria em que o campo de produto está salvo.\n4. Clique no botão **Ações** <i class=\"fas fa-angle-down\"></i>.\n5. Clique em **Campo (Produto)**.\n6. Clique na seta para baixo <i class=\"fas fa-angle-down\"></i>.\n7. Clique em **Valores**.\n\n    Nesta página, você pode visualizar os valores cadastrados e escolher entre as seguintes opções:\n      * **Ordernar Alfabeticamente:** organizar a lista de valores por ordem alfabética.\n      * **Novo valor**: criar um novo valor.\n      * **Editar**: permite alterar o texto do valor e optar por ativá-lo ou desativá-lo.\n      * <i class=\"fas fa-angle-down\"></i> > **Excluir**: excluir um valor.\n\n### Preencher especificações de produto\n\nPor fim, é necessário preencher as especificações de cada produto a partir dos campos e valores que você criou. Você pode fazer isso individualmente pela página de [cadastro do produto](#cadastro-do-produto) ou massivamente por [planilha](#planilha).\n\n#### Cadastro do produto\n\nPara preencher as especificações de cada produto de forma individual, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse __Catálogo__, ou digite __Catálogo__ na barra de busca no topo da página.\n2. Acesse **Todos os produtos**.\n3. Na linha do produto, clique em `Alterar`.\n4. Acesse a aba **Especificações**.\n5. Preencha os [campos que você criou](#criar-um-campo-de-produto) com os [valores](#cadastrar-valores-para-o-campo-de-produto) desejados.\n\n    Campos obrigatórios estarão marcados com `*`.\n\n6. Clique em `Salvar`.\n\n![product-spec-3](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/produtos-e-skus/cadastrar-especificacoes-ou-campos-de-produto_4.gif)\n\n#### Planilha\n\nPara preencher especificações de produtos em massa por planilha, é necessário exportar a planilha padrão VTEX, preenchê-la e importá-la na plataforma. Para fazer isso, siga as instruções abaixo:\n\n1. No Admin VTEX, acesse __Catálogo__, ou digite __Catálogo__ na barra de busca no topo da página.\n2. Clique em **Importação e Exportação**.\n3. Clique na aba **Especificações de produto**.\n4. Clique com o botão direito na categoria desejada.\n5. Clique em **Export…**.\n\n    Um retângulo verde aparecerá na tela.\n\n6. Clique em **Clique aqui para baixar o arquivo** para exportar a planilha.\n7. Abra o arquivo da planilha e preencha as linhas com os dados da especificação do produto.\n\n    Apenas altere a coluna `ValoreEspecificaCao` da planilha com o valor a ser preenchido para o campo listado em cada linha. As demais colunas deverão permanecer inalteradas pois seus valores serão utilizados para validação dos dados.\n\n8. No Admin VTEX, ainda em **Catálogo** > **Importação e Exportação** > **Especificações de produto**, desça a página até **Upload de Arquivo para Importação**.\n9. Clique em **Select** para selecionar o arquivo com a planilha preenchida no seu computador.\n10. Clique em `Importar`.\n\n![product-spec-4](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/produtos-e-skus/cadastrar-especificacoes-ou-campos-de-produto_5.gif)\n\n## Saiba mais\n- [Cadastrar especificações ou campos de SKU](/pt/docs/tutorials/cadastrar-especificacoes-ou-campos-de-sku)\n- [Especificações de produto e de SKU](/pt/docs/tracks/especificacoes-definicao-de-conceito)"}