CNDT de vários CNPJs de uma vez: como tirar a certidão trabalhista em lote (painel e API)

A CNDT (Certidão Negativa de Débitos Trabalhistas) é emitida de graça pelo TST, mas um documento por vez: o site não tem envio em lote. Para tirar a certidão de vários CNPJs de uma vez, o caminho é a API. Na FiscalAPI, a rota GET /api/consultar-cndt recebe o CNPJ (ou o CPF) e devolve o status, a validade, o número da certidão e o PDF emitido pelo TST, em JSON. Um laço simples percorre a sua lista e salva tudo. Cada certidão devolvida conta como 1 consulta do plano, de R$ 0,67 (Lite) a R$ 0,025 (Enterprise), e consulta com erro não é cobrada.

Atualizado em 23 de outubro de 2026.

Os três caminhos, comparados#

Para 5 ou 10 empresas, o site do TST ou o painel resolvem. A partir de algumas dezenas, ou quando a conferência se repete todo mês, a API economiza o trabalho de digitar CNPJ por CNPJ.

O que a API devolve#

O status é lido do próprio PDF emitido pelo TST. Quando a certidão não pode ser lida, a resposta é status: "erro", sem cobrança, em vez de presumir que a empresa está regular.

Passo a passo para a sua lista de CNPJs#

1. Crie a conta em app.fiscalapi.com.br/register e assine um plano. As consultas grátis da conta nova cobrem Inscrição Estadual e CNPJ; certidão exige plano.
2. Copie a chave de API no painel.
3. Monte um arquivo `cnpjs.txt` com um CNPJ por linha. Pontos, barras e traços podem ficar; o código limpa.
4. Rode o script abaixo. Ele consulta um CNPJ por vez, no ritmo do seu plano, salva o PDF de cada um e gera uma planilha cndt.csv com o resultado.
5. Abra a planilha e filtre. negativa e positiva_com_efeitos_de_negativa estão regulares. positiva vai para análise. erro é "não verificado": rode de novo só essas linhas mais tarde.

curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.fiscalapi.com.br/api/consultar-cndt?cnpj=12345678000195"

import base64
import csv
import re
import time

import requests

API = "https://api.fiscalapi.com.br/api/consultar-cndt"
HEADERS = {"X-API-Key": "SUA_CHAVE"}
POR_MINUTO = 5  # Lite 5, Starter 20, Pro 60, Enterprise 120

with open("cnpjs.txt") as f:
    cnpjs = [re.sub(r"\D", "", linha) for linha in f if linha.strip()]

with open("cndt.csv", "w", newline="") as saida:
    planilha = csv.writer(saida)
    planilha.writerow(["cnpj", "status", "validade", "numero"])
    for cnpj in cnpjs:
        resp = requests.get(API, headers=HEADERS, params={"cnpj": cnpj}, timeout=120)
        time.sleep(60 / POR_MINUTO)
        if resp.status_code == 402:
            print("Saldo do plano acabou. Faça recarga ou mude de plano e rode de novo.")
            break
        if resp.status_code == 429:
            time.sleep(int(resp.headers.get("Retry-After", "60")))
            planilha.writerow([cnpj, "repetir", "", ""])
            continue
        cert = resp.json().get("result") if resp.ok else None
        if not cert:
            planilha.writerow([cnpj, "repetir", "", ""])
            continue
        planilha.writerow([cnpj, cert["status"], cert["validade"], cert["protocolo"]])
        if cert.get("pdf_base64"):
            with open(f"CNDT_{cnpj}.pdf", "wb") as pdf:
                pdf.write(base64.b64decode(cert["pdf_base64"]))

O CNPJ do exemplo é fictício. Para CPF, troque o parâmetro cnpj por cpf. Campos e códigos de erro estão na documentação da CNDT.

Quanto tempo e quanto custa#

O ritmo máximo é o limite de requisições do plano: 5 por minuto no Lite, 20 no Starter, 60 no Pro e 120 no Enterprise. Pelo limite, uma lista de 100 CNPJs leva no mínimo 5 minutos no Starter e menos de 2 no Pro; o tempo real depende de quanto cada certidão leva para sair. Se passar do limite, a API responde HTTP 429 com o header Retry-After, e o script espera.

A franquia é a mesma das outras consultas (CND Federal, CRF, Inscrição Estadual). No Starter, no Pro e no Enterprise dá para comprar recarga quando a franquia acaba. Veja planos e preços.

O resultado de cada documento fica guardado por 24 horas: consultar o mesmo CNPJ de novo nesse prazo devolve a mesma certidão, com cached: true, e conta como 1 consulta. Não rode a lista duas vezes no mesmo dia sem motivo.

Quando rodar de novo#

A CNDT vale 180 dias, mas o retrato é do dia da emissão: um fornecedor regular hoje pode entrar no Banco Nacional de Devedores Trabalhistas amanhã. Duas regras práticas:

• Para licitação e contrato: tire a certidão perto da data em que ela será apresentada e confira a validade contra essa data.
• Para carteira de fornecedores: guarde a validade_iso de cada um e rode a lista com a frequência que o seu compliance exigir, sempre antes de vencer.

Para autenticar um PDF que chegou de terceiros, use o número da certidão no site da CNDT do TST.

A CNDT junto com as outras certidões#

Quem confere CNDT quase sempre confere também a CND Federal e o CRF do FGTS. Com a mesma chave, cada uma tem a sua rota. Para a CND Federal e o CRF, o laço acima serve trocando a URL, porque a resposta tem o mesmo formato. A CND estadual é diferente: exige o parâmetro uf e devolve outro formato de resposta; veja a documentação da CND estadual.

Perguntas frequentes#

Existe API para emitir a CNDT? Sim. Na FiscalAPI, GET /api/consultar-cndt recebe CPF ou CNPJ e devolve a certidão emitida pelo TST, com status, validade, número e PDF em JSON.

Dá para tirar a CNDT de vários CNPJs de uma vez no site do TST? Não. O site emite uma certidão por vez. Para uma lista, use a API num laço, como no exemplo acima.

O painel da FiscalAPI tem envio em lote de CNDT? Não. No painel a consulta é uma por vez, com o PDF para baixar. O lote é pela API.

Precisa de certificado digital ou autorização da empresa consultada? Não. A CNDT é pública: basta o CNPJ ou o CPF.

Qual a validade da CNDT? 180 dias contados da emissão, pela CLT. A data vem em validade_iso.

CNDT positiva com efeitos de negativa serve? Sim. Há débito, mas garantido ou com exigibilidade suspensa, e a certidão tem os mesmos efeitos da negativa.

Fontes#

• CLT, art. 642-A, incluído pela Lei 12.440/2011: CNDT gratuita, eletrônica, com validade de 180 dias
• Lei 14.133/2021, art. 68, V: regularidade perante a Justiça do Trabalho na habilitação em licitação
• Documentação da CNDT e rate limiting, FiscalAPI

Artigos relacionados#

• CNDT: como consultar a Certidão Negativa de Débitos Trabalhistas
• CNDT para licitação pública
• CND Federal automática por API
• Certidões para licitação: quais pedir e como tirar todas de uma vez

Tem uma lista de CNPJs para conferir? Veja a API de CNDT e as outras certidões por API.