Homepage

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)

201 OK
{
    "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

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

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

AnteriorOrganizaçãoPróximoReferências

Atualizado

Isto foi útil?