HCM Cadastros

Criar uma nova requisição de admissão

Changed on Nov 3, 2026

Este endpoint permite o registro de uma nova requisição de admissão, incluindo informações detalhadas sobre o trabalhador, seu cargo, categoria, dados contratuais e cadastrais.

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

post/v2/funcionarios/admissao

Request

Base URL
https://api.sankhya.com.br
URL
https://api.sankhya.com.br/v2/funcionarios/admissao
Auth
API key in header Authorization

Request body

nomestring required

Nome do Funcionário

cpfstring required

CPF do Funcionário

estadoCivil1 | 2 | 3 | 4 | 5 | 6 | 7 required

Estado Civil. Os Valores aceitos são:

1 - Solteiro(a)
2 - Casado(a)
3 - Viúvo(a)
4 - Separado(a) Judicialmente
5 - Desquitado(a)
6 - Divorciado(a)
7 - União Estável

possuiFilhosboolean

Para indicar se possui filhos

identidadeGenero'C' | 'N' | 'T' | 'U' required

Identidade de Gênero. Seguem os valores aceitos:

C - Cisgênero
N - Não-binário
T - Transgênero
U - Não informado

nivelEscolaridade1 | 3 | 4 | 2 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 required

Escolaridade. Seguem os valores aceitos:

1 - Analfabeto
2 - Até 5º Ano Incompleto
3 - 5º Ano Completo
4 - 6º Ao 9º Ano Incompleto
5 - Fundamental Completo
6 - Ensino Médio Incompleto
7 - Ensino Médio Completo
8 - Superior Incompleto
9 - Superior Completo
10 - Mestrado Completo
11 - Doutorado Completo
12 - Pós-Graduação Completa

nomeSocialstring

Nome Social do candidato. Opcional. Quando preenchido, o sistema registra automaticamente o candidato como travesti ou transexual. Quando não informado ou vazio, essa marcação não é realizada.

orientacaoSexual'A' | 'B' | 'E' | 'H' | 'N' | 'P' required

Orientação Sexual. Seguem os valores aceitos:

A - Assexual
B - Bissexual
E - Heterossexual
H - Homossexual
N - Não informado
P - Panssexual

sexo'M' | 'F' required

Sexo. Seguem os valores aceitos:

M - Masculino
F - Feminino

racaEtnia0 | 2 | 4 | 6 | 8 required

Raça/Etnia do Funcionário. Seguem os valores aceitos:

0 - Indígena
2 - Branca
4 - Preta
6 - Amarela
8 - Parda

observacaoDeficienciastring

Observação sobre Deficiência.

urlFotoPerfilstring

URL da foto de perfil (PNG/JPEG).

observacaostring

Observação da requisição de admissão: Essa informação será apresentada ao usuário do departamento pessoal da empresa, na visualização da requisição para aprovação.

statusRequisicao'Pendente' | 'Aprovado'

Controla se a requisição já deve nascer aprovada (aprovação automática) ou seguir o fluxo normal de aprovação manual pelo Departamento Pessoal.

Pendente (padrão): comportamento atual, a requisição é criada e aguarda aprovação manual.
Aprovado: a requisição é criada e aprovada em uma única operação atômica (tudo ou nada) - se qualquer validação falhar, nenhum dado é gravado.

Esse campo também determina o destino final dos anexos assíncronos (anexosCpf/anexosAdmissao):

Aprovado: quando o processo em segundo plano terminar de baixar cada anexo, ele é automaticamente disponibilizado nos anexos do cadastro do funcionário já criado - sem necessidade de nenhuma ação manual.
Pendente: o anexo baixado fica associado apenas à requisição. Mesmo que a requisição seja aprovada manualmente depois pela tela, o anexo não é vinculado automaticamente ao funcionário - é necessário incluí-lo manualmente pela aba de anexos do funcionário, ou marcar a opção correspondente na aprovação manual.

Example request

{
  "nome": "João Silva",
  "cpf": "12345678900",
  "estadoCivil": 1,
  "possuiFilhos": true,
  "identidadeGenero": "C",
  "nivelEscolaridade": 9,
  "nomeSocial": "Joana Oliveira",
  "orientacaoSexual": "E",
  "sexo": "M",
  "racaEtnia": 2,
  "observacaoDeficiencia": "Deficiência auditiva leve",
  "urlFotoPerfil": "https://imgur.com/abcd",
  "anexosCpf": [
    {
      "nome": "Documento - frente",
      "url": "https://imgur.com/abcd"
    }
  ],
  "anexosAdmissao": [
    {
      "nome": "Documento - frente",
      "url": "https://imgur.com/abcd"
    }
  ],
  "nascimento": {
    "data": "01/11/1978",
    "codigoUF": 1,
    "codigoCidade": 15,
    "nacionalidade": 10,
    "nomeMae": "Maria Silva",
    "nomePai": "José Silva"
  },
  "contato": {
    "email": "funcionario@exemplo.com",
    "emailCorporativo": "funcionario@empresa.com.br"
  },
  "endereco": {
    "codigoEndereco": 40,
    "complemento": "Apto 101",
    "codigoBairro": 54,
    "codigoCidade": 15,
    "codigoUF": 11,
    "codigoPais": 31,
    "anexos": [
      {
        "nome": "Conta de luz",
        "url": "https://imgur.com/abcd"
      }
    ]
  },
  "contrato": {
    "codigoEmpresa": 1,
    "codigoDepartamento": 100100,
    "codigoCargo": 12,
    "codigoFuncao": 9,
    "codigoCargaHoraria": 1,
    "codigoCategoria": 3,
    "codigoCategoriaESocial": 2,
    "codigoCidadeTrabalho": 56,
    "horasSemanais": 40.5,
    "mei": true,
    "percentualAdiantamento": 10.5,
    "percentualInsalubridade": 20,
    "percentualPericulosidade": 30,
    "regimePrevidencia": 1,
    "regimeJornadaTrabalho": 1,
    "regimeTrabalho": 1,
    "codigoLocalTrabalho": 12,
    "sindicato": {
      "codigo": 4,
      "sindicalizado": true
    },
    "admissao": {
      "tipo": "S",
      "indicativo": 1,
      "data": "01/11/2024"
    },
    "remuneracao": {
      "tipo": 1,
      "base": 2500,
      "salarioBase": 3000,
      "tipoSalario": 1
    },
    "fgts": {
      "dataOpcao": "01/11/2024",
      "optante": true,
      "tabelaOcorrencia": "00",
      "tabelaCategoria": "00"
    },
    "periodoExperiencia": {
      "dataVencimento1": "05/10/2021",
      "dataVencimento2": "25/11/2021"
    },
    "dataTerminoContrato": "01/12/2026",
    "dataAso": "05/10/2021"
  },
  "documentos": {
    "pis": {
      "dataCadastro": "05/11/2024"
    },
    "cnh": {
      "categoria": "B",
      "dataEmissao": "01/11/2024",
      "uf": 11,
      "vencimento": "01/06/2025",
      "orgao": "Detran-SP",
      "dataPrimeira": "15/06/2024",
      "anexos": [
        {
          "nome": "CNH - frente",
          "url": "https://imgur.com/abcd"
        }
      ]
    },
    "rg": {
      "data": "01/11/2024",
      "orgaoEmissor": "SSP-SP",
      "uf": 11,
      "anexos": [
        {
          "nome": "RG - frente",
          "url": "https://imgur.com/abcd"
        }
      ]
    },
    "ctps": {
      "digital": true,
      "numero": 1234567,
      "codigoUF": 11,
      "data": "03/11/2024"
    },
    "tituloEleitoral": {
      "anexos": [
        {
          "nome": "Título de Eleitor - Frente",
          "url": "https://imgur.com/abcd"
        }
      ]
    },
    "passaporte": {
      "numero": "AB1234567",
      "dataEmissao": "01/11/2024",
      "dataValidade": "01/11/2028",
      "emissor": "Polícia Federal"
    }
  },
  "trabalhadorEstrangeiro": {
    "classificacao": 2,
    "prazoResidencia": 1,
    "dataChegadaPais": "01/10/2024",
    "rne": {
      "dataVencimento": "01/11/2024",
      "orgaoEmissor": "PF"
    }
  },
  "informacoesBancarias": {
    "codigoAgencia": "8739X",
    "codigoBanco": 2,
    "numeroConta": "8739X",
    "tipoConta": "S",
    "anexos": [
      {
        "nome": "Conta Bancária"
      }
    ]
  },
  "convenios": {
    "possuiConvenioMedico": true,
    "possuiSeguroVida": true,
    "possuiValeAlimentacaoRefeicao": true
  },
  "observacao": "Colaborador irá atuar no atendimento ao cliente.",
  "deficiencias": [
    {
      "tipo": 2
    }
  ],
  "dependentes": [
    {
      "pessoal": {
        "nome": "Joaquim da Silva",
        "cpf": "12345678901",
        "sexo": "M",
        "convenio": true,
        "idadeEscolar": true,
        "racaEtnia": 20,
        "anexosCpf": [
          {
            "nome": "Documento - frente",
            "url": "https://imgur.com/abcd"
          }
        ]
      },
      "nascimento": {
        "data": "01/12/2000",
        "nacionalidade": 10,
        "naturalidade": 15,
        "nomeMae": "Maria Silva",
        "anexosRg": [
          {
            "nome": "Documento - frente",
            "url": "https://imgur.com/abcd"
          }
        ]
      },
      "dependencia": {
        "grauParentesco": 1,
        "dependenteIRRF": true,
        "dataInicioDependencia": "05/06/2019",
        "dataFimDependencia": "12/02/2024",
        "motivoInicio": 10,
        "motivoFim": 50,
        "dataLimiteIRRF": "26/09/2028",
        "descricaoDependencia": "Observação dependência"
      },
      "pensao": {
        "tipo": "L",
        "codigoParceiro": 25,
        "percentual": 5.5,
        "valor": 2000,
        "percentualRepassePensionista": 100,
        "percentualHomologNet": 15,
        "percentualHomologNetFGTS": 15,
        "anexosOficioPensao": [
          {
            "nome": "Documento - frente",
            "url": "https://imgur.com/abcd"
          }
        ]
      },
      "salarioFamilia": {
        "dataLimite": "26/09/2028"
      },
      "auxilioCreche": {
        "receber": true,
        "temAtestado": true,
        "dataLimite": "11/04/2026"
      }
    }
  ],
  "camposAdicionais": [
    {
      "nomeCampo": "AD_APELIDO"
    }
  ],
  "statusRequisicao": "Aprovado",
  "aprovacaoRequisicao": {
    "gerarCodigoFuncionarioAutomatico": true,
    "codigoFuncionario": 1001,
    "gerarMatriculaAutomatica": true,
    "matricula": 500123
  }
}

Response

Requisição de Admissão criada com sucesso.

codigoRequisicaointeger

Código da requisição de admissão criada

Example response

{
  "codigoRequisicao": 13
}

Changes

Nov 3, 2026b3c833e7aab1 Revision changes
- breaking
  removed the enum value 0.00 of the request property ///
- breaking
  removed the enum value 02 of the request property /
- breaking
  removed the enum value 2.00 of the request property ///
- breaking
  removed the enum value 4.00 of the request property ///
- breaking
  removed the enum value 6.00 of the request property ///
- breaking
  removed the enum value 8.00 of the request property //
- breaking
  removed the enum value 8.00 of the request property ///
- breaking
  removed the enum value 9.00 of the request property ///
- breaking
  removed the enum value 9.00 of the request property
- breaking
  the / request property type changed from integer to string
- breaking
  the response's property type changed from string to object for status
- warning
  removed the optional property from the response with the status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property
- info
  added the new 08 enum value to the request property //
- info
  added the new 10.00 enum value to the request property ///
- info
  added the new 2 enum value to the request property /
- info
  added the new 20.00 enum value to the request property ///
- info
  added the new 30.00 enum value to the request property ///
- info
  added the new 40.00 enum value to the request property ///
- info
  added the new 50.00 enum value to the request property ///
- info
  added the new 60.00 enum value to the request property ///
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status

Operation history