💡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.
URL Base
https://api.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
- Nome: Nome 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.
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://api.directd.com.br/api/VinculoEmpregaticio?CNPJ=12345678000190&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "Vínculo Empregatício",
"consultaUid": "directd-123456",
"usuario": "Cliente",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 1200
},
"retorno": {
"dataConsulta": "2024-12-09",
"cnpj": "12.345.678/0001-90",
"razaoSocial": "Empresa Exemplo Ltda.",
"quantidadeFuncionarios": 25,
"funcionarios": [
{
"nome": "João Silva",
"codigoCBO": "1234",
"descricaoCBO": "Analista de Sistemas"
},
{
"nome": "Maria Oliveira",
"codigoCBO": "5678",
"descricaoCBO": "Gerente de Projetos"
}
]
}
}
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. |
Notas Importantes
- 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.