List positions

Lista posições na empresa ou filial selecionada.

GET Url Produção: https://api.acessorh.com.br Url Homologação: https://api.rh.homolog.acesso.io Endpoint:/v1/positions

Headers

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

Parâmetros de busca obrigatórios

Key	Type	Description
acc*	string	UID da empresa ou da filial que será filtrada. Consulte aqui.

Parâmetros de busca opcionais

Key	Type	Description
admission_date	string	Data de admissão início e fim Formato: AAAA-MM-DD,AAAA-MM-DD
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. O valor máximo é 100 por pagina. (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").

Lista de status

Key	Type	Description
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	Analisys	Todos os documentos entregues, aguardando análise da mesa.
400	Completed	Documentos entregues e validados ou posição completada manualmente pelo RH.
500	Archived	Posição arquivada.
501	Declined	Posição declinada.

Parâmetros de ordenação (sort)

Chave	Tipo	Descrição
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.

Caso não seja inserido os parâmetros limit e skip , os valores padrões serão, respectivamente, 100 e 0.

Exemplo de requisição

curl --location 'https://api.acessorh.com.br/v1/positions?acc=UID%20da%20empresa&admission_date=2024-08-17%2C2024-09-16&limit=100&skip=0&status=500&order=asc&sort=admission_date' \
--header 'Authorization: Bearer Token de autorização' \
--data ''

Exemplo de response

200 OK 

{
    "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"
        }
    ]
}

31KB

JSON - Especificações.xlsx

---