integracoes-erp.txt
Projetos

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.

entradaquem consomeAPIs própriasWinThor (TOTVS)AtlasRobôs do Atlas

entrada

  • WinThor (TOTVS)

APIs próprias

quem consome

  • Atlas
  • Robôs do Atlas
fluxoWinThor (TOTVS) → APIs próprias → Atlas e 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

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

  2. desenvolvimento de API

    Construção das consultas

    As consultas ganharam parâmetros, paginação e um contrato documentado, com exemplos prontos para quem consome.

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

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

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

Documentação de uma consulta, com os parâmetros e um exemplo de resposta.
Resposta de uma consulta, com dados fictícios.

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.

    Tecnologias e técnicas: SQL Oracle · rastreio de consultas

  • Contrato de consumo

    Cada consulta publica o formato da resposta, com paginação padronizada; o Atlas confere tudo o que recebe antes de usar.

    Tecnologias e técnicas: TypeScript · OpenAPI · Zod

  • Acesso entre sistemas por chave

    Cada sistema tem chave própria, guardada só em forma cifrada, com limite de consultas por minuto.

    Tecnologias e técnicas: Fastify · segurança

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

    Tecnologias e técnicas: Oracle · transações

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

    Tecnologias e técnicas: idempotência · SHA-256

  • 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 e técnicas: agendamento de rotinas

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