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 |
|
|||||||||||||||
| 401 | Invalid credentials | - | |||||||||||||||
| default | Error response |
|
{ "result": { "ok": true, "message": "string", "idPreAdmission": "string", "linkWhatsApp": "string" } }
|
{ "message": "string", "reason": "BAD_REQUEST" }
|

English
Español


