Guia prático da harpix

Como enviar e-mails do Sankhya pelo Outlook e Microsoft 365

Registre um aplicativo no Microsoft Entra, crie uma configuração OAuth com o provedor Outlook no Sankhya Om e vincule essa configuração à conta na tela Servidor SMTP, marcando "Autenticar com OAuth". A Sankhya recomenda o envio pela Microsoft Graph API. Para alertas e aprovações entre o Sankhya e o Microsoft 365, o harpix integration hub conecta os dois sistemas.

Diagrama da integração: Sankhya, harpix integration hub e Outlook, no fluxo de ida e volta
Diagrama da integração: Sankhya, harpix integration hub e Outlook, no fluxo de ida e volta
Fluxo de ida e volta: Sankhya para o harpix integration hub e para Outlook, e o retorno volta para Sankhya
Fluxo de ida e volta: Sankhya para o harpix integration hub e para Outlook, e o retorno volta para Sankhya

Por que o e-mail do Sankhya pelo Microsoft 365 parou de funcionar

Muitas empresas configuraram o envio de e-mails do Sankhya Om com usuário e senha de uma conta do Microsoft 365. A Microsoft vem desativando a autenticação básica (usuário e senha) no envio por SMTP do Exchange Online. Por isso a ajuda da Sankhya passou a orientar o envio com OAuth, de preferência pela Microsoft Graph API, e trata o envio por SMTP como modelo legado.

Se o teste de envio mostra "Houve falha de autenticação. Verifique o usuário e senha", mesmo com a senha certa, o primeiro ponto a conferir é a forma de autenticação da conta.

Aviso: este guia descreve a configuração de OAuth do Sankhya e da Microsoft. Não é uma declaração sobre os métodos de autenticação do harpix integration hub, que são avaliados em cada projeto.

Passo a passo

Passo 1. Mapeie o que o Sankhya envia por e-mail

Liste notas, boletos, relatórios e avisos que saem por e-mail do Sankhya Om e qual conta do Microsoft 365 envia cada um.

Passo 2. Registre um aplicativo no Microsoft Entra

No portal Microsoft Entra, em Registros de aplicativo, crie um registro com redirecionamento do tipo Web, informando o endereço de redirecionamento indicado na ajuda da Sankhya, gere um segredo do cliente e anote o Client ID e o Client Secret.

Passo 3. Conceda as permissões de envio

Adicione as permissões delegadas de envio de e-mail indicadas pela Sankhya, como Mail.Send e offline_access, e conceda o consentimento do administrador.

Passo 4. Crie a configuração OAuth no Sankhya Om

Na tela Configurações OAuth, crie um registro com o provedor Outlook, marque "Usa Graph API para envio" e informe o nome da API, o Client ID e o Client Secret.

Passo 5. Vincule a conta na tela Servidor SMTP

Na conta de e-mail cadastrada em Servidor SMTP, marque "Autenticar com OAuth", selecione a configuração criada e faça a autenticação na tela da Microsoft.

Passo 6. Teste o envio

Envie um e-mail de teste e confira se ele chegou. Repita para cada conta remetente usada pelo Sankhya.

Os nomes de tela e de campo seguem a ajuda oficial da Sankhya (Configurações OAuth, Servidor SMTP, "Usa Graph API para envio", "Autenticar com OAuth"). Podem variar conforme a versão do Sankhya Om.

O que é configuração do Sankhya e o que é integração

Situação

Onde se resolve

E-mail do Sankhya não sai pelo Microsoft 365

Configuração do Sankhya Om e do Microsoft Entra, como neste guia

Pedido, título ou nota pendente precisa de aprovação de alguém que não usa o Sankhya

Integração: aviso no Outlook ou no Microsoft Teams, com a resposta voltando ao Sankhya

Falha de integração precisa chegar ao time certo

Integração: alerta por e-mail ou Teams, com registro de cada movimentação

Relatórios recorrentes em planilha para quem não acessa o ERP

Integração: envio agendado para Outlook, Excel ou SharePoint

Fluxos comuns com o harpix integration hub

Fluxo

Origem → destino

Quando

Alçada de aprovação de pedido de compra

Sankhya → Outlook ou Teams

Quando o pedido passa do limite combinado

Aviso de título vencido para o financeiro

Sankhya → Outlook

Agendado

Alerta de falha de integração

harpix integration hub → Outlook ou Teams

Quando ocorrer

Relatório de pedidos do dia

Sankhya → Excel ou SharePoint

Agendado

Quando algum sistema da empresa ainda não tem API, a harpix também integra por arquivo, via SFTP, FTP, CSV e TXT.

Onde entra cada produto harpix

  • harpix integration hub: conecta o Sankhya ao Microsoft 365 e aos demais sistemas da empresa, com monitoramento e registro de cada movimentação. Página do produto: harpix.com.br/integration-hub

  • harpix data hub: dashboards, BI e IA sobre os dados do Sankhya já integrados. Página do produto: harpix.com.br/produtos/data-hub

  • harpix consulting: quando a empresa quer desenhar as alçadas de aprovação antes de automatizar.

Leia também

Sankhya, Sankhya Om, Microsoft, Microsoft 365, Outlook, Microsoft Teams, Microsoft Entra, Excel e SharePoint são marcas de seus respectivos titulares. A harpix não tem vínculo com essas empresas, salvo quando indicado. Este guia não substitui a documentação oficial da Sankhya e da Microsoft.

Perguntas frequentes

Por que o Sankhya mostra "Houve falha de autenticação" com o Office 365?

Em geral, porque a conta tenta enviar com usuário e senha e o Microsoft 365 não aceita esse tipo de autenticação no SMTP. A ajuda da Sankhya indica configurar o envio com OAuth. Enquanto isso não é feito, o administrador do Microsoft 365 pode conferir se o SMTP autenticado está habilitado para a caixa remetente.

O Sankhya Om envia e-mail pelo Outlook com OAuth?

Sim. A ajuda da Sankhya descreve a tela Configurações OAuth, com o provedor Outlook, e a vinculação da configuração à conta na tela Servidor SMTP, com a marcação "Autenticar com OAuth".

Devo usar Microsoft Graph API ou SMTP no Sankhya?

A Sankhya recomenda a Microsoft Graph API, ativada pela marcação "Usa Graph API para envio", e trata o envio por SMTP com OAuth como modelo legado.

Quem precisa participar da configuração?

O administrador do Microsoft 365, que registra o aplicativo no Microsoft Entra e concede o consentimento das permissões, e quem administra o Sankhya Om, que cria a configuração OAuth e vincula a conta remetente.

Uma aprovação pode sair do Sankhya e voltar respondida pelo Outlook ou pelo Teams?

Sim, com uma camada de integração. O harpix integration hub leva o pedido de aprovação ao Outlook ou ao Teams e registra a resposta de volta no Sankhya, com rastreio de cada passo.

A harpix configura o e-mail do Sankhya?

A configuração de e-mail é feita no próprio Sankhya Om e no Microsoft 365, como neste guia. A harpix entra quando o e-mail faz parte de um fluxo entre sistemas, como aprovações, alertas e relatórios.

Fale com um especialista

Conte quais sistemas você usa e o que precisa circular entre eles. A harpix parte do que você já tem.

Fale com a gente