Posições
Criação e listagem de posições
Posições são as vagas, convites para os candidatos iniciarem o preenchimento do "application" (formulário). 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.
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.
Create position
POST
https://api.acessorh.com.br/v1/account/:unit/json/position
Cria uma posição na filial selecionada.
Path Parameters
unit*
string
UID da filial onde a posição será criada.
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
"ok"
Descrição do body JSON da request
Chave
Tipo
Descrição
num_matricula
string
Número da matrícula
limit_date*
string, format("YYYY-mm-dd")
Data limite para o preenchimento do cadastro
admission_date
string, format("YYYY-mm-dd")
Data de admissão
cost_center
string
Centro de custo
pos_number
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
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.)
send_sms*
boolean
Indica a necessidade do envio da notificação para o candidato através de um SMS
send_email*
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
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"
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
Opções de banco
"001", "033", "041", "047", "104", "151", "237", "341", "399", "735", "745", "748", "755"
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
Exemplo de requisição
{
"num_matricula": "4242424",
"limit_date": "2018-01-01",
"admission_date": "2018-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",
"profile": {
"name": "John Doe",
"email": "[email protected]",
"mobile": "11911111111"
},
"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
}
Get position
GET
https://api.acessorh.com.br/v1/positions/:position
Exibe a posição selecionada.
Path Parameters
position*
string
UID ou código da posição desejada
Query Parameters
unit*
string
UID da filial do qual a posição pertence
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
{
"account": {
"address": null,
"address2": "",
"brand": {
"url": ""
},
"city": null,
"cnpj": null,
"district": "",
"email": null,
"id": "8eff6480-1e71-468b-ae4d-eefe3cd3e03d",
"name": "Disenchantment",
"org": "896ffd1d-a3a9-43df-a2e8-eed057fe40e6",
"phone_number": null,
"state": null,
"trading_name": null,
"zip_code": null
},
"admission_date": "2019-05-24T00:00:00Z",
"attachments": [
{
"category": "7e332162-a0e9-4aa1-bedd-dd485cc09a9e",
"file": {
"path": "organization/7c15017b-3c9f-45e9-9833-53fcc82247a8/attachments/category/7e332162-a0e9-4aa1-bedd-dd485cc09a9e/attachment/da047c0c-befc-462f-9035-09a9f7857302/68897c45-f4a1-4f80-81fa-a5ac4d37d6e7.png",
"mime": "image/png",
"size": 67329,
"name": "Captura de Tela 2022-01-12 às 12.39.17.png"
}
},
{
"category": "80405369-7beb-4f11-988f-49a9138e9e37",
"file": {
"path": "organization/7c15017b-3c9f-45e9-9833-53fcc82247a8/attachments/category/80405369-7beb-4f11-988f-49a9138e9e37/attachment/c478d866-4627-4b52-8d15-acd388da2a72/c861b4f4-b853-424e-8403-3d991f326914.png",
"mime": "image/png",
"size": 67329,
"name": "Captura de Tela 2022-01-12 às 12.39.17.png"
}
}
],
"benefits": null,
"cost_center": null,
"data_admissao": "0001-01-01T00:00:00Z",
"department": {
"account": "2d9174c4-06b7-4956-a5dc-8824d8a2f49e",
"code": "",
"id": "4da70bb2-803c-4de5-81b7-c96423fb9127",
"name": "TI",
"safedoc": ""
},
"exame": {
"clinica": null,
"comprovante": {
"filename": null,
"id": null,
"mimetype": null,
"path": null
},
"data": null,
"hora": null,
"nome": null,
"observacoes": null
},
"dates": {
"limit_date": "2019-05-30T00:00:00Z",
"admission_date": "2019-05-24T00:00:00Z"
},
"id": "6f2c7be8-66a0-42c7-bb74-654236b8c3db",
"jornada": "",
"num_matricula": null,
"pagamento": {
"agente_integrador": null,
"data_inicio": null,
"data_termino": null,
"deficiencia": false,
"recorrencia": "mensalista",
"valor": 3500,
"vinculo": "clt"
},
"persons": [{
"personId": "50251e56-86fe-4311-a1f2-fc0a96d37772",
"personType": "candidate",
"personData": {
"nome": "John Doe",
"nomeSocial": null,
"sexo": "masculino",
"dataNascimento": "1987-07-09",
"etnia": "parda",
"estadoCivil": "casado",
"uniaoEstavel": null,
"celular": null,
"nacionalidade": null,
"tipoNacionalidade": "brasileiro",
"incapaz": null,
"nomeMae": "Melania Mickle",
"nomePai": null,
"aposentado": false,
"dataAposentadoria": null,
"numeroBeneficio": null,
"paisNascimento": null,
"paisOrigem": null,
"dataNaturalizacao": null,
"foto": {
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/person/brazil/f1849d41-baf8-48fd-85e5-1718099c6d47.png",
"mime": "image/png",
"size": 56060,
"name": "foto-perfil.png"
},
"order": 0,
"type": "selfie",
"view": null
}
},
"personCode": 200,
"candidate": {
"dependente": true,
"primeiroEmprego": null,
"filhosBrasileiros": false
},
"dependent": null,
"spouse": null,
"responsible": null,
"documents": [{
"id": "dd07f9c4-c76e-4024-a3f4-506692cb349d",
"type": "6d58e6f3-5501-40b3-b1fb-3e6949d19960",
"slug": "cpf",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "CPF"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:07:53.717Z",
"data": {
"numero": "47779132951",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/6d58e6f3-5501-40b3-b1fb-3e6949d19960/362f2583-a537-4a99-9329-7b56ffb77bfa.jpg",
"mime": "image/jpeg",
"size": 298601,
"name": "cpf.jpg"
},
"order": 0,
"type": "frente",
"view": null
}]
}
},
{
"id": "19aa1b91-08a3-467f-83c5-03a19a657116",
"type": "32e00f6d-e847-4ac8-be6e-13b8c36b7a27",
"slug": "sus",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "Cartão Nacional de Saúde"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:11:02.959Z",
"data": {
"numero": "934823995090006",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/32e00f6d-e847-4ac8-be6e-13b8c36b7a27/5850f673-4c1b-4421-9c1d-5ffb0b440954.jpg",
"mime": "image/jpeg",
"size": 2115913,
"name": "sus-verso.jpg"
},
"order": 1,
"type": "verso",
"view": null
},
{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/32e00f6d-e847-4ac8-be6e-13b8c36b7a27/eeeb2211-4aa5-40d5-ba6b-09d5d758b79a.jpg",
"mime": "image/jpeg",
"size": 26228,
"name": "sus-frente.jpg"
},
"order": 0,
"type": "frente",
"view": null
}
]
}
}
]
},
{
"personId": "bb9bf92d-0a80-4fb2-84e9-c3ed0e8b0c01",
"personType": "spouse",
"personData": {
"nome": "Lisbeth Madewell",
"nomeSocial": null,
"sexo": "feminino",
"dataNascimento": "1990-08-09",
"etnia": null,
"estadoCivil": null,
"uniaoEstavel": null,
"celular": null,
"nacionalidade": null,
"tipoNacionalidade": "brasileiro",
"incapaz": false,
"nomeMae": "Maria Madewell",
"nomePai": null,
"aposentado": null,
"dataAposentadoria": null,
"numeroBeneficio": null,
"paisNascimento": null,
"paisOrigem": "",
"dataNaturalizacao": null,
"foto": null
},
"personCode": 200,
"candidate": null,
"dependent": null,
"spouse": {
"relacionamento": "casado",
"dependente": true,
"dataCasamento": "2013-05-23"
},
"responsible": null,
"documents": [{
"id": "834ab6af-9c14-456a-8cde-1b2dfe21d681",
"type": "6d58e6f3-5501-40b3-b1fb-3e6949d19960",
"slug": "cpf",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "CPF"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:53.927Z",
"data": {
"numero": "57435244082",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/6d58e6f3-5501-40b3-b1fb-3e6949d19960/a2c7b76a-b9fd-4992-ae32-157b7bb2c97f.jpg",
"mime": "image/jpeg",
"size": 298601,
"name": "cpf.jpg"
},
"order": 0,
"type": "frente",
"view": null
}]
}
},
{
"id": "d77497ca-1a9e-49ef-944e-532b5ae6fd60",
"type": "c2069ecf-ea5d-4029-9960-6f802392c6d7",
"slug": "rg",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "RG"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:54.124Z",
"data": {
"numero": "438902853",
"orgaoEmissor": null,
"uf": null,
"dataExpedicao": null,
"naturalidadeEstado": null,
"naturalidadeCidade": null,
"filiacao1": "Maria Madewell",
"filiacao2": "",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/c2069ecf-ea5d-4029-9960-6f802392c6d7/9b9b820f-8cfc-48bc-b51e-5930d44578fc.jpg",
"mime": "image/jpeg",
"size": 1940441,
"name": "rg-verso.jpg"
},
"order": 1,
"type": "verso",
"view": null
},
{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/c2069ecf-ea5d-4029-9960-6f802392c6d7/7c31f607-0477-4318-aacf-be7627695061.jpg",
"mime": "image/jpeg",
"size": 1960026,
"name": "rg-frente.jpg"
},
"order": 0,
"type": "frente",
"view": null
}
]
}
},
{
"id": "d6fdd271-866f-4b4c-a233-30c392bf8828",
"type": "32e00f6d-e847-4ac8-be6e-13b8c36b7a27",
"slug": "sus",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "Cartão Nacional de Saúde"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:54.031Z",
"data": {
"numero": "256902775310001",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/32e00f6d-e847-4ac8-be6e-13b8c36b7a27/1ab7a5cb-d4c0-4a68-bd2d-c636cdb81fb1.jpg",
"mime": "image/jpeg",
"size": 2115913,
"name": "sus-verso.jpg"
},
"order": 1,
"type": "verso",
"view": null
},
{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/32e00f6d-e847-4ac8-be6e-13b8c36b7a27/dd9fbe09-3f23-41c9-b500-aa9c7a08c2e6.jpg",
"mime": "image/jpeg",
"size": 26228,
"name": "sus-frente.jpg"
},
"order": 0,
"type": "frente",
"view": null
}
]
}
},
{
"id": "712d1eba-9407-43cd-8127-2786aa3d07ef",
"type": "7dff436c-d450-4a75-8af5-7934ab1bb71c",
"slug": "certidao-casamento",
"exist": true,
"additional": false,
"validations": null,
"title": {},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:53.191Z",
"data": {
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/7dff436c-d450-4a75-8af5-7934ab1bb71c/ba97e8c6-2b2c-42e0-b790-a82f4e71694c.jpg",
"mime": "image/jpeg",
"size": 2277398,
"name": "nascimento.jpg"
},
"order": 0,
"type": "frente",
"view": null
}]
}
}
]
},
{
"personId": "bb9bf92d-0a80-4fb2-84e9-c3ed0e8b0c01",
"personType": "dependent",
"personData": {
"nome": "Lisbeth Madewell",
"nomeSocial": null,
"sexo": "feminino",
"dataNascimento": "1990-08-09",
"etnia": null,
"estadoCivil": null,
"uniaoEstavel": null,
"celular": null,
"nacionalidade": null,
"tipoNacionalidade": "brasileiro",
"incapaz": false,
"nomeMae": "Maria Madewell",
"nomePai": null,
"aposentado": null,
"dataAposentadoria": null,
"numeroBeneficio": null,
"paisNascimento": null,
"paisOrigem": "",
"dataNaturalizacao": null,
"foto": null
},
"personCode": 200,
"candidate": null,
"dependent": {
"parentesco": "conjuge",
"naoPossuiRg": null,
"ensinoSuperior": null,
"impostoRenda": true,
"salarioFamilia": false
},
"spouse": null,
"responsible": null,
"documents": [{
"id": "834ab6af-9c14-456a-8cde-1b2dfe21d681",
"type": "6d58e6f3-5501-40b3-b1fb-3e6949d19960",
"slug": "cpf",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "CPF"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:53.927Z",
"data": {
"numero": "57435244082",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/6d58e6f3-5501-40b3-b1fb-3e6949d19960/a2c7b76a-b9fd-4992-ae32-157b7bb2c97f.jpg",
"mime": "image/jpeg",
"size": 298601,
"name": "cpf.jpg"
},
"order": 0,
"type": "frente",
"view": null
}]
}
},
{
"id": "d77497ca-1a9e-49ef-944e-532b5ae6fd60",
"type": "c2069ecf-ea5d-4029-9960-6f802392c6d7",
"slug": "rg",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "RG"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:54.124Z",
"data": {
"numero": "438902853",
"orgaoEmissor": null,
"uf": null,
"dataExpedicao": null,
"naturalidadeEstado": null,
"naturalidadeCidade": null,
"filiacao1": "Maria Madewell",
"filiacao2": "",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/c2069ecf-ea5d-4029-9960-6f802392c6d7/9b9b820f-8cfc-48bc-b51e-5930d44578fc.jpg",
"mime": "image/jpeg",
"size": 1940441,
"name": "rg-verso.jpg"
},
"order": 1,
"type": "verso",
"view": null
},
{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/c2069ecf-ea5d-4029-9960-6f802392c6d7/7c31f607-0477-4318-aacf-be7627695061.jpg",
"mime": "image/jpeg",
"size": 1960026,
"name": "rg-frente.jpg"
},
"order": 0,
"type": "frente",
"view": null
}
]
}
},
{
"id": "d6fdd271-866f-4b4c-a233-30c392bf8828",
"type": "32e00f6d-e847-4ac8-be6e-13b8c36b7a27",
"slug": "sus",
"exist": true,
"additional": false,
"validations": null,
"title": {
"pt_BR": "Cartão Nacional de Saúde"
},
"code": 200,
"options": [],
"timestamp": "2019-05-23T19:13:54.031Z",
"data": {
"numero": "256902775310001",
"comprovantes": [{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/32e00f6d-e847-4ac8-be6e-13b8c36b7a27/1ab7a5cb-d4c0-4a68-bd2d-c636cdb81fb1.jpg",
"mime": "image/jpeg",
"size": 2115913,
"name": "sus-verso.jpg"
},
"order": 1,
"type": "verso",
"view": null
},
{
"file": {
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/document/32e00f6d-e847-4ac8-be6e-13b8c36b7a27/dd9fbe09-3f23-41c9-b500-aa9c7a08c2e6.jpg",
"mime": "image/jpeg",
"size": 26228,
"name": "sus-frente.jpg"
},
"order": 0,
"type": "frente",
"view": null
}
]
}
}
]
}
],
"position_number": "1234890",
"profile": {
"email": "[email protected]",
"id": "50251e56-86fe-4311-a1f2-fc0a96d37772",
"mobile": "11911111111",
"name": "John Doe",
"photo": {
"filename": "foto-perfil.png",
"id": "f1849d41-baf8-48fd-85e5-1718099c6d47",
"mimetype": "image/png",
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/person/brazil/f1849d41-baf8-48fd-85e5-1718099c6d47.png"
}
},
"role": {
"account": "2d9174c4-06b7-4956-a5dc-8824d8a2f49e",
"cbo": "",
"code": "",
"escolaridade_min": "",
"id": "1f67b9f3-314f-45a5-b098-7ec236c6c963",
"index": null,
"name": "Analista Programador",
"safedoc": ""
},
"decline": {
"type": "DECLINED_BY_USER",
"reason": "motivos-pessoais",
"description": "descricao",
"message": "candidato declinou da posicao",
"creationDate": "31/03/2023 16:43:40"
},
"status": {
"code": 240,
"name": "completed"
},
"track_status": [{
"Code": 220,
"Ts": "2019-05-23T19:04:03.68Z"
},
{
"Code": 240,
"Ts": "2019-05-23T19:18:00.07Z"
}
],
"updated": "2019-05-23T19:18:00.07Z",
"validation": {
"esocial": {
"approved": false
}
}
}
Campos opcionais | includes
"role","benefits","department","persons","unit","attachments","decline"
List positions
GET
https://api.acessorh.com.br/v1/positions
Lista posições na empresa ou filial selecionada.
Query Parameters
admission_date
string
Data de admissão início e fim Formato: AAAA-MM-DD,AAAA-MM-DD
acc
string
UID da empresa ou da filial que será filtrada
status
string
Filtro de status das posições
position_number
string
Código da posição desejada
limit
string
Limite de posições que serão listadas (paginação)
skip
string
Indica a quantidade de posições que serão puladas (paginação)
sort
string
Configura um parâmetro de ordenação do resultado da listagem de posições com base nas opções.
order
string
Ordena o resultado de forma crescente e decrescente ("asc" e "desc").
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
{
"offset": 0,
"limit": 100,
"count": 1,
"positions": [
{
"admission_date": "2019-05-17T00:00:00Z", //deprecated
"cost_center": "anywhere",
"exame": {
"clinica": "bcaaf3a8-b682-4809-83a7-83a73e867cb6",
"comprovante": {
"filename": "exame.jpg",
"id": "5f0676ab-648a-4c3f-92c7-eedd1802d719",
"mimetype": "image/jpeg",
"path": "organization/896ffd1d-a3a9-43df-a2e8-eed057fe40e6/position/9e70b644-fce0-442a-af8a-40b00cbbb437/context/brazil/exame/5f0676ab-648a-4c3f-92c7-eedd1802d719.jpg"
},
"data": "2019-05-11T00:00:00Z",
"hora": "2006-01-02T13:04:00Z",
"nome": "Clinica Saude",
"observacoes": "chegar cedo"
},
"id": "e8efddec-4a9e-4153-9e61-ce0056edf542",
"jornada": "De segunda a sexta das 15 as 19",
"num_matricula": "4242424",
"pagamento": {
"agente_integrador": null,
"data_inicio": null,
"data_termino": null,
"deficiencia": false,
"recorrencia": "mensalista",
"valor": 4200,
"vinculo": "clt"
},
"position_number": "pos-test",
"profile": {
"email": "[email protected]",
"id": "72421b50-c882-4684-8e10-c5a0522978e1",
"mobile": "11991111111",
"name": "John Doe",
"photo": {
"filename": "foto-perfil.png",
"id": "c8d1c2a7-75d2-4615-a9e1-d93bd09570b6",
"mimetype": "image/png",
"path": "individual/23beac75-4722-4e14-96a4-72f69322471e/person/brazil/c8d1c2a7-75d2-4615-a9e1-d93bd09570b6.png"
}
},
"decline": {
"type": "DECLINED_BY_HR",
"reason": "sem-retorno-candidato",
"description": "descricao",
"message": "declinado pela empresa",
"creationDate": "31/03/2023 16:42:44"
},
"dates": {
"limit_date": "2019-05-30T00:00:00Z",
"admission_date": "2019-05-17T00:00:00Z"
},
"status": {
"code": 501,
"name": "decline"
},
"updated": "2019-04-23T18:10:16.892Z"
}
]
}
Parâmetros para ordenação das posições
limit_date
string
Data limite para o preenchimento do cadastro.
admission_date
string
Data de admissão preenchida no cadastro da vaga.
created_date
string
Data em que o cadastro foi criado.
updated_date
string
Ultima data de atualização do cadastro.
completed_date
string
Data de finalização do cadastro.
Opções de ordenação
asc
string
Ordena de forma crescente.
desc
string
Ordena de forma decrescente.
Lista de status
210 - "invited" (posição criada e convite enviado para o candidato)
220 - "pending" (candidato iniciou o processo de admissão, mas ainda não finalizou a entrega dos documentos)
230 - "review" (posição já analisada pela mesa, mas pendente de correção pelo candidato)
240 - "completed" (todos os documentos entregues, aguardando análise da mesa)
400 - "active" (documentos entregues e validados ou posição completada manualmente pelo RH)
500 - "dismissal/archived" (posição arquivada pelo RH)
501 - "declined" (posições declinadas pelo RH)
Change status
PUT
https://api.acessorh.com.br/v1/positions/status/:position
Altera o status de uma posição.
Path Parameters
position*
string
UID ou código da posição a ser alterada
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
"ok"
Descrição do body JSON da request
Chave
Tipo
Descrição
unit*
string
UID da filial do qual a posição pertence
status*
string(options)
Status no qual a posição será alterada
decline
object
Decline é a estrutura com as informações dos motivos de declínio da posição. *Esse campo é required apenas quando o campo de status for igual a "declined".
Opções de status
"completed", "archived", "declined"
A posição só poderá ser arquivada, se ela já estiver completa ou declinada.
Não é possível declinar posições que estão arquivadas.
Campo decline
type*
string
Indica qual foi o lado responsável por decidir declinar do processo de admissão: Candidato (DECLINED_BY_USER) Empresa (DECLINED_BY_HR)
reason*
string(options)
Motivo que levou essa posição a ser declinada. Os motivos devem está de acordo com o type indicado.
description
string
Detalhes do motivo que levou essa posição ser declinada.
message
string
Mensagem customizada que fará parte do e-mail que será enviada para o candidato que teve sua posição declinada.
Tipos de declínio com seus respectivos motivos
sem-retorno-candidato
falta-documento
escolaridade-inferior
sem-vacina-covid
outro
Exemplo de requisição
{
"unit": "84ef8cd7-76ee-4b10-a77b-e0201cdcd117",
"status": "declined",
"decline":{
"type": "DECLINED_BY_HR",
"reason": "falta-documento",
"description": "descrição",
"message":"messagem de declino para o candidato",
}
}
Delete position
DELETE
https://api.acessorh.com.br/v1/positions
Deleta uma posição.
Query Parameters
uid*
string
UID da posição a ser deletada.
unit*
string
UID da filial de onde a posição será deletada.
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer).
Set benefits in a position
PATCH
https://api.acessorh.com.br/v1/positions/:position/benefits
Adiciona e/ou remove benefícios de uma posição
Path Parameters
position*
string
UID ou número da posição a ser alterada
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
"ok"
Descrição do body JSON da request
Chave
Tipo
Descrição
unit*
string
UID da filial onde a posição se encontra
add
array[string]
UIDs dos grupos de benefícios a serem adicionadas na posição
remove
array[string]
UIDs dos grupos de benefícios a serem
removidos da posição
Um dos campos
add
ouremove
deverão ser preenchidos.Não é possível adicionar ou remover benefícios para posições declinadas
Exemplo de requisição
{
"unit": "4bdaa0d3-f3e4-4520-b64e-6a22508bebc9",
"add": ["c4c17fd1-9c93-4dbf-bca8-bded7fd97287"],
"remove": ["87a6e88f-c318-416b-830e-8cf446f535fe"]
}
Creates document to send the admission kit
POST
https://api.acessorh.com.br/v1/positions/:position_id/signature-envelopes
Realiza o envio do kit admissional para candidatos concluídos.
Path Parameters
position_id*
string
UID da posição que deve receber o kit de documentos para assinatura.
{
"code": 200,
"messages": null,
"result": {
"uid": "6416fc22-4953-43d0-8db6-c96a908cf574"
},
"status": "ok"
}
Descrição do body JSON da request
Chave
Tipo
Descrição
account*
string
UID da empresa.
unit*
string
UID da filial onde a posição se encontra.
models*
array[string]
Lista com os UID dos
modelos de documentos
que devem ser enviados
para assinatura.
Não é possível enviar o kit admissional para posições:
Em andamento
Arquivadas
Declinadas
Exemplo de requisição
{
"account": "4aca3203-e791-41e1-b5d7-6ef02d152787",
"unit": "8eff6480-1e71-468b-ae4d-eefe3cd3e03d",
"models": [
"8946efe8-e100-4497-907e-3803bb048b47",
"62766bb0-b5ac-4462-8478-062950577067"
]
}
Get Position Invite
GET
https://api.acessorh.com.br/v1/admissions/invite/:pos
Exibe os link's do convite enviado para a posição iniciar o processo de cadastro dos documentos.
Path Parameters
pos*
string
UID da posição desejada
Headers
Authorization*
string
Token de acesso adquirido pela plataforma Identity (bearer)
{
"data": {
"expiresAt": "2022-02-06 17:17:55",
"longURL": "hhttps://form.rh.qa2.acesso.dev/profile/intro/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJraW5kIjoiYWRtaXNzaW9uIiwib3JnIjoiN2MxNTAxN2ItM2M5Zi00NWU5LTk4MzMtNTNmY2M4MjI0N2E4IiwicG9zIjoiMGJhMDJkMjItMzZiNy00YmQ0LWJkZjctZTVmMGUxZTk1ZDJmIn0.Hm9VSbWQjWRGER_jE2UWAhtpk5_-XpniEnPRJzdxNbO",
"shortURL": "https://aces.so/U3u6Jve"
},
"error": null,
"status": 200
}
Atualizado
Isto foi útil?