FAQ - Portal Avalara
| Site: | Universidade Avalara Brasil |
| Curso: | Portal Avalara |
| Livro: | FAQ - Portal Avalara |
| Impresso por: | Usuário visitante |
| Data: | quarta-feira, 15 mai. 2024, 01:39 |
Índice
- 1. Perguntas Frequentes - Portal Avalara
- 2. Erro "this user does not have access to this application"
- 3. Portal - Como gerar token de assinatura?
- 4. Como fazer a atualização do certificado digital?
- 5. Como fazer a recuperação de senha?
- 6. Como criar um novo usuário no Portal Avalara?
- 7. Como cadastrar CNPJs autorizados a baixar o XML da Nota fiscal (autXML).
- 8. Cadastro de Campos Complementares
- 9. Criação de Matriz e Filial por planilha
1. Perguntas Frequentes - Portal Avalara
Acesse aqui as suas dúvidas referentes ao Portal Avalara!
2. Erro "this user does not have access to this application"
Nesse passo a passo vamos detalhar o procedimento para a solução do erro "this user does not have access to this application".
Guia com passo a passo:
Esse erro ocorre quando o usuário não tem permissão para acessar a aplicação.
O que verificar:
- O usuário que requisita o acesso está no grupo do aplicativo sendo requisitado?
- O aplicativo está habilitado para a assinatura?
- O aplicativo está com a data de vencimento válida?
Onde verificar:
Grupos de usuário
* Acesse o menu Configurações / Grupo de Usuário
* Para verificar o grupo o usuário deve ter acesso de administrador do portal.
* *Adicione o usuário ao grupo da Aplicação.
Ou em Configurações acessando o usuário:
2. Aplicativos da assinatura:
É necessário acessar a Assinatura no Portal Management e verificar o Aplicativo.
**Ativar o aplicativo e atualizar a data de vencimento.
3. Portal - Como gerar token de assinatura?
Como gerar token de assinatura:
Importante: para esta configuração, o usuário deve ter acesso de administrador do portal.
1.º Passo: como criar um token de acesso à API através do Portal Avalara:
Todo o processo de criação do token, e das credenciais necessárias para ter acesso a um token de acesso, são realizados através do Portal Avalara.
Link do Portal Avalara:
https://portal.sandbox.avalarabrasil.com.br/Login
. Realize o login no Portal Avalara e siga as instruções das imagens abaixo:
**Recomenda-se, de acordo com as boas práticas, que caso exista mais de um ERP sendo integrado, que se utilize um Token de Autenticação por ERP.
Autenticação:
Nosso processo de autenticação é feito pela opção OAuth, que quer dizer que, a cada chamada com as credenciais obtidas no processo descrito acima, será possível ter acesso a um “Access Token”, e com este token, ter acesso às nossas aplicações.
Este “Access Token” tem uma validade, sendo necessário que, após o vencimento da mesma, uma nova validação com as credenciais seja enviada.
É possível ainda fazer a renovação deste “Access Token”, ou mandar as credenciais novamente a cada chamada. Porém, este último método é indicado apenas para o tráfego de ambientes não seguros, tais como: ‘interface’ gráfica.
Abaixo, segue descrição funcional de como realizar cada uma das chamadas.
2.º Passo: como pegar um “Access Token”?
URL: https://api-gateway.sandbox.avalarabrasil.com.br/oauth/token
Campos Obrigatórios/Sugeridos | Atributos | Descrição |
Obrigatório | grant_type | Para a requisição inicial de um “Access Token” deve-se enviar o valor descrito abaixo: |
Obrigatório | client_id | Este é o valor obtido no campo “Assinatura” dentro do Portal Avalara, no momento da geração do token. |
Obrigatório | client_secret | Segredo de token único, gerado pelo Portal Avalara. |
Sugerida | disableTokenRefresh | Esta propriedade indica se o requisitante da sessão gostaria de obter, ou não, um “RefreshToken” para renovar a sessão a cada “X” minutos. Caso o requisitante opte por manter a sessão ativa até que ela expire em “X” horas sem uma renovação periódica, então deve-se enviar o valor como “true”, e desta forma, NÃO OBTERÁ um “RefreshToken” |
Veja exemplos de chamadas e retornos, abaixo: disableTokenRefresh
JSON request SEM o valor “disableTokenRefresh”:
JSON request COM o valor “disableTokenRefresh” como “true”:
3.º Passo: como agir caso seu “Segredo de Token” for exposto?
Caso seu “Segredo de Token” seja exposto, é possível revogar a “data fim” do token através do Portal Avalara, conforme ilustrado abaixo, e criar outro conforme ilustrado no início deste documento:
Perguntas relacionadas: |
| Qualquer usuário pode gerar um token de assinatura? |
| Para ter autorização de gerar um "Token de Assinatura" o usuário dever ter perfil de adminstrador do Portal Avalara. |
O que fazer se eu perder ou não tiver salvado meu “Segredo de Token”? |
Caso voce não tenha guardado ou tenha perdido seu “Segredo de Token”, deve-se inativar o token atual, conforme explicado no STEP 4 deste documento, e criar um novo, conforme explicado no STEP 1. |
Onde posso consultar meu “ID de Assinatura”? |
O seu “ID de Assinatura” pode ser consultado de duas maneiras. A primeira deles é no momento da criação do “Segredo de Token”, conforme demonstrado no STEP 1. A segunda maneira é através da barra lateral do Portal Avalara, no campo “Assinatura”, seguindo as instruções abaixo. |
4. Como fazer a atualização do certificado digital?
Passo a passo para instalar e configurar certificado digital no Portal Avalara:
Importante: para efetuar o procedimento abaixo, o usuário deverá logar com o perfil administrador.
1°. Passo: acesse o link:
https://portal.avalarabrasil.com.br/Login
2.º Passo: clique em “Configurações> Certificados”:
3.º Passo: clique na opção: 
4.º Passo: clique no “Lápis azul” do certificado para inativar os certificados antigos, após a atualização do novo certificado.
. Deixe a opção em Ativo como “OFF” e clique em Salvar:
ATENÇÃO! O PROCEDIMENTO ABAIXO DEVE SER EFETUADO SOMENTE SE UTILIZAR A MENSAGERIA.
. Logo após a instalação do certificado no Portal, é necessário atualizá-lo nos cadastros das Matrizes e Filiais.
1.º Passo: clique em "Configurações> Matriz e Filiais":
2.º Passo: clique em “EDITAR” na Matriz e atualize o certificado no campo “Certificado”:
3.º Passo: clique em “EDITAR” na Filial e atualize o certificado no campo “Certificado”:
. O campo “HABILITA MENSAGERIA” deve estar sempre como “Ativo”:
5. Como fazer a recuperação de senha?
Passo a passo para recuperação de senha:
1.º passo: acesse o link: https://portal.avalarabrasil.com.br/Login
2.º passo: clique em “Esqueci minha senha”;
3.º passo: informe o seu login e clique em "Recuperar Senha".
. Ao realizar o procedimento acima, um e-mail é encaminhado para o endereço cadastrado no portal.
Importante: certifique-se de que o e-mail encaminhado não foi direcionado para a pasta de lixo ou SPAM.
. O e-mail tem este formato:
4.º passo: clique na opção “Clique aqui para redefinir sua senha”.
. O sistema irá redirecionar você para a tela de configuração de nova senha;
. Lembre-se que ela deve conter: letra maiúscula, letra minúscula, números e caractere especial; conforme o exemplo: Avalara123!
5.º passo: preencha os campos abaixo com o token (código de segurança enviado por e-mail), e com a nova senha, e clique em “Trocar senha”:
6.º passo: acesse o portal com seu usuário e a nova senha.
6. Como criar um novo usuário no Portal Avalara?
Passo a passo para criação de um novo usuário no Portal Avalara:
1.º passo: acesse o Portal Avalara utilizando um usuário com perfil de administrador;
2.º passo: clique nos botões, "Configurações > Usuário";
3.º passo: clique no botão "+ Novo Usuário";
4.º passo: preencha todos os campos exibidos em tela:
. Nome: insira o nome do usuário(a);
. E-mail: inclua um endereço de e-mail válido (tudo com letras minúsculas), pois caso o usuário necessite efetuar a recuperação de senha, ela será encaminhada para o e-mail cadastrado;
. Login: insira o e-mail do usuário ou crie algum formato de usuário.
Exemplo: “teste_2” (tudo com letra minúscula).
. Falhas de Login: informe o número zero (0).
. Expira em: insira a data de vencimento do usuário;
. Ativo: ON;
5.º passo: logo após o preenchimento dos campos, é necessário vincular um grupo “Produto” que o usuário terá acesso em “Grupo de usuário”.
6.º passo: clique no botão “Salvar”:
. Após cadastrado, o usuário fica disponível na listagem.
. Caso seja necessário efetuar atualizações no usuário, Clique na Linha.
CADASTRO DE USUÁRIO EM LOTE:
Também é possível realizar a inclusão em lote de novos usuários:
ATENÇÃO! Não efetue nenhuma modificação no layout do Excel
. Após realizar todos os passos acima, o usuário cadastrado deve solicitar a senha na página inicial do portal, clicando em “Meu Primeiro Acesso”:
7. Como cadastrar CNPJs autorizados a baixar o XML da Nota fiscal (autXML).
Como cadastrar CNPJs autorizados a baixar o XML da Nota fiscal (autXML).
1 – Acessar o cadastro da Matriz e Filiais dentro do portal Avalara.
2 – Escolher a Matriz/Filial desejada.
3 – Rolar a pagina até a opção CPFs e CNPJs autorizados, clicar no + e incluir o CNPJ desejado.
OBS: Essa informação sairá no campo autXML no XML da nota fiscal.
8. Cadastro de Campos Complementares
Cadastro de Campos Complementares
Para cadastrar campos complementares no Captura de Documentos, siga os passos abaixo:
1° Acesse o Capturas de Documentos;
2° Clique em Configurações;
3° Clique em campos complementares;
4° Selecione o Tipo de Documento desejado;
5° Cadastre os campos conforme a necessidade, formato e etc;
6° O exemplo abaixo foi criado uma caixa de seleção, sendo possível cadastrar valores;
Exemplo dos dados em tela:
9. Criação de Matriz e Filial por planilha
Criação de Matriz e Filial por planilha
Para efetuar a solicitação deve acessar o portal da Avalara e clicar no menu Matriz e Filial conforme abaixo.
Após acessar Matriz e Filial deve clicar em nova Matriz ou Filial que deseja criar, após clicar em selecionar a opção “Várias Empresas”.
Para carregar os novos estabelecimento sempre usar modelo que esta disponibilizado e seguir as orientações de preenchido da planilha e após isso importar a planilha preenchida para efetuar integração dos dados no portal avalara.
