# Certidões de Regularidade BR por CNPJ — FGTS + Trabalhista (`paulovitor18/certidoes-regularidade-br`) Actor

Emita certidões oficiais de regularidade por CNPJ, em lote: FGTS/CRF (Caixa) e Trabalhista/CNDT (TST). Para licitação, onboarding de fornecedor e due diligence. Rota anônima, captcha resolvido automaticamente. Pague por resultado.

- **URL**: https://apify.com/paulovitor18/certidoes-regularidade-br.md
- **Developed by:** [MoreLock](https://apify.com/paulovitor18) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$400.00 / 1,000 certidão por cnpjs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Certidões de Regularidade BR por CNPJ — FGTS + Trabalhista (CNDT)

Emita certidões oficiais de regularidade de empresas brasileiras por CNPJ, em lote: **FGTS/CRF** (Caixa) e **Trabalhista/CNDT** (Justiça do Trabalho). Ideal para licitação, onboarding de fornecedor, due diligence e compliance. Pague só pelo resultado.

> 🇧🇷 Certidões brasileiras · dados oficiais · sem cadastro no órgão

### Visão geral

Todo edital de licitação, contrato B2B e processo de homologação de fornecedor no Brasil exige comprovar **regularidade fiscal e trabalhista**. Este Actor consulta as fontes oficiais e devolve, por CNPJ, a situação de cada certidão — de forma estruturada (JSON) e em lote.

- **FGTS / CRF (Caixa):** situação de regularidade do empregador perante o FGTS (REGULAR / IRREGULAR) + razão social. Fonte: `consulta-crf.caixa.gov.br`.
- **Trabalhista / CNDT (TST):** Certidão Negativa de Débitos Trabalhistas (Lei 12.440/2011) — negativa / positiva + número, expedição e validade. Fonte: `cndt-certidao.tst.jus.br`. O captcha é resolvido automaticamente.

As duas fontes são **anônimas** (sem login gov.br). O Actor cobra apenas quando devolve um resultado válido (não cobra CNPJ inválido ou falha).

### Recursos

- Consulta **em lote** — vários CNPJs por execução.
- Escolha das fontes (FGTS, Trabalhista, ou ambas).
- Saída **estruturada** (JSON): situação, razão social, número da certidão, validade.
- **Não-cobrança honesta:** CNPJ inválido / sem resultado não vira item cobrado.
- Captcha da CNDT resolvido automaticamente (sem serviço externo).

### Exemplo de entrada

```json
{
  "cnpjs": ["47.960.950/0001-21", "33.000.167/0001-01"],
  "sources": ["fgts", "trabalhista"],
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "BR" }
}
````

### Exemplo de saída

```json
{
  "cnpj": "47.960.950/0001-21",
  "consultadoEm": "2026-07-10T00:21:07.359Z",
  "fgts": {
    "situacao": "REGULAR",
    "regular": true,
    "razaoSocial": "MAGAZINE LUIZA S/A",
    "inscricao": "47.960.950/0001-21",
    "consultaEm": "09/07/2026 21:21:11",
    "fonte": "FGTS/CRF (Caixa)"
  },
  "trabalhista": {
    "tipo": "POSITIVA",
    "regular": false,
    "nome": "MAGAZINE LUIZA S/A (MATRIZ E FILIAIS)",
    "certidaoNumero": "60681202/2026",
    "expedicao": "09/07/2026, às 21:21:50",
    "validade": "05/01/2027",
    "totalProcessos": 5,
    "fonte": "CNDT/TST"
  }
}
```

Valores de `trabalhista.tipo`: `NEGATIVA` (nada consta), `POSITIVA_COM_EFEITO_NEGATIVA` (débito garantido/suspenso — vale como negativa para licitação), `POSITIVA` (consta débito), `CNPJ_INVALIDO`. O campo `regular` resume a aptidão para licitação.

### Parâmetros

| Campo | Tipo | Descrição |
|---|---|---|
| `cnpjs` | array | Lista de CNPJs (com ou sem pontuação). Cada CNPJ = um registro. |
| `sources` | array | `fgts`, `trabalhista` ou ambos. Default: `fgts`. |
| `proxyConfiguration` | object | Proxy Apify. Recomendado **Residencial BR** (as fontes gov podem recusar IP de datacenter). |

### Dicas

- As fontes governamentais frequentemente bloqueiam IPs de datacenter → mantenha o **proxy residencial BR** ligado (default).
- A CNDT emite um PDF por CNPJ; o Actor extrai a situação e os metadados automaticamente.
- Para monitorar vencimento (a CNDT vale 180 dias; o CRF, ~30 dias), agende execuções recorrentes.

### Casos de uso

- **Licitação pública:** comprovar regularidade fiscal/trabalhista exigida em edital.
- **Onboarding de fornecedor:** validar novos parceiros antes de contratar.
- **Due diligence / M\&A:** checar passivos trabalhistas e de FGTS.
- **Crédito e factoring:** compor score de risco de contraparte.
- **Compliance contínuo:** re-emitir certidões por vencimento e detectar mudança de status.
- **Auditoria de carteira:** validar a base de fornecedores em lote.

### Perguntas frequentes

**As certidões têm validade oficial?** Sim — são emitidas pelas fontes oficiais (Caixa e TST) e trazem número/código de controle para verificação de autenticidade no site do órgão.

**Precisa de login gov.br?** Não. Ambas as fontes permitem emissão anônima.

**Como o captcha da CNDT é resolvido?** Por um modelo de reconhecimento próprio embarcado no Actor — sem serviço de terceiros e sem custo adicional por captcha.

**O que acontece com CNPJ inválido?** Não é cobrado. O Actor só grava (e cobra) resultados válidos.

**Cobre a certidão federal (Receita/PGFN)?** Ainda não — está no roadmap. Hoje cobre FGTS e Trabalhista.

**Posso consultar CPF?** O foco é CNPJ (empresas). As fontes aceitam CPF, mas o Actor é otimizado para pessoa jurídica.

### Preço

**Pague por resultado** — US$ 0,40 por CNPJ consultado (1 registro no dataset, cobrindo as fontes que você pedir). CNPJ inválido ou sem resultado **não é cobrado**. Sem mensalidade: você paga só pelas consultas que retornam certidão.

### Actors relacionados

- **Consulta CNPJ em Lote — Dados da Receita Federal** — dados cadastrais por CNPJ.
- **Brazil Due Diligence — CNPJ Registry + Reclame Aqui** — registro + reputação.
- **Protesto SP — Consulta por CPF/CNPJ** — protestos em cartório (SP).

### Changelog

- **0.1** — FGTS/CRF + Trabalhista/CNDT (captcha resolvido por modelo próprio). Federal (Receita/PGFN) no roadmap.

### Contato / Problemas

Encontrou um bug ou quer uma fonte nova? Abra uma issue na página do Actor.

# Actor input Schema

## `cnpjs` (type: `array`):

Lista de CNPJs a consultar (com ou sem pontuação). Cada CNPJ gera um registro no dataset.

## `sources` (type: `array`):

Quais certidões emitir por CNPJ. FGTS/CRF (Caixa) é gratuito e sem captcha. A Trabalhista/CNDT (TST) resolve o captcha automaticamente.

## `proxyConfiguration` (type: `object`):

Proxy Apify. Recomendado deixar ligado (as fontes gov podem bloquear o IP direto do datacenter).

## Actor input object example

```json
{
  "cnpjs": [
    "47.960.950/0001-21"
  ],
  "sources": [
    "fgts",
    "trabalhista"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BR"
  }
}
```

# Actor output Schema

## `resultados` (type: `string`):

Itens gerados por esta execucao, no dataset default 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 = {
    "cnpjs": [
        "47.960.950/0001-21"
    ],
    "sources": [
        "fgts",
        "trabalhista"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "BR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("paulovitor18/certidoes-regularidade-br").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 = {
    "cnpjs": ["47.960.950/0001-21"],
    "sources": [
        "fgts",
        "trabalhista",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "BR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("paulovitor18/certidoes-regularidade-br").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "cnpjs": [
    "47.960.950/0001-21"
  ],
  "sources": [
    "fgts",
    "trabalhista"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BR"
  }
}' |
apify call paulovitor18/certidoes-regularidade-br --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=paulovitor18/certidoes-regularidade-br",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Certidões de Regularidade BR por CNPJ — FGTS + Trabalhista",
        "description": "Emita certidões oficiais de regularidade por CNPJ, em lote: FGTS/CRF (Caixa) e Trabalhista/CNDT (TST). Para licitação, onboarding de fornecedor e due diligence. Rota anônima, captcha resolvido automaticamente. Pague por resultado.",
        "version": "0.1",
        "x-build-id": "bhqqnsdx7K4RD0ItL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/paulovitor18~certidoes-regularidade-br/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-paulovitor18-certidoes-regularidade-br",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/paulovitor18~certidoes-regularidade-br/runs": {
            "post": {
                "operationId": "runs-sync-paulovitor18-certidoes-regularidade-br",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/paulovitor18~certidoes-regularidade-br/run-sync": {
            "post": {
                "operationId": "run-sync-paulovitor18-certidoes-regularidade-br",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "cnpjs"
                ],
                "properties": {
                    "cnpjs": {
                        "title": "CNPJs",
                        "type": "array",
                        "description": "Lista de CNPJs a consultar (com ou sem pontuação). Cada CNPJ gera um registro no dataset.",
                        "default": [
                            "47.960.950/0001-21"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "sources": {
                        "title": "Fontes a consultar",
                        "type": "array",
                        "description": "Quais certidões emitir por CNPJ. FGTS/CRF (Caixa) é gratuito e sem captcha. A Trabalhista/CNDT (TST) resolve o captcha automaticamente.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "fgts",
                                "trabalhista"
                            ],
                            "enumTitles": [
                                "FGTS / CRF (Caixa)",
                                "Trabalhista / CNDT (TST)"
                            ]
                        },
                        "default": [
                            "fgts",
                            "trabalhista"
                        ]
                    },
                    "proxyConfiguration": {
                        "title": "Proxy",
                        "type": "object",
                        "description": "Proxy Apify. Recomendado deixar ligado (as fontes gov podem bloquear o IP direto do datacenter).",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "BR"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
