💡Esta API permite consultar informações sobre vínculos empregatícios associados a um CNPJ, incluindo detalhes como a quantidade total de funcionários e suas respectivas ocupações (CBO). Ideal para análises de crédito e auditorias de onboarding de fornecedores. .
Introdução
A API Vínculo Empregatício é utilizada para recuperar dados sobre os vínculos empregatícios ativos de uma empresa identificada por um CNPJ. Isso inclui o número total de funcionários e suas respectivas descrições ocupacionais, sendo essencial para avaliação de riscos e conformidade trabalhista.
Fonte: Fornecedor Externo
URL Base
https://apiv3.directd.com.br
Endpoint
GET /api/VinculoEmpregaticio
Descrição: Endpoint para consultar vínculos empregatícios relacionados a um CNPJ.
Nota: Esta consulta não gera comprovantes.
Autenticação
- Obrigatório: Um token de autenticação válido deve ser fornecido.
- Contato: suporte@directd.com.br em caso de dúvidas sobre o token.
Campos da API
Dados da Empresa
- CNPJ: Cadastro Nacional da Pessoa Jurídica
- Razão Social: Nome da empresa
- Quantidade de Funcionários: Número total de funcionários vinculados ao CNPJ
Detalhes de Funcionários
- CPF: CPF do funcionário
- Nome: Nome do funcionário
- Data de Nascimento: Data de nascimento do funcionário
- Data de Admissão: Data de admissão do funcionário
- Código CBO: Código Brasileiro de Ocupações
- Descrição do CBO: Descrição do cargo ou função ocupada
Informações Gerais
- Data da Consulta: Data em que a consulta foi realizada
- Lista de Funcionários: Lista contendo os detalhes de cada funcionário
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| CNPJ | string | Sim | CNPJ da empresa, com ou sem formatação. |
| TOKEN | string | Sim | Token de autenticação para acesso à API. |
Exemplos de Requisição
Usando cURL
curl 'https://apiv3.directd.com.br/api/VinculoEmpregaticio?CNPJ=12345678000190&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"dataConsulta": "string",
"cnpj": "string",
"razaoSocial": "string",
"quantidadeFuncionarios": 0,
"funcionarios": [
{
"cpf": "string",
"nome": "string",
"dataNascimento": "string",
"codigoCBO": "string",
"descricaoCBO": "string",
"dataAdmissao": "string"
}
]
}
}
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. |
| 404 | Recurso solicitado não encontrado. |
| 500 | Erro interno: falha no processamento da consulta. |
Aplicações
- Onboarding de Clientes e Fornecedores
- Análise de Risco/Crédito
Notas Importantes
- O valor da consulta é de R$ 0,72
- Os dados são atualizados em tempo real com base em fontes confiáveis
- Certifique-se de utilizar um token válido para evitar falhas de autenticação
- Esta consulta é recomendada para análises de crédito e avaliação de fornecedores