Posições

Criação e listagem de posições.
Posições são as vagas, convites para os candidatos iniciarem o preenchimento do "application" (formulário). A criação da posição é uma replica do preenchimento no Dashboard, passando as informações básicas para a identificação do candidato e geração do check-list.
Caso utilize as funcionalidades de Guia de Exame Médico e Carta de Abertura de Conta Bancária, será necessário antes criá-las através da chamada de Upload de Arquivos e então referenciar seus UIDs nos campos de Guia e Carta.
post
https://api.acessorh.com.br
/v1/account/:unit/json/position
Create position
Caso a requisição seja realizada com sucesso, o header position-id, contendo o UID da position criada, será enviado na resposta.

Descrição do body JSON da request

Chave
Tipo
Descrição
num_matricula
optional
string
Número da matrícula
limit_date
required
string, format("YYYY-mm-dd")
Data limite para o preenchimento do cadastro
admission_date
optional
string, format("YYYY-mm-dd")
Data de admissão
cost_center
optional
string
Centro de custo
pos_number
optional
string
Número da posição
role
required
string
UID ou código do cargo indicado para a vaga
department
required
string
UID ou código do departamento indicado para a vaga
pagamento
required
object
Informações sobre o pagamento
deficiencia
required
boolean
Indica se a vaga é PCD
jornada
optional
string
Informações sobre a jornada de trabalho
profile
required
object
Informações de contato do candidato
exame
optional
object
Informações sobre o agendamento de exame médico
docs
optional
array[string]
UIDs dos documentos adicionais a serem solicitados para a vaga
benefits
array[string]
UIDs dos grupos de benefícios.(Obs.: Deverá ter apenas um por categoria.)
send_sms
required
boolean
Indica a necessidade do envio da notificação para o candidato através de um SMS
send_email
required
boolean
Indica a necessidade do envio da notificação para o candidato através de um e-mail

Pagamento

Chave
Tipo
Descrição
vinculo
required
string (options)
Vínculo empregatício
valor
optional*
string
Valor da remuneração
recorrencia
optional*
string (options)
Recorrência do pagamento
dataInicio
optional
string, format("YYYY-mm-dd")
Data de início do contrato de estágio ou aprendiz
dataTermino
optional
string, format("YYYY-mm-dd")
Data de término do contrato de estágio ou aprendiz
agenteIntegrador
optional
string(options)
Agente integrador do contrato de estágio ou aprendiz
optional
object
Dados referentes à configuração de cartas de abertura de conta
Os campos de recorrencia e de valor são interdependentes. Caso um seja preenchido o outro se torna required.

Opções de vínculo

"clt", "estagio", "aprendiz", "autonomo", "temporario", "verde-amarelo", "intermitente", "estatuario"

Opções de recorrência

"horista", "mensalista", "aulista", "comissionista", "diarista"

Opções de agente integrador

"ciee", "nube", "senai", "senac", "mudes", "coep", "rede_cidada", "espro", "guarda_mirim", "iel", "iaq", "apae_jo_clemente", "gerar_guarapuva_ponta", "instituto_ser", "perfil_talentos", "pestalozzi", "renapsi", "elo", "pastoral", "via_de_acesso", "geec", "outros"

Conta bancária

Chave
Tipo
Descrição
banco
required
string(options)
Código do banco do qual a carta de abertura de conta se refere
carta
optional*
string
UID do arquivo contendo a carta de abertura de conta
template
optional*
string
UID do modelo de abertura de conta
Caso queira criar a posição com uma carta de abertura de conta anexada, é necessário realizar o seu upload antes.
Apenas uma opção deve ser escolhida: carta ou template.
O ID do modelo de carta pode ser encontrado no próprio módulo de criação dentro do Acesso RH.

Opções de banco

"001", "033", "041", "047", "104", "151", "237", "341", "399", "735", "745", "748", "755"

Profile

Chave
Tipo
Descrição
name
required
string
Nome do candidato
email
required
string
E-mail do candidato
mobile
required
string, format("11911111111")
Número do celular do candidato

Exame

Chave
Tipo
Descrição
clinica
required
string
UID ou código da clínica
data
optional
string, format("YYYY-mm-dd")
Data do agendamento
hora
optional
string, format("HH:MM")
Hora do agendamento
obs
optional
string
Observações do agendamento
guia
optional*
string
UID do arquivo contendo a guia do exame médico
Obs: Os campos data, hora e obs, não são obrigatórios mas é indicado que eles sejam preenchidos pois são essas informações que serão disponibilizadas para os candidatos no momento do preenchimento da vaga. *guia: Caso queira criar a posição com uma guia de exame médico anexada, é necessário realizar o seu upload antes.

Exemplo de requisição

{
"num_matricula": "4242424",
"limit_date": "2018-01-01",
"admission_date": "2018-01-01",
"cost_center": "anywhere",
"pos_number": "pos-test",
"role": "b63e065f-d7e0-49e1-91b7-88f74516e3fe",
"department": "bf559996-a8b9-4f5e-af57-86111b0dbde3",
"pagamento": {
"vinculo": "clt",
"valor": "4200",
"recorrencia": "mensalista",
"contaBancaria": {
"banco": "001",
"carta": "c9160763-db6c-4e8c-a1ad-ad8709c99be2"
}
},
"deficiencia": false,
"jornada": "De segunda a sexta das 15 as 19",
"profile": {
"name": "John Doe",
"email": "[email protected]",
"mobile": "11911111111"
},
"exame": {
"clinica": "6dc84ce4-7d9f-48ec-b9b1-a8a895a21fd4",
"data": "2018-01-01",
"hora": "14:00",
"obs": "Comparecer de manhã",
"guia": "e37dab24-c7a4-4b92-b9d1-32ed538b8300",
},
"docs": ["c9e26093-5e0c-4bd2-bea3-ac5182a6179f"],
"send_sms": true,
"send_email": true
}
get
https://api.acessorh.com.br
/v1/positions/:position
Get position

Campos opcionais | includes

"role","benefits","department","persons","unit","attachments","decline"
get
https://api.acessorh.com.br
/v1/positions
List positions
Caso não seja inserido os parâmetros limit e skip , os valores padrões serão, respectivamente, 100 e 0.
O parâmetro limit tem o seu valor máximo como 100.

Parâmetros para ordenação das posições

Chave
Tipo
Descrição
limit_date
string
Data limite para o preenchimento do cadastro.
admission_date
string
Data de admissão preenchida no cadastro da vaga.
created_date
string
Data em que o cadastro foi criado.
updated_date
string
Ultima data de atualização do cadastro.
completed_date
string
Data de finalização do cadastro.

Opções de ordenação

Chave
Tipo
Descrição
asc
string
Ordena de forma crescente.
desc
string
Ordena de forma decrescente.

Lista de status

210 - "invited" (posição criada e convite enviado para o candidato)
220 - "pending" (candidato iniciou o processo de admissão, mas ainda não finalizou a entrega dos documentos)
230 - "review" (posição já analisada pela mesa, mas pendente de correção pelo candidato)
240 - "completed" (todos os documentos entregues, aguardando análise da mesa)
400 - "active" (documentos entregues e validados ou posição completada manualmente pelo RH)
500 - "dismissal/archived" (posição arquivada pelo RH)
501 - "declined" (posições declinadas pelo RH)
JSON - Especificações.xlsx
31KB
Binary
Descritivo dos campos
put
https://api.acessorh.com.br
/v1/positions/status/:position
Change status

Descrição do body JSON da request

Chave
Tipo
Descrição
unit
required
string
UID da filial do qual a posição pertence
status
required
string(options)
Status no qual a posição será alterada
decline
optional*
object
Decline é a estrutura com as informações dos motivos de declínio da posição. *Esse campo é required apenas quando o campo de status for igual a "declined".

Opções de status

"completed", "archived", "declined"
  • A posição só poderá ser arquivada, se ela já estiver completa ou declinada.
  • Não é possível declinar posições que estão arquivadas.

Campo decline

Chave
Tipo
Descrição
type required
string
Indica qual foi o lado responsável por decidir declinar do processo de admissão: Candidato (DECLINED_BY_USER) Empresa (DECLINED_BY_HR)
reason required
string(options)
Motivo que levou essa posição a ser declinada. Os motivos devem está de acordo com o type indicado.
description optional
string
Detalhes do motivo que levou essa posiçao ser declinada.
message optional
string
Mensagem customizada que fará parte do e-mail que será enviada para o candidato que teve sua posição declinada.

Tipos de declínio com seus respectivos motivos

DECLINED_BY_HR
DECLINED_BY_USER
REASONS | DECLINED_BY_HR
sem-retorno-candidato
falta-documento
escolaridade-inferior
sem-vacina-covid
outro
REASONS | DECLINED_BY_USER
motivos-pessoais
proposta-melhor
nao-tem-interesse
sem-retorno
outro

Exemplo de requisição

{
"unit": "84ef8cd7-76ee-4b10-a77b-e0201cdcd117",
"status": "declined",
"decline":{
"type": "DECLINED_BY_HR",
"reason": "falta-documento",
"description": "descrição",
"message":"messagem de declino para o candidato",
}
}
delete
https://api.acessorh.com.br
/v1/positions
Delete position
patch
https://api.acessorh.com.br
/v1/positions/:position/benefits
Set benefits in a position

Descrição do body JSON da request

Chave
Tipo
Descrição
unit
required
string
UID da filial onde a posição se encontra
add
optional
array[string]
UIDs dos grupos de benefícios a serem adicionadas na posição
remove
optional
array[string]
UIDs dos grupos de benefícios a serem
removidos da posição
  • Um dos campos add ou remove deverão ser preenchidos.
  • Não é possível adicionar ou remover benefícios para posições declinadas

Exemplo de requisição

{
"unit": "4bdaa0d3-f3e4-4520-b64e-6a22508bebc9",
"add": ["c4c17fd1-9c93-4dbf-bca8-bded7fd97287"],
"remove": ["87a6e88f-c318-416b-830e-8cf446f535fe"]
}
post
https://api.acessorh.com.br
/v1/positions/:position_id/signature-envelopes
Creates document to send the admission kit

Descrição do body JSON da request

Chave
Tipo
Descrição
account
required
string
UID da empresa.
unit
required
string
UID da filial onde a posição se encontra.
models
required
array[string]
Lista com os UID dos
modelos de documentos
que devem ser enviados
para assinatura.
Não é possível enviar o kit admissional para posições:
  • Em andamento
  • Arquivadas
  • Declinadas

Exemplo de requisição

{
"account": "4aca3203-e791-41e1-b5d7-6ef02d152787",
"unit": "8eff6480-1e71-468b-ae4d-eefe3cd3e03d",
"models": [
"8946efe8-e100-4497-907e-3803bb048b47",
"62766bb0-b5ac-4462-8478-062950577067"
]
}
get
https://api.acessorh.com.br
/v1/admissions/invite/:pos
Get Position Invite