1dex-brasil

Suíte Contábil e Fiscal (Sistema Contabil) 1DEX Brasil para n8n: Conversor Extrato PDF para OFX/CSV com IA, XML NF-e para DANFE PDF e JSON Fiscal, OCR de Notas Fiscais, SEFAZ DF-e Nacional via Certificado A1, Auditoria FGTS e REDESIM.

Documentation

🇧🇷 n8n-nodes-1dex-brasil — Suíte Contábil, Fiscal, SEFAZ, OFX & FGTS (10 em 1)

npm version
License: MIT
1DEX API Hub

Pacote oficial de integração da 1DEX Brasil para n8n, escritórios de contabilidade, BPO Financeiro, ERPs e automações de documentos fiscais, bancários e trabalhistas brasileiros.


🌐 Ecossistema Oficial 1DEX Brasil (Teste Grátis no Navegador)


⚡ Visão Geral das 10 Operações Incluídas

# Operação Endpoint REST Custo Resumo
1 extratoOfx POST /api/v1/extrato/ofx 1 crédito Extrato Bancário (PDF ou Texto) -> .OFX 1.02 contábil, .CSV (Excel) e JSON estruturado com fallback de IA.
2 danfePdf POST /api/v1/danfe/pdf 1 crédito XML de NF-e (<nfeProc> ou <NFe>) -> PDF oficial do DANFE em Base64 pronto para envio ou impressão.
3 nfXmlToJson POST /api/v1/nf/xml-to-json 1 crédito XML de NF-e/NFC-e -> JSON estruturado com Itens (NCM/CFOP) e Resumo Fiscal de Impostos (ICMS, ST, IPI, PIS, COFINS).
4 nfOcr POST /api/v1/nf/ocr 1 crédito OCR de Nota Fiscal ou Cupom em PDF/Texto -> JSON estruturado com Emitente, CNPJ, Chave de 44 dígitos e Itens via IA.
5 sefazDistribuicao POST /api/v1/sefaz/distribuicao 2 créditos Sincroniza lotes de NF-e direto na SEFAZ Nacional por NSU usando Certificado Digital A1 (.pfx em Base64).
6 sefazConsultarChave POST /api/v1/sefaz/consultar-chave 2 créditos Consulta e baixa o XML oficial de uma NF-e específica pela Chave de 44 dígitos na SEFAZ Nacional via Certificado A1.
7 sefazManifestar POST /api/v1/sefaz/manifestar 2 créditos Registra Ciência da Operação (210210) na SEFAZ Nacional e já faz o download do XML completo (procNFe).
8 fgtsAnalisarPdf POST /api/v1/fgts/analisar-pdf 1 crédito Extrai todos os depósitos (115-DEPOSITO), competências, datas e soma auditada de Extratos Analíticos PDF do FGTS.
9 redesimConsultar POST /api/v1/redesim/consultar 2 créditos Consulta andamento, etapa atual e exigências de protocolos societários na REDESIM / Jucerja.
10 fiscalValidarChave POST /api/v1/fiscal/validar-chave Grátis Decompõe UF, AAMM, CNPJ, Modelo, Série, Número e valida o Dígito Verificador Módulo 11 de qualquer chave de 44 dígitos.

📖 Guia Completo de Uso por Operação

1️⃣ Converter Extrato Bancário (extratoOfx)

Converte PDFs de qualquer banco brasileiro (Itaú, Bradesco, Banco do Brasil, Santander, Caixa, Nubank, Inter, Cora, Sicredi, Sicoob, Stone, Mercado Pago) em OFX 1.02, CSV e JSON.

  • Como usar no n8n:
    • Se você recebeu um arquivo PDF (ex: via Webhook, Gmail ou WhatsApp), converta o binário para Base64 (ou use {{$binary.data.data}}) e passe no campo PDF em Base64.
    • Informe o Código FEBRABAN do Banco (ex: 0341 para Itaú, 0237 para Bradesco, 0001 para BB, 0260 para Nubank).
  • O que retorna:
    • resumo: { totalTransacoes, totalCreditos, totalDebitos, saldoLiquido }
    • transacoes: Array com { data, tipo ("CREDIT"|"DEBIT"), valor, descricao, fitid }
    • ofx: String completa do arquivo .ofx e ofxBase64 (pronto para converter em arquivo binário .ofx usando o node Convert to File).
    • csv: String completa em formato Excel Brasileiro (;).

2️⃣ Gerar DANFE PDF Oficial a partir do XML (danfePdf)

Transforma o XML bruto de uma Nota Fiscal Eletrônica (NF-e modelo 55) no PDF oficial do DANFE (retrato, com código de barras da chave de acesso, quadro de impostos, transportadora, itens e duplicatas).

  • Quando usar:
    • Quando você baixa o XML da SEFAZ (usando a operação sefazDistribuicao ou sefazConsultarChave) ou recebe o XML por e-mail/ERP e precisa enviar o PDF legível para o cliente no WhatsApp, e-mail ou salvar no Google Drive.
  • Parâmetros obrigatórios:
    • XML da NF-e (xml): Cole ou mapeie a string completa do XML (começando com <?xml... ou <nfeProc... ou <NFe...).
  • O que retorna:
    {
      "success": true,
      "filename": "danfe-123456.pdf",
      "mimeType": "application/pdf",
      "pdfBase64": "JVBERi0xLjQKJeLjz9MKNCAwIG9iago8PC9UeXBlL1hPYmplY3QvU3VidHlwZS9JbWFnZS...",
      "creditosRestantes": 9
    }
    
  • Dica no n8n (Como transformar pdfBase64 em arquivo PDF anexável):
    • Adicione um node Convert to File (operação Move Base64 String to File) logo após o node 1DEX Brasil e aponte para o campo {{$json.pdfBase64}} com Mime Type: application/pdf e File Name: {{$json.filename}}.

3️⃣ XML NF-e/NFC-e para JSON Fiscal & Auditoria de Impostos (nfXmlToJson)

Evita que você precise criar dezenas de expressões XPath/Regex para ler um XML de Nota Fiscal.

  • Parâmetros:
    • XML da NF-e / NFC-e (xml): O conteúdo XML da nota.
  • O que retorna:
    • Dados completos do emitente (CNPJ, Razão Social, UF), destinatario, chave, numero, serie, dataEmissao.
    • Lista de itens com codigo, descricao, ncm, cfop, unidade, quantidade, valorUnitario, valorTotal.
    • Objeto impostos já somado e auditado: { vBC, vICMS, vICMSDeson, vBCST, vST, vIPI, vPIS, vCOFINS, vTotTrib }.

4️⃣ OCR de Nota Fiscal / Cupom Fiscal via IA (nfOcr)

Tem apenas o PDF ou texto sujo de uma Nota Fiscal de Serviço (NFS-e de prefeitura), DANFE ou Cupom sem o XML? O motor extrai o texto do PDF e usa Inteligência Artificial estruturada para devolver os dados fiscais prontos para o seu ERP.

  • Parâmetros:
    • Envie PDF em Base64 (pdfBase64) OU Texto Extraído (texto).
  • O que retorna:
    • chaveAcessoDetectada: Chave de 44 dígitos (se encontrada no documento).
    • dados: { numero, serie, dataEmissao, emitenteNome, emitenteCnpj, destinatarioNome, destinatarioCnpj, valorTotal, impostos, itens }.

5️⃣ SEFAZ DF-e: Sincronizar Lote de Notas por NSU (sefazDistribuicao)

Conecta diretamente no WebService Nacional da SEFAZ (NFeDistribuicaoDFe) via mTLS usando o Certificado Digital A1 (.pfx) da empresa, sem que você precise configurar envelopes SOAP, OpenSSL, C14N ou descompactar GZIP (docZip).

  • Como funciona o fluxo de NSU na SEFAZ:
    • Na primeira execução, envie Último NSU (ultNSU) = "0".
    • A SEFAZ retornará até 50 documentos fiscais e informará no retorno os campos ultNSU (último NSU retornado no lote) e maxNSU (maior NSU existente na SEFAZ para aquele CNPJ).
    • Salve o ultNSU retornado no seu banco de dados e, na próxima execução (ex: a cada 1 hora), envie esse valor no campo ultNSU para buscar apenas as notas novas!
  • Parâmetros obrigatórios:
    • Certificado A1 (.pfx) em Base64 (pfxBase64): O arquivo .pfx ou .p12 convertido em string Base64.
      • Como gerar o Base64 do seu .pfx no terminal Linux/Mac: base64 -w 0 seu_certificado.pfx
      • Como gerar no PowerShell (Windows): [Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\caminho\certificado.pfx"))
    • Senha do Certificado A1 (senha): A senha do arquivo .pfx.
    • CNPJ ou CPF (cnpj): Os 14 dígitos do CNPJ (ou 11 do CPF) titular do certificado.
    • Último NSU (ultNSU): Número Sequencial Único inicial (padrão "0").
  • O que retorna:
    {
      "success": true,
      "cStat": "138",
      "xMotivo": "Documento localizado",
      "ultNSU": "000000000001452",
      "maxNSU": "000000000001452",
      "totalDocumentos": 12,
      "notas": [
        {
          "nsu": "000000000001441",
          "schema": "resNFe_v1.01.xsd",
          "tipoDocumento": "RESUMO_NFE",
          "chave": "35261112345678000199550010000012341000012345",
          "emitente": "FORNECEDOR EXEMPLO LTDA",
          "cnpjEmitente": "12345678000199",
          "valor": 1850.00,
          "xml": "<resNFe ...>...</resNFe>"
        }
      ]
    }
    

    💡 Nota importante sobre a SEFAZ: Quando alguém emite uma nota contra o seu CNPJ, a SEFAZ disponibiliza primeiro um Resumo da NF-e (resNFe). Para baixar o XML Completo (procNFe) com todos os itens, você deve executar a operação sefazManifestar (Ciência da Operação 210210) passando a chave de 44 dígitos!


6️⃣ SEFAZ DF-e: Consultar Nota por Chave de 44 Dígitos (sefazConsultarChave)

Busca diretamente o XML de uma única Nota Fiscal na SEFAZ Nacional informando os 44 dígitos da Chave de Acesso.

  • Parâmetros obrigatórios:
    • pfxBase64, senha, cnpj e chave (44 dígitos numéricos).

7️⃣ SEFAZ DF-e: Manifestar Ciência da Operação + Baixar XML (sefazManifestar)

Assina digitalmente (XMLDSig com SHA-1 padrão ICP-Brasil) e transmite o evento oficial 210210 - Ciência da Operação para a SEFAZ Nacional. Em seguida, já consulta a chave para retornar o XML completo liberado!

  • Parâmetros obrigatórios:
    • pfxBase64, senha, cnpj e chave (44 dígitos numéricos da NF-e).

8️⃣ FGTS: Analisar Extrato Analítico PDF (fgtsAnalisarPdf)

Ideal para escritórios de advocacia trabalhista, contadores e RH: envia o PDF do Extrato Analítico do FGTS (Caixa Econômica Federal) e recebe todos os depósitos (115-DEPOSITO) estruturados com competência, data de crédito, valor individual e soma auditada.

  • Parâmetros obrigatórios:
    • PDF em Base64 (pdfBase64): Arquivo PDF do extrato do FGTS em Base64.

9️⃣ REDESIM / Jucerja: Consultar Protocolo Societário (redesimConsultar)

Acompanha automaticamente processos de abertura, alteração ou baixa de empresas.

  • Parâmetros obrigatórios:
    • Protocolo REDESIM / Jucerja (protocolo): Ex: RJN2600012345.

🔟 Fiscal: Validar e Decompor Chave de 44 Dígitos (fiscalValidarChave) — GRÁTIS

Verifica instantaneamente se uma Chave de Acesso de 44 dígitos (NF-e, NFC-e ou CT-e) é matematicamente válida pelo algoritmo Módulo 11 e decompõe todos os seus blocos (UF, Ano/Mês de emissão, CNPJ do Emitente, Modelo 55/65/57, Série, Número da Nota e Tipo de Emissão).

  • Custo: 0 créditos (100% gratuito com sua API Key).

📦 Como Instalar no seu n8n

  1. No seu n8n, acesse Settings (Configurações) -> Community Nodes.
  2. Clique em Install a community node.
  3. Digite:
    n8n-nodes-1dex-brasil
    
  4. Marque a caixa de confirmação e clique em Install.

🔑 Como Obter sua API Key (x-api-key)

  1. Acesse https://contabil.1dex.com.br/desenvolvedores
  2. Clique em Entrar com Google (Ganhar 10 Créditos Grátis).
  3. Copie sua chave pessoal no formato 1dex_usr_... e cadastre nas credenciais 1DEX Brasil API dentro do n8n.
  4. Precisa de mais créditos? Recarregue via PIX instantâneo a partir de R$ 29 (créditos nunca expiram).

🛡️ Segurança e Conformidade LGPD

  • Processamento 100% Stateless em Memória (Zero Retenção): Seus arquivos PDF, XMLs e Certificados A1 (.pfx) são processados em memória RAM durante a requisição e descartados imediatamente após a resposta JSON.

Discussion