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

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:
- 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. - 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.
- 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.