# Gere Certidões PDF por CPF/CNPJ - RFB, Simples, CCC e Suframa (`brasildados/emissor-certidoes-rfb-mei-ccc-suframa`) Actor

Consulte até 20 CPFs ou CNPJs e receba os principais dados da empresa com certificados válidos em PDF, emitidos e verificados durante a execução. Gere comprovantes RFB, Simples Nacional e MEI, CCC ou Suframa, com links registrados no resultado via Batch ou Standby.

- **URL**: https://apify.com/brasildados/emissor-certidoes-rfb-mei-ccc-suframa.md
- **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community)
- **Categories:** Automation, Integrations, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1,000.00 / 1,000 por certificado válido emitidos

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Gerador de Certidões CPF e CNPJ PDF - Receita, Simples, CCC e Suframa

Consulte até 20 CPFs ou CNPJs e receba, na mesma execução, os principais dados cadastrais da empresa junto com certificados válidos em PDF. Cada comprovante é emitido e validado em tempo de execução, e seu link só é registrado no resultado quando o PDF realmente está disponível. Escolha Receita Federal, Simples Nacional e MEI, CCC, Suframa ou todos.

Para CNPJ, cada resultado combina razão social, nome fantasia, situação cadastral, endereço protegido, contatos, quadro societário e CNAEs com os links dos certificados emitidos. Assim, você recebe contexto empresarial e documentação oficial pronta para conferência, download ou integração.

### 📄 Certificados disponíveis

- **Receita Federal (RFB):** comprovante de inscrição e situação cadastral do CNPJ.
- **Simples Nacional e MEI:** comprovante de opção, enquadramento ou desenquadramento.
- **CCC:** comprovante do Cadastro Centralizado de Contribuintes para CPF ou CNPJ.
- **Suframa:** comprovante cadastral para CPF ou CNPJ registrado na Suframa.

Os links não expõem o endereço do provedor de dados. Cada PDF válido é baixado durante a execução, salvo no Key-value Store do próprio run e entregue por uma URL pública da Apify, que permanece disponível enquanto o registro existir.

RFB e Simples são exclusivos para CNPJ. Para CPF, o Actor consulta CCC e Suframa. Um certificado inexistente não gera linha de resultado nem cobrança PPE.

### Como usar

1. Informe de 1 a 20 valores no único campo `documentos`; para consultar apenas um documento, envie uma lista com um item.
2. Use CPF ou CNPJ com ou sem pontuação; o Actor identifica, valida, normaliza e remove duplicados.
3. Escolha `todos`, `rfb`, `simples`, `ccc` ou `suframa` em `tipoCertificado`.
4. Execute em Batch ou envie o mesmo JSON ao endpoint Standby `POST /certidoes`.
5. Abra o campo de URL correspondente (`certificadoRfbUrl`, `certificadoSimplesUrl`, `certificadoCccUrl` ou `certificadoSuframaUrl`) para visualizar ou baixar o PDF.

```json
{
  "documentos": ["33.000.167/0001-01", "60701190000104"],
  "tipoCertificado": "todos"
}
```

### Exemplo completo de resultado JSON

Cada linha representa um CPF ou CNPJ consultado e reúne todos os certificados solicitados. O exemplo fictício abaixo contém todas as propriedades que o Actor pode retornar.

```json
{
  "tipoDocumento": "CNPJ",
  "documento": "06045479000169",
  "documentoFormatado": "06.045.479/0001-69",
  "tipoCertificado": "todos",
  "cnpj": "06045479000169",
  "cnpjFormatado": "06.045.479/0001-69",
  "atualizadoEm": "2026-08-12T12:00:00.000Z",
  "matriz": true,
  "razaoSocial": "EMPRESA DE TECNOLOGIA LTDA",
  "nomeFantasia": "Empresa Exemplo",
  "naturezaJuridica": "2062",
  "naturezaJuridicaDescricao": "Sociedade Empresária Limitada",
  "capitalSocial": 100000,
  "porte": "3",
  "porteDescricao": "Empresa de Pequeno Porte",
  "situacaoCadastral": "2",
  "situacaoCadastralDescricao": "Ativa",
  "dataSituacaoCadastral": "2020-03-10",
  "dataInicioAtividade": "2015-04-20",
  "logradouro": "Rua Exemplo",
  "numero": "***",
  "complemento": "Sala 101",
  "bairro": "Centro",
  "cep": "01001000",
  "municipioCodigo": "3550308",
  "municipioNome": "São Paulo",
  "uf": "SP",
  "pais": "1058",
  "paisDescricao": "Brasil",
  "telefone1": "1130000000",
  "telefone2": "11999990000",
  "email": "contato@empresa.com.br",
  "telefones": [
    { "tipo": "LANDLINE", "ddd": "11", "numero": "30000000", "telefoneCompleto": "1130000000" }
  ],
  "emails": [
    { "titularidade": "OWN", "endereco": "contato@empresa.com.br", "dominio": "empresa.com.br" }
  ],
  "socios": [
    {
      "nome": "Bruno ******",
      "tipo": "NATURAL",
      "tipoDescricao": "Pessoa Física",
      "documento": "***.***.123-**",
      "qualificacao": "49",
      "qualificacaoDescricao": "Sócio-Administrador",
      "dataEntrada": "2018-08-15",
      "faixaEtariaDescricao": "41 a 50 anos"
    }
  ],
  "cnaePrincipal": { "codigo": "6201-5/01", "descricao": "Desenvolvimento de programas de computador sob encomenda" },
  "cnaesSecundarios": [
    { "codigo": "6204-0/00", "descricao": "Consultoria em tecnologia da informação" }
  ],
  "certificadoRfbUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/CERTIFICADO_RFB_ID.pdf",
  "certificadoRfbDisponivel": true,
  "certificadoSimplesUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/CERTIFICADO_SIMPLES_ID.pdf",
  "certificadoSimplesDisponivel": true,
  "certificadoCccUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/CERTIFICADO_CCC_ID.pdf",
  "certificadoCccDisponivel": true,
  "certificadoSuframaUrl": null,
  "certificadoSuframaDisponivel": false
}
```

Para CPF, `documento` e `documentoFormatado` são mascarados; os campos empresariais retornam `null` ou listas vazias. O PDF fica armazenado com identificador irreversível no Key-value Store do run.

### ⚡ Batch e Standby

No modo Batch, cada CPF ou CNPJ consultado aparece como uma linha no Dataset. No modo Standby, envie o mesmo input para:

```bash
curl --compressed -X POST "https://brasildados--emissor-certidoes-rfb-mei-ccc-suframa.apify.actor/certidoes" \
  -H "Authorization: Bearer SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  -d '{"documentos":["33.000.167/0001-01"],"tipoCertificado":"todos"}'
```

### 💳 Cobrança

O Actor usa Pay per event. Cada certificado PDF efetivamente gerado e entregue produz um evento `result-item`. Se uma consulta retornar três PDFs disponíveis, serão cobrados três eventos; certificados ausentes, incompatíveis ou com falha não são cobrados. Se o limite de gasto for atingido, links sem cobrança são removidos antes da entrega.

### Privacidade e limitações

- CPF de entrada, CPF de sócio e nome de pessoa física são mascarados.
- O número do endereço é ocultado.
- Os PDFs ficam no Key-value Store do run e permanecem acessíveis enquanto os respectivos registros forem mantidos na conta Apify do usuário.
- Alguns CPFs ou CNPJs não possuem cadastro no CCC ou na Suframa.
- A disponibilidade final depende dos órgãos emissores.

### Perguntas frequentes

#### O resultado contém apenas o certificado?

Não. Para CNPJ, o Actor retorna os principais dados da empresa junto com o certificado válido em PDF no link registrado durante a execução.

#### O link é criado mesmo quando o certificado não existe?

Não. O link só é entregue como disponível após a validação do PDF. Certificados inexistentes ou com erro não geram cobrança PPE.

Conheça outros Actors da [BrasilDados](https://apify.com/brasildados?fpr=t5lwzq) ou crie sua conta na [Apify](https://apify.com?fpr=t5lwzq).

# Actor input Schema

## `documentos` (type: `array`):

Informe de 1 a 20 CPFs ou CNPJs. Aceita valores com e sem pontuação; o Actor identifica o tipo, valida e remove duplicados.

## `tipoCertificado` (type: `string`):

Escolha um comprovante ou gere os quatro tipos disponíveis na mesma consulta.

## Actor input object example

```json
{
  "documentos": [
    "33.000.167/0001-01",
    "60701190000104"
  ],
  "tipoCertificado": "todos"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `certificates` (type: `string`):

Arquivos PDF válidos armazenados no Key-value Store do run.

# 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 = {
    "documentos": [
        "33.000.167/0001-01",
        "60701190000104"
    ],
    "tipoCertificado": "todos"
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/emissor-certidoes-rfb-mei-ccc-suframa").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 = {
    "documentos": [
        "33.000.167/0001-01",
        "60701190000104",
    ],
    "tipoCertificado": "todos",
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/emissor-certidoes-rfb-mei-ccc-suframa").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 '{
  "documentos": [
    "33.000.167/0001-01",
    "60701190000104"
  ],
  "tipoCertificado": "todos"
}' |
apify call brasildados/emissor-certidoes-rfb-mei-ccc-suframa --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/emissor-certidoes-rfb-mei-ccc-suframa"
        }
    }
}

```

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/WudS8HRvDvpySAbFU/builds/9GnoKAwJareRsuuNe/openapi.json