agendamentos.txt
Projetos

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áreasAgendamentosAgenda da LogísticaDados das notasPagamentos do ERPLogística e recebimentoFiscalCompras

chega

  • Agenda da Logística
  • Dados das notas
  • Pagamentos do ERP

Agendamentos

áreas

  • Logística e recebimento
  • Fiscal
  • Compras
fluxoAgenda da Logística, Dados das notas e Pagamentos do ERP → Agendamentos → Logística e recebimento, Fiscal e 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

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

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

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

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

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

Agenda do mês, com a ocupação de cada dia e as cargas previstas.
Histórico de uma nota: o que mudou, quem alterou e quando.

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.

    Tecnologias e técnicas: SQL · TypeScript · WinThor (TOTVS)

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

    Tecnologias e técnicas: Node.js · PostgreSQL · automação web

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

    Tecnologias e técnicas: regras de negócio · TypeScript

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

    Tecnologias e técnicas: controle de acesso · Next.js

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

    Tecnologias e técnicas: auditoria · PostgreSQL

  • 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 e técnicas: importação de dados · 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