Posições
Criação e exportação de posições
Posições são as vagas, convites para os candidatos iniciarem o preenchimento do "application" (formulário). Dentro da position estarão todos os dados preenchidos na criação da vaga, quanto os dados preenchidos pelo candidato (Pessoas e Documentos).
Create position
POST https://api.acessorh.com.br/v2/positions
Cria uma posição na filial selecionada. 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.
Path Parameters
Authorization*
string
Token ded acesso adquirido pela plataforma Identity(Bearer)
{
"code": 201,
"messages": null,
"result": {
"position_id": "9ed9063b-ed1f-44f6-9b26-f3b57b64f632"
},
"status": "ok"
}Descrição do body JSON da request
Chave
Tipo
Descrição
numMatricula
string
Número da matrícula
limitDate*
string, format("YYYY-mm-dd")
Data limite para o preenchimento do cadastro
admissionDate
string, format("YYYY-mm-dd")
Data de admissão
costCenter
string
Centro de custo
posNumber
string
Número da posição
role*
string
UID ou código do cargo indicado para a vaga
department*
string
UID ou código do departamento indicado para a vaga
unitID*
string
UID da filial onde a posição será criada.
pagamento*
object
Informações sobre o pagamento
deficiencia*
boolean
Indica se a vaga é PCD
jornada
string
Informações sobre a jornada de trabalho
profile*
object
Informações de contato do candidato
exame*
object
Informações sobre o agendamento de exame médico
docs
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.)
sendSMS*
boolean
Indica a necessidade do envio da notificação para o candidato através de um SMS
sendEmail*
boolean
Indica a necessidade do envio da notificação para o candidato através de um e-mail
Pagamento
Chave
Tipo
Descrição
vinculo*
string (options)
Vínculo empregatício
valor
string
Valor da remuneração
recorrencia
string (options)
Recorrência do pagamento
dataInicio
string, format("YYYY-mm-dd")
Data de início do contrato de estágio ou aprendiz
dataTermino
string, format("YYYY-mm-dd")
Data de término do contrato de estágio ou aprendiz
agenteIntegrador
string(options)
Agente integrador do contrato de estágio ou aprendiz
contaBancaria
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
Opções de recorrência
Opções de agente integrador
Conta bancária
Chave
Tipo
Descrição
banco*
string(options)
Código do banco do qual a carta de abertura de conta se refere
carta
string
UID do arquivo contendo a carta de abertura de conta
template*
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
Profile
Chave
Tipo
Descrição
name*
string
Nome do candidato
email*
string
E-mail do candidato
mobile*
string, format("11911111111")
Número do celular do candidato
Exame
Chave
Tipo
Descrição
clinica*
string
UID ou código da clínica
data
string, format("YYYY-mm-dd")
Data do agendamento
hora
string, format("HH:MM")
Hora do agendamento
obs
string
Observações do agendamento
guia
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
Export position
POST https://api.acessorh.com.br/v2/positions/export
Exporta posições conforme o filtro informado no formato selecionado.
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
Descrição do body JSON da request
Chave
Tipo
Descrição
account
string
UID da empresa
units
array[string]
UID das filiais
limit
integer
Quantidade limite de resultados (paginação)
skip
integer
Quantidade de resultados a serem pulados (paginação)
template*
string(options)
Formatação do resultado da consulta
templateOptions
object
Opções complementares à formatação do resultado
sort
string(options)
Ordenação dos resultados
status
string(options)
Filtro de status das posições
dates
object
Filtro de resultado por data
Um dos dois parâmetros,account ou units,deve ser enviado.
O máximo de resultados permitidos em uma requisição é 100. Caso o parâmetro limit não seja enviado, ele será definido como 100.
Opções de sort
As opções que contem o símbolo - no início, são utilizadas quando a ordenação desejada é decrescente.
Opções de status
Status
Descrição
pending
Posições pendentes de preenchimento
review
Posições em correção após análise
validation
Posições em análise
completed
Posições preenchidas e validadas
archived
Posições arquivadas
Filtro por data
Chave
Tipo
Descrição
admissionDate
object
Range da data de admissão do candidato
Range de datas
Chave
Tipo
Descrição
start*
string
Data início
end*
string
Data fim
Exemplo de requisição
Atualizado
Isto foi útil?