# Conversor Extrato PDF para OFX, DANFE PDF e SEFAZ Brasil (`servico.1dex/conversor-pdf-ofx-danfe-sefaz`) Actor

Converte extratos bancários brasileiros em PDF para OFX e CSV/Excel com IA, transforma XML de NF-e em DANFE PDF oficial e consulta SEFAZ Nacional (DF-e) via Certificado A1.

- **URL**: https://apify.com/servico.1dex/conversor-pdf-ofx-danfe-sefaz.md
- **Developed by:** [1DEX Brasil](https://apify.com/servico.1dex) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🇧🇷 Suíte Contábil, Fiscal, SEFAZ, DANFE PDF, OFX & FGTS (1DEX Brasil)

Converta extratos bancários brasileiros em **PDF para OFX e CSV/Excel** com inteligência artificial, gere **DANFE em PDF oficial** a partir do XML da NF-e, extraia impostos de notas fiscais, audite extratos do **FGTS** e consulte/manifeste notas fiscais direto na **SEFAZ Nacional (DF-e)** via Certificado Digital A1.

### 🌐 Links Diretos & Ferramentas Online (1DEX Brasil)

- 📄 **[Conversor Online Grátis de Extrato PDF para OFX & Excel](https://contabil.1dex.com.br/conversor-ofx)**
- 🔑 **[Portal do Desenvolvedor & API Key (10 Créditos Grátis no Login Google)](https://contabil.1dex.com.br/desenvolvedores)**
- 🧾 **[Plataforma 1DEX SisContábil (SEFAZ, OCR Fiscal, DANFE & REDESIM)](https://contabil.1dex.com.br)**
- 📊 **[1DEX Auditoria e Análise de Extrato Analítico FGTS](https://fgts.1dex.com.br)**
- 🏢 **[Portal Oficial 1DEX Brasil](https://1dex.com.br)**
- 📦 **[Pacote Oficial para n8n (npm: `n8n-nodes-1dex-brasil`)](https://www.npmjs.com/package/n8n-nodes-1dex-brasil)**

***

### ⚡ As 10 Operações Disponíveis neste Actor

| # | Valor em `operation` | Custo | O que faz |
|---|---|---|---|
| **1** | `extrato_ofx` | 1 crédito | Converte Extrato Bancário (PDF em Base64 ou Texto) em `.OFX` 1.02 contábil, `.CSV` (Excel) e JSON estruturado (salva `extrato.ofx` no Key-Value Store). |
| **2** | `danfe_pdf` | 1 crédito | Converte o XML da NF-e (`<nfeProc>` ou `<NFe>`) no **PDF oficial do DANFE** (salva `DANFE.pdf` pronto para download no Key-Value Store + retorna `pdfBase64`). |
| **3** | `nf_xml_to_json` | 1 crédito | Converte XML de NF-e/NFC-e em JSON estruturado com Emitente, Destinatário, Itens (NCM/CFOP) e **Resumo Fiscal de Impostos** (ICMS, ST, IPI, PIS, COFINS). |
| **4** | `nf_ocr` | 1 crédito | Extrai Emitente, CNPJ, Chave de 44 dígitos, Valor Total e Itens de PDF ou texto de Notas Fiscais/Cupons usando Inteligência Artificial. |
| **5** | `sefaz_distribuicao` | 2 créditos | Sincroniza lotes de NF-e direto na **SEFAZ Nacional (`NFeDistribuicaoDFe`)** por NSU usando Certificado Digital A1 (`.pfx` em Base64). |
| **6** | `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** | `sefaz_manifestar` | 2 créditos | Assina e envia o evento **Ciência da Operação (`210210`)** na SEFAZ Nacional para liberar e baixar o XML completo (`procNFe`) da nota. |
| **8** | `fgts_analisar_pdf` | 1 crédito | Audita PDFs de Extrato Analítico do FGTS (Caixa), extraindo todos os lançamentos `115-DEPOSITO`, competências, datas e soma auditada. |
| **9** | `redesim_consultar` | 2 créditos | Consulta status, etapa atual e exigências de protocolos societários na REDESIM / Jucerja. |
| **10** | `fiscal_validar_chave` | **Grátis** | Decompõe UF, AAMM, CNPJ, Modelo, Série, Número e valida matematicamente o Dígito Verificador (Módulo 11) de chaves de 44 dígitos. |

***

### 📖 Guia Passo a Passo das Principais Operações

#### 📄 Como usar `danfe_pdf` (Gerar PDF Oficial do DANFE a partir do XML)

Transforma qualquer XML de Nota Fiscal Eletrônica (`NF-e` modelo 55) no documento auxiliar oficial em PDF (com código de barras da chave de acesso, dados do emitente/destinatário, cálculo do imposto, transportador e lista de produtos).

1. Selecione **`operation`: `"danfe_pdf"`**.
2. Informe sua **`apiKey`** (`1dex_usr_...` — pegue grátis com 10 créditos em [contabil.1dex.com.br/desenvolvedores](https://contabil.1dex.com.br/desenvolvedores)).
3. No campo **`xml`**, cole o conteúdo completo do arquivo `.xml` da NF-e.
4. **Onde baixar o PDF gerado:**
   - No **Dataset / OUTPUT** do Apify você receberá o JSON com o campo `"pdfBase64"`.
   - Além disso, o Actor salva automaticamente o arquivo binário **`DANFE.pdf`** na aba **Storage -> Key-Value Store** da execução para você baixar ou abrir com 1 clique!

**Exemplo de Input JSON para `danfe_pdf`:**

```json
{
  "apiKey": "1dex_usr_sua_chave_aqui",
  "operation": "danfe_pdf",
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><NFe>...</NFe></nfeProc>"
}
```

***

#### 🔐 Como usar `sefaz_distribuicao` (Consultar Notas na SEFAZ Nacional via Certificado A1)

Consulta diretamente o Ambiente Nacional da SEFAZ (`NFeDistribuicaoDFe`) via mTLS usando o seu Certificado Digital ICP-Brasil A1 (`.pfx`), descompacta automaticamente os lotes GZIP (`docZip`) retornados pela Receita Federal e entrega os XMLs e resumos prontos em JSON.

1. **Converta seu arquivo `.pfx` para Base64:**
   - **No Linux / macOS:**
     ```bash
     base64 -w 0 meu_certificado.pfx
     ```
   - **No Windows (PowerShell):**
     ```powershell
     [Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\caminho\meu_certificado.pfx"))
     ```
2. Preencha os campos no Actor:
   - **`operation`**: `"sefaz_distribuicao"`
   - **`apiKey`**: `"1dex_usr_..."`
   - **`pfxBase64`**: Cole a string Base64 do seu certificado `.pfx` (campo protegido como Secret).
   - **`senha`**: Senha do certificado `.pfx` (campo protegido como Secret).
   - **`cnpj`**: Os 14 dígitos numéricos do CNPJ titular do certificado (ex: `"12345678000199"`).
   - **`ultNSU`**: Envie `"0"` na primeira vez. Nas próximas execuções, envie o valor de `"ultNSU"` retornado na resposta anterior para sincronizar apenas os documentos novos!

**Exemplo de Input JSON para `sefaz_distribuicao`:**

```json
{
  "apiKey": "1dex_usr_sua_chave_aqui",
  "operation": "sefaz_distribuicao",
  "pfxBase64": "MIIKSwIBAzCCChIGCSqGSIb3DQEHAaCCCgMEggo...",
  "senha": "senha_do_certificado",
  "cnpj": "12345678000199",
  "ultNSU": "0"
}
```

**Dica de Ouro (Resumo vs. XML Completo na SEFAZ):**

- Quando um fornecedor emite uma NF-e contra o seu CNPJ, a SEFAZ disponibiliza inicialmente o **Resumo da Nota (`resNFe`)**.
- Para liberar e baixar o **XML Completo (`procNFe`)** com todos os produtos e impostos, execute a operação **`sefaz_manifestar`** passando a `"chave"` de 44 dígitos da nota! O motor 1DEX assina o evento `210210` (Ciência da Operação), registra na SEFAZ e já retorna o XML completo.

***

#### 🏦 Como usar `extrato_ofx` (Converter Extrato Bancário PDF/Texto para OFX & CSV)

1. Selecione **`operation`: `"extrato_ofx"`**.
2. Envie o conteúdo Base64 do PDF em **`pdfBase64`** (ou cole as linhas em **`texto`**) e informe o **`bancoCodigo`** (ex: `"0341"` Itaú, `"0237"` Bradesco, `"0001"` BB, `"0260"` Nubank).
3. O Actor retornará o JSON com todas as transações categorizadas, o CSV em formato Excel e salvará o arquivo **`extrato.ofx`** pronto para download no **Key-Value Store**!

***

### 🛡️ Segurança & Privacidade (LGPD)

- **Zero Retenção:** Todos os arquivos PDF, XMLs e Certificados Digitais A1 (`.pfx`) trafegam via HTTPS criptografado, são processados **exclusivamente em memória RAM** durante a chamada e descartados imediatamente após a resposta.

# Actor input Schema

## `apiKey` (type: `string`):

Obtenha sua chave 1dex_usr\_... gratuita (com 10 créditos de bônus imediato) em https://contabil.1dex.com.br/desenvolvedores

## `operation` (type: `string`):

Selecione qual das 10 ferramentas da suíte 1DEX SisContábil deseja executar

## `texto` (type: `string`):

Cole linhas do extrato bancário (operação 1) ou texto extraído da Nota Fiscal (operação 4) se não estiver enviando pdfBase64.

## `pdfBase64` (type: `string`):

Conteúdo Base64 do arquivo PDF (Extrato Bancário na op. 1, Nota Fiscal na op. 4, ou Extrato Analítico FGTS na op. 8).

## `bancoCodigo` (type: `string`):

Ex: 0341 (Itaú), 0237 (Bradesco), 0001 (Banco do Brasil), 0033 (Santander), 0104 (Caixa), 0260 (Nubank), 0077 (Inter), 0403 (Cora).

## `xml` (type: `string`):

Cole o conteúdo completo do arquivo XML da Nota Fiscal Eletrônica (<nfeProc> ou <NFe>). Na operação 2, retorna o PDF oficial do DANFE em Base64; na operação 3, retorna o JSON estruturado com auditoria de impostos.

## `pfxBase64` (type: `string`):

Seu arquivo de certificado ICP-Brasil A1 (.pfx ou .p12) convertido para texto Base64. Exemplo no Linux: base64 -w 0 certificado.pfx

## `senha` (type: `string`):

Senha do arquivo .pfx para autenticação mTLS e assinatura digital na SEFAZ Nacional (processado 100% em memória, zero retenção).

## `cnpj` (type: `string`):

Apenas os 14 números do CNPJ (ou 11 números do CPF) da empresa titular do Certificado A1.

## `ultNSU` (type: `string`):

Envie '0' na primeira consulta para buscar desde o início, ou envie o ultNSU retornado na consulta anterior para buscar apenas novos lotes de notas.

## `chave` (type: `string`):

Os 44 dígitos numéricos da Chave de Acesso da NF-e, NFC-e ou CT-e.

## `protocolo` (type: `string`):

Número do protocolo societário para consulta de andamento e exigências (ex: RJN2600012345).

## Actor input object example

```json
{
  "operation": "extrato_ofx",
  "texto": "05/11/2026 PIX RECEBIDO CLIENTE LTDA 1.450,00 C\n06/11/2026 PAGTO BOLETO ENERGIA -280,50 D",
  "bancoCodigo": "0341",
  "ultNSU": "0"
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `outputRecord` (type: `string`):

No description

## `danfePdf` (type: `string`):

No description

## `extratoOfx` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("servico.1dex/conversor-pdf-ofx-danfe-sefaz").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("servico.1dex/conversor-pdf-ofx-danfe-sefaz").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call servico.1dex/conversor-pdf-ofx-danfe-sefaz --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,servico.1dex/conversor-pdf-ofx-danfe-sefaz"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dM8buhKJiqmBbIwIe/builds/fJtu84QJBahe95ZMz/openapi.json