plataformas
Integrações com o ERP
APIs que ligam o WinThor, o ERP da TOTVS usado pela empresa, aos sistemas internos. Yuri mapeou onde o ERP guarda cada informação e desenvolveu as consultas que entregam esses dados ao Atlas, direto do banco do ERP.
- Situação
- Em uso
- Autoria
- Projeto individual, do mapeamento das tabelas à entrada em uso, com apoio de agentes de IA.
01Cenário
Quase toda rotina da Controladoria e do Fiscal começa num dado do ERP: notas de entrada, títulos a pagar, produtos, bens. Sem acesso direto, cada sistema interno dependia de relatórios exportados e conferidos à mão, e o ERP não tem documentação aberta de onde guarda cada informação.
entrada
- WinThor (TOTVS)
APIs próprias
quem consome
- Atlas
- Robôs do Atlas
- Relatório exportado é uma fotografia: quando chega ao outro sistema, o dado pode já ter mudado.
- Cada rotina que precisava do ERP dependia de alguém gerar e importar o arquivo certo.
- Sem saber quais tabelas cada tela do ERP usa, não havia como consultar o dado com segurança.
02Abordagem
engenharia reversa
Rastreio das rotinas do ERP
Cada tela e relatório do ERP foi rastreado para descobrir quais tabelas e campos usa, e a consulta original virou a base da API.
desenvolvimento de API
Construção das consultas
As consultas ganharam parâmetros, paginação e um contrato documentado, com exemplos prontos para quem consome.
qualidade de dados
Conferência com o próprio ERP
Cada consulta foi executada numa cópia do ERP e comparada com o resultado da tela original antes de chegar à produção.
governança
Acesso de produção
Um inventário de cada tabela por finalidade (consulta, inclusão, alteração) virou o pedido de acesso à TI, sem nenhuma permissão de exclusão.
integração de sistemas
Integração com o Atlas
O Atlas e suas rotinas automáticas passaram a consumir as APIs, como na conferência diária de pagamentos.
03Decisão técnica
Escolhido
Consultar o banco do ERP direto, por APIs próprias, com um contrato que define o formato de cada resposta.
Descartado
Relatórios exportados do ERP e importados em cada sistema, um a um.
Motivo
O dado chega atualizado e no mesmo formato para todos os sistemas, sem depender de alguém gerar o arquivo.
04Quem consome as APIs
Todos os sistemas falam com o ERP pela mesma porta, cada um com a sua chave de acesso, e nenhum toca o banco do ERP diretamente.
APIs do ERP
Agendamentos
Títulos a pagar, para a conferência diária de pagamentos.
Conferência fiscal
Notas de entrada e itens, para comparar com a nota recebida.
Tributação e estoque
Produtos, cadastros fiscais e posição de estoque.
Fechamento e bens
Notas de entrada, bens, contas e centros de custo.
Devolução e remessa
Devoluções a fornecedor e remessas.
05O que as APIs entregam
≈ 55
pontos de acesso aos dados do ERP
≈ 12
tipos de dado: notas, títulos, produtos, bens, estoque e outros
87 tabelas
do ERP mapeadas por finalidade
≈ 10 módulos
do Atlas consumindo as APIs
0 exclusões
permitidas no ERP: o acesso cobre só o que cada uso precisa
2 rotinas
automáticas do Atlas apoiadas nas APIs
Ganhos na operação
- Os sistemas internos consultam o ERP direto, pela mesma porta, em vez de importar relatório.
- A conferência de pagamentos virou rotina diária: a nota quitada é marcada sozinha.
- Se o ERP para de responder, o sistema que consome segue funcionando e mostra o motivo.
- Cada consulta tem contrato documentado, com exemplos prontos para quem vai usar.
- Cada sistema acessa o ERP com chave própria e limite de consultas.
06Destaques técnicos
Engenharia reversa do ERP
Sem documentação aberta, a consulta de cada tela foi recuperada pelo rastreio da própria rotina do ERP e conferida linha a linha com o original.
Contrato de consumo
Cada consulta publica o formato da resposta, com paginação padronizada; o Atlas confere tudo o que recebe antes de usar.
Acesso entre sistemas por chave
Cada sistema tem chave própria, guardada só em forma cifrada, com limite de consultas por minuto.
Gravação com travas e rastro
A gravação no ERP exige permissão por chave e por tipo de operação, confere o banco de destino e desfaz tudo se o registro de auditoria não bater.
Reenvio sem duplicar
Reenviar a mesma operação não cria um segundo documento: cada envio carrega uma referência única, conferida antes de gravar.
Cota dividida entre os módulos
Todos os módulos usam a mesma cota de consultas; as rotinas automáticas espaçam as chamadas para sobrar espaço aos outros.
Tecnologias
- Linguagens
- TypeScript
- SQL
- Runtime e contêineres
- Docker
Termos desta página
- WinThor
- O ERP da TOTVS usado pela empresa
- ERP
- Sistema de gestão usado por toda a empresa
- API
- Ponte para um sistema consultar outro
- Rastreio
- Registro das consultas que uma tela faz
- Contrato
- Formato combinado dos dados de uma resposta
- Chave de acesso
- Senha própria de cada sistema