SAsankhya
HCM Funcionários

Lista os funcionários com dados detalhados

Changed on

Retorna uma lista paginada de funcionários com dados completos do cadastro: dados pessoais, documentos, endereço, dados contratuais (jornada, remuneração, lotação, ponto, sindicato, provisões), FGTS, afastamento, transferência, cedência, estrangeiro, eSocial, redução de jornada, vale social, médico, processo trabalhista, aprendiz, benefícios e tomador/estabelecimento.

Para utilizar o filtro modifiedSince, o parâmetro LOGTABOPER deve estar ativado no ambiente.

Versão mínima do módulo pessoal: 5.126.0

get/v1/pessoal/funcionarios-detalhados

Request

  • Base URL
    https://api.sankhya.com.br
  • URL
    https://api.sankhya.com.br/v1/pessoal/funcionarios-detalhados
  • Auth
    API key in header Authorization

Query parameters

pageinteger

Página de resultados a ser exibida (paginação).

modifiedSincestring date-time
Example:2024-01-01T00:00:00

Retorna apenas funcionários modificados a partir desta data/hora. Requer o parâmetro LOGTABOPER ativado no ambiente. Formato: AAAA-MM-DDTHH:MM:SS

codigoEmpresainteger
Example:1

Filtra os funcionários pelo código da empresa.

situacao'0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'
Example:1

Filtra pela situação do funcionário:

  • 0 - Demitido
  • 1 - Atividade normal
  • 2 - Afastado sem remuneração
  • 3 - Afastado por acidente de trabalho
  • 4 - Afastado para serviço militar
  • 5 - Afastado por licença maternidade
  • 6 - Afastado por doença acima de 15 dias
  • 7 - Outros
  • 8 - Transferido
  • 9 - Aposentadoria por invalidez
tipoRemuneracaointeger
Example:1

Filtra pelo tipo de remuneração do funcionário:

  • 1 - Salário fixo
  • 2 - Variável
  • 3 - Salário fixo + variável

Response

Lista de funcionários detalhados retornada com sucesso.

Example response

{
  "funcionarios": [
    {
      "codigoEmpresa": 1,
      "codigoFuncionario": 33,
      "cpf": "12345678900",
      "nome": "João da Silva",
      "nomeSocial": "Joana Silva",
      "matricula": 1234,
      "matriculaAnterior": 567,
      "dadosPessoais": {
        "nascimento": "01/01/1990",
        "sexo": "M",
        "celular": "11999998888",
        "telefone": "1133334444",
        "email": "joao@email.com",
        "emailCorporativo": "joao@empresa.com",
        "nomeMae": "Maria da Silva",
        "nomePai": "José da Silva",
        "estadoCivil": 1,
        "racaFuncionario": 1,
        "identidadeGenero": "01",
        "orientacaoSexual": "01",
        "travestiTransexual": "N",
        "naturalidade": 3550308,
        "nacionalidade": 10,
        "codigoPaisNacionalidade": 105,
        "nacionalidadePais": 10,
        "grauInstrucao": 7,
        "possuiFilhos": "S",
        "filhosBrasil": "S",
        "casadoBrasil": "N"
      },
      "documentos": {
        "rg": {
          "numero": "1234567",
          "uf": 25,
          "orgaoEmissor": "SSP",
          "dataEmissao": "01/01/2010"
        },
        "pis": {
          "numero": "12345678901",
          "diaVencimento": 15,
          "dataCadastro": "01/01/2010"
        },
        "ctps": {
          "numero": 12345,
          "serie": "001",
          "uf": 25,
          "dataEmissao": "01/06/2005",
          "ctpsDigital": "N"
        },
        "cnh": {
          "numero": "12345678900",
          "categoria": "B",
          "vencimento": "31/12/2027",
          "orgao": "DETRAN",
          "uf": 25,
          "dataExpiracao": "31/12/2027",
          "primeiraCnh": "N"
        },
        "tituloEleitor": {
          "numero": "123456789012",
          "secao": 1,
          "zona": 1
        },
        "reservista": "123456789",
        "oc": {
          "numero": "12345",
          "orgao": "CRM",
          "dataExpiracao": "31/12/2027"
        },
        "ric": {
          "numero": "12345",
          "orgao": "SSP",
          "codigoCidade": 3550308,
          "dataEmissao": "01/01/2010"
        },
        "rne": {
          "numero": "V123456-A",
          "orgao": "DPF",
          "dataExpiracao": "31/12/2027"
        },
        "passaporte": {
          "numero": "AA123456",
          "uf": 25,
          "orgaoEmissor": "DPF",
          "dataEmissao": "01/01/2020",
          "dataValidade": "01/01/2030"
        },
        "certidao": {
          "tipo": "N",
          "numeroCertidaoCivil": "123456",
          "codigoCidade": 3550308,
          "dataEmissao": "01/01/1990"
        },
        "consignado": {
          "id": "12345",
          "inscricao": "123456"
        }
      },
      "endereco": {
        "cep": "01234567",
        "codigo": 456,
        "descricao": "Rua Exemplo",
        "numero": "123",
        "complemento": "Apto 45",
        "enderecoFiscalExterior": "N",
        "bairro": {
          "codigo": 789,
          "descricao": "Centro"
        },
        "cidade": {
          "codigo": 1011,
          "descricao": "São Paulo",
          "codigoIBGE": 3550308
        }
      },
      "dadosContratuais": {
        "empresa": {
          "codigo": 1,
          "cnpj": "12345678000199",
          "razaoSocial": "Empresa Exemplo S/A"
        },
        "dataAdmissao": "15/01/2020",
        "codigoCategoriaEsocial": 101,
        "situacao": "1",
        "salarioBase": 3500,
        "tipoSalario": "1",
        "horasSemana": 44,
        "vinculo": 1,
        "regime": 1,
        "diasFerias": 30,
        "percentualAdiantamento": 40,
        "periodoExperiencia": {
          "dispensadoDaExperiencia": "N"
        },
        "tipoContrato": {
          "contratoSuspenso": "N"
        },
        "indicadoresAdmissao": {
          "indicadorAdmissao": 1
        },
        "jornada": {
          "regimeJornada": 1,
          "regimeTrabalho": 1
        },
        "remuneracao": {
          "tipoRemuneracao": 1
        },
        "dadosBancarios": {
          "tipoConta": "CC",
          "tipoRecebimento": "B",
          "codigoBanco": "341",
          "conta": "12345-6"
        },
        "lotacao": {
          "departamento": {
            "codigo": 22,
            "descricao": "TI"
          },
          "cargo": {
            "codigo": 7,
            "descricao": "Desenvolvedor",
            "cbo": 317105
          },
          "funcao": {
            "codigo": 15,
            "descricao": "Analista de Sistemas",
            "cbo": 212415
          },
          "localTrabalho": {
            "codigo": 3,
            "descricao": "Matriz"
          },
          "cidadeTrabalho": {
            "codigo": 1011,
            "descricao": "São Paulo",
            "codigoIBGE": 3550308
          },
          "sindicato": {
            "codigo": 9,
            "nome": "Sindicato dos Programadores",
            "cnpj": "11222333444455"
          },
          "cargaHoraria": {
            "codigo": 40,
            "descricao": "Carga Horária Semanal - 40h"
          }
        },
        "ponto": {
          "diaApuracao": 1,
          "dispensado": "N",
          "bloqueiaAtoBatidaOnline": "N"
        },
        "sindicato": {
          "sindicalizado": "N",
          "contribuicaoSindical": "N"
        },
        "provisoes": {
          "provisao13": "S",
          "provisaoFerias": "S",
          "pvd": "N"
        },
        "situacaoEmprego": {
          "primeiroEmprego": "N",
          "novoEmprego": "N",
          "trabalhaAposAposentadoria": "N",
          "trabalhaEmOutraEmpresa": "N"
        },
        "outros": {
          "cadastroInicial": "N",
          "pertenceDepartamentoPessoal": "N",
          "validado": "N",
          "mei": "N",
          "temDescAssistencia": "N",
          "historico": {
            "dataUltimaAlteracao": "15/09/2026"
          }
        }
      },
      "fgts": {
        "opcao": 1
      },
      "afastamento": {
        "causaAfastamento": {
          "codigo": 6,
          "descricao": "Doença"
        },
        "tipoRescisao": {
          "codigo": 2,
          "descricao": "Dispensa sem Justa Causa"
        }
      }
    }
  ]
}

Changes