SatiFlow: o financeiro da Satilog num lugar só

O que o sistema pronto precisa fazer

Centralizador máximo. Cada tela resolve o assunto inteiro, tudo que se repete é feito em lote e toda escrita vai para o SSW ou o Brudam.

13 de outubro de 2026Escopo para o desenvolvedor e o time financeiro

Fluxo de caixa 1ª guia

Conciliação

A pagar

Faturamento / A receber

Fiscal

Gerência

Usuários

o fluxo de caixa abre primeiro · uma tela por assunto · tudo escrito no TMS

Como ler esta apresentação

Para que ela serve

É o contrato visual do escopo. Ao final, quem constrói o SatiFlow precisa saber o que construir, de onde vem cada dado, para onde cada ação escreve e como cada entrega vai ser aceita. Dez slides curtos; o detalhe de cada um fica neste painel (tecla D).

Selos

Já existe no Conciliador igual ou melhor no SatiFlow.
Existe em parte há código ou prova em algum repositório, falta juntar.
Novo não existe hoje.
Decidido decisão da Satilog (D1 a D11).
A confirmar só o que depende de terceiros (banco, captura de tela, conta de e-mail).

Setas

✦ marca o passo em que o retrabalho some: o que hoje é manual e passa a ser automático.

Atalhos

`→` `espaço` `PageDown`	avança (passo a passo dentro do slide)
`←` `PageUp`	volta (desfaz o passo)
`Home` `End`	primeiro / último slide
`M`	índice dos 10 slides
`D`	camada de detalhe
`N`	notas do apresentador
`F`	tela cheia
`Esc`	fecha o que estiver aberto

Capa. O SatiFlow junta o financeiro dos dois TMSs num app só. A conversa de hoje é sobre o que ele precisa fazer quando estiver pronto, não sobre o que já existe. A pergunta que guia tudo: a pessoa precisa sair desta tela para terminar o trabalho? Se sim, falta escopo.

Hoje × amanhã

Hoje são 14 telas para fechar o dia. Amanhã, uma.

Cada janela é uma senha, um formato e uma chance de digitar duas vezes.

14 telas abertas hoje

SSW

CTRC, faturas, despesas, ACNI

Brudam

contas a pagar e a receber, AWB

Bradesco · Matriz

internet banking

Bradesco · Filial

internet banking

Banco do Brasil

internet banking

Caixa

baixar OFX

TruckPad

planilha de vale-pedágio

Conciliador

conferir o dia

Planilhas

controles paralelos

CSV de tarifas

exportar e importar à mão

Pagamento SSW

um arquivo por sistema

Pagamento Brudam

outro arquivo

E-mails de cobrança

fora do sistema

XML de nota

baixado um a um

1 tela no SatiFlow

SatiFlow

CTRC, fatura, nota, CNPJ, valor…Ctrl K

Saldo agora1.284.077,52Previsto em 7 dias1.374.524,10

Hojepagar 182.430,15receber 96.204,80

Amanhãpagar 74.118,40receber 131.560,00

previsão recalculada no último cron · só quem tem permissão

2 dias divergentes · 12 pagamentos para aprovar

↻ = retrabalho: a mesma informação digitada ou baixada duas vezes · dados ilustrativos

02

Cada janela de hoje, e o que a substitui

Hoje	No SatiFlow
SSW e Brudam abertos para consultar e lançar	Leitura automática + escrita de volta pelo app (P1, P8)
3 internet bankings para ver extrato	Extratos por API (Bradesco Matriz, Filial, BB Matriz) Já existe
Caixa (OFX) e TruckPad (planilha)	Upload num lugar só (OFX, CSV e PDF) Já existe
Conciliador separado	Conciliação dentro do SatiFlow, com paridade total (P7)
Planilhas paralelas	Fluxo de caixa e dashboards com a origem de cada número
CSV de tarifas importado à mão	Tarifa gravada no Brudam 061 em lote Novo
Um arquivo de pagamento por sistema	Um painel dos dois TMSs e uma remessa por conta (D1) Decidido
Cobrança por e-mail fora do sistema	E-mail de cobrança e régua no app (D6, D7) Decidido
XML de nota baixado um a um	NFS-e de madrugada, NF-e pela chave, lote ZIP para a contabilidade

Critério de aceite da visão: uma pessoa do financeiro fecha o dia sem abrir o SSW, o Brudam ou um internet banking. Quando precisar abrir, é escopo faltando.

Hoje × amanhã. Contem as janelas em voz alta. Avance uma vez: elas se recolhem para dentro do SatiFlow. Os quatro números da tela da direita são o que a pessoa vê de manhã: o app já leu tudo de madrugada e diz o que falta fazer.

As regras do jogo

Quatro regras decidem cada tela

Na dúvida sobre como uma tela deve funcionar, a resposta está aqui.

P8 · regra principal

Uma tela resolve o assunto inteiro

Consultar, editar, liquidar, lançar, anexar e aprovar num painel lateral.

Na Conciliação se liquida a fatura paga por PIX avulso, sem abrir o SSW.

P9

Tudo em lote

Seleciona vários, vê a prévia, confirma uma vez, recebe o resultado item a item.

"12 lançamentos, R$ 48.310,22, 2 TMSs" → 11 feitos, 1 recusado com motivo.

P10

Centralizador máximo

CTRC, CT-e, AWB, fatura, nota, boleto, PIX ou remessa numa busca só, com tudo ligado numa ficha.

Busca 1861-9 → cliente, PIX, baixa, e-mails e anexos.

P1

O TMS é a fonte; o app escreve de volta

Criar despesa no app cria no TMS; liquidar no app liquida no TMS.

Sem cadastro paralelo: a despesa mora no SSW ou no Brudam.

P2

Automático por padrãobancos e TMSs lidos sozinhos; upload só sem API

P3

Número certo ou erro visívelcentavos inteiros; fonte que falha nunca vira zero

P4

Nada some em silêncioexcluído e não classificado aparecem com o motivo

P5

Seguro e granularquem vê, edita ou baixa cada coisa, por módulo, filial e conta

P6

Simples de usara tela diz o que falta; uma decisão é um clique

P7

Paridade antes de novidadetudo que o Conciliador faz, igual ou melhor

Onde mora cada dado

No SSW e no Brudam

clientes e fornecedores
lançamentos e despesas
faturas, títulos, CTRC, AWB
baixas e liquidações

No SatiFlow, só o que é dele

vínculos e estados de fluxo
lotes de remessa e retorno
anexos e auditoria
cache com hora da leitura

03

Os dez princípios, e o que muda no SatiFlow de hoje

P1 · O TMS é a fonte da verdade

Clientes, fornecedores, lançamentos, faturas e títulos moram no SSW e no Brudam. O SatiFlow lê, normaliza, relaciona e escreve de volta. Guarda só o que é dele: vínculos, estados de fluxo (selecionado, aprovado, em remessa, conciliado), lotes de remessa e retorno, anexos, auditoria e cache com carimbo de hora.

P2 · Automático por padrão

Bancos e sistemas lidos sozinhos (agenda + "Atualizar"); upload só para quem não tem API: Caixa, TruckPad e outros, em OFX, CSV e PDF.

P3 · Número certo ou erro visível

Centavos inteiros, data em que o dinheiro entrou ou saiu, "zero só quando a fonte diz zero". Fonte que falha aparece como erro, nunca como zero, e o mês com erro não vai para o cache.

P4 · Nada some em silêncio

Excluído, ignorado ou não classificado aparece listado, com o motivo (ex.: termo de exclusão; natureza "(não mapeado)").

P5 · Seguro e granular

Permissão por módulo × ação × filial × conta bancária, conferida no servidor; quem monta o lote não aprova sozinho; auditoria de toda escrita; credenciais só no servidor.

P6 · Simples de usar

A tela diz o que falta fazer; uma decisão é um clique; tudo que repete tem lote; tudo que escreve tem confirmação clara e, quando o TMS permitir, desfazer.

P7 · Paridade antes de novidade

Tudo o que o Conciliador faz existe no SatiFlow igual ou melhor (lista no detalhe do slide 5 e do slide 9).

P8, P9, P10

Uma tela resolve o assunto inteiro; tudo em lote com prévia e resultado item a item; qualquer documento numa busca só, com ficha única editável que grava no TMS de origem.

O que muda no SatiFlow de hoje Existe em parte

O repositório do prestador já tem uma boa base para reaproveitar: login, perfis com permissões por módulo e por unidade, auditoria, alertas de vencimento e cadastro de contas bancárias (migrações em supabase/migrations/).

O ajuste de rumo está nos títulos: hoje o app cria o título no próprio banco (satiflow.titulos_financeiros, RPC lancar_titulo), e a tela Financeiro lista esses títulos. Pelo P1, o título passa a nascer no SSW ou no Brudam; a tabela do app vira vínculo e estado de fluxo, apontando para o id do TMS.

SatiFlow hoje: títulos no banco do app

D8 · Acesso aos TMSs Decidido

Leituras agendadas (crons várias vezes ao dia) saem por uma conta de serviço por TMS, com permissão mínima de leitura. Quando a pessoa age (abre para decidir, edita, lança, liquida), o app usa o acesso do próprio usuário ao SSW/Brudam, em tempo real: relê o dado na hora, grava e relê para confirmar. Assim o TMS registra quem fez, além da auditoria do app, como o Conciliador já faz hoje com a sessão de cada pessoa.

Regras. P8 é a regra principal: se a pessoa precisa sair da tela, falta escopo. P9: toda ação que se repete tem lote. P10: uma busca acha qualquer documento. P1: o app não guarda cadastro paralelo, escreve no TMS. No detalhe: o ajuste de rumo dos títulos no SatiFlow de hoje.

O mapa do sistema

Um centro, seis assuntos, tudo ligado ao TMS certo

04

Contexto técnico: quem fala com quem

Diagrama de contexto

O mapa ao lado é também o diagrama de contexto: cada integração liga ao SatiFlow com o tipo de seta da legenda.

Integração	O app lê	O app escreve
SSW	475, 477, 411, 571, 104, 455	475 (despesa), 048/571 (baixa por ACNI)
Brudam (via proxy)	contas a pagar, pagas, recebidas, emissões, rateios	061/062 (lançamento), liquidação
Bradesco API	extrato (mTLS), saldo	remessa Multipag, cobrança e Pix (D1, D5)
BB API	extrato v2	lote e cobrança na fase 4
Caixa · TruckPad	upload OFX / planilha	—
ADN · SEFAZ	NFS-e, NF-e pela chave	eventos só na fase 4 (D11)
Ficha Cadastral · CENPROT	ficha do vendedor, protestos	—
E-mail	faturas de parceiros (IMAP)	cobrança por SMTP (D6)

Um dia do sistema

madrugada + crons do dialê notas (ADN), extratos e os dois TMSs várias vezes ao dia

manhão painel já mostra o que falta decidir

durante o diaa pessoa decide: aprova, liquida, lança, cobra

tarderemessa sai, retorno volta e liquida no TMS

tempo realcada ação relê o TMS na hora, com o acesso do usuário, e confirma a escrita

O que o app guarda (cada um aponta para o id no TMS)

Entidade	Aponta para
Vínculo	documento do TMS ↔ extrato, nota, boleto, PIX, e-mail
Conciliação do dia	lançamentos dos TMSs e do banco do dia
Lote de pagamento · aprovação	despesas/lançamentos do TMS; quem montou, quem aprovou
Remessa · retorno	arquivo CNAB por conta; resultado por item
Anexo	documento do TMS (e a cópia enviada a ele)
Auditoria	quem, quando, antes/depois, id do TMS
Cache	leitura com carimbo de hora; mês com erro não entra

Mapa. Seis assuntos, cada um com a sua tela completa. Avance uma vez para as integrações aparecerem. Seta laranja sólida é escrita no TMS; cinza tracejada é leitura; preta é banco; laranja tracejada é a releitura que prova a escrita. Daqui, cada cartão vira o slide do seu assunto.

Conciliação

Na Conciliação se resolve tudo da conciliação

Créditos · janeiro/2026 Sistemas − Banco = DiferençaJá existe

Dia	Sistemas	Banco	Diferença	Status
07/01	41.208,77	41.208,77	0,00	OK
08/01	36.115,40	36.395,40	−280,00	DIVERGE
09/01	52.904,12	53.004,12	−100,00	DIVERGE
12/01	28.660,05	28.660,05	0,00	OK
13/01	47.931,58	47.931,58	0,00	OK
08/01 · banco: PIX RECEBIDO 280,00 sem par nos sistemas · valores ilustrativos

Ações do dia, sem sair da tela 08/01 · −280,00

Liquidar a fatura paga por PIX avulsosugerida: 1861-9, R$ 380 = PIX 280 (08/01) + 100 (09/01) · grava no SSW

Liquidar

Lançar tarifas no Brudam (061)natureza 18, conta e departamento do banco · em lote

Lançar 3

Identificar ACNIsugere o documento por valor, pagador, CNPJ e cliente

Identificar

Excluir transferência internatermo de exclusão; o excluído fica listado

Excluir

Anotar e atribuir"compensou no dia seguinte" → aguardar

Anotar

Fluxo 2 A fatura paga por PIX avulso é liquidada dentro da conciliação

05

Conciliação: paridade, tarifas e divergências

Paridade obrigatória com o Conciliador Já existe

9 fontes em paralelo, carregamento progressivo: Brudam débitos e créditos; SSW débitos (477) e créditos (411 + 571 ACNI + 104); Bradesco Matriz; Bradesco Filial; BB Matriz; Caixa (OFX); TruckPad (planilha).
Tabelas Débitos e Créditos dia a dia: Total Sistemas − Total Banco = Diferença; OK só com diferença zero, sem tolerância.
Detalhe do dia lado a lado com ✓: par um-para-um, valor idêntico, nunca cruza dias. "Detalhar mês", filtros de fonte, anotações, relatórios Excel.
SSW: arquivo morto (≥ 70 dias, busca por liquidação), fila da 156, ACNI (situações 1 a 5), fatura paga em partes (104), fatura descontada (ocorrências 76 + 79).
Cobrança: boletos dos sistemas somados por dia × "liquidação de cobrança" do extrato.
Exclusões (transferência entre contas próprias, InvestFácil, Rende Fácil) só no lado banco, com o excluído listado.

Detalhe do dia com ✓

Tarifas hoje viram CSV

ACNI pendente nos créditos

Tarifas lançadas no TMS sozinhas Novo

Antes (CSV)

Depois (automático): o app reconhece a tarifa provável (regra que já existe), sugere natureza 18, conta e departamento por banco (Bradesco Matriz 1/26, Bradesco Filial 7/22, BB Matriz 9/26), o usuário aprova em lote e o app grava no Brudam (061), o mesmo destino do CSV de hoje (D3).

Aceite: a chave de idempotência é o lançamento do extrato; reprocessar nunca lança duas vezes. Na próxima leitura o dia concilia e ganha ✓.

Divergência vira ação Novo

Dia divergente: o que é a diferença?

Tarifa bancária→lançar no TMS

ACNI→identificar o cliente

Compensou no dia seguinte→aguardar

Transferência interna→excluir (fica listada)

Outro→anotar e atribuir a alguém

Saldo por conta Novo

Saldo por conta e conciliação por instituição. Fase 1: saldo da última leitura do extrato, com a hora ao lado (D9).

Liquidar direto da conciliação (fluxo 2)

Caso real da fatura 1861-9: PIX de R$ 280 em 08/01 e de R$ 100 em 09/01 pagaram uma fatura de R$ 380. Hoje alguém cria duas ACNIs na 571 e liga as duas à fatura na 048. No SatiFlow, o app sugere a fatura e grava essa ligação no SSW pela pessoa, que não sai da tela.

Aceite do módulo: um mês fechado roda em paralelo com o Conciliador e todos os totais batem no centavo (fase 1).

Conciliação. À esquerda, o que já existe. À direita, o que muda: o dia divergente traz as ações ali mesmo. Avance para desenhar o fluxo 2 com o caso real da fatura 1861-9. O ✦ marca onde o retrabalho some: a sugestão e a gravação no SSW.

A pagar

A fatura do parceiro vira pagamento sem digitação

Esteira da fatura a pagar nada é lançado sem passar por todas as etapas Novo

1

Recebe

lê o e-mail e todos os anexos
identifica o parceiro pelo CNPJ
barra fatura já recebida

2

Confere os documentos

fatura, XML dos CT-e/AWB e boleto ou PIX presentes
emissor = parceiro; tomador = Satilog
soma dos documentos = valor da fatura
boleto: valor e vencimento batem

3

Confere o tarifário

cada CTRC/AWB existe no TMS
valor de cada item × preço combinado com o parceiro
diferença item a item, em centavos

verificador já existe

4

Lança no TMS

lançamento a pagar no TMS do parceiro (D3)
anexos enviados junto
CTRCs/AWBs vinculados

5

Autoriza

quem aprova vê a conferência e os anexos
alçada D2; quem montou não aprova

6

Paga e liquida

remessa e retorno (D1)
liquida no TMS de origem
extrato concilia ✓

Falhou em qualquer conferência → vira pendência com o item, o documento e a diferença; nada é lançado no TMS até alguém resolver.

Fluxo 3 Do e-mail do parceiro ao pagamento liquidado na origem

06

A pagar: onde nasce a despesa e quem aprova

Estados de um pagamento

Pendente no TMS (emissão automática) → Selecionado (pessoa) → Aprovado (pessoa, alçada D2) → Em remessa (app gera CNAB) → Pago · Agendado · Rejeitado (retorno do banco) → Liquidado no TMS (app grava) → Conciliado ✓ (app, pelo extrato). Rejeitado volta para a fila com o motivo do banco.

Verificador de tarifário Já existe em outro repositório

O verificador de faturas de parceiros (documentos + tarifário) já existe em outro repositório e o desenvolvedor já o conhece. No SatiFlow ele vira as etapas 2 e 3 da esteira: lê o e-mail e os anexos, confere cada CTRC/AWB contra o preço combinado; certa, cria o lançamento a pagar no TMS do parceiro (D3); divergente, vira pendência com o item e a diferença, sem lançar.

D3 · Onde nasce a despesa criada no app Decidido

O app sugere o TMS e a pessoa confirma antes de gravar:

Tarifa bancária → Brudam, o mesmo destino do CSV de hoje (natureza 18, conta e departamento por banco).
Fornecedor com histórico → o TMS onde ele mais aparece nos últimos 12 meses.
Fornecedor sem histórico → tabela natureza → TMS em Configurações. Padrão: frete de terceiros, agregados, redespacho e despesas por unidade operacional → SSW; administrativas, impostos, folha, aluguel, TI e tudo com rateio por departamento → Brudam.

O fornecedor precisa existir no TMS escolhido. Se não existir, o app avisa e abre o cadastro no TMS; nunca cria o fornecedor só no app.

D2 · Alçadas de aprovação Decidido

Quem monta o lote nunca aprova o próprio lote.
Todo lote precisa de 1 aprovação (gerente financeiro).
2ª aprovação (diretoria) quando: um pagamento ≥ R$ 50.000, o lote soma ≥ R$ 200.000, o favorecido é novo, ou os dados bancários dele mudaram nos últimos 30 dias.
Quem aprova vê o lote item a item; aprovar e reprovar ficam na auditoria. Lote aprovado não se edita: editar volta para aprovação.

Valores são o padrão inicial, editáveis em Configurações só pelo master.

Lançar despesa pelo app → grava no TMS Existe em parte

Formulário único: fornecedor buscado no TMS (não digitado), natureza, valor, vencimento, conta bancária, rateio por departamento/filial, documento fiscal e anexos. Grava no Brudam 061 ou no SSW 475, inclusive anexos; cancelar e editar também passam pelo TMS. A escrita já foi provada com registros de teste cancelados: Brudam 061/062 (criar, editar descrição/memo, cancelar, anexos, histórico) e SSW 475 (incluir, alterar, cancelar, imagens, ocorrências).

Painel único e relatórios Novo

Despesas pendentes dos dois TMSs (SSW 475 programação; Brudam contas a pagar) por vencimento, filial, fornecedor e forma de pagamento. Relatórios: o que devo hoje, vencidos, por fornecedor e por filial.

Aceite (fase 2): um lote real pago pelo app, liquidado no TMS sem digitação e conciliado pelo extrato.

A pagar. Hoje alguém abre o e-mail, confere a fatura de olho e digita no TMS. No SatiFlow, o app confere contra o tarifário e só chama uma pessoa para autorizar. Avance passo a passo: o último passo mostra os estados de um pagamento e quem move cada um.

Pagar e receber

Do TMS ao banco e de volta, sozinho

Fluxo 1 O retorno do banco liquida no TMS sem digitação

No receber três portas de entrada terminam no mesmo lugar

Retorno de cobrança D5boleto registrado no Bradesco; arquivo processado pelo app

PIX ou TED identificado NovoQR dinâmico ligado ao documento; pagador ↔ cliente

ACNI assistida Novoo app sugere o documento, a pessoa confirma; 571/048

Baixa no TMS + conciliação ✓a cobrança sai por e-mail e régua (D6, D7)

07

Banco, cobrança e cliente

D1 · Pagamento em lote (CNAB) Decidido

Começa pelo Bradesco Matriz e Filial, Multipag, CNAB 240: é por onde sai a maior parte dos pagamentos. O BB entra na fase 4.
Na primeira versão o app gera uma remessa por conta, a pessoa envia pelo internet banking do Bradesco e devolve o retorno ao app. Não exige contrato novo nem dá ao app poder de pagar sozinho. Transmissão automática (API ou VAN) é fase 4, sobre o mesmo fluxo.
Tipos: boleto, PIX (chave), TED e tributos ou contas de consumo com código de barras. Tributo sem código de barras fica fora.
Layout: manual CNAB 240 Multipag vigente, fornecido pelo banco; o arquivo passa pela homologação do Bradesco antes de produção. A confirmar
O app só liquida no TMS o que o retorno disse que foi pago; rejeitado volta para a fila com o motivo do banco; o extrato confirma depois.

D5 · Cobrança registrada (boleto e PIX) Decidido

Banco: Bradesco, na carteira que SSW e Brudam já usam. BB na fase 4.
Um título, um registro: se o TMS já gera o boleto e a remessa de cobrança, o app não registra de novo; transmite a remessa do TMS e processa o retorno. Quando o TMS não registra, o app registra pela API e grava o nosso número e a linha digitável no documento do TMS.
PIX: cobrança com QR dinâmico (vencimento, juros e multa) pela API Pix do Bradesco; o identificador fica ligado ao documento e a baixa vai ao TMS sem digitação. A confirmar liberação das APIs.

D6 · E-mail de cobrança Decidido

Caixa dedicada no domínio da Satilog (ex.: cobranca@satilog.com.br, a criar), servidor da própria empresa: SMTP para enviar e cópia em "Enviados" por IMAP, como o app Email-em-massa já faz; o financeiro vê e responde no Outlook. Sem SMTP direto, serviço transacional com SPF, DKIM e DMARC, mantendo a cópia. Três modelos (lembrete, vencido, cobrança formal) com fatura, boleto e QR PIX anexos. Cada envio entra no histórico do cliente.

D7 · Régua de inadimplência Decidido

Quando	Ação	Automático?
D-3	lembrete por e-mail	sim
D0	aviso de vencimento por e-mail	sim
D+3	cobrança por e-mail + tarefa de ligação	e-mail sim; ligação é tarefa
D+10	2ª cobrança + aviso ao vendedor	sim
D+20	cliente "em risco": frete novo pede liberação	o app propõe, uma pessoa libera
D+30	notificação formal + proposta de negociação	e-mail sim; proposta é de uma pessoa
D+45	sugestão de protesto	nunca: a gerência aprova

Cliente estratégico fica fora dos envios automáticos e recebe só tarefas. O bloqueio no TMS só entra depois de capturar como SSW e Brudam marcam o cliente. A confirmar

Cadastro de cliente Existe em parte

A ficha cadastral (vendedor) e o cadastro com CENPROT e gravação no SSW/Brudam já existem em dois repositórios (ficha-cadastral, cadastro-de-clientes). O SatiFlow junta os dois no fluxo e guarda só o vínculo e o dossiê.

Faturas em aberto e cliente 360 Novo

Faturas dos dois TMSs num painel único (cliente, vencimento, filial, idade) e a visão do cliente: faturas, pagamentos, protestos, contatos, histórico de cobrança. Lançamentos de crédito avulsos (receitas) gravados no TMS.

D4 · Fechamento de fatura de cliente Decidido

Fase 3: painel "a faturar" por cliente (CTRCs e AWBs sem fatura) com botão que abre a tela do TMS já filtrada. Fase 4: fechar pelo próprio app, depois de capturar e testar as telas com faturas de teste canceladas, como foi feito na 475 e na 061. A opção exata do SSW e a tela do Brudam ficam A confirmar até a captura.

Cobrança × liquidação hoje

Aceite (fase 3): um mês de recebimentos baixado pelo app, com a cobrança enviada pelo app.

Ponta a ponta. O TMS emite, o SatiFlow lê e confere, a pessoa só autoriza, o banco paga, o retorno liquida no TMS e o extrato fecha o dia. No receber, as três portas (retorno, PIX, ACNI) terminam no mesmo lugar: baixa no TMS e conciliação.

P9 · P10

Tudo em lote, tudo numa busca só

A pagar · pendentes dos 2 TMSs vencimento até 17/10

Favorecido	TMS	Venc.	Valor
Transportes Exemplo Ltda	SSW 475	14/10	12.480,00
Posto Modelo Ltda	SSW 475	14/10	6.215,37
Locadora Fictícia S.A.	Brudam	15/10	9.900,00
Telefonia Teste	Brudam	16/10	1.242,65
Agregado Exemplo ME	SSW 475	17/10	4.380,00

12 · R$ 48.310,22 · 2 TMSs LiquidarTrocar bancoNaturezaVencimentoAprovar

1861-9 · CTRC, CT-e, AWB, fatura, nota, chave, CNPJ, nome, valorCtrl K

Pedidos do dia a dia, a um clique da busca

"Baixar todos os CT-es desta fatura""O que está em aberto para mim?""Qual o próximo fechamento deste cliente?" "Quanto transportamos com este parceiro no mês?""Liberar crédito para este cliente""O que vence amanhã?"e vários outros

Fatura 1861-9 SSWR$ 380,00

Clientecliente da fatura · contatos · protestos

PagamentosPIX 280,00 (08/01) + 100,00 (09/01)

Conciliação08/01 ✓ · 09/01 ✓ no extrato

Cobrançaboleto, e-mails enviados, anexos

Editar vencimento 10/01 → 15/01grava no SSW · auditoria

Fluxo 4 Uma confirmação, cada item no TMS de origem

08

Lote, busca única e ficha do documento

Ações em lote Novo

Em qualquer lista: liquidar todos, trocar de banco, mudar natureza, mudar vencimento, cancelar, aprovar, gerar remessa, enviar cobrança. A barra aparece quando há linhas selecionadas.

Prévia: quantidade, valor e TMSs afetados ("12 lançamentos, R$ 48.310,22, 2 TMSs").
Confirmação clara.
O app grava cada item no TMS de origem.
Resultado item a item: feito, ou recusado com o motivo.
Tudo na auditoria; desfazer quando o TMS permitir.

Aceite: um item recusado não derruba o lote; reprocessar o lote não duplica o que já foi feito (idempotência por item).

Pedidos do dia a dia com resposta imediata Novo

O que a equipe pede todo dia tem que estar a um clique, a partir da busca única ou da ficha do documento, sempre com dados atualizados do TMS e respeitando as permissões de quem pede.

Pedido	O que o app entrega
"Preciso baixar todos os CT-es desta fatura"	ZIP com XML e PDF de todos os CT-e/AWB ligados à fatura (exige permissão de baixar; fica na auditoria)
"Que documentos estão em aberto para mim?"	a fila da pessoa: aprovações, faturas a conferir, pendências atribuídas, notas a conferir, dias divergentes
"Qual o próximo fechamento deste cliente?"	data do próximo fechamento pela regra de faturamento do cliente no TMS e o que já está a faturar captura da tela
"Quanto transportamos com este parceiro este mês?"	CTRCs/AWBs, peso e valor do mês com o parceiro, e quanto já foi pago e falta pagar
"Preciso liberar crédito para este cliente"	pedido com a situação do cliente (faturas em aberto, régua, protestos) → aprovação de quem tem a permissão → registro no TMS captura da tela
"O que vence hoje / amanhã?"	a pagar e a receber do dia, direto do fluxo de caixa
"Segunda via do boleto desta fatura"	boleto e QR PIX atualizados, prontos para enviar por e-mail ao cliente
"Comprovante deste pagamento"	retorno do banco e lançamento do extrato ligados ao pagamento
"Notas sem pagamento / pagamentos sem nota"	a lista do mês, com ação de vincular ou trazer o documento

Aceite: a fase 0 levanta a lista completa desses pedidos com a equipe; cada um tem a sua resposta no app, em até poucos cliques, sem abrir o SSW, o Brudam ou o internet banking.

Busca única Novo

Atalho de teclado; aceita número de CTRC, CT-e, AWB, fatura, lançamento, nota, chave de acesso, CNPJ, nome e valor.

Ficha única do documento Novo

Tudo ligado ao documento: TMS de origem, cliente ou fornecedor, faturas, pagamentos, boleto e PIX, remessa e retorno, notas fiscais, extrato conciliado, e-mails de cobrança, anexos e histórico.

Editar dali, gravando no TMS

Vencimento, valor permitido, natureza, conta, rateio e anexos. A edição grava no TMS de origem e fica na auditoria, com "via SatiFlow por <pessoa>" no histórico do TMS (D8).

Cada tela é completa no seu assunto (P8)

Conciliação, A pagar, Faturamento/A receber, Fiscal e Gerência resolvem tudo do assunto num painel lateral, sem sair dela.

Lote e busca. Avance: a barra de lote aparece ao selecionar, junto com os pedidos do dia a dia que a busca resolve num clique. Depois o fluxo 4: prévia, uma confirmação, gravação item a item no TMS, resultado com motivo. À direita, a busca acha a 1861-9 e a ficha mostra tudo ligado a ela; editar o vencimento grava no SSW.

Fiscal · Gerência · Permissões

Cada número com origem, cada um vê o seu

Fiscal

Igual ou mais completo que o Conciliador; a nota chega sozinha.

EntradaConferênciaVínculoFechamento

NFS-e do ADN de madrugada, 4 CNPJs Já existe
NF-e pela chave, CT-e do SSW Já existe
"Aproveita créditos?" sempre manual Já existe
Só nota conferida cobre pagamento Já existe
Relatórios de faturamento Novo
Lote ZIP de XML e CT-e Novo
Eventos no portal só na fase 4 D11

Fluxo de caixa1ª guia

só quem tem permissão · previsões recalculadas a cada cron

Hoje

pagar 182.430,15

receber 96.204,80

Amanhã

pagar 74.118,40

receber 131.560,00

7 dias

pagar 611.902,33

receber 702.348,91

Saldo agora

1.284.077,52

por conta · lido às 06:10

Projetado 7 dias

1.374.524,10

previsto × realizado · último cron

Saldo←extrato do banco, última leitura (D9)

A pagar←pendentes dos TMSs + lotes aprovados, a cada cron

A receber←faturas em aberto + previsão de cobrança, a cada cron

Inadimplentes: cobrar, negociar, protestar Novo
Gasto e ganho por filial Novo
Custos: De→Para, rateio, 3 meses Já existe

valores ilustrativos

Permissões

Controle máximo: cada perfil tem permissão por ação, em cada módulo, filial e conta.

vercriareditaraprovarliquidargerar remessabaixar / exportarver anexos

Perfil (D10)	Conc.	Pagar
Master
Diretoria		2ª
Gerente financeiro		1ª
Analista a pagar	déb.
Analista a receber	créd.
Fiscal
Gestor de filial
Contabilidade

operasó vêaprovasem acesso

Gestor de filial vê só a sua filial em listas, dashboards, relatórios e exportações. Hoje o Conciliador tem master × comum, sem recorte por filial.

09

Fiscal, gerência e permissões

Fiscal: paridade Já existe

NFS-e automática pelo ADN (madrugada, 4 CNPJs); NF-e pela chave (relay SEFAZ); CT-e do SSW; upload de XML, PDF ou chave; caixa de entrada com Nova, Divergente, Conferida, Recusada e Cancelada; "Aproveita créditos?" sempre manual e obrigatório; vínculo nota ↔ pagamento N:N com sugestão; só nota conferida cobre pagamento; check do dia; fechamento do mês; relatórios Excel com fornecedor e chave completa.

Fiscal: novo Novo

Relatórios de faturamento (emitidos) por período, filial, cliente, cidade e regime tributário. O proxy já tem as consultas: SSW 455 (CTRCs), Brudam emissões, vendas por cidade e regime tributário.
Download em lote de CT-e e XML (emitidos e recebidos) por competência e filial, em ZIP organizado para a contabilidade.

D11 · Eventos fiscais no portal Decidido

Fase 4, só depois de testados em homologação, com a permissão fiscal_manifestar, sempre por decisão do fiscal e nunca automáticos. Até lá, a recusa fica registrada no app e o fiscal repete no portal, como o Conciliador já faz.

Fluxo de caixa: a primeira guia do SatiFlow Novo

É a primeira guia que quem tem a permissão vê ao entrar. Responde: o que tenho para pagar e receber hoje? Amanhã? Nos próximos 7 dias? Qual o saldo agora, por conta? Qual o saldo previsto? Com previsto × realizado.

Não é só saldo atual. As previsões vêm do próprio sistema: despesas pendentes e lotes aprovados nos TMSs, faturas em aberto e cobranças registradas. Elas são recalculadas a cada cron, várias vezes ao dia, e cada número mostra a hora da última leitura.

Acesso restrito: a guia só aparece para quem tem a permissão de fluxo de caixa, conferida no servidor. Padrão inicial: master, gerente financeiro (operam), diretoria e contabilidade (só veem). O master libera para outros perfis; quem tem recorte por filial vê só a sua filial.

Número	De onde vem
Saldo agora	extrato do banco, última leitura, com a hora ao lado (D9)
A pagar	pendentes dos TMSs + lotes aprovados
A receber	faturas em aberto + previsão de cobrança
Projetado	saldo + a receber − a pagar, dia a dia

D9 · Saldo bancário Decidido

Fase 1: saldo da última leitura, tirado do extrato que o app já lê. O Bradesco traz o saldo após cada lançamento e a Caixa traz o saldo no OFX. O BB traz linhas de saldo, mas em produção vieram com valor zero; se não servirem, usar a API de saldo do BB. Fase 4: saldo em tempo real onde o banco liberar.

Dashboards e inadimplência

Paridade com o Dashboard do Conciliador: natureza → centro de custo (De→Para), por filial com rateio pelos maiores restos, fornecedores, comparativo de 3 meses Já existe. Novos: inadimplentes com ação na própria tela (cobrar, negociar, protestar, bloquear), faturas que devemos, faturas a receber, gasto e ganho por filial.

Dashboard de gastos

Fiscal: painel do pagamento

Usuários hoje: sem filial

D10 · Perfis padrão Decidido

Perfil	O que pode
Master		tudo, inclusive usuários, perfis, alçadas e configurações
Diretoria	ver tudo, 2ª aprovação de pagamentos, exportar
Gerente financeiro	ver e operar tudo do financeiro, 1ª aprovação
Analista a pagar	lançar despesa, montar lote, importar retorno, lançar tarifas, conciliar débitos; não aprova
Analista a receber	faturas, cobrança, e-mails, liquidar, ACNI, cadastro de cliente, conciliar créditos
Fiscal	módulo fiscal inteiro; ver pagamentos (só leitura)
Gestor de filial	só leitura da própria filial: dashboards, a pagar, a receber, inadimplentes
Contabilidade / auditoria	só leitura de tudo, exportações e lote de XML

Qualquer perfil pode ser restrito a filiais e a contas bancárias. Ações: ver, criar, editar, aprovar, gerar remessa, liquidar, exportar. A matriz do slide resume a D10 por módulo; as células sem menção na D10 começam sem acesso e o master ajusta.

Permissões granulares: controle máximo de quem acessa o quê Novo

Cada permissão é a combinação perfil × módulo × ação × filial × conta bancária. Ver não dá direito a editar, e editar não dá direito a baixar: cada ação é liberada à parte.

Ação	O que libera
Ver	abrir a guia e consultar os dados (ex.: fluxo de caixa só para quem tem a permissão)
Criar · editar	lançar e alterar no TMS pelo app
Aprovar	1ª ou 2ª aprovação de lote (D2)
Liquidar · gerar remessa	baixar títulos no TMS; gerar o arquivo do banco
Baixar / exportar	Excel, PDF, ZIP de XML, relatórios; cada download fica na auditoria
Ver anexos	abrir documentos anexados (notas, faturas, comprovantes)
Configurar	usuários, perfis, alçadas, crons (só master)

O recorte por filial e por conta bancária vale para tudo: listas, busca, ficha do documento, dashboards, relatórios e downloads. O que a pessoa não pode ver não aparece nem na busca.

Regras de permissão

Conferido no servidor (não só esconder botão); auditoria de quem fez o quê e quando, com antes/depois; leituras agendadas por conta de serviço e ações com o acesso do próprio usuário ao TMS (D8). Hoje o SatiFlow do prestador já tem perfis por módulo e por unidade Existe em parte.

Aceite (fase 1): permissões granulares por filial, auditoria, crons e tempo real prontos; fiscal igual ao Conciliador; dashboards de custo; fluxo de caixa e saldos; relatórios de faturamento e lote de XML/CT-e.

Três colunas. Fiscal: o que já existe continua; entram relatórios de faturamento e o lote de XML. Gerência: as perguntas do dia respondidas em cartões, e cada número diz de onde vem. Permissões: os perfis da D10; o gestor de filial só vê a sua filial em tudo.

Como vamos entregar

Cinco fases, cada uma com prova de pronto

0

Base

pesquisa completa do dia a dia de cada pessoa do financeiro, fiscal e gerência, com os pedidos que se repetem
inventário das telas do SSW, do Brudam e dos bancos que cada um usa, e para quê
todas as regras do Conciliador aplicadas no motor

Pronta quandocada rotina tem a sua tela no SatiFlow, aprovada pelo financeiro, e o motor passa os casos reais do Conciliador

1

Fundação e paridade

permissões granulares por filial e conta; auditoria
crons e tempo real ligados aos TMSs
conciliação e fiscal iguais ao Conciliador
fluxo de caixa (1ª guia) com previsões a cada cron
dashboards e lote de XML

Pronta quandoum mês fechado roda em paralelo com o Conciliador e todos os totais batem no centavo

2

Contas a pagar

painel único de pendentes
esteira da fatura de parceiro: documentos e tarifário
tarifas automáticas; lote CNAB, retorno, liquidação
alçadas

Pronta quandoum lote real é pago pelo app, liquidado no TMS sem digitação e conciliado pelo extrato

3

Contas a receber

faturas em aberto e cliente 360
liquidação por retorno, PIX e ACNI
boleto e PIX registrados; e-mail e régua
cadastro de cliente; "a faturar"

Pronta quandoum mês de recebimentos é baixado pelo app, com a cobrança enviada pelo app

4

Expansão

BB no lote e na cobrança
transmissão automática ao banco
fechamento de fatura pelo app
bloqueio, protesto, eventos fiscais

Pronta quandocada item é homologado com o banco ou o portal

Em todas as fases o dado na tela é sempre o dado do TMS

Crons várias vezes ao diamadrugada e outras janelas ao longo do dia: TMSs, extratos e notas relidos e previsões de caixa recalculadas; cada número mostra a hora da leitura

Tempo real quando a pessoa ageabrir para decidir, editar, lançar ou liquidar relê o TMS na hora, com o acesso do próprio usuário ao SSW/Brudam

Escreve, relê, confirmatoda escrita volta a ler o TMS; se o TMS mudou desde a última leitura, o app mostra a diferença antes de gravar

Menos telas, menos retrabalho, tudo no TMS certo.

10

Requisitos técnicos, decisões e o que já está provado

Como o sistema tem que funcionar: o que foi decidido Decidido

SSW e Brudam são TMSs e são a fonte da verdade. O SatiFlow lê, relaciona e escreve de volta neles; não mantém cadastro paralelo.
Dado sempre atual. Crons várias vezes ao dia (madrugada e outras janelas) releem os TMSs, os extratos e as notas, e recalculam as previsões. Cada número mostra a hora da leitura.
Tempo real quando a pessoa age. Abrir para decidir, editar, lançar ou liquidar relê o TMS na hora, com o acesso do próprio usuário ao SSW/Brudam (D8 revisada). Leituras agendadas usam uma conta de serviço só de leitura.
Escreve, relê, confirma. Toda escrita volta a ler o TMS. Se o dado mudou desde a última leitura, o app mostra a diferença antes de gravar. O TMS registra quem fez.
Fluxo de caixa é a primeira guia, só para quem tem permissão: saldo agora, a pagar e a receber de hoje, amanhã e 7 dias, e previsões do próprio sistema recalculadas a cada cron, com previsto × realizado.
Esteira da fatura a pagar. Nenhuma fatura de parceiro é lançada sem passar por: recebe (e-mail e anexos, parceiro pelo CNPJ, fatura repetida barrada) → confere documentos (fatura, XML dos CT-e/AWB, boleto ou PIX; emissor e tomador; soma = valor da fatura; boleto bate) → confere tarifário (cada CTRC/AWB existe no TMS e bate com o preço combinado, diferença item a item) → lança no TMS do parceiro com anexos → autoriza (D2) → paga e liquida. Falhou: vira pendência, nada é lançado.
Permissões granulares. Perfil × módulo × ação × filial × conta. Ações separadas: ver, criar, editar, aprovar, liquidar, gerar remessa, baixar/exportar, ver anexos, configurar. Todo download fica na auditoria; o que a pessoa não pode ver não aparece nem na busca; só o master configura usuários, alçadas e crons.
Uma tela resolve o assunto inteiro, tudo em lote, busca e ficha únicas (P8, P9, P10).
Pedidos do dia a dia com resposta imediata: "baixar todos os CT-es desta fatura", "o que está em aberto para mim", "próximo fechamento deste cliente", "quanto transportamos com este parceiro no mês", "liberar crédito para este cliente" e os demais levantados na fase 0, cada um a poucos cliques.
Fase 0 · Base antes de construir: pesquisa completa do dia a dia de cada pessoa do financeiro, fiscal e gerência; inventário das telas do SSW, do Brudam e dos bancos usadas e para quê; todas as regras do Conciliador aplicadas e testadas com os casos reais.

Requisitos não funcionais

Dado sempre atualcrons várias vezes ao dia + releitura em tempo real a cada ação, com o acesso do próprio usuário

Idempotênciatoda escrita no TMS tem chave; repetir não duplica

Reprocessar sem duplicarlote, retorno e tarifa podem rodar de novo

Erro visívelcom a mensagem da origem; nunca zero falso

Homologação antes de produçãobanco, portal e telas de escrita

Logs e auditoriaquem, quando, antes/depois, id no TMS

Segredos fora do códigosó em secrets do servidor

Testes com casos reaiscomo os 308 testes do Conciliador (1861-9, 3481-9, 3662-5)

Permissão no servidornão basta esconder o botão; cada ação conferida na API

Download auditadotodo Excel, PDF ou ZIP baixado fica registrado

Hora da leitura visíveltodo número diz de quando é; cron que falha aparece como erro

Conflito antes de gravarse o TMS mudou, a pessoa vê a diferença antes

Já provado nos repositórios

Integração	Onde está a prova	Status
Extrato Bradesco Matriz/Filial e BB Matriz	Conciliador `worker/integracoes/`	Já existe
Brudam débitos/créditos; SSW 477, 411, 571, 104	Conciliador `worker/fontes/`, `shared/normalizadores/`	Já existe
Contas a pagar, pagas e recebidas; emissões; vendas por cidade; regime; CTRCs 455	proxy `src/modules/ssw`, `src/modules/brudam`	Já existe
Escrita Brudam 061/062 (criar, editar, cancelar, anexos, histórico)	`capturas anexos e comentarios/brudam_62/`	Em parte
Escrita SSW 475 (incluir, alterar, cancelar, imagens, ocorrências)	`capturas anexos e comentarios/ssw_475/`	Em parte
NFS-e ADN, NF-e pela chave, CT-e	Conciliador `worker/fiscal/`	Já existe
Cliente no SSW/Brudam + CENPROT	`satilog-suporte/cadastro-de-clientes`	Em parte
Ficha cadastral	`satilog-suporte/ficha-cadastral`	Em parte
Verificador de faturas de parceiros a pagar (documentos + tarifário)	repositório próprio, já conhecido pelo desenvolvedor; entra na esteira do slide 6	Já existe
CNAB 240 Multipag	—	Novo
Registro de boleto e PIX	—	Novo
E-mail de cobrança	—	Novo

"Em parte": a chamada já foi capturada e testada com registros fictícios cancelados, ou existe em outro app; falta trazer para o SatiFlow.

Decisões, onde estão

D1 CNAB · D5 cobrança · D6 e-mail · D7 régua · D4 fatura	detalhe do slide 7
D2 alçadas · D3 onde nasce a despesa	detalhe do slide 6
D8 acesso aos TMSs (revisada)	detalhe do slide 3 e acima
D9 saldo · D10 perfis · D11 eventos fiscais	detalhe do slide 9

Entrega. Cada fase tem uma prova objetiva de pronto. A fase 0 é a base: entender o dia a dia de cada pessoa e trazer todas as regras do Conciliador. Depois, enfatize a faixa de baixo: o dado é sempre o do TMS, por crons e em tempo real com o acesso do próprio usuário. Feche com a frase.