Ir para o conteúdo
prumo

funcionárioscadastrar funcionário

POST/v1/employeespermissão: manage_employees, mais manage_members quando access.role não é employee

Cadastrar funcionário

Cria a ficha. Com o objeto access a pessoa também ganha conta para assinar o próprio holerite, e aí o e-mail é obrigatório.

corpo da requisição

fullNamestringobrigatório
Nome completo.
cpfstringobrigatório
Com ou sem pontuação.
jobTitlestringobrigatório
Cargo.
hiredOnstringobrigatório
Admissão, AAAA-MM-DD.
contractTypepermanent | temporary | pjobrigatório
Tipo de contrato. PJ não entra em INSS, IRRF nem FGTS.
baseSalarynumberobrigatório
Salário base em reais.
contractEndsOnstring | nullopcional
Obrigatório no contrato temporário.
emailstring | nullopcional
E-mail do funcionário.
pisNisstring | nullopcional
Onze dígitos.
weeklyHoursnumber | nullopcional
Jornada semanal.
ctpsstring | nullopcional
CTPS.
unionNamestring | nullopcional
Sindicato.
costCenterstring | nullopcional
Centro de custo.
employmentStatusactive | on_vacationopcional
Situação. Padrão active.
dependentsCountnumberopcional
De 0 a 20.
bankNamestring | nullopcional
Banco.
bankBranchstring | nullopcional
Agência.
bankAccountstring | nullopcional
Conta.
pixKeystring | nullopcional
Chave PIX.
mealAllowancenumber | nullopcional
Vale refeição.
transportAllowancenumber | nullopcional
Vale transporte.
childcareAllowancenumber | nullopcional
Auxílio creche.
healthPlannumber | nullopcional
Plano de saúde.
accessobjetoopcional
password e role para criar a conta de acesso.

erros deste endpoint

  • 401not_authenticatedA chave não veio, não existe mais ou foi revogada.
  • 403not_allowedA chave não tem manage_employees, mais manage_members quando access.role não é employee.
  • 409cpf_already_registeredJá existe um funcionário com esse CPF nesta organização.
  • 422invalid_inputUm campo não passou na validação; fields aponta qual.