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
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
Path Parameters
Descrição do body JSON da request
Objeto de profile
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
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
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
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
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
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
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
----KEY---- ----LABEL----
"ciee": "CIEE",
"nube": "Nube",
"senai": "Senai",
"senai_pa_barcarena": "Senai PA - Barcarena",
"senai_pe_sto_agostinho": "Senai PE - Santo Agostinho",
"senai_mt_cuiaba": "Senai MT - Cuiaba",
"senai_mt_nova_mutum": "Senai MT - Nova Mutum",
"senai_rj_rio_de_janeiro": "Senai RJ - Rio de Janeiro",
"senai_mg_mariana": "Senai MG - Mariana",
"senac": "Senac",
"mudes": "Mudes",
"coep": "COEP",
"rede_cidada": "Rede cidadã",
"espro": "Espro",
"espro_sp_av_paulista": "Espro SP - Av. Paulista",
"espro_mg_belo_horizonte": "Espro MG - Belo Horizonte",
"espro_sp_santo_amaro": "Espro SP - Santo Amaro",
"espro_sp_osasco": "Espro SP - Osasco",
"espro_rj_rio_de_janeiro": "Espro RJ - Rio de Janeiro",
"guarda_mirim": "Guarda Mirim",
"iel": "IEL - Instituto Euvaldo Lodi",
"iaq": "IAQ",
"apae_jo_clemente": "INSTITUTO JÔ CLEMENTE (APAE)",
"gerar_guarapuva_ponta": "GERAR (Guarapuava_Ponta Grossa)",
"instituto_ser": "INSTITUTO SER+",
"perfil_talentos": "INTAL (Instituto Nacional Talentos de Inclusão Profissional)",
"intal_sao_paulo": "INTAL - SÃO PAULO (BARRA FUNDA)",
"intal_guarulhos": "INTAL GUARULHOS",
"intal_sao_bernardo": "INTAL SÃO BERNARDO DO CAMPO",
"intal_santo_andre": "INTAL SANTO ANDRÉ",
"pestalozzi": "PESTALOZZI (Maceió)",
"renapsi": "RENAPSI",
"elo": "ELO",
"pastoral": "Pastoral",
"via_de_acesso": "Via de Acesso",
"geec": "Grupo Educação Etica E Cidadania",
"cieds": "CIEDS",
"metta_integradora": "Metta Integradora Empresa Escola Sociedade Simples LTDA",
"instituto_pater": "Instituto Pater",
"cia_de_estagios": "Cia de Estágios",
"abecao": "ABECAO",
"outros": "Outros",Conta bancária
banco
string(options)
Código do banco do qual a carta de abertura de conta se refere (obrigatório apenas caso usar conta bancaria.)
carta
string
UID do arquivo contendo a carta de abertura de conta
As opções de código de banco respeitam as configurações da plataforma. Essa configuração pode ser sobreposta pelas informações do payload, se e somente se no objeto “contaBancaria”, forem especificados ambos os atributos, “banco” e “carta”/”template” com valores válidos. Se for informado somente “banco”, vai respeitar as opções de banco cadastradas na empresa.
Exame
clinica*
string
UID ou código da clínica. (obrigatório apenas caso usar exame.)
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
}Exemplo de response
"ok"Atualizado
Isto foi útil?