SAsankhya
HCM Funcionários

Cria um novo funcionário

Changed on

Cria um novo funcionário diretamente no SankhyaOM, sem necessidade de fluxo de requisição de admissão prévia.

O código do funcionário e a matrícula são gerados automaticamente por padrão. Para informar os valores manualmente, defina gerarCodigoFuncionarioAutomatico: false e/ou gerarMatriculaAutomatica: false e forneça os respectivos campos.

Campos condicionalmente obrigatórios:

  • contrato.fgts.tabelaOcorrencia e contrato.fgts.tabelaCategoria: obrigatórios quando contrato.fgts.optante = true
  • contrato.periodoExperiencia.dataVencimento1 e dataVencimento2: obrigatórios quando contrato.periodoExperiencia.dispensa = false
  • naturezaAtividade: obrigatório para categorias eSocial 401, 731, 734 e 738
  • codigoFuncionario: obrigatório quando gerarCodigoFuncionarioAutomatico = false
  • matricula: obrigatório quando gerarMatriculaAutomatica = false
  • contrato.codigoCidadeTrabalho ou contrato.codigoCidadeTrabalhoIbge: é obrigatório informar pelo menos um
  • nascimento.codigoCidade ou nascimento.codigoCidadeIbge: é obrigatório informar pelo menos um

Limitações:

  • Não é permitido cadastrar funcionário com vínculo de aprendiz (categoria eSocial 103 ou vínculo 55 - Menor Aprendiz) por este endpoint.

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

post/v1/pessoal/funcionarios

Request

  • Base URL
    https://api.sankhya.com.br
  • URL
    https://api.sankhya.com.br/v1/pessoal/funcionarios
  • Auth
    HTTP bearer

Request body

nomestring required

Nome completo do funcionário

cpfstring required

CPF do funcionário (somente dígitos)

nomeSocialstring

Nome social do funcionário. Quando preenchido, o sistema registra automaticamente o funcionário como travesti ou transexual.

sexo'M' | 'F' required

Sexo. Seguem os valores aceitos:

  • M - Masculino
  • F - Feminino
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
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
estadoCivil1 | 2 | 3 | 4 | 5 | 6 | 7 required

Estado Civil. Seguem os valores aceitos:

  • 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
nivelEscolaridade1 | 2 | 3 | 4 | 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
racaEtnia'0' | '2' | '4' | '6' | '8' required

Raça/Etnia. Seguem os valores aceitos:

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

Indica se o funcionário possui filhos

observacaostring

Observações gerais sobre o funcionário

observacaoDeficienciastring

Informações específicas sobre deficiência do funcionário

naturezaAtividade'P' | 'U'

Natureza da Atividade. Obrigatório para as categorias eSocial 401, 731, 734 e 738. Seguem os valores aceitos:

  • P - Rural
  • U - Urbano
urlFotoPerfilstring

URL pública da foto de perfil do funcionário (formatos PNG ou JPEG).

isParceiroboolean

Indica se o funcionário deve ser vinculado como parceiro no SankhyaOM

gerarCodigoFuncionarioAutomaticoboolean

Quando true (padrão), o sistema gera o código do funcionário automaticamente. Quando false, o campo codigoFuncionario torna-se obrigatório.

codigoFuncionariointeger

Código do funcionário a ser cadastrado. Obrigatório quando gerarCodigoFuncionarioAutomatico = false.

gerarMatriculaAutomaticaboolean

Quando true (padrão), o sistema gera a matrícula automaticamente. Quando false, o campo matricula torna-se obrigatório.

matriculainteger

Matrícula do funcionário. Obrigatória quando gerarMatriculaAutomatica = false.

Example request

{
  "nome": "João da Silva",
  "cpf": "12345678900",
  "nomeSocial": "Joana Silva",
  "sexo": "M",
  "identidadeGenero": "C",
  "orientacaoSexual": "E",
  "estadoCivil": 1,
  "nivelEscolaridade": 9,
  "racaEtnia": "2",
  "observacao": "Contratado via portal de integração",
  "observacaoDeficiencia": "Deficiência auditiva leve",
  "naturezaAtividade": "P",
  "urlFotoPerfil": "https://exemplo.com/foto.jpg",
  "gerarCodigoFuncionarioAutomatico": true,
  "codigoFuncionario": 100,
  "gerarMatriculaAutomatica": true,
  "matricula": 1001,
  "nascimento": {
    "data": "15/06/1990",
    "nomeMae": "Maria da Silva",
    "nomePai": "José da Silva",
    "nacionalidade": 10,
    "codigoCidade": 15,
    "codigoCidadeIbge": 3550308,
    "codigoUF": 35,
    "codigoPaisNascimento": 105
  },
  "contato": {
    "email": "joao.silva@email.com",
    "emailCorporativo": "joao.silva@empresa.com.br",
    "celular": "11999998888",
    "telefone": "1133334444"
  },
  "endereco": {
    "cep": "01310100",
    "numero": "100",
    "complemento": "Apto 42",
    "anexos": [
      {
        "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
        "nome": "rg-joao.pdf"
      }
    ]
  },
  "contrato": {
    "codigoEmpresa": 1,
    "codigoDepartamento": 10,
    "codigoCargo": 7,
    "codigoFuncao": 15,
    "codigoCargaHoraria": 1,
    "codigoCategoriaESocial": 101,
    "codigoCategoria": 1,
    "codigoCidadeTrabalho": 56,
    "codigoCidadeTrabalhoIbge": 3550308,
    "codigoLocalTrabalho": 3,
    "horasSemanais": 44,
    "percentualAdiantamento": 40,
    "percentualInsalubridade": 20,
    "percentualPericulosidade": 30,
    "regimePrevidencia": 2,
    "regimeJornadaTrabalho": 1,
    "regimeTrabalho": 1,
    "vinculo": 15,
    "tipoRecebimento": "B",
    "dataAso": "10/01/2025",
    "dataTerminoContrato": "31/12/2025",
    "sindicato": {
      "codigo": 4
    },
    "admissao": {
      "tipo": "N",
      "indicativo": 1,
      "data": "15/01/2025"
    },
    "remuneracao": {
      "tipo": "1",
      "salarioBase": 4500,
      "base": 4500,
      "tipoSalario": "1"
    },
    "fgts": {
      "optante": true,
      "dataOpcao": "15/01/2025",
      "tabelaOcorrencia": "00",
      "tabelaCategoria": "01"
    },
    "periodoExperiencia": {
      "dataVencimento1": "15/04/2025",
      "dataVencimento2": "15/07/2025"
    }
  },
  "documentos": {
    "pis": {
      "numero": "12345678901",
      "dataCadastro": "01/01/2010"
    },
    "rg": {
      "numero": "123456789",
      "data": "10/05/2005",
      "orgaoEmissor": "SSP-SP",
      "uf": 35,
      "anexos": [
        {
          "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
          "nome": "rg-joao.pdf"
        }
      ]
    },
    "ctps": {
      "digital": true,
      "numero": 1234567,
      "serie": "001",
      "codigoUF": 35,
      "data": "01/03/2010"
    },
    "cnh": {
      "numero": "12345678900",
      "categoria": "B",
      "vencimento": "01/06/2028",
      "uf": 35,
      "orgao": "Detran-SP",
      "dataPrimeira": "15/06/2010",
      "dataEmissao": "01/07/2023",
      "anexos": [
        {
          "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
          "nome": "rg-joao.pdf"
        }
      ]
    },
    "tituloEleitoral": {
      "numero": "123456789012",
      "secao": "0001",
      "zona": "001",
      "anexos": [
        {
          "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
          "nome": "rg-joao.pdf"
        }
      ]
    },
    "reservista": {
      "numero": "12345"
    },
    "passaporte": {
      "numero": "AA123456",
      "dataEmissao": "01/01/2020",
      "dataValidade": "01/01/2030",
      "emissor": "DPF",
      "codigoUF": 35
    }
  },
  "informacoesBancarias": {
    "codigoBanco": 341,
    "codigoAgencia": "1234",
    "numeroConta": "12345-6",
    "tipoConta": "C",
    "anexos": [
      {
        "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
        "nome": "rg-joao.pdf"
      }
    ]
  },
  "camposAdicionais": [
    {
      "nomeCampo": "AD_CODINTEGRACAO",
      "valor": "EXT-001"
    }
  ],
  "dependentes": [
    {
      "pessoal": {
        "nome": "Maria de Fatima",
        "cpf": "65497593070",
        "sexo": "F",
        "convenio": true,
        "racaEtnia": 20,
        "anexosCpf": [
          {
            "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
            "nome": "rg-joao.pdf"
          }
        ]
      },
      "nascimento": {
        "data": "01/01/2005",
        "nacionalidade": 10,
        "naturalidade": 123,
        "naturalidadeIbge": 3305802,
        "nomeMae": "Carmen",
        "anexosRg": [
          {
            "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
            "nome": "rg-joao.pdf"
          }
        ]
      },
      "dependencia": {
        "grauParentesco": 1,
        "dependenteIRRF": true,
        "dataInicioDependencia": "01/01/2020",
        "dataFimDependencia": "01/01/2030",
        "motivoInicio": 10,
        "motivoFim": 50,
        "dataLimiteIRRF": "01/01/2035",
        "descricaoDependencia": "Dependente universitário"
      },
      "pensao": {
        "tipo": "L",
        "pensionista": true,
        "codigoParceiro": 1,
        "percentual": 20,
        "valor": 100,
        "percentualRepassePensionista": 1,
        "percentualHomologNet": 2,
        "percentualHomologNetFGTS": 2,
        "anexosOficioPensao": [
          {
            "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
            "nome": "rg-joao.pdf"
          }
        ]
      },
      "salarioFamilia": {
        "fazRepasse": true,
        "dataLimite": "01/01/2030"
      },
      "auxilioCreche": {
        "dataLimite": "01/01/2030"
      }
    }
  ],
  "trabalhoTemporario": {
    "tipoInclusaoContratual": 1,
    "cpfSubstituido": "12345678900",
    "tipoInscricaoEstabelecimentoTomador": "1",
    "inscricaoEstabelecimentoTomador": "12345678000199",
    "tipoInscricaoEstabelecimentoVinculado": "1",
    "inscricaoEstabelecimentoVinculado": "98765432000188",
    "justificativaContratacao": "Substituição de empregado afastado"
  },
  "trabalhadorEstrangeiro": {
    "classificacao": "1",
    "dataChegadaPais": "01/03/2020",
    "prazoResidencia": "PERMANENTE",
    "rne": {
      "numero": "W123456-7",
      "dataVencimento": "31/12/2030",
      "orgaoEmissor": "PF"
    }
  },
  "anexosCpf": [
    {
      "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
      "nome": "rg-joao.pdf"
    }
  ],
  "anexosAdmissao": [
    {
      "url": "https://storage.exemplo.com.br/docs/rg-joao.pdf",
      "nome": "rg-joao.pdf"
    }
  ],
  "deficiencias": [
    {
      "tipoDeficiencia": 2
    }
  ]
}

Response

Funcionário criado com sucesso

codigoFuncionariointeger

Código do funcionário gerado no SankhyaOM

codigoEmpresainteger

Código da empresa do funcionário

matriculainteger

Matrícula gerada para o funcionário

statusCadastrostring

Status do cadastro após a criação

Example response

{
  "codigoFuncionario": 42,
  "codigoEmpresa": 1,
  "matricula": 1001,
  "statusCadastro": "ATIVO"
}

Changes