Senior API SDK para Java

Esta biblioteca permite desenvolvedores criar integrações das APIs do HCM da Senior.

Instalação

Usando Maven

1. Executar mvn clean install, após a execução do comando Senior API SDK para Java estará instalado no repositório local do maven.

2. Adicionar a dependência Senior HCM no pom.xml do seu projeto

  ...
  <dependencies>
      <dependency>
          <groupId>br.com.senior</groupId>
          <artifactId>senior-hcm-java</artifactId>
          <version>{version}</version>
      </dependency>
  </dependencies>
  ...

3. Para obter a última versão da SDK verifique no repositório. https://mvnrepository.com/artifact/br.com.senior/senior-hcm-java

Ambiente

Atualmente o ambiente padrão para o desenvolvimento é o da Homologx. Para fazer a troca do ambiente basta chamar o construtor da api passando um dos Environments configurados:

public enum Environment {

    PROD("https://api.senior.com.br"),
    HOMOLOG("https://platform-homologx.senior.com.br/t/senior.com.br/bridge/1.0");

    private final String url;

    Environment(String url) {
        this.url = url;
    }
}

Exemplo Rápido

Implementamos no pacote /src/test/java/br/com/senior/hcm um conjunto de testes de integração para cada serviço. Alguns serviços dependem de variáveis que precisam ser informadas pelos usuários, como login e senha.

O ambiente pode ser definido no construtor de cada client, por padrão é utilizado o ambiente de homologação.

Os testes servem como exemplos de implementação, basta copiar o código do exemplo que se deseja para sua aplicação.

Utilizando como exemplo o dependentQuery, basta instanciar o client utilizando o token, retornado pelo login, após isto criar o payload de entrada informando os parâmetros e passando para o client:

    ...
    DependentClient client = new DependentClient(token);
    DependentQueryInput input = new DependentQueryInput(dependentId);
    DependentQueryOutput output = client.dependentQuery(input);
    ...

Definir as seguintes variáveis de ambiente:

Para mudar o ambiente para produção é necessário informar o environment ao chamar o construtor do Client:

  AuthenticationClient client = new AuthenticationClient(Environment.PROD);

SENIOR_USERNAME=<usuario>
PASS=<senha_do_usuario>

Entidades

Implementamos a parte de utilidades para entidades, para facilitar as requisições realizadas para as mesmas. Conforme exemplos abaixo:

Como realizar uma chamada rest de uma entidade:

// Criando um filtro, caso seja necessário.
// Tendo como retorno o seguinte: ?filter=id eq 123
String filter = new FilterBuilder().field("id").equals("123").build();

// O Objeto.class define ao objeto da entidade que você deseja requisitar.
// Disponibiliamos as classes das entidades públicas no pacote pojos de cada módulo.
Objeto retorno = new EntitiesUtils<>(dominio, serviço, token de autenticação, Objeto.class).executeGet(entity_name, filter);

Entidades do Recruitment

• Currículo - Resume.java
• Contato telefônico (Currículo) - ResumePhoneContact.java
• Educação (Currículo) - EducationSection.java
• Experiência profissional (Currículo) - ProfessionalExperienceSection.java
• Vaga de emprego - Vacancy.java
• Processo seletivo do candidato - RecruitmentProcess.java
• Etapa do processo seletivo do candidato - RecruitmentProcessStage.java
• Compromisso do processo seletivo - Appointment.java

Entidades do Payroll

• Histórico de natureza de despesa - HistoricalExpenseNature.java
• Histórico de movimentação de um colaborador - Movimentation.java
• Vínculo do telefone de contato com a pessoa - Personphonecontact.java
• Documentação de uma pessoa - Document.java
• Histórico de sindicato - Syndicate.java
• Aviso Prévio - PriorNotice.java
• Histórico de posto de trabalho - HistoricalJobPosition.java
• Histórico de afastamento - Historicalleave.java
• Histórico de horário - HistoricalWorkshift.java
• Tipo de atuação - Actingtype.java
• Estrutura do posto de trabalho - Workstationgroupstructure.java
• Pessoa - Person.java
• Histórico de centro de custo - HistoricalCostCenter.java
• Vínculo do colaborador - HistoricalEmploymentRelationship.java
• Histórico de categoria do eSocial - HistoricalEsocialCategory.java
• Outros contratos - OtherContract.java
• Telefone de contato - Phonecontact.java
• Local de trabalho - Department.java
• Endereço de email da pessoa - Email.java
• Conta bancária - Account.java

Entidades do Dependent

• Dependente - Dependent.java
• Tutela - Tutelage.java
• Auxílio creche - ChildcareAssistance.java
• Salário família - FamilySalary.java
• Documento do salário família - FamilySalaryDocument.java
• Dependente do imposto de renda - DependentIncomeTax.java
• Dependente do plano saúde - DependentHealthInsurance.java
• Pensão judicial - JudicialPension.java

Guia de contribuição

Suporte

Criar um issue https://github.com/dev-senior-com-br/senior-hcm-java/issues

License

Copyright © 2020.