Integracoes externas e pagamentos

Catalogo das integracoes e dependencias externas que atravessam cobranca, baixa e comunicacao do sistema.

Mapa resumido da baixa financeira

flowchart LR
    A[clubecad_pgto_novo] --> C[atualiza_dados.asp]
    B[musicasregistradas_pgto_nova] --> C
    D[baixa_boleto_bradesco_novo.asp] --> E[clubecad]
    C --> E[clubecad]
    C --> F[musicasregistradas ou musicasregistradas_1]
    C --> G[faturamento_mensal]
    C --> H[musicas]
    D --> F[musicasregistradas ou musicasregistradas_1]
    D --> I[pedidos_servicos]
    D --> J[festival_ccb_2021]
    D --> K[coletanea]
    D --> L[shop_*]
    D --> G[faturamento_mensal]

Integracoes do conjunto

Integracao	Papel	Evidencia documental
Mailcow	disparo e apoio ao envio de emails do sistema	ambiente e aplicacao
Bradesco	baixa e retorno financeiro de boleto	regras, dados e operacao
e-Rede / callback central	baixa de pagamentos e propagacao de efeitos	fluxos centrais e estrutura do banco
AnyDesk	acesso remoto ao ambiente	ambiente e operacao
Includes em API/	reaproveitamento interno de consultas e dados em cabecalhos e fluxos especificos	estrutura do codigo e legado coletado

Matriz operacional das integracoes

Integracao	Gatilho principal	Entrada	Saida ou efeito	Falha pratica
Mailcow	envio transacional ou tarefa agendada	dados de associado, cobranca, aviso ou ranking	email entregue ou tentativa de disparo	comunicacao automatica deixa de ocorrer
Bradesco	baixa de boleto ou retorno financeiro	pedido, referencia de cobranca e confirmacao	atualizacao financeira e restauracao do estado do associado	pedido permanece sem reflexo final no cadastro
callback central arede/erede/scripts_ccb/atualiza_dados.asp	confirmacao de pagamento	pedidof, controle_refer e tabelas intermediarias	baixa, promocao de estado e consolidacao financeira	pagamento aprovado sem propagacao completa para o modulo
includes em API/	include interno de utilitario ASP	email, CPF ou contexto do fluxo	dados reaproveitados por cabecalho ou paginas especificas	telas dependentes perdem leitura comum desses dados
AnyDesk	acesso manual ao ambiente	operador e sessao remota	manutencao, deploy e validacao manual	operacao fica bloqueada ou mais lenta

Pagamentos e callback

1. O legado usa tabelas intermediarias de pagamento, como clubecad_pgto_novo e musicasregistradas_pgto_nova, antes da baixa definitiva.
2. A abertura da cobranca do associado aparece tanto na central publica quanto em variantes internas da central, preservando clubecad_pgto_novo como tabela intermediaria comum.
3. A baixa do registro percorre o pedidof, marca pagamento em musicasregistradas_pgto_nova e promove os titulos pagos em musicasregistradas ou musicasregistradas_1.
4. O callback central aparece em arede/erede/scripts_ccb/atualiza_dados.asp.
5. A baixa da associacao e refletida em clubecad, clubecad_pgto_novo, faturamento_mensal e musicas.
6. Bradesco/baixa_boleto_bradesco_novo.asp funciona como rota de retorno e restauracao do estado financeiro por boleto.

Matriz de baixa financeira

Caso	Tabela intermediaria	Chave operacional	Escrita final	Efeito esperado
associacao nova	clubecad_pgto_novo	pedidof e controle_refer	clubecad, musicas, faturamento_mensal	associado volta ou entra em S e recebe creditos correspondentes
reativacao	clubecad_pgto_novo	pedidof e controle_refer	clubecad, musicas, shop_*, faturamento_mensal	restauracao do estado ativo
registro de obra	musicasregistradas_pgto_nova	pedidof	musicasregistradas ou musicasregistradas_1 e faturamento_mensal	titulo sai de pendente e fica emitivel

Sequencia pratica do callback central

1. O fluxo encontra o pedido financeiro intermediario.
2. Resolve para qual cadastro, titulo ou lote o pedido aponta.
3. Marca a baixa na tabela intermediaria.
4. Propaga o efeito final para a tabela principal do modulo.
5. Atualiza consolidacoes ou dados derivados, como faturamento_mensal, musicas ou creditos do associado.

Callback central e retorno Bradesco

1. atualiza_dados.asp recebe pedidof por query string, abre pedidos_rede e grava historico_de_pagamentos com meio_de_pgto montado por bandeira.
2. baixa_boleto_bradesco_novo.asp le controle_bradesco.txt, processa arquivos CBddmm00.RET e grava historico_de_pagamentos com meio_de_pgto = boleto_bradesco.
3. Os dois handlers recalculam faturamento_mensal dentro da propria rotina.
4. Os dois usam pedidof como chave de roteamento para decidir a familia de baixa.
5. O detalhamento das duas rotas fica em Baixas Financeiras.
6. O contrato entre as duas rotas fica em Contrato da Baixa.
7. A reexecucao das rotas tecnicas fica em Interrupcoes e Reexecucao.

Email e comunicacao automatica

1. O servidor de email documentado e o Mailcow em VM Linux.
2. O sistema depende dele tanto para disparos transacionais quanto para rotinas automaticas executadas via agendamento/.
3. Falha nessa integracao afeta alertas, cobrancas, avisos de bonus, aniversario, ranking e outras trilhas automaticas.

Eventos e rotinas dependentes de email

Origem	Uso do email
associacao e boas-vindas	comunicacao inicial com o associado
cobranca e atraso	aviso financeiro e lembrete operacional
registro pendente	estimulo a quitacao do titulo
creditos e bonus	aviso de beneficio disponivel
heartbeat operacional	confirmacao de que o servidor segue ativo

Includes em API/ e reaproveitamento interno

Papel da pasta API/

A pasta API/ existe no legado coletado e aparece tambem na arvore publicada. O uso ate aqui e de include interno em ASP, nao de API publica moderna com contrato formal. Os casos concretos encontrados foram getClubecadInfoByEmail.asp, usado por header.asp e headerISO.asp, e getStudioUserInfo.asp, usado por paginas do estudio.

Pontos sensiveis na manutencao

Ponto	Efeito pratico
payload e retorno do callback	manutencao mais arriscada em pagamentos
callback central e retorno Bradesco	duas rotas de baixa precisam permanecer coerentes no fechamento financeiro
contratos de erro e reprocessamento	dificuldade de resposta a falhas e conciliacao

Referencias cruzadas

1. Tabelas transacionais ficam em Dicionario de Dados.
2. Formacao de pedidof e desfechos do pagamento ficam em Pagamentos por Titulo e Fluxos Centrais.
3. A montagem da cobranca e as variantes internas ficam em Centrais de Pagamento.
4. As duas rotas de baixa ficam em Baixas Financeiras.
5. O contrato operacional da baixa fica em Contrato da Baixa.
6. A reexecucao das rotas tecnicas fica em Interrupcoes e Reexecucao.