{"section":"tutorials","requestedLocale":"pt","requestedSlug":"aplicativo-affiliates-program","locale":"pt","slug":"aplicativo-affiliates-program","path":"docs/pt/tutorials/apps/aplicativo-affiliates-program.md","branch":"main","content":"> ℹ️ O **Affiliates Program** é um aplicativo compatível apenas com lojas [VTEX IO](/pt/docs/tracks/cms-vtex-io), e não está disponível para lojas que utilizam [CMS Portal (Legado)](/pt/docs/tracks/cms-portal-legado) ou [Headless CMS](https://faststore.dev/tutorials/cms/0#vtex-headless-cms). Para instalar e configurar o aplicativo na sua loja VTEX, acesse o guia para desenvolvedores Affiliates Program app.\n\nNo aplicativo **Affiliates Program**, um afiliado é alguém que se associa a sua loja VTEX para promover as vendas em troca de uma comissão. O termo é, portanto, diferente do [conceito usual de afiliado na VTEX](/pt/docs/tutorials/o-que-e-afiliado).\n\nO aplicativo **Affiliates Program** cria uma URL específica da sua loja VTEX para os seus [afiliados cadastrados](#adicionar-afiliado). Quando o afiliado compartilha sua URL com um cliente e este realiza uma compra pelo link, o afiliado recebe uma comissão sobre a venda.\n\nO aplicativo cria dois grupos de página após ser instalado em seu ambiente VTEX:\n\n- [Páginas dos afiliados](#paginas-dos-afiliados)\n- [Páginas no Admin VTEX](#paginas-no-admin-vtex)\n\n### Páginas dos afiliados\n\nO aplicativo cria três tipos de páginas para os afiliados, que dispõem delas sem precisar de qualquer acesso ao Admin VTEX da sua loja, conforme indicado na tabela abaixo:\n\n| **Tipo**                         | **URL**                                              |\n| -------------------------------- | ---------------------------------------------------- |\n| Página do afiliado               | `{storeName.com}/affiliates/{affiliateSlug}`         |\n| Página de perfil do afiliado     | `{storeName.com}/affiliates/{affiliateSlug}/profile` |\n| Página do formulário de cadastro | `{storeName.com}/affiliate/form`                     |\n\nA **página do afiliado** é a URL da loja VTEX que ele compartilha com os clientes. Veja um exemplo na imagem a seguir:\n\n![print_affiliates_url_pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/apps/aplicativo-affiliates-program_1.png)\n\nA **página de perfil do afiliado** é uma interface pela qual ele pode acompanhar e gerenciar seus pedidos e comissões. Veja um exemplo na imagem a seguir:\n\n![affiliate_profile_page_pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/apps/aplicativo-affiliates-program_2.png)\n\nA **página de cadastro** permite que os próprios interessados em se tornar afiliados preencham seus dados para solicitar registro junto a sua loja VTEX.\n\n> ℹ️ As páginas dos afiliados são customizáveis. Para mais informações, veja o guia para desenvolvedores [Affiliates Program app](https://developers.vtex.com/vtex-developer-docs/docs/affiliates-program-app).\n\n### Páginas no Admin VTEX\n\nO aplicativo **Affiliates Program** cria interfaces no Admin VTEX para que você gerencie todo o conteúdo relacionado a afiliados.\n\nApós a [instalação](https://developers.vtex.com/vtex-developer-docs/docs/affiliates-program-app#installation) do aplicativo, as seguintes páginas se tornam disponíveis no seu Admin VTEX, em **Apps > Afiliados**:\n\n- [Gerenciamento de afiliados](#gerenciamento-de-afiliados)\n- [Gerenciamento de pedidos](#gerenciamento-de-pedidos)\n- [Gerenciamento de comissões](#gerenciamento-de-comissoes)\n\n## Gerenciamento de afiliados\n\nA página **Gerenciamento de afiliados** permite realizar as seguintes ações:\n\n- [Adicionar afiliado](#adicionar-afiliado)\n- [Pesquisar afiliados](#pesquisar-afiliados)\n- [Filtrar afiliados](#filtrar-afiliados)\n- [Visualizar detalhes do afiliado](#visualizar-detalhes-do-afiliado)\n- [Editar afiliado](#editar-afiliado)\n\n![affiliates_management_page_pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/apps/aplicativo-affiliates-program_3.jpg)\n\n### Adicionar afiliado\n\nPara criar um novo afiliado, clique no botão `Adicionar afiliado`, preencha os campos apresentados e clique em `Salvar`.\n\n> Os seguintes campos são de preenchimento obrigatório: _Nome_, _Email_, _Identificador da URL_ e _Telefone_.\n\n### Pesquisar afiliados\n\nPara pesquisar um afiliado, digite na barra de busca por alguma das seguintes informações: _ID do afiliado, Nome, Nome da Loja, Email_ ou *Telefone.*\n\n> ⚠️ No aplicativo **Affiliates Program**, além do termo afiliado ser diferente do [conceito usual de afiliado na VTEX](/pt/docs/tutorials/o-que-e-afiliado), o `ID do Afiliado` também não corresponde ao código padrão. No aplicativo, o `ID do Afiliado` é um código alfanumérico gerado automaticamente quando você cria um novo afiliado.\n\n### Filtrar afiliados\n\nPara filtrar a pesquisa de afiliados, clique sobre `Todos` <i class=\"fas fa-toggle-on\"></i> e selecione a opção desejada. A opção default `Todos` realiza a pesquisa em todos os seus afiliados, e as outras opções são referentes à aprovação: `Sim` para afiliados aprovados e `Não` para os não aprovados.\n\n### Visualizar detalhes do afiliado\n\nPara visualizar os dados de um afiliado, na linha referente ao afiliado, clique em <i class=\"fas fa-ellipsis-v\"></i> **Mais ações**, e em seguida clique em <i class=\"fas fa-eye\"></i> **Detalhes**. Você será redirecionado para uma página onde pode visualizar informações sobre o afiliado e também realizar as seguintes ações:\n\n- **Ativar o afiliado**: clicando no toggle em `Ativo?` <i class=\"fas fa-toggle-on\"></i>.\n- **Acessar a página [Gerenciamento de pedidos](#gerenciamento-de-pedidos) dos afiliados:** clicando no botão `Gerenciamento de pedidos`.\n- **Editar afiliado:** clicando no botão `Editar`.\n\n### Editar afiliado\n\nPara editar um afiliado de forma a modificar seu cadastro, siga os passos abaixo:\n\n1. Na linha referente ao afiliado, clique em <i class=\"fas fa-ellipsis-v\"></i> **Mais ações**.\n2. Clique em <i class=\"fas fa-pencil-alt\"></i> **Editar**.\n3. Altere os dados do cadastro.\n4. Clique em `Salvar`.\n\n## Gerenciamento de pedidos\n\nA página **Gerenciamento de pedidos** permite realizar as seguintes ações:\n\n- [Acompanhar dashboard](#acompanhar-dashboard)\n- [Pesquisar pedidos](#pesquisar-pedidos)\n- [Filtrar pedidos](#filtrar-pedidos)\n- [Exportar lista de pedidos](#exportar-lista-de-pedidos)\n- [Visualizar detalhes do pedido](#visualizar-detalhes-do-pedido)\n\n![orders_management_page_pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/apps/aplicativo-affiliates-program_4.jpg)\n\n### Acompanhar dashboard\n\nNo topo da página, você visualiza as seguintes métricas sobre os pedidos realizados pelos links de um ou mais afiliados:\n\n- **Total de pedidos:** número total de pedidos dos afiliados.\n- **Total do pedido:** soma dos valores dos pedidos, feita a partir do preço dos itens e sem incluir os custos de envio.\n- **Total da comissão do pedido:** soma dos valores das comissões dos afiliados sobre os pedidos.\n\n> ℹ️ Para acompanhar o fluxo de um pedido, clique sobre o `ID do pedido`. Desta forma, você é redirecionado para o Admin VTEX em **Pedidos > Todos os pedidos**.\n\n### Pesquisar pedidos\n\nPara pesquisar um pedido, digite na barra de busca o `ID do afiliado` relacionado ao pedido. Você pode realizar esta busca associada ao uso de filtros, como será visto [a seguir](#filtrar-pedidos).\n\n### Filtrar pedidos\n\nÉ possível filtrar a busca de pedidos pelos seguintes critérios:\n\n- **Status do pedido:** a opção default é mostrar todos os pedidos. Para escolher um status, clique em **Todos os pedidos** <i class=\"fas fa-angle-down\"></i> e selecione uma das opções sobre o pedido: _Criado, Pagamento aprovado, Pagamento pendente, Faturado ou Cancelado_. Saiba mais em [Fluxo e status de pedidos](/pt/docs/tutorials/fluxo-e-status-de-pedidos).\n- **Período de criação do pedido:** filtre a partir de um intervalo de dias e horas durante o qual os pedidos foram criados. Para isso, no campo `De` determine uma data de início, e no campo `Até` coloque a data final.\n\n### Exportar lista de pedidos\n\nO aplicativo **Affiliates Program** permite que você exporte uma lista com extensão CSV dos pedidos de afiliados.\n\n> ⚠️ Para habilitar a função de exportar lista, primeiro é necessário configurar templates de email, conforme descrito no guia para desenvolvedores [Affiliates Program app](https://developers.vtex.com/vtex-developer-docs/docs/affiliates-program-app#email-templates).\n\nApós a configuração, para exportar a lista, clique em **Exportar** na página **Gerenciamento de Pedidos**. A seguinte mensagem de confirmação deve aparecer:\n\n> _O relatório está sendo gerado e será enviado para o seu email._\n\nO arquivo gerado será enviado para o email do [usuário](/pt/docs/tutorials/gerenciar-usuarios-administrativos) logado. O conteúdo exportado é referente ao total de pedidos da listagem no momento da exportação. Se algum filtro estiver ativo, somente os anúncios selecionados serão exportados.\n\n### Visualizar detalhes do pedido\n\nPara visualizar os dados de um pedido, na linha referente ao pedido clique <i class=\"fas fa-ellipsis-v\"></i> **Mais ações**, e em seguida clique em <i class=\"fas fa-eye\"></i> **Detalhes**.\n\n## Gerenciamento de comissões\n\nA página **Gerenciamento de comissões** permite realizar as seguintes ações:\n\n- [Pesquisar comissões](#pesquisar-comissoes)\n- [Editar comissões](#editar-comissoes)\n- [Exportar planilha de comissões](#exportar-planilha-de-comissoes)\n- [Importar comissões](#importar-comissoes)\n- [Fazer o download da última importação](#fazer-o-download-da-ultima-importacao)\n\n![commissions_ management_page_pt](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/apps/aplicativo-affiliates-program_5.jpg)\n\n### Pesquisar comissões\n\nPara pesquisar entre as comissões de pedidos, na barra de busca da aba **Comissões cadastradas**, digite o `ID do SKU` do pedido, ou seja, o número que [identifica o SKU](/pt/docs/tutorials/descobrir-o-id-de-um-sku).\n\n### Editar comissões\n\nÉ possível alterar o valor percentual de uma comissão seguindo o passo a passo abaixo:\n\n1. Na aba **Comissões cadastradas**, na linha referente à comissão que deseja editar, clique em <i class=\"fas fa-ellipsis-v\"></i> **Mais ações**.\n2. Clique em <i class=\"fas fa-pencil-alt\"></i> **Editar**.\n3. No modal aberto, digite o número da comissão desejada. Decimais não são aceitos.\n4. Clique em `Confirmar`.\n\nA seguinte mensagem deve aparecer:\n\n> _Comissão atualizada com sucesso_\n\n### Exportar planilha de comissões\n\nPara exportar uma planilha de comissionamento por SKU com extensão CSV, no topo da página **Gerenciamento de comissões**, clique em **Exportar**. A seguinte mensagem de confirmação deve aparecer:\n\n> _O relatório está sendo gerado e será enviado para o seu email._\n\nO arquivo será enviado para o email do [usuário](/pt/docs/tutorials/gerenciar-usuarios-administrativos) logado.\n\n> ℹ️ O conteúdo exportado é referente ao comissionamento dos SKUs da listagem no momento da exportação. Se algum filtro estiver ativo, somente as comissões de SKU selecionadas serão exportadas.\n\n### Importar comissões\n\nVocê pode fazer uma atualização em massa de comissionamentos por SKU, conforme o passo a passo abaixo. Se desejar, pode utilizar um template de modelo, clicando em `template em XLSX`.\n\n1. Acesse a aba **Importar comissões**.\n2. Arraste e solte o arquivo em formato CSV ou XLSX na área pontilhada, ou clique em `escolha um arquivo`.\n3. Clique em `Enviar arquivo`.\n\nConfira se a seguinte mensagem aparece:\n\n> _O arquivo está sendo processado_\n\nO nome do arquivo adicionado vai aparecer próximo ao campo `Última importação`.\n\n> ℹ️ É possível identificar a data de importação e o usuário que executou a ação, passando o cursor sobre o símbolo `?` em `Última importação`.\n\n### Fazer o download da última importação\n\nO último arquivo importado fica disponível para download. Para baixá-lo, acesse a aba **Importar comissões**, identifique o nome do arquivo próximo a `Última importação` e clique sobre ele."}