Create position

Cria uma posição na filial selecionada. 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.

POST Url Produção: https://api.acessorh.com.br Url Homologação: https://api.rh.homolog.acesso.io Endpoint: /v1/account/:unit/json/position

Headers

Name	Type	Description
Authorization*	string	Token de acesso adquirido pela plataforma Identity (bearer)

Path Parameters

Name	Type	Description
unit*	string	UID da filial onde a posição será criada. Consulte aqui

Descrição do body JSON da request

Objeto de profile

Key	Type	Description
name*	string	Nome do candidato
email*	string	E-mail do candidato
mobile*	string, format("11911111111")	Número do celular do candidato

Exemplo de profile no payload

"profile": {
        "name": "John Doe",
        "email": "[email protected]",
        "mobile": "11911111111"
    },

Campos obrigatórios no payload

Key	Type	Description
limit_date*	string, format("YYYY-mm-dd")	Data limite para o preenchimento do cadastro. Valor mínimo válido precisa ser maior ou igual à data atual
role*	string	UID ou código do cargo indicado para a vaga. Consulte aqui
department*	string	UID ou código do departamento indicado para a vaga. Consulte aqui
pagamento*	object	Informações sobre o pagamento. A string de "vinculo" é obrigatória.

Exemplo de dados obrigatórios no payload

    "limit_date": "2028-01-01",
    "role": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "department": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "pagamento": {
        "vinculo": "clt"
    },

Campos opcionais para o payload

Ke	Type	Description
num_matricula	string	Número da matrícula
pos_number	string	Número da posição
cost_center	string	Centro de custo
admission_date	string, format("YYYY-mm-dd")	Data de admissão
deficiencia	boolean	Indica se a vaga é PCD
jornada	string	Informações sobre a jornada de trabalho
exame	object	Informações sobre o agendamento de exame médico
docs	array[string]	UIDs dos types de 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	boolean	Indica a necessidade do envio da notificação para o candidato através de um SMS/Whats app
send_email	boolean	Indica a necessidade do envio da notificação para o candidato através de um e-mail

Opções do objeto de pagamento - Obrigatório

Type	Key	Descript
vinculo*	string (options)	Vínculo empregatício

Opções de vínculo

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

Opções do objeto de pagamento - Opcionais

Key	Type	Description
recorrencia	string (options)	Recorrência do pagamento
valor	string	Valor da remuneração
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

Opções de recorrência

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

Opções de agente integrador

"ciee", "nube", "senai", "senai_pa_barcarena", "senai_pe_sto_agostinho", "senai_mt_cuiaba", "senai_mt_nova_mutum", "senai_rj_rio_de_janeiro", "senai_mg_mariana", "senac", "mudes", "coep", "rede_cidada", "espro", "espro_sp_av_paulista", "espro_mg_belo_horizonte", "espro_sp_santo_amaro", "espro_sp_osasco", "espro_rj_rio_de_janeiro", "guarda_mirim", "iel", "iaq", "apae_jo_clemente", "gerar_guarapuva_ponta", "instituto_ser"

Os campos de recorrencia e de valor são interdependentes. Caso um seja preenchido o outro se torna obrigatório.

Conta bancária

Key	Type	Description
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. Consulte aqui

Opções de banco

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

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.

Para o template: O ID do modelo de carta pode ser encontrado usando essa api.

Exame

Key	Type	Description
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 completa

{
  "profile": {
    "name": "John Doe",
    "email": "[email protected]",
    "mobile": "11911111111"
  },
  "num_matricula": "4242424",
  "limit_date": "2028-01-01",
  "admission_date": "2028-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",
  "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
}

Resposta:

200 OK

"ok"

Caso a requisição seja realizada com sucesso, o header position-id, contendo o UID da position criada, será enviado na resposta.