Change status

Altera o status de uma posição.

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

Headers

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

Path Parameters

Key	Type	Description
position*	string	UID ou código da posição a ser alterada

Descrição do body JSON da request.

Parâmetros obrigatórios.

Key	Type	Description
status*	string(options)	Status no qual a posição será alterada

Opções de status.

"completed", "archived", "declined"

Parâmetros opcionais.

Key	Type	Description
unit	string	UID da filial do qual a posição pertence. Colete aqui.
decline	object	Decline é a estrutura com as informações dos motivos de declínio da posição. *Esse campo é obrigatório apenas quando o campo de status for igual a "declined".

• A posição só poderá ser arquivada, se ela já estiver completa ou declinada.

Campo decline.

Motivos (reason) de declínio para cada type.

DECLINED_BY_USER

motivos-pessoais

proposta-melhor

nao-tem-interesse

sem-retorno

outro

DECLINED_BY_HR

sem-retorno-candidato

falta-documento

escolaridade-inferior

sem-vacina-covid

outro

• Importante! Não é possível declinar posições que estão arquivadas.

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",
        }
}

Exemplo de resposta

200 OK

"ok"