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
Name | Type | Description |
---|---|---|
Authorization | string | Token ded acesso adquirido pela plataforma Identity(Bearer) |
Descrição do body JSON da request
Chave | Tipo | Descrição |
numMatricula optional | string | Número da matrícula |
limitDate required | string, format("YYYY-mm-dd") | Data limite para o preenchimento do cadastro |
admissionDate optional | string, format("YYYY-mm-dd") | Data de admissão |
costCenter optional | string | Centro de custo |
posNumber 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 |
unitID required | string | UID da filial onde a posição será criada. |
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 |
required | object | Informações de contato do candidato |
optional | object | Informações sobre o agendamento de exame médico |
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.) |
sendSMS required | boolean | Indica a necessidade do envio da notificação para o candidato através de um SMS |
sendEmail 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
Opções de recorrência
Opções de agente integrador
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
Profile
Chave | Tipo | Descrição |
name required | string | Nome do candidato |
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
Export position
POST
https://api.acessorh.com.br/v2/positions/export
Exporta posições conforme o filtro informado no formato selecionado.
Headers
Name | Type | Description |
---|---|---|
Authorization | string | Token de acesso adquirido pela plataforma Identity (bearer) |
Descrição do body JSON da request
Chave | Tipo | Descrição |
account optional* | string | UID da empresa |
units optional* | array[string] | UID das filiais |
limit optional | integer | Quantidade limite de resultados (paginação) |
skip optional | integer | Quantidade de resultados a serem pulados (paginação) |
template required | string(options) | Formatação do resultado da consulta |
templateOptions optional | object | Opções complementares à formatação do resultado |
sort optional | string(options) | Ordenação dos resultados |
status optional | string(options) | Filtro de status das posições |
optional | 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 |
optional | object | Range da data de admissão do candidato |
Range de datas
Chave | Tipo | Descrição |
start required | string | Data início |
end required | string | Data fim |
Exemplo de requisição
Last updated