A API Sólides é RESTful, e assim podemos oferecer um conjunto de funcionalidades do nosso sistema para ter uma boa integração junto com o sistema da sua empresa.
Nossa API de integração com o sistema Solides Gestão. A mesma oferece criação, edição, atualização de registros importantes para sua empresa como:
Passaportes, Colaboradores, Ocorrências e Currículos.
Vantagens da Integração:
O que integramos:
Base URL:
https://app.solides.com/pt-BR/api/v1/
https://apigw.solides.com.br/management/
Em nossas requisições é obrigatório informar na URL base o parâmetro {locale} cujo os valores possvíeis são: pt-BR, ou es, ou en". E todas devem ser autenticadas, esta autenticação é realizada a partir de um token, gerado a partir de nossa plataforma. O token deve ser enviado no cabeçalho (header) da requisição HTTPS.
Authorization: Token token=pca3e478144a2bf2a05c1fb1fe98asdk53247secfb55c1709e669
Accept: application/json
Content-Type: application/json
[- {
- "id": 1,
- "incidentDate": "12/07/2017",
- "classification": "Positivo",
- "comment": "Comentário para Fulano",
- "value": "12,90",
- "typeIncident": "Atraso",
- "colaborador": {
- "id": 123456,
- "nome": "João Silva"
}
}
]
Registra uma nova ocorrência
Parâmetros para registrar uma nova ocorrência.
idNumber | string Número de cpf do colaborador sem formatação |
incidentDate | string <date> data da ocorrência |
classification | string classificação para a ocorrência |
comment | string comentário da ocorreência |
value | number <float> valor da ocorrência |
typeIncidentId | integer Idenficador do tipo de ocorrência. ["1 - Falta/Ausência", "2 - Atraso", "3 - Promoção", "4 - Falha/Erro", "5 - Ideia / Contribuição", "6 - Recontratação", "7 - Outros", "8 - Advertência", "9 - Suspensão", "10 - Feedback", "11 - Subperformance", "12 - Folga"] |
{- "idNumber": "123456789101",
- "incidentDate": "12/07/2017",
- "classification": "Positivo",
- "comment": "Comentário para Fulano",
- "value": "12,90",
- "typeIncidentId": 1
}
{- "id": 1,
- "incidentDate": "12/07/2017",
- "classification": "Positivo",
- "comment": "Comentário para Fulano",
- "value": "12,90",
- "typeIncident": "Atraso",
- "colaborador": {
- "id": 123456,
- "nome": "João Silva"
}
}
Busca ocorrência pelo id
id required | integer >= 1 Example: 1 identificador único da ocorrência |
{- "id": 1,
- "incidentDate": "12/07/2017",
- "classification": "Positivo",
- "comment": "Comentário para Fulano",
- "value": "12,90",
- "typeIncident": "Atraso",
- "colaborador": {
- "id": 123456,
- "nome": "João Silva"
}
}
Listar todos colaboradores da empresa
status | string Example: status=todos Aumenta escopo da busca para incluir inativos. |
page_size | string Example: page_size=150 Quando informado junto ao parâmetro 'page' irá definir a quantidade de registros por página. |
page | integer Example: page=1 Quando informado junto ao parâmetro 'page_size' irá definir qual página deve ser retornada. |
data_admissao | string Example: data_admissao=01/01/2022 Recuperar registros de pessoas admitidas a partir da data especificada. |
data_admissao_anterior | string Example: data_admissao_anterior=01/01/2023 Recuperar registros de pessoas admitidas antes da data especificada. |
Authentication required | string token_api da empresa |
[- {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
]
Registra um novo colaborador
Parâmetros para registrar um colaborador.
name required | string nome do colaborador |
email required | string email do colaborador |
birthDate | string <date> data de nascimento |
gender | string Enum: "Feminino" "Masculino" sexo do colaborador |
maritalStatus | string Enum: "Casado" "Solteiro" "União Estável" "Divorciado" "Viúvo" "Separado" estado civil do colaborador |
education | string Enum: "Curso extra-curricular" "Fundamental Incompleto" "Fundamental Completo" "Médio Incompleto" "Médio Completo" "Superior Incompleto" "Superior Completo" "Pós Graduação" "Mestrado" "Doutorado" escolaridade do colaborador |
nationality | string nacionalidade do colaborador |
birthPlace | string naturalidade do colaborador |
fatherName | string nome do pai |
motherName | string nome da mae |
zipCode | string cep do colaborador |
countryAcronym | string país do colaborador (Sigla) |
stateAcronym | string estado do colaborador (Sigla) |
city | string cidade do colaborador |
neighborhood | string bairro do colaborador |
streetName | string Rua do colaborador |
number | string número de endereço |
additionalInformation | string complemento do endereco |
phone | string telefone fixo |
cellPhone | string telefone celular |
emergencyPhoneNumber | string número de emergência |
personalEmail | string email pessoal |
corporateEmail | string email coorporativo |
departamentId | integer <int64> identificador do departamento |
positionId | integer <int64> identificador do cargo |
unityId | integer <int64> identificador da unidade |
typeContract | string Enum: "CLT" "CLT + Comissão" "Comissionado" "Concursados" "Contrato" "Cooperado" "Efetivos" "Estagiário" "Estatuários" "Menor Aprendiz" "Jovem aprendiz" "Outros" "Parceiros" "Prestador de Serviço" "Sócio" "Temporário" "Mais Médicos" "Cedido pela União" tipo de contrato |
dateContract | string data de início do contrato |
contractDuration | string tempo de duração do contrato |
contractExpirationDate | string <date> data final do contrato |
registration | string matrícula do colaborador |
senior | integer <int64> identificador da pessoa superior direta. |
salary | number <float> <= 99999999.99 salário do colaborador |
workShift | string turno do colaborador |
hierarchicalLevel | string Enum: "Alto" "Baixo" "Médio" nível hierárquico do colaborador |
dateAdmission | string <date> data de admissão do colaborador |
dateDismissal | string <date> data de demissão do colaborador |
idNumber | string cpf do colaboraor |
rg | string rg do colaborador |
data_expedicao | string data de expedição do rg |
orgao_expedidor | string orgão emissor do rg |
cpf required | string CPF do colaborador |
voterRegistration | string título de eleitor do colaborador |
electoralZone | string zona eleitoral do colaborador |
electoralSection | string seção eleitoral do colaborador |
ctpsNum | string ctps num do colaborador |
ctpsSerie | string ctps serie do colaborador |
reservist | string número de reservista do colaborador |
nqc | string cnh do colaborador |
bank | string nome do banco do colaborador |
agency | string número da agência do colaborador |
checkingsAccount | string conta corrente do colaborador |
pis | string pis do colaborador |
disabledPerson | boolean Portador de Necessidade |
typeOfSpecialNeed | string Tipo de necessidade especial |
ethnicity | string Enum: "Branca" "Preta" "Amarela" "Parda" "Indígena" "Outro" Etnia |
salutation | string Enum: "Prezado Sr." "Prezada Sra." "Prezado" "Prezada" "Amigo" "Amiga" "Caro" "Cara" "Querida" "Querido" Saudação |
{- "name": "Nome X",
- "email": "email@example.com.br",
- "birthDate": "01/01/1991",
- "gender": "Feminino",
- "maritalStatus": "Solteiro",
- "education": "Doutorado",
- "nationality": "Brasileiro",
- "birthPlace": "Belo Horizontino",
- "fatherName": "Nome X",
- "motherName": "Nome Y",
- "zipCode": "00.000-000",
- "countryAcronym": "BR",
- "stateAcronym": "MG",
- "city": "Belo Horizonte",
- "neighborhood": "Savassi",
- "streetName": "Rua Sobradinho",
- "number": "1",
- "additionalInformation": "Apto 1",
- "phone": "(31) 33333333",
- "cellPhone": "(31) 999999999",
- "emergencyPhoneNumber": "(31) 999999999",
- "personalEmail": "email@gmail.com",
- "corporateEmail": "email@example.com.br",
- "departamentId": 1,
- "positionId": 1,
- "unityId": 1,
- "typeContract": "CLT",
- "dateContract": "01/01/2018",
- "contractDuration": "12 meses",
- "contractExpirationDate": "12/09/2019",
- "registration": "3819",
- "senior": 1,
- "salary": 3798.9,
- "workShift": "Diurno",
- "hierarchicalLevel": "Alto",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "01/01/2018",
- "idNumber": "22426759666",
- "rg": "390569422",
- "data_expedicao": "02/01/2019",
- "orgao_expedidor": "SSP",
- "cpf": "01234567890",
- "voterRegistration": "282850080221",
- "electoralZone": "131",
- "electoralSection": "Seção 29",
- "ctpsNum": "22426759",
- "ctpsSerie": "2242",
- "reservist": "39330569422",
- "nqc": "29998619616",
- "bank": "Bradesco",
- "agency": "2202",
- "checkingsAccount": "0186958-2",
- "pis": "48348426997",
- "disabledPerson": true,
- "typeOfSpecialNeed": "Visual",
- "ethnicity": "Outro",
- "salutation": "Prezado Sr."
}
{- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
id required | integer >= 1 Example: 1 identificador único do colaborador |
{- "id": 1,
- "name": "Maria de Fátima Souza",
- "email": "email@example.com.br",
- "registration": "381998",
- "birthDate": "01/01/1987",
- "gender": "Feminino",
- "maritalStatus": "Solteiro",
- "salutation": "Prezado Sr.",
- "nationality": "Brasileiro",
- "birthplace": "Belo Horizontino",
- "education": "Superior Completo",
- "course": "Arquiteura e Urbanismo",
- "dateAdmission": "01/01/2018",
- "salary": "R$ 3.890,00",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "hierarchicalLevel": "Alto",
- "typeContract": "CLT",
- "dateContract": "01/01/2018",
- "durationContract": "12 meses",
- "contractExpirationDate": "01/01/2019",
- "workShift": "Diurno",
- "ethnicity": "Outro",
- "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "departament": {
- "id": 1,
- "name": "TI"
}, - "contact": {
- "phone": "(31) 33333333",
- "cellPhone": "(31) 999999999",
- "emergencyPhoneNumber": "(31) 999999999",
- "personalEmail": "emailpessoal@example.com.br",
- "corporateEmail": "emailcoorporativa@example.com.br"
}, - "documents": {
- "idNumber": "22426759666",
- "rg": "390569422",
- "dispatchDate": "02/01/2019",
- "issuingBody": "SSP",
- "voterRegistration": "282850080221",
- "electoralZone": "131",
- "electoralSection": "Seção 29",
- "ctpsNum": "22426759",
- "ctpsSerie": "2242",
- "reservist": "39330569422",
- "nqc": "29998619616",
- "bank": "Bradesco",
- "agency": "2202",
- "checkingsAccount": "0186958-2",
- "pis": "48348426997"
}, - "dependents": [
- {
- "name": "Fulano X",
- "idNumber": "22426759666",
- "rg": "390569422",
- "birthDate": "01/01/2010",
- "relationship": "Filho(a)"
}
], - "vacations": [
- {
- "startDate": "01/08/2017",
- "endDate": "02/09/2017",
- "dueDate": "01/10/2019",
- "numberOfVacationDays": 30,
- "numberOfAllowanceDays": 0,
- "allowancesAmount": "R$ 300,00",
- "enjoyed": true,
- "note": "Observações"
}
], - "benefits": [
- {
- "benefitName": "Plano de Saúde X",
- "typeBenefit": "Plano de Saúde",
- "value": "R$ 397,00",
- "benefitAppliedAs": "em_reais",
- "dates": "Mensal",
- "valueDiscount": "R$ 120,00",
- "discountOption": "valor_fixo"
}
], - "healthAndSafety": [
- {
- "dateExamProcedure": "20/06/2017",
- "typeOfExamProcedure": "Exame Admissional",
- "description": "Descrição do exame/procedimento",
- "doctorName": "Médico X",
- "medicalRegister": "1267",
- "icd": "A01 - Febres tifóide e paratifóide",
- "medicalEvaluation": "Avaliação médica",
- "finished": true,
- "able": true,
- "dateOfNextExam": "23/06/2017",
- "numberOfDaysOff": 2
}
], - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
Atualiza informações de um colaborador
id required | integer >= 1 Example: 1 identificador único do colaborador |
Parâmetros para registrar um colaborador.
name required | string nome do colaborador |
email required | string email do colaborador |
birthDate | string <date> data de nascimento |
gender | string Enum: "Feminino" "Masculino" sexo do colaborador |
maritalStatus | string Enum: "Casado" "Solteiro" "União Estável" "Divorciado" "Viúvo" "Separado" estado civil do colaborador |
education | string Enum: "Curso extra-curricular" "Fundamental Incompleto" "Fundamental Completo" "Médio Incompleto" "Médio Completo" "Superior Incompleto" "Superior Completo" "Pós Graduação" "Mestrado" "Doutorado" escolaridade do colaborador |
nationality | string nacionalidade do colaborador |
birthPlace | string naturalidade do colaborador |
fatherName | string nome do pai |
motherName | string nome da mae |
zipCode | string cep do colaborador |
countryAcronym | string país do colaborador (Sigla) |
stateAcronym | string estado do colaborador (Sigla) |
city | string cidade do colaborador |
neighborhood | string bairro do colaborador |
streetName | string Rua do colaborador |
number | string número de endereço |
additionalInformation | string complemento do endereco |
phone | string telefone fixo |
cellPhone | string telefone celular |
emergencyPhoneNumber | string número de emergência |
personalEmail | string email pessoal |
corporateEmail | string email coorporativo |
departamentId | integer <int64> identificador do departamento |
positionId | integer <int64> identificador do cargo |
unityId | integer <int64> identificador da unidade |
typeContract | string Enum: "CLT" "CLT + Comissão" "Comissionado" "Concursados" "Contrato" "Cooperado" "Efetivos" "Estagiário" "Estatuários" "Menor Aprendiz" "Jovem aprendiz" "Outros" "Parceiros" "Prestador de Serviço" "Sócio" "Temporário" "Mais Médicos" "Cedido pela União" tipo de contrato |
dateContract | string data de início do contrato |
contractDuration | string tempo de duração do contrato |
contractExpirationDate | string <date> data final do contrato |
registration | string matrícula do colaborador |
senior | integer <int64> identificador da pessoa superior direta. |
salary | number <float> <= 99999999.99 salário do colaborador |
workShift | string turno do colaborador |
hierarchicalLevel | string Enum: "Alto" "Baixo" "Médio" nível hierárquico do colaborador |
dateAdmission | string <date> data de admissão do colaborador |
dateDismissal | string <date> data de demissão do colaborador |
idNumber | string cpf do colaboraor |
rg | string rg do colaborador |
data_expedicao | string data de expedição do rg |
orgao_expedidor | string orgão emissor do rg |
cpf required | string CPF do colaborador |
voterRegistration | string título de eleitor do colaborador |
electoralZone | string zona eleitoral do colaborador |
electoralSection | string seção eleitoral do colaborador |
ctpsNum | string ctps num do colaborador |
ctpsSerie | string ctps serie do colaborador |
reservist | string número de reservista do colaborador |
nqc | string cnh do colaborador |
bank | string nome do banco do colaborador |
agency | string número da agência do colaborador |
checkingsAccount | string conta corrente do colaborador |
pis | string pis do colaborador |
disabledPerson | boolean Portador de Necessidade |
typeOfSpecialNeed | string Tipo de necessidade especial |
ethnicity | string Enum: "Branca" "Preta" "Amarela" "Parda" "Indígena" "Outro" Etnia |
salutation | string Enum: "Prezado Sr." "Prezada Sra." "Prezado" "Prezada" "Amigo" "Amiga" "Caro" "Cara" "Querida" "Querido" Saudação |
{- "name": "Nome X",
- "email": "email@example.com.br",
- "birthDate": "01/01/1991",
- "gender": "Feminino",
- "maritalStatus": "Solteiro",
- "education": "Doutorado",
- "nationality": "Brasileiro",
- "birthPlace": "Belo Horizontino",
- "fatherName": "Nome X",
- "motherName": "Nome Y",
- "zipCode": "00.000-000",
- "countryAcronym": "BR",
- "stateAcronym": "MG",
- "city": "Belo Horizonte",
- "neighborhood": "Savassi",
- "streetName": "Rua Sobradinho",
- "number": "1",
- "additionalInformation": "Apto 1",
- "phone": "(31) 33333333",
- "cellPhone": "(31) 999999999",
- "emergencyPhoneNumber": "(31) 999999999",
- "personalEmail": "email@gmail.com",
- "corporateEmail": "email@example.com.br",
- "departamentId": 1,
- "positionId": 1,
- "unityId": 1,
- "typeContract": "CLT",
- "dateContract": "01/01/2018",
- "contractDuration": "12 meses",
- "contractExpirationDate": "12/09/2019",
- "registration": "3819",
- "senior": 1,
- "salary": 3798.9,
- "workShift": "Diurno",
- "hierarchicalLevel": "Alto",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "01/01/2018",
- "idNumber": "22426759666",
- "rg": "390569422",
- "data_expedicao": "02/01/2019",
- "orgao_expedidor": "SSP",
- "cpf": "01234567890",
- "voterRegistration": "282850080221",
- "electoralZone": "131",
- "electoralSection": "Seção 29",
- "ctpsNum": "22426759",
- "ctpsSerie": "2242",
- "reservist": "39330569422",
- "nqc": "29998619616",
- "bank": "Bradesco",
- "agency": "2202",
- "checkingsAccount": "0186958-2",
- "pis": "48348426997",
- "disabledPerson": true,
- "typeOfSpecialNeed": "Visual",
- "ethnicity": "Outro",
- "salutation": "Prezado Sr."
}
{- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
Registra demissão de um colaborador
id required | integer >= 1 Example: 1 identificador único da ocorrência |
Parâmetros para registrar uma demissão.
dateDismissal required | string <date> data da demissão do colaborador |
reasonDismissalId | integer <int64> identificador único do motivo de demissão |
formDismissal required | string (form_dismissal) Enum: "sem_justa_causa" "com_justa_causa" "pedido_demissao_funcionario" "acordo_entre_partes" "agrupamento_contratual" "antecipada_termo_empregado" "antecipada_termo_empregador" "aposentadoria_compulsoria" "aposentadoria_exceto_invalidez" "aposentadoria_idade" "aposentadoria_idade_tempo" "aposentadoria_invalidez" "aprendiz_ausencia_escolar" "aprendiz_inadaptacao" "contrato_nulo_art_37_cf" "culpa_reciproca" "demissao" "encerramento_empresa" "encerramento_empresa_geral" "exclusao_militar_com_efeitos" "exclusao_militar_sem_efeitos" "exoneracao" "extincao_trabalho_intermitente" "extravio_militar" "falecimento_domestico" "falecimento_empregado" "falecimento_empregador" "falecimento_empregador_opcao" "forca_maior" "mudanca_cpf" "mudanca_regime" "paralizacao_atos_autoridade" "redistribuicao" "reforma_administrativa" "reforma_militar" "remocao_orgao_declarante" "reserva_militar" "rescisao_aprendiz_inadaptacao" "rescisao_art_394_483_clt" "rescisao_indireta" "reversao_reintegracao" "termino_cessao_requisicao" "termino_contrato_termo" "termino_mandato" "transferencia_consorciado" "transferencia_domestico" "transferencia_empresa_inapta" "transferencia_grupo_empresarial" "transferencia_sucessao_empresarial" "vacancia_cargo" forma da demissão |
decisionDismissal required | string Enum: "pediu_saida" "demitido" decisão da demissão |
terminationAmount | number <float> <= 99999999.99 valor da recisão |
{- "dateDismissal": "14/07/2017",
- "reasonDismissalId": 1,
- "formDismissal": "sem_justa_causa",
- "decisionDismissal": "pediu_saida",
- "terminationAmount": 3798.9
}
Modifica matrícula de um colaborador
id required | integer Identificador do colaborador que será atualizado. |
Parâmetros para registrar uma demissão.
registration | string Nova matrícula do colaborador |
{- "registration": "123456"
}
Registra um novo departamento na empresa
Parâmetros para registrar um novo departamento.
name | string nome do departamento |
descricao | string descrição do departamento |
employee_id | number Id do responsável do departamento |
string email do departamento | |
monthly_budget | number orçamento mensal do departamento |
location | string Local do departmamento |
phone | number Telefone do departamento |
fax | number fax do departamento |
extension | number Ramal do departamento |
{- "name": "Administrativo",
- "descricao": "Projeta e planeja construções urbanas",
- "employee_id": 190299,
- "email": "teste@teste.com",
- "monthly_budget": 1000,
- "location": "São Paulo",
- "phone": 3133333333,
- "fax": 10,
- "extension": 1010
}
{- "id": 1,
- "name": "TI"
}
Atualiza informações de um departamento
id required | integer >= 1 Example: 1 identificador único do departamento |
Parâmetros para registrar um novo departamento.
name | string nome do departamento |
descricao | string descrição do departamento |
employee_id | number Id do responsável do departamento |
string email do departamento | |
monthly_budget | number orçamento mensal do departamento |
location | string Local do departmamento |
phone | number Telefone do departamento |
fax | number fax do departamento |
extension | number Ramal do departamento |
{- "name": "Administrativo",
- "descricao": "Projeta e planeja construções urbanas",
- "employee_id": 190299,
- "email": "teste@teste.com",
- "monthly_budget": 1000,
- "location": "São Paulo",
- "phone": 3133333333,
- "fax": 10,
- "extension": 1010
}
{- "id": 1,
- "name": "TI"
}
[- {
- "id": 1,
- "name": "Maria de Souza",
- "email": "mariadesouza@example.com",
- "profile": "EC",
- "idNumber": "12345678909",
- "gender": "Feminino",
- "dateOfBirth": "01/07/1987",
- "responseDate": "12/07/2017",
- "sendDate": "12/07/2017",
- "expirationDate": "12/07/2017",
- "state": "respondido",
}
]
Cria um novo passaporte
Parâmetros para registrar um novo passaporte.
name required | string nome completo da pessoa que irá responder o passaporte |
email required | string email para o qual será enviado o passaporte |
sendResultToEmail required | boolean Default: false se marcado como true, o resultado do teste será enviado automaticamente para o email cadastrado |
expirationDate required | string <date> data de expiração do passaporte |
blockSendingPassport | boolean se marcado como true, bloqueia o envio do passaporte para o email do candidato |
{- "name": "José da Silva",
- "email": "jose@example.com",
- "sendResultToEmail": true,
- "expirationDate": "12/09/2017",
- "blockSendingPassport": true
}
{- "id": 1,
- "name": "Maria de Souza",
- "email": "mariadesouza@example.com",
- "profile": "EC",
- "idNumber": "12345678909",
- "gender": "Feminino",
- "dateOfBirth": "01/07/1987",
- "responseDate": "12/07/2017",
- "sendDate": "12/07/2017",
- "expirationDate": "12/07/2017",
- "state": "respondido",
}
Busca por um passaporte na empresa
id required | integer >= 1 Example: 1 identificador único do candidato |
{- "id": 1,
- "name": "Maria de Souza",
- "email": "mariadesouza@example.com",
- "profile": "EC",
- "idNumber": "12345678909",
- "gender": "Feminino",
- "dateOfBirth": "01/07/1987",
- "responseDate": "12/07/2017",
- "sendDate": "12/07/2017",
- "expirationDate": "12/07/2017",
- "state": "respondido",
}
Atualiza informações de um Passaporte cujo status seja não iniciado
id required | integer >= 1 Example: 1 identificador único do passaporte |
Parâmetros para registrar um novo passaporte.
name required | string nome completo da pessoa que irá responder o passaporte |
email required | string email para o qual será enviado o passaporte |
sendResultToEmail required | boolean Default: false se marcado como true, o resultado do teste será enviado automaticamente para o email cadastrado |
expirationDate required | string <date> data de expiração do passaporte |
blockSendingPassport | boolean se marcado como true, bloqueia o envio do passaporte para o email do candidato |
{- "name": "José da Silva",
- "email": "jose@example.com",
- "sendResultToEmail": true,
- "expirationDate": "12/09/2017",
- "blockSendingPassport": true
}
{- "id": 1,
- "name": "Maria de Souza",
- "email": "mariadesouza@example.com",
- "profile": "EC",
- "idNumber": "12345678909",
- "gender": "Feminino",
- "dateOfBirth": "01/07/1987",
- "responseDate": "12/07/2017",
- "sendDate": "12/07/2017",
- "expirationDate": "12/07/2017",
- "state": "respondido",
}
Relatório Profiler obtido após responder o passaporte
id required | integer >= 1 Example: 1 identificador único do passaporte |
option required | integer >= 1 Example: 2566 tipo de relatório. Vide Tipos de Relatórios Profiler |
Desbloqueia um passaporte utilizando créditos da empresa, permitindo a visualização do relatório do passaporte desbloqueado
id required | integer >= 1 Example: 1 identificador único do passaporte |
required | object |
{- "candidato": {
- "tipo_relatorio": 2
}
}
{- "id": 1,
- "name": "Maria de Souza",
- "email": "mariadesouza@example.com",
- "profile": "EC",
- "idNumber": "12345678909",
- "gender": "Feminino",
- "dateOfBirth": "01/07/1987",
- "responseDate": "12/07/2017",
- "sendDate": "12/07/2017",
- "expirationDate": "12/07/2017",
- "state": "respondido",
}
Busca por todos os currículos da empresa
data_inicial | string Example: data_inicial=01/01/2021 (opcional) Busca por currículos a partir da data específicada (dia/mes/ano) |
data_final | string Example: data_final=01/01/2022 (opcional) Busca por currículos até a data específicada (dia/mes/ano) |
page | integer Example: page=1 Indicador da página |
ocultar_foto | string Example: ocultar_foto=SIM Ocultar foto |
Authentication required | string token_api da empresa |
[- {
- "id": 1,
- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@example.com.br",
- "secondaryEmail": "secundario@example.com.br",
- "idNumber": "012345678909",
- "gender": "Feminino",
- "phone": "(31) 33333333",
- "mobile": "(31) 999999999",
- "birthDate": "01/01/1987",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "Fulano de Tal",
- "origin": "Banco de talentos",
- "photo": "iVBORw0KGgoAAAANSUhEUgAABJQAAAXWCAYAAADVTfeWAAAgAElEQVR4XuzdC5xN5f7H8",
- "photo_extension": ".jpg",
- "adress": {
- "zipCode": "00.000-000",
- "streetName": "Rua Api",
- "additionalInformation": "Apto 001",
- "number": "001",
- "neighborhood": "Teste",
- "city": {
- "name": "Belo Horizonte",
- "state": {
- "name": "Minas Gerais",
- "initials": "MG"
}
}
}, - "languages": [
- {
- "name": "Português",
- "level": "Fluente"
}
], - "notes": [
- {
- "note": "Observacao",
- "date": "20/06/2017"
}
], - "professionalExperiences": [
- {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "activitiesDescription": "Descrições das atividades"
}
], - "academicEducations": [
- {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "grade": "Doutorado"
}
]
}
]
Registra um novo currículo na empresa
Parâmetros para registrar um novo passaporte.
fullName required | string nome completo |
mainEmail required | string email principal |
secondaryEmail | string email secundário |
idNumber required | string cpf |
gender required | string Enum: "Feminino" "Masculino" gênero |
phone | string telefone |
mobile | string celular |
birthDate | string <date> data de nascimento |
maritalStatus | string Enum: "Casado" "Solteiro" "União Estável" "Divorciado" "Viúvo" estado civil |
seniority | string Enum: "Estágio" "Trainee" "Operacional" "Supervisão" "Gerência" "Diretoria" senioridade |
skypeGtalk | string skype ou gtalk |
string | |
string | |
youtube | string canal do youtube |
introductionVideoURL | string video de apresentação do candidato |
origin | string origem da entrada do candidato na empresa |
zipCode | string cep |
number | string número |
street | string Logradouro |
district | string Bairro |
state | string Estado (Sigla) |
city | string Cidade (nome) |
additionalInformation | string complemento |
Array of objects (IdiomaParameters) | |
Array of objects (FormacaoAcademicaParameters) | |
Array of objects (ExperienciaProfissionalParameters) |
{- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@example.com.br",
- "secondaryEmail": "secundario@example.com.br",
- "idNumber": "012345678909",
- "gender": "Feminino",
- "phone": "(31) 33333333",
- "mobile": "(31) 999999999",
- "birthDate": "01/01/1987",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "Fulano de Tal",
- "origin": "Banco de talentos",
- "zipCode": "00.000-000",
- "number": "001",
- "street": "Avenida Afonso Pena",
- "district": "Centro",
- "state": "MG",
- "city": "Belo Horizonte",
- "additionalInformation": "Apto 001",
- "languages": [
- {
- "name": "Português",
- "level": "Fluente"
}
], - "academicEducations": [
- {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "grade": "Doutorado"
}
], - "professionalExperiences": [
- {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "activitiesDescription": "Descrições das atividades"
}
]
}
{- "id": 1,
- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@example.com.br",
- "secondaryEmail": "secundario@example.com.br",
- "idNumber": "012345678909",
- "gender": "Feminino",
- "phone": "(31) 33333333",
- "mobile": "(31) 999999999",
- "birthDate": "01/01/1987",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "Fulano de Tal",
- "origin": "Banco de talentos",
- "photo": "iVBORw0KGgoAAAANSUhEUgAABJQAAAXWCAYAAADVTfeWAAAgAElEQVR4XuzdC5xN5f7H8",
- "photo_extension": ".jpg",
- "adress": {
- "zipCode": "00.000-000",
- "streetName": "Rua Api",
- "additionalInformation": "Apto 001",
- "number": "001",
- "neighborhood": "Teste",
- "city": {
- "name": "Belo Horizonte",
- "state": {
- "name": "Minas Gerais",
- "initials": "MG"
}
}
}, - "languages": [
- {
- "name": "Português",
- "level": "Fluente"
}
], - "notes": [
- {
- "note": "Observacao",
- "date": "20/06/2017"
}
], - "professionalExperiences": [
- {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "activitiesDescription": "Descrições das atividades"
}
], - "academicEducations": [
- {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "grade": "Doutorado"
}
]
}
Busca por um currículo na empresa
id required | integer >= 1 Example: 1 identificador único do currículo |
[- {
- "id": 1,
- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@example.com.br",
- "secondaryEmail": "secundario@example.com.br",
- "idNumber": "012345678909",
- "gender": "Feminino",
- "phone": "(31) 33333333",
- "mobile": "(31) 999999999",
- "birthDate": "01/01/1987",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "Fulano de Tal",
- "origin": "Banco de talentos",
- "photo": "iVBORw0KGgoAAAANSUhEUgAABJQAAAXWCAYAAADVTfeWAAAgAElEQVR4XuzdC5xN5f7H8",
- "photo_extension": ".jpg",
- "adress": {
- "zipCode": "00.000-000",
- "streetName": "Rua Api",
- "additionalInformation": "Apto 001",
- "number": "001",
- "neighborhood": "Teste",
- "city": {
- "name": "Belo Horizonte",
- "state": {
- "name": "Minas Gerais",
- "initials": "MG"
}
}
}, - "languages": [
- {
- "name": "Português",
- "level": "Fluente"
}
], - "notes": [
- {
- "note": "Observacao",
- "date": "20/06/2017"
}
], - "professionalExperiences": [
- {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "activitiesDescription": "Descrições das atividades"
}
], - "academicEducations": [
- {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "20/06/2016",
- "endDate": "20/06/2017",
- "grade": "Doutorado"
}
]
}
]
Registra um novo motivo de demissão
Parâmetros para registrar um novo motivo de demissão.
name | string nome dado ao motivo de demissão |
{- "name": "Falta"
}
{- "id": 1,
- "name": "Falta"
}
Atualiza informações de um motivo de demissão
id required | integer >= 1 Example: 1 identificador único do motivo de demissão |
Parâmetros para registrar um novo motivo de demissão.
name | string nome dado ao motivo de demissão |
{- "name": "Falta"
}
{- "id": 1,
- "name": "Falta"
}
Registra um novo cargo na empresa
Parâmetros para registrar um novo departamento.
name | string nome do cargo |
higher_id | number Id do usuário responsável do cargo |
cboCode | number identificador do cargo superior |
description | string descrição do cargo |
activies | string atividades para esse cargo |
minimunWage | number Salário minimo para esse cargo |
{- "name": "Assistente adminstrativo",
- "higher_id": 109285,
- "cboCode": 141405,
- "description": "Projeta e planeja construções urbanas",
- "activies": "Projetar e planejar construções urbanas",
- "minimunWage": 1100
}
{- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição"
}
Busca por um cargo da empresa
id required | integer >= 1 Example: 1 identificador único do motivo |
{- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}
Atualiza informações de um cargo
id required | integer >= 1 Example: 1 identificador único do cargo |
Parâmetros para registrar um novo departamento.
name | string nome do cargo |
higher_id | number Id do usuário responsável do cargo |
cboCode | number identificador do cargo superior |
description | string descrição do cargo |
activies | string atividades para esse cargo |
minimunWage | number Salário minimo para esse cargo |
{- "name": "Assistente adminstrativo",
- "higher_id": 109285,
- "cboCode": 141405,
- "description": "Projeta e planeja construções urbanas",
- "activies": "Projetar e planejar construções urbanas",
- "minimunWage": 1100
}
{- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição"
}
Busca por todos absenteísmos da empresa
[- {
- "id": 1,
- "dateTimeAbsenteeism": "11/07/2017 08:30:00",
- "type": "Saída",
- "location": "Belo Horizonte",
- "tangerinoId": 1,
- "note": "Observação do Absenteísmo",
- "employee": {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
}
]
Registra um novo absenteísmo
Parâmetros para registrar um novo absenteísmo.
dateRegistration required | string <YYYY-MM-DD HH:MM:SS> Horário do registro do Absenteísmo |
idNumber required | string Número de cpf do colaborador sem formatação |
type | string Tipo de Absenteísmo |
location | string Localização no qual foi registrado o Absenteísmo |
tangerinoId | string identificador do tangerino |
note | string Observação sobre o Absenteísmo registrado |
{- "dateRegistration": "2018-08-19 08:20:34",
- "idNumber": "123456789101",
- "type": "Chegada",
- "location": "Belo Horizonte, MG",
- "tangerinoId": "123456789",
- "note": "Uma observação sobre o Absenteísmo registrado"
}
{- "id": 1,
- "dateTimeAbsenteeism": "11/07/2017 08:30:00",
- "type": "Saída",
- "location": "Belo Horizonte",
- "tangerinoId": 1,
- "note": "Observação do Absenteísmo",
- "employee": {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
}
Busca por um absenteísmo da empresa
id required | integer >= 1 Example: 1 identificador único do absenteismo |
{- "id": 1,
- "dateTimeAbsenteeism": "11/07/2017 08:30:00",
- "type": "Saída",
- "location": "Belo Horizonte",
- "tangerinoId": 1,
- "note": "Observação do Absenteísmo",
- "employee": {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
}
Atualiza informações de um absenteísmo
id required | integer >= 1 Example: 1 identificador único do absenteísmo |
Parâmetros para registrar um novo absenteísmo.
dateRegistration required | string <YYYY-MM-DD HH:MM:SS> Horário do registro do Absenteísmo |
idNumber required | string Número de cpf do colaborador sem formatação |
type | string Tipo de Absenteísmo |
location | string Localização no qual foi registrado o Absenteísmo |
tangerinoId | string identificador do tangerino |
note | string Observação sobre o Absenteísmo registrado |
{- "dateRegistration": "2018-08-19 08:20:34",
- "idNumber": "123456789101",
- "type": "Chegada",
- "location": "Belo Horizonte, MG",
- "tangerinoId": "123456789",
- "note": "Uma observação sobre o Absenteísmo registrado"
}
{- "id": 1,
- "dateTimeAbsenteeism": "11/07/2017 08:30:00",
- "type": "Saída",
- "location": "Belo Horizonte",
- "tangerinoId": 1,
- "note": "Observação do Absenteísmo",
- "employee": {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
}
Atualiza informações de um absenteísmo
id required | integer >= 1 Example: 1 tangerino_id único do absenteísmo |
Parâmetros para atualizar um absenteísmo
dateRegistration required | string <YYYY-MM-DD HH:MM:SS> Horário do registro do Absenteísmo |
idNumber required | string Número de cpf do colaborador sem formatação |
type | string Tipo de Absenteísmo |
location | string Localização no qual foi registrado o Absenteísmo |
note | string Observação sobre o Absenteísmo registrado |
{- "dateRegistration": "2018-08-19 08:20:34",
- "idNumber": "123456789101",
- "type": "Chegada",
- "location": "Belo Horizonte, MG",
- "note": "Uma observação sobre o Absenteísmo registrado"
}
{- "id": 1,
- "dateTimeAbsenteeism": "11/07/2017 08:30:00",
- "type": "Saída",
- "location": "Belo Horizonte",
- "tangerinoId": 1,
- "note": "Observação do Absenteísmo",
- "employee": {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
}
Busca por absenteísmos de um colaborador na empresa
cpf required | integer Example: 99988877766 cpf de um colaborador específico |
[- {
- "id": 1,
- "dateTimeAbsenteeism": "11/07/2017 08:30:00",
- "type": "Saída",
- "location": "Belo Horizonte",
- "tangerinoId": 1,
- "note": "Observação do Absenteísmo",
- "employee": {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "idNumber": "11223344556",
- "email": "email@example.com.br",
- "birthDate": "01/01/1987",
- "education": "medio_completo",
- "course": "Arquiteura e Urbanismo",
- "registration": "381998",
- "gender": "Feminino",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "reasonDismissal": "Motivo da demissão",
- "ethnicity": "Outro",
- "workShift": "Diurno",
- "typeContract": "CLT",
- "senior": {
- "id": 1,
- "name": "Joana"
}, - "active": true,
- "updated_at"": "02/01/2019",
- "departament": {
- "id": 1,
- "name": "TI"
}, - "position": {
- "id": 1,
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Breve descrição",
- "activities": "Atividades"
}, - "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
], - "unity": {
- "name": "Unidade 1"
}
}
}
]
Busca pelos profilers dos colaboradores da empresa
[- {
- "id": 1,
- "name": "Maria de Fátima Souza",
- "email": "email@example.com.br",
- "gender": "Feminino",
- "departamentId": 1,
- "positionId": 1,
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "salary": "R$ 3.890,00",
- "workShift": "Diurno",
- "perfil": "EA",
- "testDate": "20/12/2017"
}
]
id required | number identificador único do colaborador |
{- "id": 1,
- "name": "Maria de Fátima Souza",
- "email": "email@example.com.br",
- "gender": "Feminino",
- "departamentId": 1,
- "positionId": 1,
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "salary": "R$ 3.890,00",
- "workShift": "Diurno",
- "perfil": "EA",
- "testDate": "20/12/2017"
}
Responde um questionário profiler fornecendo informações pessoais do candidato e as chaves identificadora dos adjetivos e desejos do candidato.
Parâmetro de criação do questionário profiler.
name | string Nome do candidato |
string Email do candidato | |
idNumber | number CPF do candidato |
gender | string Sexo do candidato |
start | string <date-time> Data e hora do início do teste |
end | string <date-time> Data e hora do fim do teste |
racional1 | boolean Adjetivo |
rotineiro1 | boolean Adjetivo |
bemquisto1 | boolean Adjetivo |
destacado1 | boolean Adjetivo |
pessimista1 | boolean Adjetivo |
racional2 | boolean Desejo |
rotineiro2 | boolean Desejo |
bemquisto2 | boolean Desejo |
destacado2 | boolean Desejo |
pessimista2 | boolean Desejo |
{- "name": "Fulano",
- "email": "fulano@email.com",
- "idNumber": "49556733418",
- "gender": "Feminino",
- "start": "2019-01-21 17:10:00",
- "end": "2019-01-21 17:19:10",
- "racional1": true,
- "rotineiro1": true,
- "bemquisto1": true,
- "destacado1": true,
- "pessimista1": true,
- "racional2": true,
- "rotineiro2": true,
- "bemquisto2": true,
- "destacado2": true,
- "pessimista2": true
}
Avaliações avançadas por intervalo de data
data_inicial required | string Example: data_inicial=01/01/2000 Data que representa o intervalo inicial da avaliação avançada |
data_final required | string Example: data_final=01/01/2022 Data que representa o intervalo final da avaliação avançada |
[- {
- "evaluatorId": 74909,
- "evaluatorName": "João da Silva Pires",
- "evaluatorDocument": "12345678912",
- "ratedId": 190281,
- "ratedName": "José de Souza Pires",
- "ratedDocument": "12345678912",
- "ratedPosition": "Assistente Administrativo",
- "ratedDepartament": "Compras",
- "criterions": [
- {
- "criterionId": 27862,
- "criterionType": "Agilidade",
- "criterionDescription": "Entrega das tarefas em tempo hábil",
- "criterionGrade": 3,
- "criterionWeigth": 100
}
]
}
]
Avaliações de desempenho por intervalo de data
data_inicial required | string Example: data_inicial=01/01/2000 Data que representa o intervalo inicial da avaliação de desempenho |
data_final required | string Example: data_final=01/01/2022 Data que representa o intervalo final da avaliação de desempenho |
[- {
- "evaluationId": 9319,
- "evaluatorId": 74909,
- "evaluatorName": "João da Silva Pires",
- "evaluatorDocument": "12345678912",
- "ratedId": 190281,
- "ratedName": "José de Souza Pires",
- "ratedDocument": "12345678912",
- "ratedPosition": "Assistente Administrativo",
- "ratedDepartament": "Compras",
- "comments": "Compras",
- "criterions": [
- {
- "relacionamento": 3,
- "engajamento": 1,
- "entrega": 3,
- "produtividade": 3,
- "preparo": 3
}
]
}
]
{- "data": [
- {
- "id": 111,
- "type": "solicitations",
- "attributes": {
- "name": "Avaliação de Desempenho - 01/2029",
- "description": "Teste",
- "started_at": "2029-01-22",
- "finished_at": "2029-02-07",
- "tatus": "active"
}
}
], - "included": [ ],
- "meta": {
- "pagination": {
- "current": 1,
- "previous": null,
- "next": null,
- "per_page": 20,
- "pages": 1,
- "total_count": 2
}
}
}
Avaliações de desempenho
solicitation_id required | integer Example: 123654 solicitation_id específico |
{- "data": [
- {
- "attributes": {
- "evaluatorId": 123654,
- "evaluatorName": "Teste",
- "evaluatorEmail"": "teste@teste.com.br",
- "ratedId": 321456,
- "ratedName": "Teste",
- "ratedDocument": 456321,
- "ratedPosition": "ASSISTENTE DE COBRANÇA",
- "ratedDepartament": "FINANCEIRO",
- "ratedDate": "2088-01-25",
- "ratedProfiler": "PC",
- "criterions": [
- {
- "criterionId": 1,
- "criterionType": "criterion name",
- "criterionDescription": "criterion description",
- "criterionGrade": 1,
- "criterionWeight": 1,
- "criterionComments": "criterion comments"
}
]
}
}
], - "included": [ ],
- "meta": {
- "pagination": {
- "current": 1,
- "previous": null,
- "next": null,
- "per_page": 20,
- "pages": 1,
- "total_count": 2
}
}
}
A Classificação Brasileira de Ocupações (CBO) é um documento que retrata a realidade das profissões do mercado de trabalho brasileiro.
API para facilitar a integração e sincronização de informações. Com ela os sistemas externos poderão utilizar identificadores próprios quando precisarem interagir com a plataforma Sólides.
Para o funcionamento na api de externos, é necessário duas chaves, o target-system e o externo_id.
target-system:
Representa o sistema de origem dos dados – sistema HOST das informações. Deve ser passado no header de todas as requisições para API Externos e nunca deve ser vazio.
externo_id:
É a chave do registro na aplicação de origem, identifica o registro. Não pode ser duplicado para um mesmo tipo (Cargo, Departamento, Colaborador etc) e target_system. Ao enviar uma requisição a aplicação irá verificar se o externo_id/target_system estão vinculados a algum registro. Caso esteja, o mesmo será atualizado, caso contrário um novo cadastro será feito..
Listar Cargos externos da empresa
externo_id required | string identificador único do cargo |
Target-System required | string identificador único do sistema |
{- "id": 1,
- "nome": "Assistente adminstrativo",
- "piso_salarial": 1200,
- "cbo": "214105 - Arquiteto de edificações",
- "descricao": "Projeta e planeja construções urbanas",
- "atividade": "Atividades"
}
Cria ou atualiza um cargo externo
Target-System required | string identificador único do sistema |
Parâmetros para registrar um novo Cargo.
externo_id | string Identificador único do cargo externo |
nome | string nome do colaborador |
piso_salarial | number <float> piso salarial do cargo |
cbo | string identificador do cargo |
descricao | string descrição do cargo |
atividade | string atividades para esse cargo |
{- "externo_id": "externo_id",
- "nome": "Assistente adminstrativo",
- "piso_salarial": 1200,
- "cbo": "214105 - Arquiteto de edificações",
- "descricao": "Projeta e planeja construções urbanas",
- "atividade": "Projetar e planejar construções urbanas"
}
Lista Colaborador externo da empresa
externo_id required | string identificador externo único do colaborador |
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string |
{- "id": 1,
- "name": "Maria de Fátima Souza",
- "email": "teste@teste.com.br",
- "registration": 381998,
- "birthDate": "01/01/2017",
- "sexo": "Feminino",
- "maritalStatus": "Solteiro",
- "nationality": "Brasileiro",
- "birthplace": "Belo Horizontino",
- "motherName": "Maria",
- "education": "Superior Completo",
- "dateAdmission": "01/01/2018",
- "salary": "R$ 3.890,00",
- "dateDismissal": "02/01/2019",
- "hierarchicalLevel": "Alto",
- "typeContract": "CLT",
- "dateContract": "01/01/2018",
- "durationContract": "12 meses",
- "contractExpirationDate": "01/01/2019",
- "workShift": "Diurno",
- "photo": "string",
- "ethnicity": "Outro",
- "senior": {
- "id": "externo_id",
- "name": "Jose Maria"
}, - "departament": {
- "id": "externo_id",
- "name": "TI"
}, - "position": {
- "id": "externo_id",
- "name": "Cargo",
- "minimumWage": 1200,
- "briefDescription": "Gerir equipe de adm",
- "activities": "Gerir equipe de adm"
}, - "address": {
- "zipCode": 27115000,
- "streetName": "Rua X",
- "additionalInformation": "Perto de...",
- "number": 15,
- "neighborhood": "Bairro X",
- "city": {
- "name": "Cidade X",
- "state": {
- "name": "Estado Y",
- "initials": "RJ"
}
}
}, - "contact": {
- "phone": "(31) 33333333",
- "cellPhone": "(31) 999999999",
- "emergencyPhoneNumber": "(31) 999999999",
- "personalEmail": "emailpessoal@example.com.br",
- "corporateEmail": "emailcorporativo@example.com.br"
}, - "documents": {
- "idNumber": 22426759666,
- "rg": 390569422,
- "dispatchDate": "02/01/2019",
- "issuingBody": "SSP",
- "voterRegistration": 282850080221,
- "electoralZone": 131,
- "electoralSection": 29,
- "ctpsNum": 22426759,
- "ctpsSerie": 2242,
- "reservist": 39330569422,
- "nqc": 29998619616,
- "bank": "Bradesco",
- "agency": 2202,
- "checkingsAccount": "0186958-2",
- "pis": 48348426997
}, - "vacations": {
- "startDate": "01/08/2017",
- "endDate": "02/09/2017",
- "dueDate": "01/10/2019",
- "numberOfVacationDays": 30,
- "numberOfAllowanceDays": 0,
- "allowancesAmount": 30000,
- "enjoyed": true,
- "note": "Observações"
}, - "dependents": {
- "name": "Fulano X",
- "IdNumber": 22426759666,
- "rg": 390569422,
- "birthDate": "01/01/2010",
- "relationship": "Filho(a)"
}, - "healthAndSafety": {
- "dateExamProcedure": "20/06/2017",
- "typeOfExamProcedure": "Exame Admissiona",
- "description": "Descrição do exame/procedimento",
- "doctorName": "Médico X",
- "medicalRegister": 1267,
- "icd": "A01 - Febres tifóide e paratifóide",
- "medicalEvaluation": "Avaliação médica",
- "finished": true,
- "able": true,
- "dateOfNextExam": "23/06/2017",
- "numberOfDaysOff": 2
}, - "benefits": {
- "benefitName": "Plano de Saúde X",
- "typeBenefit": "Plano de Saúde",
- "value": "R$ 39700",
- "benefitAppliedAs": "em reais",
- "dates": "Mensal",
- "valueDiscount": "R$ 12000",
- "discountOption": "valor fixo"
}, - "observacoes": "Funcionário muito dedicado",
- "vinculo_externos": {
- "externalId": "Cgb-123456",
- "targetSystem": "mySystem01",
- "linkedTo": "Colaborador"
}
}
Cria ou atualiza um colaborador externo
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
Parâmetros para registrar um colaborador.
externo_id | string Identificador único externo do colaborador |
name required | string nome do colaborador |
email required | string email do colaborador |
birthDate | string <date> data de nascimento |
gender | string Enum: "Feminino" "Masculino" sexo do colaborador |
maritalStatus | string Enum: "Casado" "Solteiro" "União Estável" "Divorciado" "Viúvo" "Separado" estado civil do colaborador |
education | string Enum: "Curso extra-curricular" "Fundamental Incompleto" "Fundamental Completo" "Médio Incompleto" "Médio Completo" "Superior Incompleto" "Superior Completo" "Pós Graduação" "Mestrado" "Doutorado" escolaridade do colaborador |
nationality | string nacionalidade do colaborador |
birthPlace | string naturalidade do colaborador |
fatherName | string nome do pai |
motherName | string nome da mae |
zipCode | string cep do colaborador |
countryAcronym | string país do colaborador (Sigla) |
stateAcronym | string estado do colaborador (Sigla) |
city | string cidade do colaborador |
neighborhood | string bairro do colaborador |
streetName | string Rua do colaborador |
number | string número de endereço |
additionalInformation | string complemento do endereco |
phone | string telefone fixo |
cellPhone | string telefone celular |
emergencyPhoneNumber | string número de emergência |
personalEmail | string email pessoal |
corporateEmail | string email coorporativo |
departamentId | string identificador externo do departamento |
positionId | string identificador externo do cargo |
unityId | string identificador externo da unidade |
typeContract | string Enum: "CLT" "CLT + Comissão" "Comissionado" "Concursados" "Contrato" "Cooperado" "Efetivos" "Estagiário" "Estatuários" "Menor Aprendiz" "Jovem aprendiz" "Outros" "Parceiros" "Prestador de Serviço" "Sócio" "Temporário" "Mais Médicos" "Cedido pela União" tipo de contrato |
dateContract | string data de início do contrato |
durationContract | string tempo de duração do contrato |
contractExpirationDate | string <date> data final do contrato |
registration | string matrícula do colaborador |
senior | string identificador externo da pessoa superior direta. |
salary | number <float> <= 99999999.99 salário do colaborador |
workShift | string turno do colaborador |
hierarchicalLevel | string Enum: "Alto" "Baixo" "Médio" nível hierárquico do colaborador |
dateAdmission | string <date> data de admissão do colaborador |
dateDismissal | string <date> data de demissão do colaborador |
idNumber | string cpf do colaboraor |
rg | string rg do colaborador |
data_expedicao | string data de expedição do rg |
orgao_expedidor | string orgão emissor do rg |
cpf required | string CPF do colaborador |
voterRegistration | string título de eleitor do colaborador |
electoralZone | string zona eleitoral do colaborador |
electoralSection | string seção eleitoral do colaborador |
ctpsNum | string ctps num do colaborador |
ctpsSerie | string ctps serie do colaborador |
reservist | string número de reservista do colaborador |
nqc | string cnh do colaborador |
bank | string nome do banco do colaborador |
agency | string número da agência do colaborador |
checkingsAccount | string conta corrente do colaborador |
pis | string pis do colaborador |
disabledPerson | boolean Portador de Necessidade |
typeOfSpecialNeed | string Tipo de necessidade especial |
ethnicity | string Enum: "Branca" "Preta" "Amarela" "Parda" "Indígena" "Outro" Etnia |
salutation | string Enum: "Prezado Sr." "Prezada Sra." "Prezado" "Prezada" "Amigo" "Amiga" "Caro" "Cara" "Querida" "Querido" Saudação |
{- "externo_id": "1A",
- "name": "Nome X",
- "email": "email@example.com.br",
- "birthDate": "01/01/1991",
- "gender": "Feminino",
- "maritalStatus": "Solteiro",
- "education": "Doutorado",
- "nationality": "Brasileiro",
- "birthPlace": "Belo Horizontino",
- "fatherName": "Nome X",
- "motherName": "Nome Y",
- "zipCode": "00.000-000",
- "countryAcronym": "BR",
- "stateAcronym": "MG",
- "city": "Belo Horizonte",
- "neighborhood": "Savassi",
- "streetName": "Rua Sobradinho",
- "number": "1",
- "additionalInformation": "Apto 1",
- "phone": "(31) 33333333",
- "cellPhone": "(31) 999999999",
- "emergencyPhoneNumber": "(31) 999999999",
- "personalEmail": "email@gmail.com",
- "corporateEmail": "email@example.com.br",
- "departamentId": "9a35996b-44a6-4438-a662",
- "positionId": "9a35996b-44a6-4438-a662",
- "unityId": "9a35996b-44a6-4438-a662",
- "typeContract": "CLT",
- "dateContract": "01/01/2018",
- "durationContract": "12 meses",
- "contractExpirationDate": "12/09/2019",
- "registration": "3819",
- "senior": "9a35996b-44a6-4438-a662",
- "salary": 3798.9,
- "workShift": "Diurno",
- "hierarchicalLevel": "Alto",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "01/01/2018",
- "idNumber": "22426759666",
- "rg": "390569422",
- "data_expedicao": "02/01/2019",
- "orgao_expedidor": "SSP",
- "cpf": "01234567890",
- "voterRegistration": "282850080221",
- "electoralZone": "131",
- "electoralSection": "Seção 29",
- "ctpsNum": "22426759",
- "ctpsSerie": "2242",
- "reservist": "39330569422",
- "nqc": "29998619616",
- "bank": "Bradesco",
- "agency": "2202",
- "checkingsAccount": "0186958-2",
- "pis": "48348426997",
- "disabledPerson": true,
- "typeOfSpecialNeed": "Visual",
- "ethnicity": "Outro",
- "salutation": "Prezado Sr."
}
{- "externo_id": "1A",
- "name": "Maria de Fátima Souza",
- "email": "teste@teste.com.br",
- "birthDate": "01/01/2017",
- "gender": "Feminino",
- "maritalStatus": "Solteiro",
- "education": "Superior Completo",
- "nationality": "Brasileiro",
- "birthplace": "Belo Horizontino",
- "fatherName": "João",
- "motherName": "Maria",
- "zipCode": "00.000-000",
- "neighborhood": "Savassi",
- "city": "Belo Horizonte",
- "stateAcronym": "MG",
- "streetName": "Rua Tomé de Souza",
- "number": 1,
- "additionalInformation": "Apto 1",
- "phone": "(31) 33333333",
- "cellPhone": "(31) 999999999",
- "emergencyPhoneNumber": "(31) 999999999",
- "personalEmail": "email@gmail.com",
- "corporateEmail": "email@example.com.br",
- "departamentId": 1,
- "positionId": 1,
- "typeContract": "CLT",
- "dateContract": "01/01/2018",
- "durationContract": "12 meses",
- "contractExpirationDate": "12/09/2019",
- "registration": 3819,
- "salary": 3798.9,
- "workShift": "Diurno",
- "hierarchicalLevel": "Alto",
- "dateAdmission": "01/01/2018",
- "dateDismissal": "02/01/2019",
- "idNumber": 22426759666,
- "rg": 390569422,
- "data_expedicao": "02/01/2019",
- "orgao_expedidor": "SSP",
- "cpf": 1234567890,
- "voterRegistration": 282850080221,
- "electoralZone": 131,
- "electoralSection": "Seção 29",
- "ctpsNum": 22426759,
- "ctpsSerie": 2242,
- "reservist": 39330569422,
- "nqc": 29998619616,
- "bank": "Bradesco",
- "agency": 2202,
- "checkingsAccount": "0186958-2",
- "pis": 48348426997,
- "unityId": 1,
- "ethnicity": "Outro"
}
Demitir um colaborador
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
Parâmetros para registrar um colaborador.
externo_id | string Identificador externo do registro |
dateDismissal | string Data da demissão do(a) colaborador(a) |
formDismissal | string forma da demissão |
decisionDismissal | string decisão da demissão |
reasonDismissalId | integer identificador único do motivo de demissão |
terminationAmount | number <float> <= 99999999.99 valor da recisão |
{- "externo_id": 1548799,
- "dateDismissal": "14/07/2017",
- "formDismissal": "sem_justa_causa",
- "decisionDismissal": "pediu_saida",
- "reasonDismissalId": 1,
- "terminationAmount": 3798.9
}
Cria ou atualiza Informações personalidadas de um colaborador
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
Parâmetros para registrar um colaborador.
externo_id | string Identificador externo do registro |
chave_formulario | string |
object |
{- "externo_id": 1548799,
- "chave_formulario": "chave_formulario",
- "customInformations": {
- "campo_1": "valor campo"
}
}
Cria ou atualiza currículo
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
Parâmetros para registrar um novo Cargo.
externo_id | string Identificador externo do registro |
fullName | string Nome |
mainEmail | string e-mail Principal |
secondaryEmail | string e-mail Secundario |
idNumber | string CPF |
gender | string Genero |
phone | string Número do Telefone |
mobile | string Celular |
birthDate | string Data de Nascimento |
maritalStatus | string Estado Civil |
seniority | string Senioridade |
skypeGtalk | string Identificador externo do registro |
string Link do Linkedin | |
string Link do Facebook | |
youtube | string Link do youtube |
introductionVideoURL | string Link do vídeo |
origin | string Origem |
zipCode | string CEP |
number | string Número |
street | string Nome da Rua |
district | string Bairro |
state | string Estado |
city | string Cidade |
additionalInformation | string Complemento |
disabledPerson | boolean Portador de Necessidade |
object | |
object | |
object |
{- "externo_id": "externo_id",
- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@email.com.br",
- "secondaryEmail": "secundary@email.com.br",
- "idNumber": 11111111111,
- "gender": "Feminino",
- "phone": "3123-4567",
- "mobile": 988883333,
- "birthDate": "01/01/2000",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "nickGTalk",
- "origin": "Banco de Talentos",
- "zipCode": "33333-888",
- "number": 1234,
- "street": "Rua X",
- "district": "Centro",
- "state": "MG",
- "city": "Belo Horizonte",
- "additionalInformation": "Apto 12345",
- "disabledPerson": true,
- "languages": {
- "name": "Português",
- "level": "Fluente"
}, - "academicEducations": {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "01/01/2000",
- "endDate": "01/01/2004",
- "grade": "Doutorado"
}, - "professionalExperiences": {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "01/01/2000",
- "endDate": "01/01/2004",
- "activitiesDescription": "Desenvolvedor JAVA"
}
}
{- "id": 123456,
- "candidato_id": null,
- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@email.com.br",
- "secondaryEmail": "secundary@email.com.br",
- "idNumber": 11111111111,
- "sexo": "Feminino",
- "phone": "3123-4567",
- "mobile": 988883333,
- "birthDate": "01/01/2000",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "nickGTalk",
- "origin": "Banco de Talentos",
- "zipCode": "33333-888",
- "number": 1234,
- "street": "Rua X",
- "district": "Centro",
- "state": "MG",
- "city": "Belo Horizonte",
- "additionalInformation": "Apto 12345",
- "disabledPerson": true,
- "languages": {
- "name": "Português",
- "level": "Fluente"
}, - "academicEducations": {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "01/01/2000",
- "endDate": "01/01/2004",
- "grade": "Doutorado"
}, - "professionalExperiences": {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "01/01/2000",
- "endDate": "01/01/2004",
- "activitiesDescription": "Desenvolvedor JAVA"
}
}
Busca currículo externo
externo_id required | string identificador único do sistema, pode ser id do currículo da empresa ou e-mail principal do candidato |
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
{- "externo_id": "externo_id",
- "fullName": "Maria de Fátima Souza",
- "mainEmail": "principal@email.com.br",
- "secondaryEmail": "secundary@email.com.br",
- "idNumber": 11111111111,
- "sexo": "Feminino",
- "phone": "3123-4567",
- "mobile": 988883333,
- "birthDate": "01/01/2000",
- "maritalStatus": "Solteiro",
- "seniority": "Trainee",
- "skypeGtalk": "nickGTalk",
- "origin": "Banco de Talentos",
- "zipCode": "33333-888",
- "number": 1234,
- "street": "Rua X",
- "district": "Centro",
- "state": "MG",
- "city": "Belo Horizonte",
- "additionalInformation": "Apto 12345",
- "disabledPerson": true,
- "languages": [
- {
- "name": "Português",
- "level": "Fluente"
}
], - "academicEducations": [
- {
- "course": "Ciência da Computação",
- "institution": "Instituição",
- "startDate": "01/01/2000",
- "endDate": "01/01/2004",
- "grade": "Doutorado"
}
], - "professionalExperiences": [
- {
- "position": "Desenvolvedor",
- "company": "Empresa Y",
- "startDate": "01/01/2000",
- "endDate": "01/01/2004",
- "activitiesDescription": "Desenvolvedor JAVA"
}
]
}
Lista departamento externo
externo_id required | string identificador único do cargo |
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
{- "externo_id": "externo_id",
- "name": "TI",
- "employee_id": 123
}
Cria ou atualiza um novo departamento externo
Target-System required | string identificador único do sistema |
Accept | string Conteúdo a ser enviado |
Content-Type | string Conteúdo a ser enviado |
Criar Departamento.
externo_id | string Identificador único do cargo externo |
name | string Nome do departamento |
employee_id | integer Identificador externo do colaborador responsável |
{- "externo_id": "externo_id",
- "name": "TI",
- "employee_id": 123
}
{- "externo_id": "externo_id",
- "name": "TI",
- "employee_id": 123
}
Lista de posições externo por externo_id
externo_id required | string identificador único do cargo |
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
{- "externo_id": "externo_id",
- "numero_posicao": 50,
- "amei": "amei1",
- "buscar_mercado": false,
- "buscar_mercado_nome": "",
- "colaborador_matricula": 123456,
- "colaborador_nome": "João Silva Souza",
- "derivado_outro": "Derivado",
- "designacao_local_posicao": "desig -local",
- "designacao_posicao_grupo": "Desig Grupo",
- "gg_unit": "gg_unit",
- "local_posicao": "Local Posicao",
- "local_site": "Local Site",
- "position_career": "Posição Carreira",
- "rh_bp": "RH BP",
- "vp_diretoria": "VP Diretoria",
- "cargo": {
- "id": 123456,
- "nome": "Analista Fiscal"
}, - "colaborador": {
- "id": 123456,
- "nome": "João Silva Souza"
}, - "departamento": {
- "id": 123456,
- "nome": "Contabilidade"
}
}
Lista de posições externo
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
[- {
- "id": "123456Abcd",
- "numero_posicao": 200,
- "nome_cargo": "Analista de RH",
- "nome_departamento": "Departamento Financeiro",
- "colaborador_matricula": 123456,
- "colaborador_nome": "Fernanda M.",
- "Vinculos_Externos": "Unknown Type: Array"
}
]
Cria ou atualiza posições externas
Target-System required | string identificador único do sistema |
Accept | string |
Content-Type | string Tipo de conteúdo |
Parâmetros para registrar um novo Cargo.
externo_id | integer Identificador único do departamento |
numero_posicao | string Número de posições |
amei | string |
buscar_mercado | boolean |
buscar_mercado_nome | string |
colaborador_matricula | number Matrícula do colaborador |
colaborador_nome | string Nome do colaborador |
derivado_outro | string |
designacao_local_posicao | string |
designacao_posicao_grupo | string |
gg_unit | string |
local_posicao | string |
local_site | string |
position_career | string |
rh_bp | string |
vp_diretoria | string |
cargo_id | number Id do Cargo |
colaborador | number Id do Colaborador |
departamento | number Id do Departamento |
{- "externo_id": "externo_id",
- "numero_posicao": 5008,
- "amei": "amei1",
- "buscar_mercado": false,
- "buscar_mercado_nome": "",
- "colaborador_matricula": 123456,
- "colaborador_nome": "João Silva Souza",
- "derivado_outro": "Derivado",
- "designacao_local_posicao": "desig -local",
- "designacao_posicao_grupo": "Desig Grupo",
- "gg_unit": "gg_unit",
- "local_posicao": "Local Posicao",
- "local_site": "Local Site",
- "position_career": "Posição Carreira",
- "rh_bp": "RH BP",
- "vp_diretoria": "VP Diretoria",
- "cargo_id": 123456,
- "colaborador": 123456,
- "departamento": 123456
}
Lista de unidades externo por externo_id
externo_id required | string identificador único do cargo |
Target-System required | string identificador único do sistema |
Content-Type | string Tipo de conteúdo |
{- "id": 1,
- "name": "Tecnologia"
}
Cria ou atualiza unidades
Target-System required | string identificador único do sistema |
Content-Type | string Tipo de conteúdo |
Parâmetros para registrar uma nova unidade.
externo_id | integer Identificador único da unidade |
name | string Nome da unidade |
{- "externo_id": "externo_id",
- "name": "Tecnologia"
}
Lista Vinculo Externo
Content-Type | string Tipo de conteúdo |
Accept | string |
[- {
- "id": 1,
- "tipo": "Curriculo",
- "descricao": "Nome Pessoa",
- "email": "email@email.com.br",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
]
Cria ou atualiza Vinculo Externo
Content-Type | string Conteúdo a ser enviado |
Accept | string |
Parâmetros para registrar um novo vinculo.
Array of objects (Vinculo_Externos@criar) |
{- "vinculo_externos": [
- {
- "id": 1,
- "tipo": "Curriculo",
- "sistema": "totvs",
- "externo_id": "9f662cbe-8310-4d5a-9603-32614883d6ac"
}
]
}
Cria ou atualiza Profiler
Accept | string |
Parâmetros para registrar um novo Cargo.
name | string |
string | |
idNumber | number |
gender | string |
tipo_relatorio | string |
start | string |
end | string |
C821 | boolean |
alegre1 | boolean |
animado1 | boolean |
ativo1 | boolean |
audacioso1 | boolean |
autodisciplinado1 | boolean |
barulhento1 | boolean |
bemhumorado1 | boolean |
C822 | boolean |
alegre2 | boolean |
animado2 | boolean |
ativo2 | boolean |
audacioso2 | boolean |
autodisciplinado2 | boolean |
autosuficiente2 | boolean |
barulhento2 | boolean |
{- "name": "Usuario Teste",
- "email": "usuarioteste@mail.com",
- "idNumber": 12365445585,
- "gender": "Feminino",
- "tipo_relatorio": "simples",
- "start": "2020-01-21 16:00:00",
- "end": "2020-01-21 16:10:00",
- "C821": true,
- "alegre1": true,
- "animado1": true,
- "ativo1": true,
- "audacioso1": true,
- "autodisciplinado1": true,
- "barulhento1": true,
- "bemhumorado1": true,
- "C822": true,
- "alegre2": true,
- "animado2": true,
- "ativo2": true,
- "audacioso2": true,
- "autodisciplinado2": true,
- "autosuficiente2": true,
- "barulhento2": true
}
{- "id": 1,
- "link": "www.example.com",
- "created_at": "05/05/2020",
- "expirationDate": "05/05/2020",
- "resultType": "simple",
- "limit": 5,
- "totalUsed": 1,
- "emailResult": true,
- "user": {
- "id": 5,
- "name": "Foo Bar",
- "email": "foo@bar.com",
- "picture": "www.example.com",
- "total": 5,
- "access_level": 5,
- "show_v2_presentation": true,
- "peopleId": 5,
- "role": "gestor"
}
}
Cria ou atualiza Link Genérico
Parâmetros para registrar um novo Cargo.
expirationDate | string |
limit | string |
resultType | string |
emailResult | boolean |
{- "expirationDate": "31/12/2050",
- "limit": 5,
- "resultType": "Simple",
- "emailResult": true
}
Webhooks dão aos clientes a possibilidade de se cadastrarem para receberem requisições web mediante determinados acontecimentos no Gestão (eventos), os eventos somente são enviados em ambiente de produção.
Configuração
A configuração do webhook se dá dentro do gestão basta acessar o menu Configurações >> Configuração do Webhook, onde será possível a criação do endpoint informando a URL, o evento, Ativação e desativação alem da configuração dos headers.
Headers
Quando se cadastra um webhook no gestão há a possibilidade de se informar os headers que serão enviados. Os Headers são valores fixos.
Eventos Disponíveis
Quando um Webhook é cadastrado, os eventos disponiveis para disparo são
Sempre que um colaborador é criado no gestão, o Webhook é enviado com o seguinte payload:
{ "acao": "novo_colaborador", "data_criacao": "11/01/2022 11:49:19 ", "dados":{ "nome": "Valentina G. F. N. ", "email": "v_n@localhost.com ", "matricula": " ", "data_nascimento": "01/01/1993 ", "sexo": "Feminino ", "estado_civil": " ", "nacionalidade": " ", "naturalidade": " ", "nome_pai": " ", "nome_mae": " ", "pne":false, "escolaridade": "Curso extra-curricular ", "saudacao": " ", "data_admissao": "11/01/2022 ", "salario": "R$ 0,00 ", "total_beneficios": "R$ 0,00 ", "data_demissao": " ", "grau_hierarquico": "Alto ", "tipo_contrato": " ", "data_contrato": " ", "duracao_contrato": " ", "vencimento_contrato": " ", "turno": " ", "criado_em": "11/01/2022 11:47:46 ", "atualizado em": "11/01/2022 11:47:46 ", "departamento":{ "id":29381, "nome": "A.R.G. SA - APOIO ADMINIST CENTRAL ", "vinculo_externos":[] }, "cargo":{ "id":64848, "nome": "A-HISTORICO ", "piso_salarial": "R$ 0,00 ", "vinculo_externos":[] }, "endereco":{ "cep":null, "logradouro":null, "complemento":null, "numero":null, "bairro":null }, "contato":{ "telefone":null, "celula":null, "emergencia":null, "emai":null, "email_empresaria":null }, "documentos":{ "cpf": "60353418102 ", "rg": " ", "titulo_eleitor": " ", "zona_eleitoral": " ", "secao_eleitoral": " ", "ctps_num": " ", "ctps_serie": " ", "reservista": " ", "cnh": " ", "banco": " ", "agencia": " ", "conta_corrente": " ", "pis": " " }, "observacoes":[], "vinculo_externos":[] } }
Sempre que um colaborador é editado no gestão, o Webhook é enviado com o seguinte payload:
{ "acao":"edicao_colaborador", "data_criacao":"11/01/2022 09:14:01", "dados":{ "nome":"José Pereira Silva", "email":"email@exemplo.com", "matricula":"123", "data_nascimento":"15/05/1969", "sexo":"Feminino", "estado_civil":"Casado", "nacionalidade":"", "naturalidade":"", "nome_pai":"", "nome_mae":"", "pne":false, "escolaridade":"Médio Completo", "saudacao":"", "data_admissao":"01/12/1998", "salario":"R$ 0,00", "total_beneficios":"R$ 0,00", "data_demissao":"", "grau_hierarquico":"Baixo", "tipo_contrato":"", "data_contrato":"", "duracao_contrato":"", "vencimento_contrato":"", "turno":"", "criado_em":"04/07/2019 09:58:59", "atualizado em":"11/01/2022 09:14:01", "departamento":{ "id":123456, "nome":"Pesquisa", "vinculo_externos":[] }, "cargo":{ "id":123456, "nome":"TECNICO EM DOCUMENTAÇÃO", "piso_salarial": null, "descricao": null "atividades": null "vinculo_externos":[] }, "endereco":{ "cep":null, "logradouro":null, "complemento":null, "numero":null, "bairro":null }, "contato":{ "telefone":null, "celular":null, "emergencia":null, "email":null, "email_empresarial":null }, "documentos":{ "cpf":"12345678912", "rg":"1234568", "titulo_eleitor":"", "zona_eleitoral":"", "secao_eleitoral":"", "ctps_num":"", "ctps_serie":"", "reservista":"", "cnh":"", "banco":"", "agencia":"", "conta_corrente":"", "pis":"" }, "observacoes":[], "vinculo_externos":[] } }
Sempre que um colaborador é demitido no gestão, o Webhook é enviado com o seguinte payload:
{ "acao":"demissao_colaborador", "data_criacao":"29/12/2021 09:15:44", "dados":{ "nome":"José Pereira Silva", "email":"email@exemplo.com", "matricula":"123", "data_nascimento":"15/05/1969", "sexo":"Feminino", "estado_civil":"Casado", "nacionalidade":"", "naturalidade":"", "nome_pai":"", "nome_mae":"", "pne":false, "escolaridade":"Médio Completo", "saudacao":"", "data_admissao":"01/12/2021", "salario":"R$ 0,00", "total_beneficios":"R$ 0,00", "data_demissao":"01/12/2022", "grau_hierarquico":"Baixo", "tipo_contrato":"", "data_contrato":"", "duracao_contrato":"", "vencimento_contrato":"", "turno":"", "criado_em":"04/07/2019 09:58:59", "atualizado em":"11/01/2022 09:14:01", "departamento":{ "id":123456, "nome":"Pesquisa", "vinculo_externos":[] }, "cargo":{ "id":40740, "nome":"LIDER", "piso_salarial":"R$ 2.000,00", "descricao": null "atividades": null "vinculo_externos":[] }, "endereco":{ "cep":"12345123", "logradouro":"Rua 01", "complemento":null, "numero":"1139", "bairro":"Nova Cachoeirinha", "cidade":{ "nome":"Belo Horizonte", "estado":{ "nome":"Minas Gerais", "sigla":"MG" } } }, "contato":{ "telefone":null, "celular":null, "emergencia":null, "email":null, "email_empresarial":null }, "documentos":{ "cpf":"12345678912", "rg":"1234568", "titulo_eleitor":"", "zona_eleitoral":"", "secao_eleitoral":"", "ctps_num":"", "ctps_serie":"", "reservista":"", "cnh":"", "banco":"", "agencia":"", "conta_corrente":"", "pis":"" }, "observacoes":[], "vinculo_externos":[] } }
Sempre que uma ocorrência é atribuída á um colaborador no gestão, o Webhook é enviado com o seguinte payload:
{ "acao":"nova_ocorrencia", "data_criacao":"19/10/2021 22:26:45", "dados":{ "colaborador_nome":"José Pereira da Silva", "colaborador_email":"email@exemplo.com.br", "data_ocorrencia":"20/10/2021", "classificacao":"Neutro", "comentario":"Ausência Justificada", "valor":"0,00", "tipo_ocorrencia":"Falta/Ausência" } }
Sempre que uma resposta de uma pesquisa é registrado no gestão, o Webhook é enviado com o seguinte payload:
{ "acao": "nova_resposta_pesquisa", "data_criacao": "13/07/2020 16:22:59", "dados":{ "pesquisa_id": 403370, "descricao_Pesquisa": "Este é um convite para reflexão sobre alguns pilares estratégicos sobre sua carreira "titulo_pesquisa": "Carreira 2020", "criado_em": "13/07/2020 20:22:59", "respostas":[ { "pergunta_id": 123456, "pergunta": "Quais são os seus objetivos de carreira de curto, médio e longo prazo?", "pergunta_posicao": 0, "resposta": "Curto prazo é permanecer como Gerente de Engenharia, Manutenção e Utilidades "alternativa_id": null, "numero_alternativa": null }, { "pergunta_id": 15140989, "pergunta": "Face aos seus objetivos de carreira, o que você considera como seus pontos fortes? "pergunta_posicao": 1,"resposta": "Como meus pontos fortes destaco a Liderança, assim como o Comprometimento e a Confiança. "alternativa_id": null, "numero_alternativa": null } ], "respondente": { "id": 123456, "nome": "Antonio Pereira Silva", "vinculo_externos": [ { "externo_id": null, "target_system": null } ] } } }
Sempre que um currículo é criado no gestão, o Webhook é enviado com o seguinte payload:
{ "acao":"novo_curriculo", "data_criacao":"05/05/2022 10:55:53", "dados":{ "nome_completo":"Valentina Campos", "email_principal":"valentinac@localhost.com", "email_secundario":"", "sexo":"feminino", "telefone":"(31) 3333-3333", "celular":"(31) 99999-9999", "skype_gtalk":"skype/gc", "linkedin":"linkedin/gc", "facebook":"facebook/gc", "youtube":"youtube/gc", "data_nascimento":"01/01/1990 00:00:00", "estado_civil":"Casado", "senioridade":"directors", "created_at":"05/05/2022 10:55:53", "updated_at":"05/05/2022 10:55:53", "endereco":{ "cep":"12.345-678", "logradouro":"Rua 01", "complemento":"Casa", "numero":"280", "bairro":"Santana do Norte", "cidade":{ "nome":"Belo Horizonte", "estado":{ "nome":"Minas Gerais", "sigla":"MG" } } }, "cpf":"12345678910", "contratado":false, "portador_necessidade":false, "tipo_necessidade_especial":"", "banco_talento":false, "pretensao_salarial":"12000.0", "favoritado":false, "visualizado":false, "url_video_apresentacao":"youtube/gc/1214@#$$", "origem":"Jobs", "sobre_mim":"", "nacionalidade":"Brasileiro", "naturalidade":"Belo Horizonte", "cnh":"12312121322313213", "cnh_categoria":"AB", "cnh_data_emissao":"05/05/2022 00:00:00", "cnh_data_primeira_habilitacao":"05/05/2022 00:00:00", "cnh_uf":"Rio Grande do Sul", "rg":null, "ctps_num":"123456", "ctps_serie":"55", "instagram":"instagram/gc", "twitter":null, "whatsapp":null, "primeiro_emprego":null, "turno":null, "fds_feriado":null, "escolaridade":"curso", "banido":false, "banido_em":"", "portador_deficiencia":false, "tipo_deficiencia":null, "adaptacao_necessidade_especial":null, "url_portfolio":null, "telefone_ddi":"55", "whatsapp_ddi":"55" } }