Akitasoft REST API

gustavo_siqueira

Essa nova API tem como objetivo realizar a integração com o sistema Akitasoft.
Inicialmente conta com dois endpoints: um para retorno dos tipos de pessoas cadastrados no Akita; e o outro para inserir/atualizar pessoas no sistema.

Links úteis:

documentação de consumo da API - https://akitasoftrestapi.docs.apiary.io/#
repositório do projeto - https://gitlab.insoft4.com.br/apis/akitasoft-rest-api
pasta na rede com deploys das versões - O:\Sistemas_Java\AkitasoftRestApi

Histórico de versões

v1.0.1

2021-07-21. Gustavo. OS9559. Criação do akitasoft-rest-api para integração de cadastros de pessoas com sistema de terceiro.

Felipe Dietrich

@gustavo_siqueira
v1.0.4

OS9806. Adicionar endpoint "/afastamentos", permitindo consulta, inclusão, alteração e exclusão de afastamentos na base do Akita Soft através desta API.

OS9831. Adicionar endpoint "/cadastroFoto" que espera uma requisição POST.

URL da documentação do método:
https://akitasoftrestapi.docs.apiary.io/#reference/0/cadastrar-foto/cadastrar-foto

Parâmetros são enviados no formato JSON. É necessário enviar um dos dados da pessoa:
- codIntegracao
- cpf
- rg e ufRg
- outroDocumento
Deve-se enviar também a foto no formato base64 através do atributo "imagemFoto".
A foto será salva no destino especificado no programa PSW5560 conforme o valor salvo nos campos "Armazena Foto Banco" ou "Diretório Armazenagem". Caso a foto seja armazenada na rede, terá como nome "codPessoa.png" (ex: 12345.png).

Jeferson S.

OS9893. Adicionar endpoints:

\eventosIngresso: permitindo consulta de eventos (tickets_eventos), junto com as repetições (tickets_repeticoes) e setores (tickets_setores) associados ao mesmo.
- Parâmetro nomeEvento para consulta é enviado junto a URL. Esse parâmetro pode conter o nome completo do evento ou parte do mesmo.

\ingresso: permitindo consulta (GET), inclusão (POST) e exclusão (DELETE) de ingressos (tickets_ingressos) na base do Akita
- Parâmetros para consulta, enviados junto a URL: dataInicial, dataFinal ou codigo
- Junto com o Ingresso devem ser enviado os ingressos dependentes, assim os mesmos vão ter a mesma configuração do ingresso Responsável:
- Exemplo dos parâmetros no formato JSON para inclusão de ingresso:
```
 {
"codigo": "123456789012",
"dtHrInicial": "2022-02-21T00:00:00",
"dtHrFinal": "2022-02-22T00:00:00",
"idRepeticao": "17",
"idSetor": "48",
"limite": "1",
"restricao": "0",
"tipo": "INTEIRA",
"dependentes": [
    {
      "codigo": "12345"
    },
    {
      "codigo": "67890"
    }
  ]
 }
```
- Parâmetro no formato JSON para exclusão de ingresso:
  codigo
  OBS: oa remover um ingresso de Responsável os ingressos Dependentes são removidos também!

\consultaAcessosIngressos: permitindo consulta de acesso dos ingressos (tickets_acessos), listando junto o ingresso responsável, também o relógio e status de acesso.
- Parâmetros para consulta, enviados junto a URL: dataInicial, dataFinal ou codigo

jhartmann

1.0.5

OS9892

Corrigir tamanho do campo serieCtps para tamanho máximo de 6 caracteres, nas classes de domínio que possuem esse atributo mapeado.

jhartmann

1.0.7
10241

Retornar mensagens da aplicação somente em português, evitando conflito com o idioma do sistema implantado.

Jeferson S.

1.0.8
10257

akitasoft-rest-api

Adicionado na tabela INTFOL_CADASTROS_PESSOAS as colunas data_cadastros e data_desligamento
Mapeado dataCadastro e dataDesligamento na IntfolCadastroPessoa, e utilizar as mesmas no processo de incluir as pessoas.
Ajustado processo de inserir TIPO_CONTROLE_PESSOA, para considerar dataCadastro e dataDesligamento.
Incluído atz_perfil_pessoa depois de atualizar todos os dados de pessoa

PACK_REGRAS_ACESSO

Alterados procedimentos de inclusão e alteração do histórico de pessoa (tipos_controles_pessoas) para verificar se ao incluir/alterar registro de pessoa ativa não existe um afastamento ativo com motivo de rescisão. Se houver, encerra o afastamento com data do dia anterior a data de cadastro do novo registro. (Ajuste incluído em função de registros antigos quando essa funcionalidade de incluir afastamento por desligamento estava ativa, atualmente não é mais utilizada em novos desligamentos).

Jeferson S.

v2.0.0
OS10337. Migração para Grails 5 e adequações para a versão 7 do Akita Soft.
Nesta nova versão deve ser utilizado Java 11.

Compatibilidade com GT:
Para cliente que tem integração entre GT e Akita.

GTSoft 3.0.2.0 e gtsoft-rest-api 1.4.0

Esta versão não é compatível com a versão 6 dos sistemas!

Diretório akitasoft-rest-api: O:\Sistemas_Java\AkitasoftRestApi\v2.0.0 - Grails 5

Documentação da api: https://akitasoftrestapiv7.docs.apiary.io/#

Novo endpoit

/site: lista todas as plantas cadastradas

endpoits alterados

/controlePessoa: adiconaro parametro nroSite

/afastamentoPessoa: Para inserir ou alterar deve ser enviado o tcpId e não mais o conjunto pessoa{}

/dependentes: Para inserir ou alterar deve ser enviado tcpId e tcpIdResponsavel e não mais codPessoa e codPessoaResponsavel

Leonardo Melzer

v2.2.0

OS10831:

Obs: gtsoft-rest-api deverá ser atualizada para a versão 1.5.0 para a comunicação correta entre as APIs

Esta manutenção inclui alterações no processamento de pessoas, prevendo alterações originadas de ponteiros de integração no GT Soft e aplicando as regras de negócio da versão 7 na persistência dos dados.

As seguintes configurações no application.yml externalizado são obrigatórias para que a comunicação ocorra como o esperado:

---
gt.url:  "http://server:port/gtsoft-rest-api/"
gt.username: "usuario-login-gt"
gt.password: "senha-login-gt"

Obs.: Note que a antiga configuração gt.urlAuth deverá ser substituída agora por gt.url

Felipe Dietrich

v2.4.2

Obs: gtsoft-rest-api deverá ser atualizada para a versão 1.7.2 para a comunicação correta entre as APIs

OS11490 / Solicitação 26186:

Ajustado fluxo de integração de pessoas do GT ao Akita, onde as operações são
realizadas de acordo com o tipo de registro integrado.

Diretório versão akita-sot-rest-api: O:\Sistemas_Java\AkitasoftRestApi\v2.4.2