Note: This page was translated using automation resources with the purpose of providing content in your language more quickly. Consequently, it may have grammatical errors and similar situations. If the content is not useful in this state, in the page footer you can access the original material in Brazilian Portuguese and also give us opinions on this translation.

An error occurred with sending a pre-hire invitation on the Colabbe system.

Envia um convite para iniciar o processo de pré-admissão de um novo colaborador. Durante o processo de envio, a API valida as informações da requisição e retorna se o convite foi enviado com sucesso ou não.

Definições da API:


URL

POST <url_plataforma>/t/senior.com.br/bridge/1.0/rest/hcm/onboardingintegration/actions/preAdmissionSend

Substitua <url_plataforma> pela URL correspondente ao seu ambiente. Se for o ambiente de produção, substitua por: https://platform.senior.com.br

Cabeçalho (Header)

Authorization Bearer​ <access_token>
Content-Type application/json

Substitua <access_token> pela chave de acesso obtida a partir da API de autenticação na plataforma.

Parâmetros

* Obrigatórios

Parâmetro Tipo Descrição
employeeName * String Nome completo do novo colaborador.
employeeEmail String E-mail do novo colaborador.
employeeMobilePhone String Número de telefone celular do novo colaborador.
key String

Chave da pré-admissão. Para convites brasileiros, a chave de identificação é o CPF do novo colaborador.

Este parâmetro é obrigatório somente se a empresa o definiu como obrigatório no envio do modelo de convite. Caso contrário, permanece opcional.

admissionDate * Date Data de admissão do novo colaborador.
modelId * String Identificador único do modelo de convite associado a pré-admissão.
additionalInfo String Informação adicional que pode ser enviada no modelo de convite.
vacancyCode Long

Número da vaga gerada pelo módulo Gestão de Recrutamento e Seleção (GRS) do HCM senior X. Este parâmetro é usado pelo GRS para enviar as informações da vaga e do candidato para as pré-admissões no sistema da Colabbe.

O parâmetro vacancyCode é opcional e é usado exclusivamente pelo GRS. Caso não tenha a integração da Colabbe com este sistema, este parâmetro não deve ser usado.

Quando este código existir, você pode obtê-lo fazendo uma requisição para o endpoint preAdmissionQuery.

jobPosition String

Identificador único do cargo.

Este parâmetro é obrigatório somente se a empresa o definiu como obrigatório no envio do modelo de convite. Caso contrário, permanece opcional.

branchOffice String

Identificador único da filial.

Este parâmetro é obrigatório somente se a empresa o definiu como obrigatório no envio do modelo de convite. Caso contrário, permanece opcional.

company String Identificador único da empresa.
employeeMobilePhoneOption String

Forma de recebimento de convite pelo novo colaborador.

personalData { } - Dados pessoais da pré-admissão. Estes dados podem ser enviados para a API diretamente a partir do processo de recrutamento do novo colaborador.
companyName String Nome da empresa.
branchOfficeName String Nome da filial.
tradingName String Nome fantasia da filial.
jobPositionName String Nome do cargo.
customFieldsContract { } - Campos customizados do contrato.

personalData:

Parâmetro Tipo Descrição
personalData { } - Dados de informações pessoais.
documentData { } - Dados de documentos.
hasDependent Boolean Identifica se o novo colaborador tem dependentes.
saveAsDraft Boolean Identifica se a pré-admissão será salva como rascunho.
hasDisability Boolean Identifica se o novo colaborador é uma pessoa com deficiência.

preAdmissionPersonalBRADataComplete:

Parâmetro Descrição
basic { } Informações pessoais básicas.
complementary { } Informações complementares.
birthPlace { } Informações do local de nascimento.
address { } Informações de endereço.
email { } Informações de e-mail.
telephone { } Informações de telefone de contato.

documentData:

Parâmetro Descrição
cpf { } Dados do Cadastro de Pessoa Física (CPF).
pis { } Dados do Programa de Integração Social (PIS).
ctps { } Dados da Carteira de Trabalho e Previdência Social (CTPS).
rg { } Dados do Registro Geral (RG).
passport { } Dados do Passaporte.
ric { } Dados do Registro de Identidade Civil (RIC).
voter { } Dados do Título de Eleitor.
cnh { } Dados da Carteira Nacional de Habilitação (CNH).
reservist { } Dados do Certificado de Reservista.
civilCertificate { } Dados da Certidão Civil.
cns { } Dados do Cartão Nacional de Saúde (CNS).
dnv { } Dados da Declaração de Nascido Vivo (DNV).
bankAccount { } Dados bancários.
receiveSalaryAdvance { } (ver enumInformationItemData) Identifica se o novo colaborador gostaria de receber adiantamento salarial.

basic:

Parâmetro Tipo Descrição
employeeFullName String Nome completo do novo colaborador.
preferredName String Nome pelo qual o novo colaborador prefere ser chamado.
badgeFileId String Endereço onde a imagem do crachá está salva.
badgeFileVersion String Versão para realizar o commit do arquivo.
badgeFileIdPermanentUrl String Caminho permanente (URL) do local onde está o arquivo de imagem do crachá.
gender { } (ver enumInformationItemData) - Gênero do novo colaborador.
birthDate Date Data de nascimento do novo colaborador.
mothersName String Nome da mãe do novo colaborador.
fathersName String Nome do pai do novo colaborador.
customFields { } - Campos customizados criados no modelo de convite de pré-admissão.

complementary:

Parâmetro Tipo Descrição
maritalStatus { } (ver enumInformationItemData) - Informações sobre o estado civil.
degreeOfEducation { } - Informações sobre o grau de instrução.
degreeOfEducationFileId String Comprovante do grau de instrução.
degreeOfEducationFileVersion String Versão para realizar o commit do anexo de grau de instrução.
degreeOfEducationFileIdPermanentUrl String Caminho permanente (URL) do local onde está o arquivo que comprova o grau de instrução.
nationality { } - Informações sobre a nacionalidade.
religion { } - Informações sobre a religião.
race { } (ver enumInformationItemData) - Informações sobre a raça/cor.
socialName String Nome social do novo colaborador, se houver.
customFields { } - Campos customizados criados no modelo de convite de pré-admissão.

birthPlace:

Parâmetro Tipo Descrição
country { } - Dados do país de nascimento.
state { } - Dados do estado de nascimento.
city { } - Dados da cidade de nascimento.

address:

Parâmetro Tipo Descrição
country { } - Dados do país do endereço.
state { } - Dados do estado do endereço.
city { } - Dados da cidade do endereço.
cep String CEP do endereço.
neighborhood String Bairro do endereço.
addressType { } (ver enumInformationItemData) - Dados do logradouro do endereço.
address String Endereço.
number String Número do endereço.
firstFileId String Primeira imagem.
firstFileVersion String Versão para realizar o commit do primeiro arquivo.
firstFilePermanentUrl String URL de acesso a primeira imagem.
additional String Informações adicionais referente ao endereço.

email:

Parâmetro Tipo Descrição
firstEmail String E-mail principal do novo colaborador.
firstType { } (ver enumInformationItemData) - Tipo do e-mail principal.
secondEmail String E-mail secundário do novo colaborador.
secondType { } (ver enumInformationItemData) - Tipo do e-mail secundário.

telephone:

Parâmetro Tipo Descrição
firstPhone String Telefone de contato principal do novo colaborador.
firstType { } (ver enumInformationItemData) - Tipo do telefone de contato principal.
secondPhone String Telefone de contato secundário do novo colaborador.
secondType { } (ver enumInformationItemData) - Tipo do telefone de contato secundário.

cpf:

Parâmetro Tipo Descrição
number String Número do documento (CPF).

pis:

Parâmetro Tipo Descrição
number String Número do documento (PIS).
issueDate Date Data da emissão do documento.

ctps:

Parâmetro Tipo Descrição
number String Número do documento (CTPS).
issueDate Date Data da emissão do documento.
issuerState { } - Estado de emissão do documento.
serie String Série do documento.
digit String Dígito do documento.

rg:

Parâmetro Tipo Descrição
number String Número do documento (RG).
issueDate Date Data da emissão do documento.
issuerState { } - Estado de emissão do documento.
issuer String Orgão emissor do documento.

passport

Parâmetro Tipo Descrição
number String Número do documento (Passaporte).
issueDate Date Data da emissão do documento.
issuerState { } - Estado de emissão do documento.
issuer String Órgão emissor do documento.
issuerCountry { } - País de emissão do documento.
expiryDate Date Data de expiração do documento.

ric:

Parâmetro Tipo Descrição
number String Número do documento (RIC).
issueDate Date Data da emissão do documento.
issuerState { } - Estado de emissão do documento.
issuer String Órgão emissor do documento.
issuerCity { } - Cidade de emissão do documento.
expiryDate Date Data de expiração do documento.

voter:

Parâmetro Tipo Descrição
number String Número do documento (Título de Eleitor).
issueDate Date Data da emissão do documento.
issuerState { } - Estado de emissão do documento.
issuerCity { } - Cidade de emissão do documento.
votingDistrict String Zona de votação.
votingSection String Sessão de votação.

cnh:

Parâmetro Tipo Descrição
number String Número do documento (CNH).
category { } (ver enumInformationItemData) - Categoria do documento.
issuer String Órgão emissor do documento.
issuerState { } - Estado de emissão do documento.
issueDate Date Data da emissão do documento.
expiryDate Date Data de expiração do documento.
firstDriveLicenceDate Date Data da primeira CNH.

reservist:

Parâmetro Tipo Descrição
number String Número do documento (Certificado de Reservista).
serie String Série do documento.
ra String Número do Registro de Alistamento (RA).
exemptionDate Date Data de dispensa.
doesntHave Boolean Identifica se a pessoa possui o Certificado de Reservista.

civilCertificate:

Parâmetro Tipo Descrição
type { } (ver enumInformationItemData) - Tipo do documento (Certidão Civil).
issueDate Date Data da emissão do documento.
registry Date Matrícula do documento.
term String Termo do documento.
book String Livro do documento.
sheet String Folha do documento.
notaryOffice String Cartório do documento.
issuerState { } - Estado de emissão do documento.
issuerCity { } - Cidade de emissão do documento.

cns:

Parâmetro Tipo Descrição
number String Número do documento (Cartão Nacional de Saúde).

dnv:

Parâmetro Tipo Descrição
number String Número do documento (Declaração de Nascido Vivo).

bankAccount:

Parâmetro Tipo Descrição
bank { } - Banco.
branch Integer Número da agência bancária.
accountType { } (ver enumInformationItemData) - Tipo da conta.
bankAccount String Número da conta bancária.
digit String Digito da conta bancária.

degreeOfEducation:

Parâmetro Tipo Descrição
code Integer Código do grau de instrução.
name String Nome do grau de instrução.
type String

Tipo do grau de instrução.

nationality:

Parâmetro Tipo Descrição
code Integer Código da nacionalidade.
name String Nome da nacionalidade.
type String

Tipo da nacionalidade.

religion:

Parâmetro Tipo Descrição
code Integer Código da religião.
name String Nome da religião.

country e issuerCountry:

Parâmetro Tipo Descrição
name String Nome do país.
abbreviation String Abreviação do nome do país.

state e issuerState:

Parâmetro Tipo Descrição
name String Nome do estado.
abbreviation String Abreviação do nome do estado.
country String País onde o estado está localizado.

city e issuerCity:

Parâmetro Tipo Descrição
name String Nome da cidade.
state String Estado onde a cidade está localizada.

bank:

Parâmetro Tipo Descrição
name String Nome do banco.
code Integer Código do banco.

customFields:

Parâmetro Tipo Descrição
field String Identificador do campo customizado criado na senior X Platform.
value - Recebe o valor preenchido no campo. O tipo do campo value será o mesmo tipo que foi definido durante a criação do campo customizado na senior X Platform.

enumInformationItemData:

Parâmetro Tipo Descrição
key String Chave do item da enumeração.
value String

Valor do item da enumeração.

Estes são os valores permitidos para cada campo que utiliza a enumeração:

customFieldsContract:

Parâmetro Tipo Descrição
field String Identificador do campo customizado criado na senior X Platform.
value - Recebe o valor preenchido no campo. O tipo do campo value será o mesmo tipo que foi definido durante a criação do campo customizado na senior X Platform.

Exemplo

 { "employeeName": "string", "employeeEmail": "string", "employeeMobilePhone": "string", "key": "string", "admissionDate": "2022-01-28", "modelId": "string", "additionalInfo": "string", "jobPosition": "string", "branchOffice": "string", "company": "string", "employeeMobilePhoneOption": "SMS", "personalData": { "personalData": { "basic": { "id": "string", "employeeFullName": "string", "preferredName": "string", "badgeFileId": "string", "badgeFileVersion": "string", "badgeFileIdPermanentUrl": "string", "gender": { "key": "string", "value": "string" }, "birthDate": "2022-01-28", "mothersName": "string", "fathersName": "string", "customFields": [ { "field": "campo customizado 1", "value": "valor preenchido no campo" } ] }, "complementary": { "id": "string", "maritalStatus": { "key": "string", "value": "string" }, "degreeOfEducation": { "id": "string", "code": 0, "name": "string", "type": "ILLITERATE" }, "degreeOfEducationFileId": "string", "degreeOfEducationFileVersion": "string", "degreeOfEducationFileIdPermanentUrl": "string", "nationality": { "id": "string", "code": 0, "name": "string", "type": "BRAZILIAN" }, "religion": { "id": "string", "code": 0, "name": "string" }, "race": { "key": "string", "value": "string" }, "socialName": "string", "customFields": [ { "field": "campo customizado 2", "value": "valor preenchido no campo" } ] }, "birthPlace": { "id": "string", "country": { "id": "string", "name": "string", "abbreviation": "string" }, "state": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "city": { "id": "string", "name": "string", "state": "string" } }, "address": { "id": "string", "country": { "id": "string", "name": "string", "abbreviation": "string" }, "state": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "city": { "id": "string", "name": "string", "state": "string" }, "cep": "string", "neighborhood": "string", "addressType": { "key": "string", "value": "string" }, "address": "string", "number": "string", "firstFileId": "string", "firstFileVersion": "string", "firstFilePermanentUrl": "string", "additional": "string" }, "email": { "id": "string", "firstEmail": "string", "firstType": { "key": "string", "value": "string" }, "secondEmail": "string", "secondType": { "key": "string", "value": "string" } }, "telephone": { "id": "string", "firstPhone": "string", "firstType": { "key": "string", "value": "string" }, "secondPhone": "string", "secondType": { "key": "string", "value": "string" } } }, "documentData": { "cpf": { "id": "string", "number": "string" }, "pis": { "id": "string", "number": "string", "issueDate": "2022-01-28" }, "ctps": { "id": "string", "number": "string", "serie": "string", "digit": "string", "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "issueDate": "2022-01-28" }, "rg": { "id": "string", "number": "string", "issuer": "string", "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "issueDate": "2022-01-28" }, "passport": { "id": "string", "number": "string", "issuer": "string", "issueDate": "2022-01-28", "expiryDate": "2022-01-28", "issuerCountry": { "id": "string", "name": "string", "abbreviation": "string" }, "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" } }, "ric": { "id": "string", "number": "string", "issuer": "string", "issuerCity": { "id": "string", "name": "string", "state": "string" }, "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "issueDate": "2022-01-28", "expiryDate": "2022-01-28" }, "voter": { "id": "string", "number": "string", "votingDistrict": "string", "votingSection": "string", "issuerCity": { "id": "string", "name": "string", "state": "string" }, "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "issueDate": "2022-01-28" }, "cnh": { "id": "string", "number": "string", "category": { "key": "string", "value": "string" }, "issuer": "string", "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" }, "issueDate": "2022-01-28", "expiryDate": "2022-01-28", "firstDriverLicenceDate": "2022-01-28" }, "reservist": { "id": "string", "number": "string", "serie": "string", "ra": "string", "exemptionDate": "2022-01-28", "doesntHave": false }, "civilCertificate": { "id": "string", "type": { "key": "string", "value": "string" }, "issueDate": "2022-01-28", "registry": "string", "term": "string", "book": "string", "sheet": "string", "notaryOffice": "string", "issuerCity": { "id": "string", "name": "string", "state": "string" }, "issuerState": { "id": "string", "name": "string", "abbreviation": "string", "country": "string" } }, "cns": { "id": "string", "number": "string" }, "dnv": { "id": "string", "number": "string" }, "bankAccount": { "id": "string", "bank": { "id": "string", "code": 0, "name": "string" }, "branch": 0, "accountType": { "key": "string", "value": "string" }, "bankAccount": "string", "digit": "string" }, "receiveSalaryAdvance": { "key": "string", "value": "string" } }, "hasDependent": true, "saveAsDraft": true, "hasDisability": true }, "companyName": "string", "branchOfficeName": "string", "tradingName": "string", "jobPositionName": "string", "customFieldsContract": [ { "field": "usu_custom", "value": "Valor 1" }, { "field": "usu_custom1", "value": "Valor 2" }, { "field": "usu_custom2", "value": "Valor 3" } ] } 

Respostas

Código Descrição Campos da resposta
200 Ok - resultado do envio do convite
Campo Tipo Descrição
ok Boolean Indicativo se o envio foi bem sucedido ou não.
message String Mensagem de retorno da primitiva.
idPreAdmission String Identificador da pré-admissão.
linkWhatsApp String  
401 Invalid credentials   -
default Error response
Campo Tipo Descrição
message String Mensagem descritiva do erro.
reason String Um código que representa a categoria da causa do erro.

Este artigo ajudou você?