O módulo de Certidões consulta uma fonte oficial no momento da solicitação, estrutura os dados encontrados e preserva a evidência em PDF. Use estas rotas quando a decisão exigir uma evidência D+0. Para buscas rápidas, exploração cadastral e processamento em volume, continue usando os endpoints de Pessoa e Empresa, que consultam a base consolidada da Sherlocker.

​
Rotas

​
Tempo de resposta

A emissão depende do processamento e da disponibilidade da fonte oficial. Por isso, a criação responde 202 Accepted e devolve um certidao_id para acompanhamento.
A vantagem desse fluxo é a atualização oficial D+0. Em contrapartida, ele é deliberadamente mais lento que a base consolidada e deve ser acompanhado por polling.
Essas faixas são expectativas de engenharia para dimensionar a integração, não um SLA nem percentis medidos em produção. Elas serão refinadas com telemetria de latência e taxa de sucesso por fonte.
Os estados públicos são: Uma falha da fonte aparece no recurso com status: "failed". O GET do recurso continua respondendo HTTP 200, pois a solicitação existe e foi localizada.

​
Certidão trabalhista

A Certidão de Débitos Trabalhistas informa se uma pessoa física ou jurídica está inscrita no Banco Nacional de Devedores Trabalhistas (BNDT). Ela pode ser:
Uma certidão positiva não é erro da API. É um resultado oficial válido da consulta realizada.
A CNDT tem abrangência nacional e sua validade é informada no próprio documento. O PDF disponibilizado nesta rota é o documento emitido pelo TST.

​
Confirmação D+0 do nome de uma pessoa

Na busca básica de Pessoa, use realtime=true para confirmar no TST o nome associado ao CPF. A busca retorna os dados consolidados imediatamente e inclui uma referência para acompanhar a validação D+0:

Consultar Pessoa

Acesse a busca básica e habilite a validação em tempo real quando necessário.
A fonte do TST não oferece uma pesquisa aberta por nome. A validação retorna o nome que consta na certidão associada ao CPF informado. Essa confirmação reduz o risco de divergência quando houve alteração já registrada de nome social, sobrenome por casamento ou divórcio ou retificação civil. Ela complementa a base consolidada nos casos em que o nome no momento da decisão é essencial. Quando a emissão termina, o recurso consultado deixa a divergência explícita:
O valor da base não é sobrescrito silenciosamente. O cliente decide se deve atualizar o cadastro, abrir uma revisão ou apenas registrar a evidência. Se também precisar comprovar a regularidade trabalhista, emita a Certidão Trabalhista. Nesse fluxo, o nome oficial fica em result.titular.nome; a comparação com o nome da base é retornada apenas pela validação realtime=true.
O nome validado é aquele associado ao documento no TST/BNDT no momento da emissão. A CNDT também informa a situação de débitos trabalhistas; ela não confirma a situação cadastral do CPF na Receita Federal.

​
Comprovante do CNPJ

Informe o CNPJ no corpo da requisição:
O resultado contém razão social, nome fantasia, situação cadastral, atividades, endereço e demais campos retornados pela fonte. Quando o portal não fornece um PDF oficial, o arquivo é identificado como sherlocker_verification_report. Ele é uma evidência gerada pela Sherlocker a partir dos dados consultados e não deve ser apresentado como documento emitido pela Receita Federal.

​
Segurança do PDF

A CNDT e os comprovantes de CNPJ ficam em armazenamento privado. A rota de download produz um acesso temporário, sem expor uma URL pública permanente. O recurso assíncrono permanece disponível por 24 horas. Depois desse período, o polling e o download respondem 404, e uma nova emissão deve ser solicitada.

​
Erros

Erros de entrada são recusados antes da criação do recurso:
Depois que a solicitação é aceita, falhas da emissão aparecem no campo error do recurso consultado. Esse objeto usa códigos estáveis, category, retryable e retry_after_seconds. Falhas temporárias comuns incluem indisponibilidade da fonte, tempo limite e indisponibilidade do armazenamento.

​
Códigos da emissão

O campo code pode receber novos valores sem alteração de versão. Integrações devem usar category, retryable e retry_after_seconds para decidir o próximo passo e tratar códigos desconhecidos como falha da emissão. O download pode devolver EVIDENCIA_INDISPONIVEL com HTTP 503 quando a certidão terminou, mas o arquivo ou a URL temporária não puderam ser entregues.

​
Erros HTTP antes do job