Área do desenvolvedorComunidadeMarketplaceUniversidade
Documentação API

Cria um novo funcionário

post
https://api.sankhya.com.br/v1/pessoal/funcionarios

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Nome completo do funcionário

string
required

CPF do funcionário (somente dígitos)

string

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

string
enum
required

Sexo. Seguem os valores aceitos:

  • M - Masculino
  • F - Feminino
Allowed:
string
enum
required

Identidade de Gênero. Seguem os valores aceitos:

  • C - Cisgênero
  • N - Não-binário
  • T - Transgênero
  • U - Não informado
Allowed:
string
enum
required

Orientação Sexual. Seguem os valores aceitos:

  • A - Assexual
  • B - Bissexual
  • E - Heterossexual
  • H - Homossexual
  • N - Não informado
  • P - Panssexual
Allowed:
integer
enum
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
Allowed:
integer
enum
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
string
enum
required

Raça/Etnia. Seguem os valores aceitos:

  • 0 - Indígena
  • 2 - Branca
  • 4 - Preta
  • 6 - Amarela
  • 8 - Parda
Allowed:
boolean

Indica se o funcionário possui filhos

string

Observações gerais sobre o funcionário

string

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

string
enum

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

  • P - Rural
  • U - Urbano
Allowed:
string

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

boolean

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

boolean
Defaults to true

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

integer

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

boolean
Defaults to true

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

integer

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

nascimento
object
required

Informações de nascimento do funcionário

contato
object
required

Informações de contato do funcionário

endereco
object
required

Informações de endereço do funcionário

contrato
object
required

Informações contratuais do funcionário

documentos
object

Documentos do funcionário

informacoesBancarias
object

Informações bancárias para pagamento do salário

camposAdicionais
array of objects

Campos adicionais configurados na entidade Funcionario do SankhyaOM

camposAdicionais
dependentes
array of objects

Lista de dependentes do funcionário

dependentes
trabalhoTemporario
object

Informações de trabalho temporário (obrigatório para vínculos temporários conforme eSocial)

trabalhadorEstrangeiro
object

Informações complementares para trabalhadores estrangeiros

anexosCpf
array of objects

Anexos do CPF do funcionário

anexosCpf
anexosAdmissao
array of objects

Anexos do exame admissional (ASO)

anexosAdmissao
deficiencias
array of objects

Lista de deficiências do funcionário. A presença de ao menos um item marca automaticamente o funcionário como deficiente físico (PCD) e como informação de cota.

deficiencias
Responses

500

Erro interno no servidor

Updated 2 days ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago

Did this page help you?