Este documento apresenta os passos necessários para o cadastro e a validação de endereços de e-mail no sistema Vetor Farma, utilizados para o recebimento automático dos arquivos XML enviados à loja. Confira a seguir as orientações para realizar essa operação corretamente.

Pré-requisitos

Os pré-requisitos para a realização dessa operação variam de acordo com o tipo de provedor de e-mail utilizado pelo usuário.

  1. Configuração utilizando provedores de e-mail (KingHost, Yahoo, Uol, Bol, GloboMail, iCloud etc.)
    • O usuário deve possuir autorização para realizar o cadastro do e-mail no sistema.
    • A conta de e-mail que será cadastrada deve estar ativa, e o usuário deve possuir a "Senha" de acesso correspondente.
  1. Configuração utilizando provedores Google (Gmail) ou Microsoft (Outlook)
    • O usuário deve possuir autorização para realizar o cadastro do e-mail no sistema.
    • A conta de e-mail que será cadastrada deve estar ativa, e o usuário deve possuir as credenciais Client ID e Client Secret.
    • Exclusivamente para e-mails hospedados nesses provedores é obrigatória a realização de uma configuração adicional utilizando a autenticação OAuth 2.0, responsável pela geração das credenciais Client ID e Client Secret. Esse método garante maior segurança no acesso às contas de e-mail, dispensando o uso direto de usuário e senha. 

Saiba mais light bulb 

O OAuth 2.0 (Open Authorization) é um padrão de autorização segura que permite que um sistema acesse recursos de outro serviço em nome do usuário, sem a necessidade de informar ou armazenar a senha desse serviço. Ele funciona por meio da emissão de tokens de acesso, que substituem o uso direto de credenciais tradicionais.

No caso dos provedores Google (Gmail) e Microsoft (Outlook), o OAuth 2.0 é utilizado em conjunto com seus respectivos serviços de identidade, Google Identity e o Microsoft Entra ID (antigo Azure AD). Esses serviços são responsáveis por autenticar o usuário e conceder, via OAuth 2.0, as permissões necessárias ao sistema.

Na prática, o usuário autoriza explicitamente que o sistema acesse apenas os dados necessários, mantendo suas credenciais protegidas e sob controle do provedor de e-mail.

Exemplo:

Ao configurar um e-mail no Vetor Farma para a busca automática de arquivos XML, o sistema precisa acessar a caixa de entrada do endereço informado. Com o OAuth 2.0, essa permissão é concedida por meio das credenciais Client ID e Client Secret, geradas nos provedores do Gmail ou do Outlook.

Dessa forma:

  • O Azure AD (Microsoft Entra ID) ou o Google Identity autentica o usuário;
  • O OAuth 2.0 é utilizado para conceder a autorização de acesso;
  • O Vetor Farma recebe autorização para ler os e-mails e identificar os arquivos XML;
  • A senha do e-mail não é compartilhada nem armazenada no sistema;
  • O acesso é restrito apenas à finalidade configurada, garantindo mais segurança e conformidade com os padrões atuais dos provedores de e-mail.

Em caso de dúvidas, o usuário pode entrar em contato com a equipe de Suporte da Zetti Tech para obter orientações sobre o correto preenchimento das informações de configuração. No entanto, a equipe irá apenas orientar, o acesso à conta de e-mail e a realização da configuração devem ser efetuados exclusivamente pelo usuário autorizado e responsável pela loja.

A operação está organizada em dois passos principais: o cadastro do e-mail no sistema e a "Validação" do cadastro, que também contempla as ações de edição e exclusão do e-mail configurado. Para os usuários que têm e-mail hospedado no Google ou Microsoft, no fim da documentação, encontra-se a passo a passo para a configuração dos provedores de e-mail Google (Gmail) e Microsoft (Outlook). Para facilitar a navegação, utilize o menu lateral à direita para acessar o passo que deseja consultar.

Como acessar

  1. Realize o login no Vetor Farma;
  2. Acesse o menu: Cadastros >> Outros cadastros >> E-mail.

1º Passo – Cadastrar E-mail

Através da tela de cadastro de e-mails, o usuário realiza o cadastro e o gerenciamento dos endereços de e-mail que serão utilizados para o recebimento automático dos arquivos XML enviados à loja. Para e-mails hospedados nos provedores Gmail ou Outlook, é obrigatória a realização prévia da configuração de autenticação OAuth 2.0, com a obtenção das credenciais Client ID e Client Secret, conforme mencionado nos pré-requisitos gerais dessa operação. Somente após essa configuração adicional o e-mail poderá ser cadastrado corretamente no sistema. Por outro lado, os usuários cujos e-mails estejam hospedados em outros provedores, como o Yahoo por exemplo, não precisam realizar essa configuração adicional. Nesses casos, basta ter em mãos o endereço de e-mail e a senha de acesso correspondentes para concluir o cadastro.

Ao acessar a tela, observe que, na seção superior, são exibidos os campos destinados ao cadastro de novos e-mails. Já na seção inferior, é apresentada a relação de e-mails já cadastrados, quando houver, permitindo a consulta e seleção de um cadastro para edição, validação e /ou exclusão. Neste primeiro passo, acompanhe os detalhes para o cadastro de um novo e-mail ou, se preferir, clique aqui para acessar o segundo passo e aprender como consultar, editar, validar e excluir um e-mail já cadastrado.

Para iniciar o cadastro, caso o usuário utilize e-mails hospedados nos provedores Google (Gmail) ou Microsoft (Outlook), é necessário estar em posse do endereço de e-mail, do Client ID e do Client Secret. Clique aqui para apreender como configurar. Já para e-mails hospedados em outros provedores, basta possuir o endereço de e-mail e a senha correspondente. Com essas informações em mãos, informe no campo "E-mail" o endereço que será cadastrado e no campo à frente, informe a "Senha". 

No campo "Senha", preencha apenas se o e-mail utilizar um provedor diferente de Gmail ou Microsoft; caso contrário, mantenha esse campo em branco. Se o usuário informar qualquer valor no campo "Senha", ao final do cadastro o sistema exibirá uma mensagem de alerta, impedindo a conclusão do cadastro e informando que, para esses provedores, não é necessário preencher a senha. 

 

Na sequência, no campo "Situação", selecione o status do novo cadastro. Ao escolher a opção "Ativo", após a finalização do cadastro, a configuração do e-mail ficará funcional e o sistema passará a realizar automaticamente a busca pelos arquivos XML. Já a opção "Inativo" indica que o cadastro permanecerá desativado, não efetuando a busca dos arquivos. Essa alternativa permite que o e-mail seja ativado posteriormente, quando necessário.

As configurações das duas seções abaixo, requerem conhecimento técnico e os dados podem ser visualizadas nas telas de configuração do "E-mail" no provedor correspondente (Google, Microsoft, KingHost, Yahoo etc.). 

Na seção à esquerda "E-mails de entrada (POP)" informe o "Servidor" e a "Porta" e marque a opção "Este servidor requer uma conexão SSL/TLS", caso ele precise dessa conexão. 

Para e-mails hospedados nos provedores Gmail e Outlook, a opção “Este servidor requer uma conexão SSL/TLS” deve ser obrigatoriamente marcada. Conforme o caso, clique aqui para acessar as instruções detalhadas de como habilitar o POP conforme as orientações da Microsoft e clique aqui para consultar o procedimento correspondente no Google.

Já para outros provedores, como KingHost ou Yahoo, por exemplo, é necessário consultar a documentação oficial do serviço para verificar se a conexão SSL/TLS é exigida, bem como confirmar o servidor e a porta a serem utilizados na configuração.

Ao lado direito, na seção "E-mail de saída (SMTP)" indique o "Servidor" e a "Porta" correspondente, a seguir em "Método de criptografia", marque o tipo de segurança de dados do E-mail. 

Para e-mails hospedados nos provedores Gmail e Outlook, o “Método de criptografia” é SSL/TLS" deve ser configurado como "SSL/TLS", conforme a exigência de conexão definida nas opções ao lado. Para e-mails hospedados em outros provedores, o “Método de criptografia” deverá ser selecionado de acordo com as configurações exigidas pelo servidor, sendo recomendada a consulta à documentação oficial do serviço de e-mail para garantir a correta seleção.

As configurações apresentadas na seção “OAuth 2.0 (Gmail/Outlook)” devem ser realizadas exclusivamente por usuários que utilizam e-mails hospedados nos provedores Google (Gmail) ou Microsoft (Outlook). Caso o seu e-mail esteja hospedado em outro provedor, clique aqui para continuar para a próxima etapa do cadastro. Se o e-mail for Gmail ou Outlook, informe nos campos correspondentes o "Client ID" e o "Client Secret", credenciais obtidas durante a configuração do OAuth 2.0.

Para que o sistema realize a busca automática dos arquivos XML no e-mail cadastrado, é indispensável marcar a opção “Habilitar importação de XMLs de entrada”. 

Caso essa opção não seja marcada, o recurso permanecerá desativado e nenhuma busca por arquivos XML será executada. Portanto, para que o serviço de importação ocorra corretamente, a opção “Habilitar importação de XMLs de entrada” deve estar sempre ativa.

Para finalizar o cadastro e gravar o registro, tecle o atalho >>F2 e confirme a operação.

Logo após, o sistema gravará a informação gerando um código de cadastro para o novo registro, e ao final exibirá a mensagem: "Transação efetuada com sucesso!". O novo registro será incluído na "Relação de e-mails" na seção abaixo, clique em >> Ok para confirmar a leitura da mensagem.

Com a configuração realizada e validada corretamente, o sistema se conectará ao e-mail configurado a cada 30 minutos para realizar a busca dos arquivos XML recebidos. Sempre que forem identificados arquivos XML vinculados ao CNPJ da loja, o sistema efetuará o download e a importação dos documentos, que ficarão disponíveis para conferência na tela Importação de Nota Fiscal, acessível pelo caminho Operação >> Entradas >> Entradas de nota fiscal, botão >> Importação.

Sendo assim, acompanhe no passo a seguir e veja como validar um novo e-mail cadastrado.

2 º Passo – Consultar, editar, validar e/ou excluir E-mail configurado

Após cadastrar um novo e-mail, o usuário deverá realizar a validação da autenticação para que, por meio do OAuth 2.0, sejam concedidas ao sistema as permissões necessárias de acesso à conta de e-mail. Por esse motivo, é fundamental que o cadastro tenha sido preenchido corretamente. Caso alguma informação esteja incorreta ou incompleta, a comunicação com o provedor de e-mail não será estabelecida de forma adequada e, consequentemente, a verificação e importação dos arquivos XML não ocorrerá corretamente. Sendo assim, ao acessar o cadastro do e-mail para validação, é recomendável verificar se todas as informações informadas estão corretas e, se necessário, atualizar os dados ou até mesmo excluir o registro. Confira a seguir os detalhes a seguir.

  • Consultar e editar

Como visto anteriormente, todos os e-mails cadastrados são exibidos na seção "Relação de e-mails". Para detalhar um cadastro, basta localizar o e-mail desejado e clicar duas vezes sobre ele. Se preferir, o usuário pode informar o código do cadastro no campo "Código" e pressionar >> Enter para detalhar o registro. Por outro lado, caso a lista de e-mails seja extensa e o usuário desconheça o código de cadastro e não queira navegar pela lista, ele pode utilizar o botão de pesquisa "" para facilitar a localização do cadastro desejado.

Após analisar os dados do cadastro, o usuário pode editar as informações, se identificar a necessidade. E para gravar os ajustes, deverá teclar o atalho >> F2  e confirmar a mensagem seguinte.

Com o cadastro realizado corretamente, veja a seguir como validar o e-mail. Caso seja necessário, clique aqui e veja como excluir o cadastro selecionado.

  • Validar

Com o cadastro do e-mail desejado detalhado na tela, veja que o botão >> Validar autenticação do e-mail estará habilitado, sendo assim, clique sobre ele para validar os dados configurados e aguarde. 

Após clicar no botão >> Validar autenticação do e-mail, a resposta do sistema varia conforme o tipo de provedor de e-mail utilizado. Veja a seguir como ocorre em cada situação.

    • Provedores de e-mail (KingHost, Yahoo, Uol, Bol, GloboMail, iCloud etc.)

Quando o e-mail consultado pertencer ao provedor KingHost, Yahoo, Uol, Bol, GloboMail, iCloud ou outro que não seja Google e Microsoft, e as informações de cadastro estiverem preenchidas corretamente, o sistema exibirá a mensagem “Autenticação do e-mail validada com sucesso”. Clique em >> OK para confirmar a leitura e concluir a validação.

Se houver alguma divergência no cadastro do e-mail, será exibido um alerta de inconsistência de dados, sendo necessária a correção das informações. Neste caso, clique em >> Ok para confirmar a leitura da mensagem, realize os ajustes necessários e repita o processo de validação.

Se mesmo após a revisão e o ajuste das informações, o erro persistir, o usuário deverá entrar em contato com a equipe de Suporte para obter orientações adicionais e auxílio na resolução do problema.

    • Provedores de e-mail Google (Gmail) e Microsoft (Outlook)

Para e-mails hospedados nos provedores Google e Microsoft , ao realizar a validação, o sistema abrirá uma nova guia do navegador com a tela de login do respectivo provedor. Após efetuar o login normalmente, será exibida uma tela informando que a aplicação app zetti.dev solicita permissão para acessar a conta de e-mail. Para concluir o processo de autenticação e permitir a comunicação com o sistema, clique em >> Permitir.

Após, caso a validação seja concluída com sucesso, a página será atualizada com o retorno da validação, conforme o exemplo abaixo, exibindo a mensagem “E-mail validado com sucesso”.  Observe que, o link exibido contém a URL de redirecionamento utilizada no cadastro (https://api.zetti.dev/webapi/notasfiscais/NotaFiscal/callback). Essa informação confirma que o processo de autenticação e validação foi realizado com sucesso.

Caso essa confirmação não seja apresentada, o usuário deverá acessar consultar o cadastro do e-mail e revisar as informações informadas, corrigindo os dados necessários antes de realizar uma nova validação.

Se mesmo após a revisão e o ajuste das informações, o erro persistir, o usuário deverá entrar em contato com a equipe de Suporte para obter orientações adicionais e auxílio na resolução do problema.

Se ao analisar as informações, o usuário sentir a necessidade de excluir o registro para realizar um novo, será possível. Confira no tópico a seguir como realizar a exclusão de um cadastro.


  • Excluir

Após consultar um cadastro, é possível excluí-lo facilmente através do >>F5. Após acionar o atalho, será exibida uma mensagem para que o usuário confirme se realmente deseja realizar a exclusão. Clique em >> Sim para confirmar.

Ao confirmar, outra mensagem será exibida, informando sobre o sucesso da operação e o registro será removido da seção "Relação de e-mails". 

Assista à videoaula



Configurar Gmail (Google OAuth 2.0) e Outlook (Microsoft OAuth 2.0 / Azure AD)

A obtenção das credenciais Client ID e Client Secret é obrigatória para a comunicação do sistema Vetor Farma com os provedores de e-mail Gmail e Outlook. Esse modelo de autenticação, baseado em OAuth 2.0, é o único meio suportado para integração com esses provedores. Sem essas credenciais, a configuração do e-mail não poderá ser concluída, pois o Client ID é um requisito exigido tanto pelo Google quanto pela Microsoft.

Acesse o Google Cloud Console através do endereço: https://console.cloud.google.com

De acordo com o provedor de e-mail utilizado, clique na opção correspondente para acessar o passo a passo detalhado de configuração no Google ou no Microsoft (Azure AD).

  • Gmail (Google OAuth 2.0)

A configuração do OAuth 2.0 começa com a criação de um projeto, seguido da sua configuração e, por fim, da geração das credenciais. No Google Cloud, um projeto funciona como um contêiner que organiza e centraliza todos os recursos utilizados em uma determinada solução ou aplicação. É dentro do projeto que ficam vinculados os dados, como os armazenados no Cloud Storage, além das permissões de usuários, APIs habilitadas e configurações essenciais, como faturamento, autenticação e monitoramento. Dessa forma, o projeto permite gerenciar de forma estruturada quem pode acessar os recursos, quais serviços estão ativos e como o uso da plataforma é controlado e acompanhado. Veja a seguir como configurar cada etapa.

    • Criar projeto

Ao acessar o Google Cloud Console, caso o usuário já esteja conectado a uma conta do Gmail, será exibida uma tela identificando a conta em uso. Nela, é necessário aceitar os "Termos de Serviço" e clicar em >> Concordar e continuar para prosseguir. Se a conta exibida não for a desejada, basta clicar em "Mudar de conta" e realizar o login com o e-mail correto. Por outro lado, caso o usuário ainda não esteja autenticado, ao acessar o Google Cloud a tela de login será exibida automaticamente; nesse caso, é só informar as credenciais da conta Google e confirmar o acesso.

Em seguida, de acordo com o tipo de conta utilizada no acesso, o botão localizado no canto superior esquerdo da tela apresentará uma descrição específica. Caso o usuário esteja logado em uma conta corporativa (ex.: @nomedaempresa), o botão será exibido como >> Selecionar um projeto. Se o acesso estiver sendo feito por uma conta pessoal (ex.: @gmail.com), esse botão será exibido com o nome >> Módulo Mapas Suite CRM. De acordo com o tipo de conta, clique no botão para prosseguir.

Na sequência, uma nova tela será exibida para dar continuidade à configuração. Portanto, clique em >> Novo projeto.

Em seguida, outra tela será apresentada. No campo "Nome do projeto", o sistema sugerirá uma descrição padrão; apague esse texto e informe um nome de sua preferência (por exemplo: integração e-mail Zetti). Observe que, caso a conta utilizada seja corporativa, também serão exibidos os campos "Organização", com o domínio @nomedaempresa, e o campo "Local", preenchido com a mesma informação. Mas se a conta logada for pessoal, será exibido apenas o campo “Local”, sem a indicação de uma organização vinculada. Para avançar, clique em >> Criar.

Quando o Google Cloud é acessado com um e-mail corporativo do Google Workspace, os projetos são criados dentro de uma Organização, que representa a empresa e permite governança centralizada, como controle de acesso, políticas de segurança, auditoria e faturamento. Já ao utilizar uma conta pessoal @gmail.com, não há uma organização associada; nesse caso, o projeto não fica vinculado a uma organização.

Em seguida, clique novamente no botão localizado no canto superior esquerdo da tela. Nesse momento, ele estará identificado com o nome atribuído ao projeto criado. Na tela exibida na sequência, o projeto aparecerá listado; localize-o e clique sobre ele para selecioná-lo e dar continuidade à configuração.

Ao acessar o projeto, no canto superior esquerdo da tela, clique no ícone representado por três linhas "". 

Em seguida, no menu exibido à esquerda, selecione a opção "APIs e serviços" e, depois, clique em "Tela de permissão OAuth".

Feito isso, será exibida a tela “Visão geral de OAuth”. No centro da página, aparecerá uma mensagem informando que a plataforma de autenticação do Google ainda não está configurada. Para iniciar o processo, clique em >> Vamos começar.

    • Configurar projeto

Na tela seguinte, configure as informações do projeto. Comece pelas "Informações do APP".  No primeiro campo informe "O nome do aplicativo que precisa da permissão", e no campo a seguir informe um endereço de "E-mail para suporte do usuário". Após, clique em >> Avançar.

O campo "E-mail de Suporte ao Usuário" exige que o usuário especifique um endereço de e-mail que será exibido aos usuários na tela de consentimento. Este deve ser um endereço de e-mail que ele monitora regularmente para poder responder às perguntas que eles possam ter sobre login ou autorização.

Em seguida, marque a opção “Externo” (mais comum para aplicações SaaS). Essa opção indica ao Google que a aplicação será utilizada fora do ambiente interno da empresa, como em sistemas web, plataformas online ou soluções em nuvem. Ao selecionar essa configuração, o usuário permite que outros  usuários externos realizem a autenticação, normalmente por meio de um navegador, utilizando URLs públicas de redirecionamento, que são obrigatórias nesse tipo de integração. Após a marcação, clique em >> Avançar.

Em "Dados de contato", informe um ou mais endereços de e-mail. Esses contatos serão utilizados pelo Google para enviar notificações sobre todas as mudanças do projeto. Informados o(s) e-mail(s), clique em >> Avançar.

Para concluir, marque a opção para concordar com a política de dados do usuário dos serviços de API do Google. Em seguida, clique em >> Continuar e, depois, em >> Criar para finalizar a configuração. Assim, o usuário retorna para a tela principal.

Após a configuração do projeto, a próxima etapa é criar as Credenciais OAuth 2.0, veja a seguir como realizar essa etapa.

    • Gerar Credenciais OAuth 2.0

 No canto superior esquerdo da tela, clique no ícone representado por três linhas "". 

Em seguida, no menu exibido à esquerda, selecione a opção "APIs e serviços" e, depois, clique em "Credenciais".

Na tela de credenciais, clique em " + Criar credenciais" e selecione a opção "ID do cliente OAuth".

Depois disso, informe o tipo de aplicativo como "Aplicativo da Web".

Logo abaixo, preencha o campo "Nome" com uma identificação que facilite o reconhecimento da integração, (por exemplo: "Integração Gmail", "Integração e-mail zetti"). A seguir, em "URIs de redirecionamento autorizados",  clique no botão >> Adicionar URL e  informe no campo "URLs 1" o seguinte endereço: https://api.zetti.dev/webapi/notasfiscais/NotaFiscal/callback

Os usuários serão redirecionados para este caminho após serem autenticados no Google. O caminho será anexado com o código de autorização para acesso e terá um protocolo. Ele não conterá fragmentos de URL, caminhos relativos ou caracteres curinga, nem será um endereço IP público.

Após conferir os dados, clique em >> Criar para finalizar a configuração do ID do cliente OAuth.

Feito isso, uma nova tela será exibida informando que o cliente OAuth foi criado com sucesso, destacando o "ID do cliente" (Client ID) e a "Chave secreta do cliente" (Client Secret). Clique no botão copiar ""ao lado de cada informação e cole os respectivos dados nos campos correspondentes da tela de cadastro de e-mail no sistema. Para fechar a tela, clique em >>Ok.

O ID do cliente está sempre disponível da guia "Clientes da plataforma" de autenticação do Google para que o usuário possa copiar sempre que necessário. Já para visualizar novamente a senha, será preciso clicar no botão de editar, para acessar os detalhes.

Para seguir para o passo de cadastro do e-mail, clique aqui. Caso prefira, continue a leitura para conferir as orientações de como configurar o OAuth do Outlook (Microsoft / Azure AD) e gerar as credenciais desse provedor.

  • Outlook (Microsoft OAuth / Azure AD)

A configuração do OAuth 2.0 / Azure AD no Outlook inicia-se com a criação de um aplicativo no Azure Active Directory (atualmente denominado Microsoft Entra ID), etapa essencial para a geração das credenciais necessárias à autenticação. Nesse contexto, um App no Azure AD representa o registro da aplicação que irá se comunicar com os serviços da Microsoft. Esse registro define a identidade da aplicação e quais recursos ela está autorizada a acessar. A partir dele, os usuários podem se autenticar e conceder permissões utilizando suas credenciais Microsoft, sem a necessidade de compartilhar usuário e senha com o sistema. Esse modelo centraliza o gerenciamento de identidade e acesso (IAM), garantindo maior segurança, controle de permissões e aplicação de políticas de acesso, tanto para recursos em nuvem quanto para ambientes locais. Confira a seguir, como realizar essa configuração.

  1. Pré-requisito
    1. Além dos requisitos gerais, a configuração do Outlook exige o cadastro de um cartão de crédito durante as etapas de criação do app no Azure. É importante destacar que o uso do OAuth 2.0 para o serviço de e-mail não gera cobranças por parte da Microsoft. O cartão é solicitado apenas como requisito da plataforma, e nenhum valor será debitado enquanto forem utilizados, através do Vetor Farma, exclusivamente os recursos de leitura de e-mails. A cobrança somente ocorrerá caso o usuário opte por habilitar ou utilizar outros serviços pagos da Microsoft.

    • Criar App no Azure Active Directory

Após acessar o link do portal Azure, caso o usuário já esteja logado em uma conta Microsoft, o sistema solicitará apenas a confirmação do acesso. Caso contrário, será necessário informar o endereço de e-mail e, em seguida, clicar em >> Avançar para inserir a senha e concluir o login.

Dependendo das configurações de segurança da conta Microsoft, o acesso poderá exigir a inserção de um código de verificação enviado para outro e-mail, aplicativo autenticador ou SMS, ou permitir o login direto apenas com a senha.

Ao acessar o Portal Azure, navegue até >> Azure Active Directory e, em seguida, clique em >> Registros de aplicativos. Na tela exibida, clique na opção >> Novo registro para iniciar o cadastro da aplicação.


Em seguida, no canto superior esquerdo da tela, clique em >> Novo registro.

Na tela que será exibida "Registrar um aplicativo", preencha o campos em destaque da seguinte maneira:

  • Nome: Insira uma descrição que identifique a integração, por exemplo, "Integração E-mail Vetor".
  • Tipos de conta com suporte: Selecione a opção "Contas em qualquer diretório organizacional (qualquer locatário do Microsoft entra com ID-Multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).
  • URI de Redirecionamento: Selecione o tipo "Web" e informe no campo ao lado, o seguinte: endereço https://api.zetti.dev/webapi/notasfiscais/NotaFiscal/callback.

Após conferir os dados informados, clique em >> Registrar para concluir essa etapa.

Após concluir o registro do aplicativo, o sistema exibirá a tela com as informações do app criado. Nela, localize o campo "ID do aplicativo (cliente)", copie o valor apresentado e guarde-o, pois esse identificador corresponde ao "Client ID", que deverá ser informado posteriormente na tela de configuração de e-mail do sistema.

Por fim, para concluir a configuração, é necessário criar o "Client Secret'. No menu ao lado esquerdo da tela, acesse a opção "Certificados e Segredos".

Em seguida, na seção "Segredos do cliente", clique em >> Novo segredo do cliente. 

Depois disso, no canto direito da tela em "Adicionar um segredo de cliente", informe uma "Descrição" para identificação do segredo e defina no campo "Expira em", o prazo de validade do segredo do cliente, (por exemplo, 6, 12 ou 24 meses). Após clique em >> Adicionar. 

A Microsoft, por questões de segurança, estabelece prazos de expiração para os segredos do cliente. Por esse motivo, selecione o período mais adequado à sua operação e, quando o prazo expirar, retorne a essa tela para gerar um novo segredo e manter a integração em funcionamento.

Logo após, o segredo de cliente será criado com sucesso. Localize o campo "ID secreto", copie o valor apresentado e guarde-o, pois ele deverá ser informado posteriormente na tela de configuração de e-mail do sistema.

Esse valor é apresentado apenas uma única vez; portanto, copie e armazene-o em local seguro. Caso perca essa informação, ou ele venha a expirar, será necessário acessar novamente essa tela e registrar um novo ID.

Ao obter as credenciais o usuário pode seguir para o passo de cadastro do e-mail, para isso, clique aqui


Experiências direct hit 

Compartilhe sua experiência

✍️ Clique aqui, descreva o cenário com a experiência e a tratativa aplicada. Seu relato será avaliado e, se aprovado, contribuirá para a troca de conhecimento.

Nota final memo 

Este tópico tem como objetivo esclarecer pontos específicos e complementares relacionados à documentação, oferecendo informações adicionais que contribuem para uma melhor compreensão do conteúdo apresentado.

  • Destaques visuais apresentados no documento;
  • Termos técnicos utilizados:
    • OAuth 2.0 (Open Authorization): é um padrão de autorização segura que permite que um sistema acesse recursos de outro serviço em nome do usuário, sem a necessidade de informar ou armazenar a senha desse serviço. Ele funciona por meio da emissão de tokens de acesso, que substituem o uso direto de credenciais tradicionais.
    • Client ID: (ID de Cliente) é um identificador público que identifica sua aplicação (como um "nome de usuário").
    • Client Secret: (Segredo do Cliente) é uma chave privada, uma "senha" secreta, que autentica essa aplicação e garante que apenas ela possa acessar os dados, sendo essencial para a segurança em sistemas de autorização como OAuth, onde o ID é público e o Secret deve ser mantido em segredo nos servidores.
    • Provedor: é uma empresa ou serviço (como Gmail, Outlook, Yahoo, etc.) que oferece a infraestrutura técnica para você criar um endereço de e-mail (@seuprovedor.com) e enviar, receber, armazenar e gerenciar suas mensagens eletrônicas, sendo fundamental para a comunicação digital, com opções gratuitas (pessoais) e pagas (profissionais, com domínio próprio e mais recursos). 

Explore outros conteúdos e descubra o passo a passo da operação.