{"section":"tutorials","requestedLocale":"pt","requestedSlug":"como-criar-um-anexo-de-assinatura-pelo-modulo-catalogo","locale":"pt","slug":"como-criar-um-anexo-de-assinatura-pelo-modulo-catalogo","path":"docs/pt/tutorials/assinaturas/como-criar-um-anexo-de-assinatura-pelo-modulo-catalogo.md","branch":"main","content":"> ℹ️ Caso você utilize o módulo de **Assinaturas** no Admin VTEX, recomendamos criar um plano de assinatura por esse módulo. Para mais informações, veja o artigo [Como criar um plano de assinatura](/pt/docs/tutorials/como-criar-um-plano-de-assinatura).\n\n[Assinaturas](/pt/docs/tutorials/como-funciona-a-assinatura) é a solução da VTEX que permite aos lojistas venderem de forma recorrente e automática para os clientes assinantes, de acordo com determinada frequência.\n\nExistem duas formas pelas quais os produtos da sua loja podem ser adquiridos via assinatura:\n\n* Criação de [planos de assinatura](/pt/docs/tutorials/como-criar-um-plano-de-assinatura) pelo módulo **Assinatura**.\n* Criação de anexos de assinatura pelo módulo **Catálogo**.\n\nEste artigo explica como criar anexos de assinatura pelo **Catálogo**, o que é recomendado quando a loja não utiliza o módulo **Assinaturas (Beta)**.\n\n> ⚠️ É importante compreender a utilização do termo anexo no contexto de assinaturas:<ul><li>[Anexo](/pt/docs/tutorials/o-que-e-um-anexo): é uma customização do SKU opcional e sem custos, uma forma do lojista adicionar informação a um item.</li><li>**Anexo de assinatura:** é um tipo específico de anexo que possibilita a criação de assinaturas para um SKU. Os clientes podem criar assinaturas para obter o SKU periodicamente quando ele foi associado a um anexo de assinatura.</li><li>**Assinatura de SKU com anexo:** quando o cliente cria uma assinatura a partir de um pedido com um SKU que possui anexo, para que o anexo do pedido original seja mantido nos pedidos da assinatura, o lojista precisa habilitar essa configuração na loja. Isso é feito somente por API usando o endpoint [Edit subscriptions settings](https://developers.vtex.com/docs/api-reference/subscriptions-api-v3#post-/api/rns/settings). Saiba mais em [How to keep attachments from original orders in subscriptions](https://developers.vtex.com/docs/guides/how-to-keep-attachments-from-original-orders-in-subscriptions).</li></ul>\n\n## Anexo de assinatura do Catálogo\n\nO anexo de assinatura é utilizado para configurar a funcionalidade de assinatura para o SKU associado a ele. Esse tipo de anexo contém a configuração da frequência e data de ciclo da assinatura.\n\nPara criar um anexo de assinatura pelo Catálogo, você deverá realizar as seguintes ações:\n\n1. [Criar anexo de assinatura](#1-criar-anexo-de-assinatura)\n2. [Configurar frequência e data do ciclo de assinatura](#2-configurar-frequencia-e-data-do-ciclo-de-assinatura)\n3. [Associar SKU ao anexo de assinatura](#3-associar-sku-ao-anexo-de-assinatura)\n\n## 1. Criar anexo de assinatura\n\nSiga os passos abaixo para criar um anexo de assinatura:\n\n1. No Admin VTEX, acesse **Catálogo > Campos personalizados**, ou digite **Campos personalizados** na barra de busca no topo da página.\n2. Na aba **Serviços e SKUs**, clique em `Novo anexo`.\n3. No campo **Nome**, cadastre um valor no formato `vtex.subscription.{sufixo}`, e substitua `{sufixo}` pelo nome que você deseja utilizar para diferenciar essa assinatura, como nos exemplos a seguir:\n  * `vtex.subscription.plano1`\n  * `vtex.subscription.teste`\n4. No campo **Anexo obrigatório**, deixe a caixa de seleção desmarcada.\n\n  > ❗ O campo **Anexo obrigatório** não deve ser marcado. Se por acaso ele for marcado, o sistema de **Assinaturas** tentará enviar um pedido com assinatura para um item que já possui um anexo obrigatório (o anexo de assinatura), gerando um erro no sistema. Portanto, caso o campo **Anexo obrigatório** tenha sido marcado por engano, desmarque-o e solicite ao cliente da loja que realize o pedido novamente.\n\n5. No campo **Status**, marque a caixa de seleção `Ativa/Desativa o anexo`.\n6. Clique em `Salvar`.\n\n## 2. Configurar frequência e data do ciclo de assinatura\n\nApós criar o anexo de assinatura, você deverá configurar a frequência e a data do ciclo de assinatura. A frequência é a periodicidade da assinatura. Este valor é exibido para o seu cliente escolher no momento da criação da assinatura, e pode ser diário, semanal, mensal ou anual, dependendo da estratégia do seu negócio.\n\nA data do ciclo de assinatura corresponde ao dia em que o pedido será repetido a cada ciclo de assinatura. Por exemplo, o cliente cria uma assinatura para obter ração para gatos no dia 15 de cada mês. Nesse caso, o dia 15 é a data do ciclo e a frequência da assinatura é mensal.\n\nPara configurar as frequências e datas de ciclo de assinatura que deseja oferecer na sua loja, siga os passos abaixo:\n\n1. No Admin VTEX, acesse **Catálogo > Campos personalizados**, ou digite **Campos personalizados** na barra de busca no topo da página.\n2. Na aba **Serviços e SKUs**, na linha correspondente ao anexo criado anteriormente, clique em `Editar`.\n3. No campo **Nome da chave**, insira o valor fixo `vtex.subscription.key.frequency`, que corresponde à frequência.\n4. No campo **Valores permitidos**, defina os valores desejados para a frequência da assinatura (conforme as orientações da tabela abaixo).\n5. Clique em `Adicionar novo`.\n6. No campo **Nome da chave**, insira o valor fixo `vtex.subscription.key.purchaseday`, que corresponde a data do ciclo da assinatura.\n7. No campo **Valores permitidos**, defina os valores desejados para a data do ciclo (conforme as orientações da tabela abaixo).\n\n  > ⚠️ Caso nenhum valor seja inserido no campo **Valores Permitidos** para o `vtex.subscription.key.purchaseday`, a data do ciclo de assinatura será o mesmo dia da semana (para frequência semanal) ou dia do mês (para frequência mensal) do pedido original.\n\n  > ℹ️ Não é necessário preencher o campo **Número máximo de caracteres**.\n\n8. Clique em `Salvar`.\n\n| **Nome da chave** | **Valores permitidos** |\n| --- | --- |\n| `vtex.subscription.key.frequency` | Os valores permitidos são uma combinação de um número de 1 a 9 + espaço + algum dos seguintes valores:<ul><li>`day`: pedidos diários. Exemplo: `5 day`.</li><li>`week`: pedidos semanais. Exemplo: `4 week`.</li><li>`month`: pedidos mensais. Exemplo: `3 month`.</li><li>`year`: pedidos anuais. Exemplo: `2 year`.</li></ul>Para disponibilizar múltiplas opções de frequência, separe os valores usando vírgula. Não utilize espaço após a vírgula.<ul><li>Exemplo: para oferecer uma opção de assinatura mensal e outra semanal, preencha `1 month,1 week`.</li></ul> |\n| `vtex.subscription.key.purchaseday` | **Frequência semanal**Os valores permitidos para a data do ciclo de assinaturas semanais vão de 0 a 6 e equivalem aos dias da semana:<ul><li>`0`: domingo</li><li>`1`: segunda</li><li>`2`: terça</li><li>`3`: quarta</li><li>`4`: quinta</li><li>`5`: sexta</li><li>`6`: sábado</li></ul>Para oferecer mais de um dia para o ciclo com frequência semanal, separe os valores usando vírgula.<ul><li>Exemplo: uma assinatura semanal com data do ciclo aos domingos, quartas e sextas seria `0,3,5`.</li></ul><br />**Frequência mensal**Os valores permitidos vão de `1` a `28` e equivalem aos dias do mês, sendo `1` o primeiro dia do mês, `2` o segundo, e assim sucessivamente até `28`, o vigésimo oitavo dia do mês.Se utilizar mais de um número, separe-os usando vírgula. Não utilize espaço após a vírgula.<ul><li>Exemplo: uma assinatura mensal com data do ciclo no primeiro ou último dia permitido seria `1,28`.</li></ul> |\n\nAs imagens a seguir apresentam exemplos de preenchimento no Admin VTEX:\n\n* **Exemplo de frequência mensal:** a imagem apresenta uma assinatura mensal com pedidos que podem ser feitos todo dia 1, 15 ou 28 de cada mês:\n\n  ![PT Assinatura Exemplo Valores month](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/assinaturas/guias-de-assinatura/como-criar-um-anexo-de-assinatura-pelo-modulo-catalogo_1.png)\n\n* **Exemplo de frequência a cada 3 semanas:** a imagem apresenta uma assinatura que cria novos pedidos a cada 3 semanas, e a compra pode acontecer aos domingos, terças ou sábados.\n\n  ![PT Assinatura Exemplo Valores week](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/assinaturas/guias-de-assinatura/como-criar-um-anexo-de-assinatura-pelo-modulo-catalogo_2.png)\n\n## 3. Associar SKU ao anexo de assinatura\n\nPara a última etapa da criação de um anexo de assinatura pelo Catálogo, você deve associar o anexo de assinatura aos SKUs desejados. Para isso, siga os passos abaixo:\n\n1. No Admin VTEX, acesse **Catálogo > Todos os produtos**, ou digite **Todos os produtos** na barra de busca no topo da página.\n2. Na coluna **SKU**, clique no nome do SKU que deseja associar ao anexo de assinatura.\n3. Na aba **Configurações Avançadas**, no campo **Anexos**, marque a caixa de seleção do anexo de assinatura. \n4. Clique em `Salvar`.\n\nFeito isso, os clientes poderão criar assinaturas na sua loja para adquirir de forma recorrente e automática o SKU associado ao anexo de assinatura.\n\n### Saiba mais\n\n* [Como funciona a assinatura](/pt/docs/tutorials/como-funciona-a-assinatura)\n* [Como configurar Assinaturas na sua loja](/pt/docs/tutorials/como-configurar-assinaturas)\n* [How to keep attachments from original orders in subscriptions](https://developers.vtex.com/docs/guides/how-to-keep-attachments-from-original-orders-in-subscriptions)"}