Create role

Cria um cargo na empresa selecionada.

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

Headers

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

Path Parameters

Key	Type	Description
acc*	string	UID da empresa onde o cargo será criado

Descrição do body JSON da requisição

Key	Type	Description
name*	string	Nome do cargo (obrigatório)
code	string	Codigo do cargo, para integrações.
context	object	Informações específicas por país, caso queira informar escolaridade ou CBO.

Context

Key	Type	Description
brazil	object	Informações específicas para o Brasil

Brazil

Key	Type	Description
cbo	string	Número do CBO
escolaridadeMinima	string(options)	Escolaridade mínima permitida para o cargo

Opções de escolaridade mínima

"analfabeto", "5_ano_fundamental_incompleto", "5_ano_fundamental_completo", "6_9_fundamental_incompleto", "fundamental_completo", "medio_incompleto", "medio_completo", "superior_incompleto", "superior_completo", "pos_graduacao", "especializacao", "mestrado", "doutorado", "phd"

A única informação obrigatória é o nome do cargo, porém caso queira informar a escolaridade ou CBO, precisa usar o context - brazil.

Exemplo de requisição obrigatória

{
    "name": "Analista Programador Jr"
}

Exemplo de requisição completa

{
    "code":"an-prog-jr",
    "name": "Analista Programador Jr",
    "context": {
        "brazil": {
            "cbo": "789",
            "escolaridadeMinima": "superior_completo"
        }
    }
}

Exemplo de response

201 OK

{
    "code": 201,
    "messages": null,
    "result": {
        "uid": "3a46ca19-506f-4e80-a217-891d48a2a0ac"
    },
    "status": "ok"
}

O UID em "result" é o identificador do cargo, para usar em outras api's ou integrações.