pontosoft-rep-p-api

mateusroerig

A API pontosoft-rep-p-api é responsável pela sincronização de marcações e empregadores com a Plataforma do REP-P. Além disso ela serve como meio de integração com o aplicativo REP-P Desktop e Ponto Soft REP-P Mobile.

Observação:
Para utilizar a integração com o REP-P Desktop e Ponto Soft REP-P Mobile é necessário que exista uma instância do insoft-auth (versão Spring Boot) conectado a base do Ponto Soft.

Instalação

Requisitos

Tomcat 9 com JDK 11
Instância do insoft-auth

Banco de dados

A aplicação deve estar conectada ao banco de dados do Ponto Soft
A coluna api_key_rep_p da tabela parametros_gerais_pontos deve estar configurada de acordo com o cadastro do cliente na base de dados do REP-P

Configuração

A aplicação pode ser configurada através de um arquivo externo application.yml, esse arquivo pode ser disposto de duas maneiras:

Na $HOME do usuário (somente unix):

$HOME/.grails/pontosoft-rep-p-apiConfig/application.yml

Diretório definido na propriedade JVM app.base.config.directory, por exemplo:
```
-Dapp.base.config.directory=C:/App/Tomcat/Config
```
No exemplo acima, o caminho do arquivo completo será o seguinte:
```
C:/App/Tomcat/Config/pontosoft-rep-p-apiConfig/application.yml
```

As configurações da aplicação devem ser definidas no application.yml de acordo com o contexto do sistema.

---
dataSource:
    # Configurações do banco de dados

---
pontosoft:
    repp:
        tipoSistema: ENTERPRISE # Tipo de sistema sendo ENTERPRISE ou EXPRESS
        cloudURL: 'http://localhost:8080/rep-p-rest-api' # URL da API rep-p-rest-api

---
api:
    authenticator:
        url: "http://localhost:8080/insoft-auth" # URL insoft-auth (necessário somente para utilizar o REP-P Desktop)

Documentação

A documentação está disponível no apiary pelo link: https://pontosoftreppapi.docs.apiary.io/

Jobs

Sincronização de empregadores

Responsável por cadastrar, atualizar ou deletar os empregadores na API rep-p-rest-api buscando os dados na tabela empregadores_rep_p em que a coluna data_sincronizacao é null.

Sincronização de marcações

Responsável por cadastrar as marcações na API rep-p-rest-api buscando os dados na tabela marcacoes_rep_p em que a coluna sincronizado_rep_p for igual a 'N' ou 'E'.

OBS: A tabela marcacoes_rep_p retém registros de marcações efetuadas pelo REP-P Desktop antes de efetivamente serem incluídas na acessos_funcionarios.