💡A API Ministério do Trabalho - PIS permite consultar o número de inscrição (PIS/NIT/NIS) de uma pessoa física no Cadastro Nacional de Informações Sociais (CNIS). Este serviço é fundamental para validação de dados cadastrais e compliance.
Introdução
A API Ministério do Trabalho - PIS é uma ferramenta para validar a inscrição de indivíduos no Cadastro Nacional de Informações Sociais (CNIS). É amplamente utilizada em processos de onboarding de clientes, compliance e ESG.
URL Base
A API está hospedada no seguinte endereço:
https://api.directd.com.br
Endpoint
GET /api/MinisterioTrabalhoPIS
Descrição: Endpoint para consultar o número do PIS/NIT/NIS de uma pessoa física.
Nota: Esta consulta não gera comprovantes.
Autenticação
Para acessar esta API, é necessário fornecer um token de autenticação.
Regras de Autenticação:
- O token deve ser enviado como parâmetro na URL da requisição.
- O token é obrigatório para realizar consultas.
Campos da API
Dados Pessoais
- CPF: Cadastro de Pessoa Física (obrigatório).
- Nome: Nome completo do indivíduo.
- Nome da Mãe: Nome completo da mãe do indivíduo.
- Data de Nascimento: Data de nascimento do indivíduo.
Dados do PIS
- PIS: Número de inscrição no PIS/NIT/NIS.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| CPF | string | Sim | CPF da pessoa a ser consultada. Pode ser enviado com ou sem formatação. |
| TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
Exemplos de Requisição
Usando cURL
curl 'https://api.directd.com.br/api/MinisterioTrabalhoPIS?CPF=12345678909&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "Ministério do Trabalho - PIS",
"consultaUid": "mtpis-123456",
"usuario": "Ana Silva",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 150
},
"retorno": {
"pis": "123.45678.90-1",
"cpf": "123.456.789-09",
"nome": "JOÃO DA SILVA",
"nomeMae": "MARIA DA SILVA",
"dataNascimento": "1980-05-20"
}
}
9. Erros Comuns
| Código | Descrição |
|---|---|
| 400 | Requisição inválida: parâmetros incorretos. |
| 401 | Não autenticado: token inválido ou ausente. |
| 403 | Não autorizado: saldo insuficiente para realizar a consulta. |
| 404 | Não encontrado: registro não localizado. |
| 408 | Tempo esgotado: consulta não foi concluída no prazo. |
| 500 | Erro interno: falha no processamento da consulta. |
| 503 | Serviço em manutenção: indisponível temporariamente. |
10. Notas Importantes
- É obrigatório informar o CPF e o token para realizar a consulta.
- O PIS retornado é o número oficial cadastrado no CNIS.
- Certifique-se de utilizar o token correto para evitar erros de autenticação.