Captura automática de XMLs do OneDrive ou SharePoint

Captura automática de XMLs do OneDrive ou SharePoint

Objetivo
Configurar no Fiscal.io Monitor a Integração via Cloud Drive para receber (capturar) XMLs do OneDrive / OneDrive for Business (contas Microsoft pessoais ou Office 365).

Para quem se aplica
Fiscal, Administrativo ou Implantação — com acesso a Integrar e o recurso Cloud Drive liberado no plano.
Pré-requisitos
  1. Fiscal.io Monitor com o recurso Cloud Drive liberado.
  2. Conta Microsoft com OneDrive (Hotmail/Outlook.com ou corporativa Microsoft 365).
  3. Pasta no OneDrive onde os XMLs serão depositados (XML, XSD, ZIP ou RAR — ou subpastas).
  4. Máquina/servidor em Local com internet.
  5. Se for OAuth Privada: aplicativo no Entra ID — veja Como criar o aplicativo no Microsoft Entra ID (OneDrive / SharePoint).

Dois tipos de conexão
  • OAuth 2.0 - Pública — contas pessoais (Hotmail, Outlook.com, etc.). Sem cadastro no Azure.
  • OAuth 2.0 - Privada — contas empresariais Office 365 / Microsoft 365. Exige app no Microsoft Entra ID (Client ID, Tenant ID e permissões/escopos).
Caminho no Monitor
  1. Integrar → Gerenciar Canais de Integração → Adicionar.
  2. Objetivo: Receber arquivos XML.
  3. Meio: Integração via Cloud Drive.
  4. Informe Nome, Local e frequência em Quando.
  5. Selecione a(s) empresa(s) e abra a aba Cloud Drive.
Canal de captura — Integração via Cloud Drive
Cenário 1 — OAuth 2.0 Pública (Hotmail / Outlook pessoal)
  1. Em Tipo de Conexão, selecione OAuth 2.0 - Pública.
  2. Na aba Diretório de Entrada, informe a pasta (ex.: Documents/Fiscal IO - Histórico). Use /.
  3. Opcional: marque leitura em subdiretórios.
  4. Em ação após processamento: Mover para [Processados] ou Excluir arquivo do Diretório.
  5. Clique em Testar Conexão ..., autentique e Salve.
Tipo de conexão Pública
Tipo de conexão Pública
Diretório de Entrada e ação após processamento
Diretório de Entrada e ação após processamento
Importante: teste a conexão antes de salvar.
Como cadastrar o Diretório de Entrada (caminho)
Na aba Diretório de Entrada, informe o caminho da pasta no OneDrive da conta autenticada (não é caminho de disco local tipo C:\).

Formato do caminho
  • Use / para separar pastas (barra normal). Ex.: Documents/Fiscal IO/Entrada.
  • O caminho é relativo à raiz do OneDrive do usuário que autenticou no canal.
  • Não use barra no final. Não informe prefixos como /drive/root:.
  • Barras invertidas (\) são convertidas automaticamente para /, mas o padrão recomendado é já digitar com /.
  • Nomes de pasta podem ter espaço (ex.: Fiscal IO - Histórico).
Exemplos válidos
  • Documents/Fiscal IO - Histórico
  • Documents/XML/Entrada
  • Fiscal.io/Monitor/Receber (pasta na raiz do OneDrive)
Exemplos inválidos / a evitar
  • C:\XML\Entrada — caminho de Windows local
  • \\servidor\share\xml — pasta de rede
  • URL do SharePoint no navegador (copie o caminho de pastas do OneDrive, não o link completo da web)
Subpastas
Se marcar a opção de ler em subdiretórios, o Monitor também busca XML/XSD/ZIP/RAR dentro das pastas abaixo do caminho informado.

Ação após processar
  • Mover para [Processados] — arquivos tratados saem da pasta de entrada.
  • Excluir arquivo do Diretório — remove após processar.
Arquivos com formato inválido ou sem vínculo com a empresa do canal são movidos para pastas internas do fluxo (ex.: inválidos / sem vínculo), conforme a regra do canal.

Dica: crie antes no OneDrive a pasta de entrada (ou deixe o Monitor criá-la quando necessário no fluxo) e use Testar Conexão para validar acesso à pasta.
Cenário 2 — OAuth 2.0 Privada (Office 365)
Primeiro crie o app no Entra ID (Client ID, Tenant ID, plataforma desktop + URI nativeclient, Graph Files.ReadWrite.All, offline_access, User.Read). Não precisa de Client Secret.
Etapa com o cliente (TI): envie este artigo para a TI criar o app e devolver Client ID / Tenant ID — Criar aplicativo no Microsoft Entra ID (OneDrive / SharePoint).
Etapa no Monitor (depois): com os IDs em mãos, siga os passos abaixo.
  1. No Monitor: Tipo de Conexão = OAuth 2.0 - Privada.
  2. Preencha Client ID e Tenant ID.
  3. Em Clique aqui para cadastrar os escopos, cadastre por exemplo Files.ReadWrite.All (ou files.readwrite.all), offline_access e profile / User.Read.
  4. Configure o Diretório de Entrada.
  5. Testar Conexão ... → autorizar a conta corporativa → Salvar.
OAuth 2.0 Privada — Client ID, Tenant ID e escopos
Tela de escopos no Monitor
Tela de escopos no Monitor
Como a captura funciona
  1. Na frequência de Quando, o Monitor lista a pasta no OneDrive da conta autenticada.
  2. Processa XML/XSD/compactados.
  3. Depois move/exclui conforme a ação; arquivos inválidos ou sem vínculo vão para pastas internas (ex.: Fiscal_io_Invalidos, Fiscal_io_Sem_Vinculo).
Artigos relacionados