/
Envio de XML por E-mail no SAC Gerencial

Envio de XML por E-mail no SAC Gerencial

1. Contexto do Problema

Durante o envio automático de e-mails com Notas Fiscais Eletrônicas (NF-e) pelo SAC Gerencial, foram identificados dois problemas principais:

  1. O arquivo XML estava sendo enviado sem a devida extensão (.xml), impossibilitando sua abertura direta.

  2. O corpo do e-mail era enviado com formatação incorreta (HTML tratado como texto simples), impactando a legibilidade.

Além disso, o arquivo XML estava sendo transmitido apenas como “xml” sem o nome completo da chave da nota.

2. Causa Identificada

  • Extensão ausente: a rotina de anexos não estava acrescentando a extensão .xml automaticamente.

  • Problema de formatação: o parâmetro de envio “IsHtml” estava configurado como false, o que fazia o cliente de e-mail interpretar o conteúdo HTML como texto puro.

  • Nome do arquivo: não havia padronização para que o arquivo fosse renomeado com base na chave de acesso da nota, resultando em inconsistência no anexo.

3. Correção Aplicada

A correção foi disponibilizada a partir da versão 3.4.06 (29/09/2025) do SAC Gerencial, com atualização da LumiAPI (1.1.0.15).

As melhorias implementadas foram:

  • Inclusão automática da extensão .xml nos arquivos enviados.

  • Ajuste do parâmetro “IsHtml” para true, garantindo que o corpo do e-mail seja exibido corretamente em formato HTML.

  • Melhoria no mecanismo de nomeação dos arquivos, passando a usar a chave de acesso da NF-e como padrão de nome do anexo (chavenota.xml).

4. Procedimento de Atualização

  1. Verifique a versão atual do SAC Gerencial.

    • Menu: Ajuda → Sobre o Sistema.

    • Certifique-se de estar na versão 3.4.06 ou superior.

  2. Caso já esteja nesta versão:

    • Baixe novamente no GestorWeb, com correções adicionais.

  3. Confirme também a versão da LumiAPI:

    • Utilize a versão 1.1.0.15 ou superior.

    • Link de atualização disponível no repositório oficial da Lumi.

5. Teste de Validação

Após a atualização:

  • Emita uma NF-e e configure o envio por e-mail.

  • Verifique no e-mail do destinatário:

    • O corpo da mensagem deve estar corretamente formatado (HTML ativo).

    • O arquivo anexo deve estar com o nome no formato chavenota.xml.

    • A abertura do XML deve ocorrer sem necessidade de renomeação manual.

6. Observações Importantes

  • Caso a extensão continue ausente, confirme se a versão da DLL LumiAPI foi substituída corretamente no diretório de instalação.

  • Se o corpo do e-mail ainda aparecer sem formatação, valide a configuração de envio com “IsHtml = true” no parâmetro do sistema.

  • Em clientes que utilizam Gmail, certifique-se de que o servidor SMTP aceite anexos com extensão XML sem bloqueios adicionais.

7. Resultado Esperado

  • O envio de XML por e-mail deve funcionar corretamente, com:

    • Arquivo anexo no formato .xml.

    • Nome do arquivo baseado na chave da nota.

    • Corpo do e-mail formatado em HTML.

 

Envio de XML por E-mail no SAC Gerencial

  1. Por que o XML estava sendo enviado sem a extensão .xml?

Porque a rotina de anexos não adicionava automaticamente a extensão, resultando em arquivos genéricos sem reconhecimento pelos clientes de e-mail.

  1. O que foi corrigido na versão 3.4.06 do SAC Gerencial?

Foram implementados ajustes para garantir que:

  • O arquivo seja anexado com a extensão .xml.

  • O nome seja a chave da NF-e.

  • O corpo do e-mail seja exibido corretamente em HTML.

  1. Preciso atualizar o sistema para corrigir o problema?

Sim. A correção está disponível a partir da versão 3.4.06 ou superior.

  1. Onde encontro a atualização?

No Gestor de Atualizações da Lumi Software. Caso já esteja na 3.4.06, baixe novamente, pois houve atualização do mesmo release.

  1. Qual versão da LumiAPI devo utilizar?

A versão 1.1.0.15 ou superior. Essa DLL é responsável por corrigir a extensão do arquivo e o envio correto em HTML.

  1. O corpo do e-mail ainda está aparecendo como texto simples, o que fazer?

Verifique se o parâmetro de envio IsHtml está configurado como true. Essa configuração é necessária para que o HTML seja renderizado corretamente.

  1. O problema afeta todos os provedores de e-mail?

Não. O erro foi mais evidente em contas Gmail, que não reconheciam o anexo sem extensão. Outros provedores podem ter aceitado o arquivo, mas com falhas de leitura.

  1. O que devo fazer se o XML continuar indo sem extensão após a atualização?

Certifique-se de que a DLL LumiAPI_1.1.0.15.dll foi substituída corretamente no diretório de instalação. Se persistir, entre em contato com o suporte.

  1. O sistema permite personalizar o nome do anexo XML?

Atualmente, o padrão é utilizar a chave da nota fiscal como nome do arquivo, garantindo unicidade e conformidade com o processo fiscal.