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

Key

Type

Description

Authorization*

string

Token de acesso adquirido pela plataforma Identity (bearer)

Path Parameters

Key

Type

Description

unit*

string

UID da filial onde a posição será criada. Consulte aqui

Descrição do body JSON da request

Objeto de profile

Key

Type

Description

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

Key

Type

Description

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

role*

string

UID ou código do cargo indicado para a vaga. Consulte aqui

department*

string

UID ou código do departamento indicado para a vaga. Consulte aqui

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

Key

Type

Description

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

docs

array[string]

UIDs dos types de 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/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

Key

Type

Description

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

Key

Type

Description

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

jornada_trabalho

object

Campo para preenchimento do turno de trabalho, ex: { "entrada": "09:00", "saida": "18:00" },

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

Os campos de recorrencia e de valor são interdependentes. Caso um seja preenchido o outro se torna obrigatório.

Conta bancária

Key

Type

Description

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

template

string

UID do modelo de abertura de conta. Consulte aqui

Opções de banco - expandir

Code

Label

025

BANCO ALFA

041

BANRISUL

001

BANCO DO BRASIL

033

BANCO SANTANDER

003

BANCO DA AMAZÔNIA

070

BANCO DE BRASÍLIA

082

BANCO TOPÁZIO

069

BANCO CREFISA

085

COOP CENTRAL AILOS

077

BANCO INTER

004

BANCO DO NORDESTE

037

BANPARÁ

047

BANESE

021

BANESTES

218

BANCO BS2

237

BANCO BRADESCO

260

NUBANK

290

PAGBANK

301

BANCO BBC

265

BANCO FATOR

336

C6 BANK

318

BANCO BMG

341

BANCO ITAÚ

380

PICPAY

340

BANCO SUPERDIGITAL

389

BANCO MERCANTIL DO BRASIL

422

BANCO SAFRA

399

BANCO HSBC

611

BANCO PAULISTA

612

BANCO GUANABARA

104

CAIXA ECONÔMICA FEDERAL

121

AGIBANK

643

BANCO PINE

151

BANCO NOSSA CAIXA

413

BANCO BV

212

BANCO ORIGINAL

745

BANCO CITIBANK

746

BANCO MODAL

735

BANCO POTTENCIAL

748

BANCO SICREDI

413

BANCO BV

755

BANK OF AMERICA MERRILL LYNCH

756

SICOOB

623

BANCO PAN

637

BANCO SOFISA

738

BANCO MORADA

536

BANCO NEON

349

AL5 S.A. CREDITO

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.

Apenas uma opção deve ser escolhida: Carta ou template.

Para o template: O ID do modelo de carta pode ser encontrado usando essa api.

Para carta: Caso queira criar a posição com uma carta de abertura de conta anexada, é necessário realizar o seu upload antes.

Exame

Key

Type

Description

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",
  "jornada_trabalho": {
        "entrada": "09:00",
        "saida": "18:00"
    },
  "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

200 OK

"ok"

Caso a requisição seja realizada com sucesso, o header position-id, contendo o UID da position criada, será enviado na resposta.

AnteriorPosições PróximoList positions

Atualizado há 1 mês

Isto foi útil?

hashtagHeaders

hashtagPath Parameters

hashtagDescrição do body JSON da request

hashtagObjeto de profile

hashtagCampos obrigatórios no payload

hashtagOpções do objeto de pagamento - Obrigatório

hashtagOpções do objeto de pagamento - Opcionais

hashtagExemplo de requisição completa

hashtagExemplo de response

Headers

Path Parameters

Descrição do body JSON da request

Objeto de profile

Campos obrigatórios no payload

Opções do objeto de pagamento - Obrigatório

Opções do objeto de pagamento - Opcionais

Exemplo de requisição completa

Exemplo de response