API de RH — KFP

Autenticação. Toda requisição precisa do cabeçalho x-api-key. Sem ele a resposta é 401. A chave é fornecida pela equipe de informática da KFP — trate-a como senha e não a coloque em código versionado nem em front-end.

Testar agora

Chave de API

Endpoint

A chave fica só nesta aba do navegador e é esquecida ao fechá-la.

Endpoints

POST/funcionarios

Funcionários ativos na competência corrente, com empresa de registro, empresa onde trabalha e cargo.

Resposta

campo	descrição
competencia	Competência de referência, em `DD/MM/AAAA`
total	Quantidade de funcionários retornados
funcionarios[]	`cpf`, `nome`, `empresa_registro`, `cnpj_empresa_registro`, `empresa_trabalho`, `cnpj_empresa_trabalho`, `uf_trabalho`, `admitido`, `situacao`, `cargo`, `classe`, `data_nascimento`

POST/cargos

Cargos cadastrados, com a classe a que pertencem e se são considerados de periculosidade.

Resposta

campo	descrição
total	Quantidade de cargos
cargos[]	`id`, `nome`, `classe`, `periculosidade`

POST/empresas

Empresas do grupo, com CNPJ, regime de tributação e endereço.

Resposta

campo	descrição
total	Quantidade de empresas
empresas[]	`nome_comum`, `razao_social`, `cnpj`, `regime_tributacao`, `uf`, `endereco`

POST/feriados

Feriados nacionais, estaduais e municipais que afetam as empresas do grupo, considerando as UFs e cidades onde elas operam.

Parâmetro

nome	descrição
?ano=	Ano desejado. Ex.: `/feriados?ano=2026`

Resposta

campo	descrição
ano	Ano consultado
total	Quantidade de feriados
resumo	Contagem por tipo: `nacionais`, `estaduais`, `municipais`
ufs_empresas[]	UFs onde o grupo tem operação
empresas[]	`nome`, `cnpj`, `uf`
feriados[]	`data`, `nome`, `tipo`, `estado`, `cidade`

POST/cadastro-funcionarios

Dados cadastrais dos funcionários — contato e filiação. Contém dado pessoal: use apenas quando necessário.

Resposta

campo	descrição
total	Quantidade de registros
funcionarios[]	`nome`, `cpf`, `data_nascimento`, `nome_mae`, `email`, `telefone_principal`

Exemplos

curl

curl -X POST https://api-rh.kfp.com.br/funcionarios \
  -H "x-api-key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{}'

JavaScript

const r = await fetch("https://api-rh.kfp.com.br/funcionarios", {
  method: "POST",
  headers: {
    "x-api-key": process.env.RH_API_KEY,
    "Content-Type": "application/json",
  },
  body: "{}",
});
const { total, funcionarios } = await r.json();

Python

import os, requests

r = requests.post(
    "https://api-rh.kfp.com.br/funcionarios",
    headers={"x-api-key": os.environ["RH_API_KEY"]},
    json={},
    timeout=30,
)
dados = r.json()

Códigos de resposta

código	significado
200	Sucesso
401	Chave ausente ou inválida no cabeçalho `x-api-key`
404	Caminho inexistente — só os 5 endpoints acima respondem
500	Erro no servidor. Persistindo, avise a informática