soluçõesMódulo do Atlas
Agendamentos e Recebimento
Módulo do Atlas, a plataforma interna de uma distribuidora em Manaus, que organiza a chegada de mercadorias ao centro de distribuição. Logística, Fiscal e Compras acompanham a mesma carga, do agendamento do caminhão ao pagamento da nota fiscal.
- Situação
- Em uso
- Quem usa
- Logística, Centro de distribuição, Fiscal e Compras
- Autoria
- Projeto individual, da análise do processo à entrada em uso, desenvolvido com apoio de agentes de IA.
01Cenário
Receber uma carga em Manaus não termina na descarga. Cada nota fiscal precisa ser liberada pela SEFAZ, a Secretaria da Fazenda do Amazonas, e tem uma taxa da SUFRAMA, o órgão que administra a Zona Franca de Manaus. Parte dos prazos de pagamento combinados com o fornecedor só começa a contar a partir da entrega ou dessa liberação. Cada área cuidava de um pedaço dessa informação, e o trabalho de uma dependia do que a outra havia preenchido.
chega
- Agenda da Logística
- Dados das notas
- Pagamentos do ERP
Agendamentos
áreas
- Logística e recebimento
- Fiscal
- Compras
- Sem a data informada por outra área, o prazo de pagamento da nota ficava em aberto.
- Notas de fornecedores diferentes com o mesmo número podiam receber o dado uma da outra.
- Não havia registro da chegada da carga: valia a data prevista.
- A planilha compartilhada aceitava uma pessoa editando por vez: enquanto uma área usava, as outras esperavam.
02Abordagem
análise de processo
Leitura do processo real
O controle anterior, uma planilha com macros em VBA criada pelo próprio Yuri, foi estudado por inteiro: 8 abas, 16 colunas e o que cada área preenchia.
especificação
Regras antes do código
As regras foram escritas e fechadas antes da construção: de onde vem cada dado e quem responde por ele.
integração de sistemas
Integração com o ERP
As tabelas do WinThor, o ERP da TOTVS, foram mapeadas e viraram uma API própria, que entrega à plataforma os títulos a pagar de cada nota.
desenvolvimento
Construção e entrada em uso
O módulo foi construído com testes automatizados, o histórico do ano veio da planilha e as áreas passaram a usá-lo em agosto de 2026.
melhoria contínua
Ajustes a partir do uso
O retorno das áreas virou novas funções, como a conferência diária de pagamentos e a confirmação do recebimento da véspera.
03Decisão técnica
Escolhido
Carga e nota como registros separados e ligados. O caminhão e a data pertencem à carga; cada nota tem o próprio andamento fiscal e o próprio prazo de pagamento.
Descartado
Uma linha por nota, como no controle anterior, com os dados do caminhão repetidos em cada uma.
Motivo
Os dados reais mostraram que a maioria dos caminhões traz mais de uma nota. Com a separação, remarcar a entrega é uma ação só, na carga inteira.
04Áreas envolvidas
Cada área edita apenas a parte que é dela. Toda alteração fica registrada com autor, data e valor anterior.
Uma carga
Logística
Agenda o caminhão e remarca a entrega quando necessário.
Centro de distribuição
Confirma a chegada da carga.
Fiscal
Acompanha a situação de cada nota na SEFAZ e na SUFRAMA.
Compras
Acompanha o vencimento e o pagamento de cada nota.
Rotinas automáticas
Buscam a liberação na SEFAZ, a taxa na SUFRAMA e o pagamento no ERP.
05O que o módulo entrega
≈ 3 mil
cargas acompanhadas no módulo em 2026
≈ 9 mil
notas, cada uma com andamento fiscal e prazo próprios
≈ 65 mil
alterações registradas com autor, data e valor anterior
≈ 10 pessoas
de 4 áreas trabalhando ao mesmo tempo na mesma carga
2.560 → 263
cargas no painel de aguardando, depois de separar o que ainda vai chegar do que já passou da data
274 → 28
notas vencidas após a primeira conferência automática de pagamentos, com 271 notas consultadas em cerca de 6 minutos
Ganhos na operação
- As áreas editam ao mesmo tempo, cada uma na sua parte; na planilha, uma pessoa editando travava as demais.
- O pagamento é conferido sozinho todo dia no ERP: a nota quitada sai da lista de vencidas, sem consulta manual.
- A liberação na SEFAZ e a taxa da SUFRAMA chegam por rotina automática, sem digitação.
- O vencimento é calculado pela condição de cada fornecedor, inclusive a que conta a partir da liberação fiscal.
- Remarcar uma entrega passou a ser uma ação só, na carga inteira.
- Toda manhã, as cargas da véspera são confirmadas como recebidas ou reagendadas, e o painel mostra só o que ainda vai chegar.
06Destaques técnicos
API própria sobre o ERP
As tabelas do WinThor foram mapeadas e expostas numa API própria; a plataforma consulta os títulos a pagar direto no ERP, sem relatório exportado.
Rotinas diárias com órgãos públicos
Agendadores dentro da própria plataforma consultam SEFAZ, SUFRAMA e ERP uma vez por dia, com trava contra execução dupla e registro de cada rodada.
Prazo calculado pela regra
O vencimento sai da condição de cada fornecedor (data fixa, dias após a entrega, dias após a liberação fiscal, parcelado); sem a liberação, a nota mostra que aguarda, em vez de uma data errada.
Cada área dona da sua parte
Perfis e permissões definem o que cada área vê e edita, o que permite trabalhar ao mesmo tempo na mesma carga.
Histórico com desfazer seguro
Cada campo guarda valor anterior, novo, autor e data; o desfazer recusa o que outra pessoa alterou depois, para não apagar trabalho alheio.
Agenda sem redigitação
A Logística monta a agenda por linha rápida, texto colado do e-mail ou arquivo importado; o histórico do ano veio da planilha antiga por migração.
Tecnologias
- Linguagens
- TypeScript
- SQL
- PowerShell
- Frameworks e bibliotecas
- Next.js
- Banco de dados e ORM
- PostgreSQL
Termos desta página
- Centro de distribuição
- Armazém que recebe e distribui as mercadorias
- SEFAZ
- Secretaria da Fazenda do Amazonas
- SUFRAMA
- Órgão que administra a Zona Franca de Manaus
- ERP
- Sistema de gestão usado por toda a empresa
- WinThor
- O ERP da TOTVS usado pela empresa
- API
- Ponte para um sistema consultar outro