> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Personalizar Portais de Clientes, Controles de Acesso e Alíquotas de Impostos
> Personalize as páginas de login e cadastro dos clientes, controle a visibilidade da barra lateral por função e configure alíquotas de impostos para faturas e checkout no AgencyHandy.
O AgencyHandy oferece controle aprofundado sobre o que seus clientes veem e experimentam — desde a primeira página que encontram ao fazer login até quais seções da plataforma podem navegar após acessarem. Esta página abrange quatro áreas de configuração interconectadas: o **Portal de Login**, o **Portal de Cadastro**, os **Controles de Barra Lateral e Acesso** e as **Alíquotas de Impostos**. Juntas, essas configurações permitem criar uma experiência polida e adequada à função para cada usuário no seu workspace.
Todas as configurações desta página exigem acesso de **Super Admin** ou **Admin**. Acesse **Configuração do Workspace** na barra lateral esquerda para acessar cada seção.
***
## Portal de Login
O Portal de Login é a página de acesso que seus clientes e membros da equipe veem ao acessar seu workspace no AgencyHandy. Personalizá-lo garante que a primeira impressão dos clientes esteja totalmente alinhada à sua marca — com as imagens, o título e a mensagem da sua agência.
### O Que Você Pode Personalizar
| Elemento | Descrição | Limite |
| ------------ | --------------------------------------------------------- | -------------------------- |
| **Título** | O título principal exibido no topo da página de login | Máximo de 120 caracteres |
| **Imagem** | Uma foto ou ilustração com a identidade visual da agência | PNG, JPG, JPEG — máx. 5 MB |
| **Subtexto** | Uma mensagem curta abaixo dos campos de login | Máximo de 300 caracteres |
### Passos para Personalizar o Portal de Login
Acesse **Configuração do Workspace** na navegação à esquerda e selecione **Portal de Login** no submenu.
Digite o título desejado no campo **Título**. Mantenha-o conciso e relevante — por exemplo, *"Bem-vindo de volta à \[Nome da Agência]"* ou *"Seu Portal do Cliente."* O comprimento máximo é de 120 caracteres.
Clique na área de upload ou arraste e solte um arquivo de imagem (PNG, JPG ou JPEG, máximo de 5 MB) para adicionar um elemento visual à página de login. Essa imagem normalmente aparece ao lado do formulário de login.
Use uma imagem de alta qualidade que represente sua agência — uma foto da equipe, uma ilustração limpa da marca ou um fundo profissional. Certifique-se de que o tamanho do arquivo seja inferior a 5 MB para evitar erros de upload.
No campo **Subtexto**, escreva uma breve mensagem para aparecer abaixo dos campos de login — por exemplo, uma nota de boas-vindas, contato de suporte ou um slogan curto. Mantenha abaixo de 300 caracteres.
Revise o layout da página de login usando a visualização. Quando estiver satisfeito, clique em **Salvar** (ou **Atualizar**) para aplicar as alterações. As mudanças entram em vigor imediatamente.
### Redefinir para os Padrões
Clique em **Redefinir Configurações Padrão** na página do Portal de Login para remover todas as personalizações e restaurar a página de login original do AgencyHandy.
A redefinição para os padrões é irreversível. Todos os títulos, imagens e subtextos personalizados serão permanentemente removidos. Clique em **Cancelar** se não tiver certeza — as alterações não salvas serão descartadas e as configurações salvas atuais permanecerão intactas.
### Boas Práticas
* Mantenha o título curto e acolhedor — os clientes o veem antes de fazer login, por isso ele deve ser tranquilizador.
* Use uma imagem profissional que represente sua agência. Evite fotos de banco de imagens genéricas que pareçam desconectadas da sua marca.
* Visualize em diferentes tamanhos de tela antes de salvar para garantir que o layout da imagem e do texto esteja correto.
* Se a imagem não carregar, confirme se ela atende aos requisitos de formato (PNG, JPG, JPEG) e tamanho (abaixo de 5 MB).
## Portal de Cadastro
O Portal de Cadastro é a página de registro que novos clientes encontram ao criar uma conta no seu workspace. Personalizá-lo cria uma experiência de marca consistente desde a primeira interação que um cliente potencial tem com a plataforma da sua agência.
### O Que Você Pode Personalizar
| Elemento | Descrição | Limite |
| ------------ | --------------------------------------------------------- | -------------------------- |
| **Título** | O título principal exibido no topo da página de cadastro | Máximo de 120 caracteres |
| **Imagem** | Uma foto ou ilustração com a identidade visual da agência | PNG, JPG, JPEG — máx. 5 MB |
| **Subtexto** | Uma mensagem curta abaixo dos campos de registro | Máximo de 300 caracteres |
### Passos para Personalizar o Portal de Cadastro
Acesse **Configuração do Workspace** na navegação à esquerda e selecione **Portal de Cadastro** no submenu.
Digite um título no campo **Título** que dê boas-vindas a novos clientes. Por exemplo, *"Comece com a \[Nome da Agência]"* ou *"Crie sua conta de cliente."* Máximo de 120 caracteres.
Clique na área de upload ou arraste e solte um arquivo de imagem (PNG, JPG ou JPEG, máximo de 5 MB). Essa imagem é exibida na página de cadastro ao lado do formulário de registro.
Use o mesmo estilo visual e paleta de cores nas imagens do portal de Login e do portal de Cadastro para criar uma experiência coesa entre as duas páginas.
Escreva uma breve mensagem de apoio no campo **Subtexto** — por exemplo, instruções sobre o que esperar após o cadastro ou uma proposta de valor breve. Máximo de 300 caracteres.
Revise a página de cadastro usando a opção de visualização. Clique em **Salvar** (ou **Atualizar**) para aplicar as alterações imediatamente.
### Redefinir para os Padrões
Clique em **Redefinir Configurações Padrão** na página do Portal de Cadastro para remover todas as personalizações e restaurar a página de cadastro original do AgencyHandy.
Esta ação não pode ser desfeita. Todas as configurações personalizadas de título, imagem e subtexto serão permanentemente apagadas.
### Boas Práticas
* Combine o tom do título de cadastro com seu estilo geral de comunicação com clientes — profissional, amigável ou ambos.
* Mantenha o subtexto focado: informe aos novos clientes o que acontece após o registro (por exemplo, *"Após o cadastro, nossa equipe enviará um e-mail de boas-vindas em até 24 horas."*).
* Teste o fluxo de cadastro você mesmo após salvar as alterações para confirmar que a página está com a aparência e o comportamento esperados.
## Controles de Barra Lateral e Acesso
As configurações de Barra Lateral e Acesso permitem controlar exatamente o que cada função de usuário pode ver no menu de navegação à esquerda. Você pode renomear itens de menu para combinar com a terminologia da sua agência, substituir ícones padrão por personalizados e ativar/desativar a visibilidade de qualquer seção do menu por função. O resultado é uma interface mais limpa e direcionada para cada pessoa que faz login.
### Funções Que Você Pode Configurar
* Cliente
* Super Admin
* Admin
* Gerente
* Colaborador
* Personalizado (quaisquer funções personalizadas que você criou em Funções e Permissões)
### Passos para Personalizar Itens do Menu da Barra Lateral
Acesse **Configuração do Workspace** e selecione **Barra Lateral e Acesso** no menu de configurações.
Clique no botão **Personalizar** no topo do painel. A lista completa dos itens atuais do menu da barra lateral aparece na categoria **Principal**.
Clique no campo de texto de qualquer item do menu e digite o novo rótulo. Por exemplo, renomeie "Dashboard" para "Visão Geral" ou "CRM" para "Contatos." Clique em **Salvar** para aplicar o novo nome.
Clique no ícone ao lado do nome de um item do menu. Um pop-up é aberto com um conjunto de opções de ícones — selecione um da biblioteca ou faça upload de uma imagem personalizada de 32×32 px para usar seu próprio ícone com a identidade da marca. Clique em **Salvar** para aplicar.
### Passos para Configurar a Visibilidade por Função
Clique no botão **Editar Acesso** (ao lado do botão **Personalizar**). Você verá abas para cada função disponível.
Clique na aba da função que deseja configurar — por exemplo, **Cliente**.
Para cada item do menu listado, use o botão de alternância para mostrar ou ocultar para a função selecionada. Por exemplo, você pode ocultar **Faturas** e **Assinaturas** dos Clientes, mantendo-os visíveis para Admins e Gerentes.
Clique em **Salvar**. As configurações de visibilidade atualizadas entram em vigor imediatamente — os usuários verão as alterações na próxima navegação de página ou após fazer login novamente.
Clique em **Redefinir para o Padrão** na aba de qualquer função para restaurar as configurações de visibilidade originais daquela função.
Uma barra lateral limpa e minimalista melhora a experiência do cliente. Mostrar aos clientes apenas o que precisam — como **Dashboard**, **Pedidos** e **Mensagens** — reduz a confusão e evita que acessem seções destinadas apenas ao uso interno.
### Exemplos de Configurações por Função
| Função | Seções Visíveis Recomendadas |
| ----------- | ------------------------------------------------------ |
| Cliente | Dashboard, Pedidos, Mensagens, Faturas (se necessário) |
| Gerente | CRM, Projetos, Timesheet, Tarefas |
| Colaborador | Dashboard, Tarefas, Projetos, Mensagens |
| Super Admin | Todas as seções (sem restrições) |
### Observações Importantes
* **As alterações são imediatas:** As atualizações de visibilidade por função refletem imediatamente após os usuários atualizarem a página ou fazerem login novamente.
* **A função mais permissiva prevalece:** Se um usuário tiver múltiplas funções, a função com acesso mais amplo tem precedência.
* **Ícones personalizados:** Faça upload de imagens de 32×32 px para combinar com os visuais da marca da sua agência na barra lateral.
* **Consistência de nomenclatura:** Use convenções de nomenclatura claras e consistentes que toda a equipe entenda — evite abreviações ou jargões internos que novos membros da equipe não reconhecerão.
## Alíquotas de Impostos
O recurso de Alíquotas de Impostos permite criar, gerenciar e aplicar configurações de impostos em seus serviços, assinaturas e faturas. Você pode configurar múltiplos tipos de impostos — IVA, GST, Imposto sobre Vendas e outros — com alíquotas específicas por país e estado, suporte para modelos de preços inclusivos e exclusivos e aplicação automática no checkout com base na localização do cliente.
Somente **Super Admins** e **Admins** podem criar, editar ou excluir configurações de impostos.
### Conceitos de Imposto em Resumo
| Conceito | Definição |
| ------------- | ---------------------------------------------------------------------------------------------------------- |
| **Exclusivo** | O imposto é adicionado ao preço listado no checkout (por exemplo, R$100 + 10% de imposto = R$110 no total) |
| **Inclusivo** | O imposto já está incluído no preço exibido ao cliente (por exemplo, R\$110 já inclui o imposto) |
| **ID Fiscal** | O número de identificação fiscal empresarial da sua agência, exibido nas faturas |
### Passo 1: Criar uma Alíquota de Imposto
Acesse **Configuração do Workspace** e clique na aba **Alíquotas de Impostos**.
Clique no botão **+ Novo Imposto**. Um formulário é exibido.
Complete os seguintes campos:
* **Título / Tipo de Imposto** *(obrigatório)*: Insira um nome descritivo, por exemplo, IVA Padrão, GST Reduzido ou Imposto sobre Vendas EUA. Máximo de 255 caracteres.
* **ID Fiscal** *(opcional)*: O número de identificação fiscal empresarial da sua agência. Máximo de 20 caracteres.
* **País de Origem**: Selecione o país principal ao qual este imposto se aplica.
* **Alíquota Geral do País de Origem %** *(opcional)*: A alíquota padrão para o seu país de origem.
* **Alíquotas por País** *(opcional)*: Adicione alíquotas por país com estado, CEP e percentual opcionais. Isso é útil para agências que atendem clientes em múltiplas jurisdições fiscais.
Ative o imposto para **Ativo** para torná-lo imediatamente disponível para uso em serviços e faturas. Defina como **Inativo** para salvar a configuração sem aplicá-la a novas compras ainda.
Clique em **Salvar**. O imposto aparece na sua lista de Alíquotas de Impostos e agora está disponível para vincular a serviços.
Você pode suportar até 4 casas decimais nas porcentagens de alíquota de imposto. Uma alíquota de 0% é válida — use-a para itens com alíquota zero ou cenários de conformidade em que o imposto deve ser listado, mas o valor é zero.
### Passo 2: Vincular Impostos a Serviços
Acesse **Serviços** e crie um novo serviço ou edite um existente.
Prossiga para o Passo 3 (Informações Adicionais) do assistente de configuração de serviço.
Clique em **Adicionar Imposto** e selecione um ou mais tipos de imposto da sua lista configurada. Escolha se os impostos se aplicam como **inclusivos** ou **exclusivos** para este serviço. Esta configuração se aplica a todos os impostos vinculados ao serviço, incluindo taxas de configuração e complementos.
### Passo 3: Como os Impostos São Aplicados
Os impostos podem ser aplicados **automaticamente no checkout** ou **manualmente nas faturas**:
**Automático (Checkout)**
* Os impostos vinculados a um serviço são calculados automaticamente com base na localização de faturamento do cliente.
* O cliente deve fornecer seu país, estado e CEP no checkout para que o imposto baseado em localização seja aplicado.
* Para contas Stripe da Índia, as informações completas de localização (país, estado, CEP) são obrigatórias.
**Manual (Fatura)**
* Ao criar uma fatura manualmente, clique em **Adicionar Impostos** para escolher quais impostos aplicar.
* Os campos de endereço de faturamento são preenchidos automaticamente.
* **Somente impostos exclusivos** podem ser aplicados a faturas manuais — impostos inclusivos não são suportados neste fluxo.
### Exibição do Imposto na Fatura
Cada fatura que inclui um imposto exibe os seguintes detalhes:
* **Nome do Imposto** — o rótulo que você inseriu (por exemplo, IVA, GST)
* **Percentual do Imposto** — a alíquota aplicada (por exemplo, 15%)
* **Valor do Imposto** — o valor calculado cobrado
### Gerenciando Alíquotas de Impostos Existentes
* **Editar um imposto:** Clique na entrada do imposto na lista para atualizar seu título, alíquota ou regras por país. As atualizações se aplicam apenas a faturas e compras futuras.
* **Excluir um imposto:** Impostos excluídos não se aplicam mais a novas compras ou assinaturas, mas as faturas existentes que os incluíam não são afetadas.
* **Desativar um imposto:** Defina um imposto como **Inativo** para parar de aplicá-lo a novas compras sem excluir a configuração.
### Observações Importantes
* **Descontos de cupom são aplicados antes do imposto:** Quando um cliente usa um cupom de desconto, o imposto é calculado sobre o preço com desconto, não sobre o preço original.
* **Múltiplos impostos por serviço:** Você pode vincular mais de um imposto a um único serviço (por exemplo, IVA + GST simultaneamente).
* **O imposto se aplica a complementos e taxas de configuração:** Se o seu serviço tiver uma taxa de configuração ou complementos, o imposto também será aplicado a esses valores.
* **A localização do cliente é preenchida automaticamente:** Se um cliente tiver um país e estado de faturamento salvos em seu perfil, esses campos serão preenchidos automaticamente no checkout. No entanto, editar a localização durante o checkout **não** atualiza o perfil do cliente.
* **Detecção de estado por CEP:** Para clientes dos EUA, o sistema pode detectar automaticamente o estado a partir do CEP e aplicar o imposto regional correto, se configurado.