v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB

HCM Cadastros

Criar uma nova requisição de admissão

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.26.0

post/v2/funcionarios/admissao

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

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 | 9 required

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

0 - Indígena
2 - Branca
4 - Preta
6 - Amarela
8 - Parda
9 - Não informado

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.

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"
  },
  "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"
    }
  },
  "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": 457390,
    "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": 2,
        "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"
      }
    }
  ]
}

Response

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

codigoRequisicaointeger

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

Example response

{
  "codigoRequisicao": 13
}