Pular para o conteúdo
Voltar para os projetos

Back-end

KTHAcerto

Acerto de viagem de ponta a ponta: a API que o app dos motoristas usa para lançar despesas, fichas e comprovantes, e as telas do ERP Sankhya em que os analistas conferem e aprovam ou reprovam os lançamentos.

Publicado em

Capa do projeto KTHAcerto sobre fundo escuro, com o monograma KA e as tecnologias Java, Sankhya, Oracle, PL/SQL e API REST

Tecnologias

  • Java
  • Sankhya
  • Oracle
  • PL/SQL
  • API REST

Sobre o projeto

Resumo

Em dez meses de uso, o módulo tirou do papel a prestação de contas das viagens. O motorista passou a lançar as próprias despesas e a enviar a foto do comprovante no mesmo momento.

  • Lançamentos feitos pelo app: 87.577 (90,9% de todos os lançamentos)
  • Comprovantes (imagens) enviados pelo app: 111.025 (87,8% de todas as imagens)
  • Motoristas usando o app por mês: ~1.160
  • Despesas do app com comprovante anexado: 99,9%
  • Mediana de dias entre a despesa e o registro: 1 dia no app, contra 5 a 8 dias no lançamento manual
  • Comprovações com participação do app: 94,3%
  • Comprovações encerradas com análise concluída: 100% (11.904 de 11.904, de nov/2025 a ago/2026)

O módulo

O KTHAcerto tem três partes que funcionam juntas:

  1. API (AppKothe-API): 11 serviços em Java no Sankhya. Oito são de consulta: visão geral, comprovações recentes, viagens, adiantamentos, despesas, fichas, tipos de despesa e imagens de um lançamento. Três são de gravação: salvar despesa, salvar ficha e enviar comprovantes. Cada tela do app faz uma única chamada ao banco. Os pacotes PL/SQL (PKG_APPACERTODEVIAGEM_P) já devolvem o JSON pronto, em vez de o Java juntar várias consultas.
  2. App Flutter, feito pelos colegas do time mobile, que consome a API. O motorista vê o saldo de adiantamentos e as despesas, lança despesas e fichas e fotografa os comprovantes.
  3. Telas no Sankhya para os analistas, onde eles revisam os lançamentos, aceitam, recusam ou aceitam com observação, e anexam documentos que faltaram sem sair do ERP.

Regras que protegem a qualidade dos dados:

  • Um lançamento só é aceito se a data estiver dentro do período da referência (dia 26 do mês anterior ao dia 25).
  • Novos lançamentos são recusados quando a análise já foi concluída ou a comprovação já foi entregue, e o motivo aparece para o motorista.
  • Cada comprovante pode ter no máximo 10 MB.
  • Se o envio do comprovante falhar, o arquivo é apagado e a despesa ligada a ele é removida. Assim não fica despesa sem comprovante.

Antes e depois

Antes: o motorista entregava papel ou mandava fotos dos comprovantes ao suporte de frota, que digitava tudo no sistema. Passavam dias entre a despesa e o registro, e o comprovante não ficava ligado ao lançamento no sistema, o que atrasava a aprovação.

Depois: o motorista registra a despesa e anexa a foto no próprio app. O analista recebe o lançamento já com a imagem vinculada.

Resultados em detalhe

O app virou o caminho principal desde o primeiro mês.

Despesas e fichas lançadas pelo app em cada mês, com a parte do total que passou pelo app e o número de motoristas:

  • nov/25: 843 despesas (100,0%), 5 fichas (100,0%), 130 motoristas
  • dez/25: 6.249 despesas (97,6%), 310 fichas (99,4%), 917 motoristas
  • jan/26: 10.253 despesas (91,9%), 1.511 fichas (91,5%), 1.194 motoristas
  • fev/26: 8.266 despesas (88,7%), 1.626 fichas (93,7%), 1.203 motoristas
  • mar/26: 8.484 despesas (89,8%), 1.489 fichas (92,8%), 1.203 motoristas
  • abr/26: 7.565 despesas (89,9%), 1.127 fichas (96,1%), 1.183 motoristas
  • mai/26: 7.860 despesas (90,6%), 1.094 fichas (95,0%), 1.166 motoristas
  • jun/26: 7.399 despesas (89,9%), 1.083 fichas (94,7%), 1.132 motoristas
  • jul/26: 7.441 despesas (88,3%), 976 fichas (93,2%), 1.136 motoristas
  • ago/26: 7.523 despesas (88,7%), 928 fichas (93,7%), 1.150 motoristas
  • set/26 (incompleto, até 24/09): 5.494 despesas (90,0%), 51 fichas (94,4%), 1.088 motoristas
  • Novembro/2025 foi o piloto, com 130 motoristas. Em janeiro/2026 já eram cerca de 1.200.
  • De março a agosto/2026 o uso ficou estável: ~7.700 despesas, ~1.100 fichas e ~11.900 imagens por mês pelo app, somando cerca de R$ 2,5 milhões por mês em despesas.
  • Nas comprovações que têm lançamentos, 94,3% tiveram participação do app e 67,7% foram feitas só pelo app. Apenas cerca de 5,7% dependeram só de digitação no Sankhya.

Conclusão

Os 87.577 lançamentos feitos pelo app deixaram de ser feitos pela equipe de Apoio à frota.

O que antes era feito às pressas no final da viagem e muitas vezes no final do período de acerto onde faltavam documentos. Passaram a ser feitos em tempo real chegando ao final do período do acerto com os lançamentos feitos e analisados.

Cerca de 10% ainda são lançados pelos analistas, de forma mais acessível, por motivos externos.

São aproximadamente 1200 motoristas mensais e cerca de 15 analistas do Apoio à frota utilizando o sistema.

Código fechado. O projeto roda em ambiente corporativo da Kothe SA.

Interações

Carregando as curtidas…