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

{
    "code": 201,
    "messages": null,
    "result": {
        "position_id": "9ed9063b-ed1f-44f6-9b26-f3b57b64f632"
    },
    "status": "ok"
}

• Descrição do body JSON da request

• Exemplo de requisição

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.
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.)
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
contaBancaria 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", "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

{
  "numMatricula": "4242424",
  "limitDate": "2018-01-01",
  "admissionDate": "2018-01-01",
  "costCenter": "anywhere",
  "posNumber": "pos-test",
  "role": "b63e065f-d7e0-49e1-91b7-88f74516e3fe",
  "department": "bf559996-a8b9-4f5e-af57-86111b0dbde3",
  "unitID": "e37dab24-c7a4-4b92-b9d1-d2ed538b8398",
  "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": "[e-mail]",
    "mobile": "11911111111"
  },
  "exame": {
    "clinica": "6dc84ce4-7d9f-48ec-b9b1-a8a895a21fd4",
    "data": "2018-01-01",
    "hora": "14:00",
    "obs":descricao-do-body-json-da-request-1 "Comparecer de manhã",
    "guia": "e37dab24-c7a4-4b92-b9d1-32ed538b8300",
  },
  "docs": ["c9e26093-5e0c-4bd2-bea3-ac5182a6179f"],
  "benefits": ["d4260f8d-f19a-463d-acdf-958ed358bb43"],
  "sendSMS": true,
  "sendEmail": true
}

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)

200

• Descrição do body JSON da request
• Exemplo de requisição

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
dates 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

"created", "-created", "updated", "-updated"

As opções que contem o símbolo - no início, são utilizadas quando a ordenação desejada é decrescente.

Opções de status

"pending", "review", "validation", "completed",	"archived"

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 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

{
    "account": "2d9174c4-06b7-4956-a5dc-8824d8a2f49e",
    "limit": 100,
    "skip": 0,
    "template": "csv-v2.2",
    "sort": "-created",
    "status": [ "pending" ],
    "dates": {
       "admissionDate": {
           "start": "2020-09-01",
            "end": "2020-09-30"
        } 
    }
}