O processo financeiro do anúncio representa toda a jornada que transforma uma ocupação de painel em receita efetivamente recebida.
É o fluxo mais crítico do sistema porque conecta operação, comercial e financeiro em uma linha contínua.

O processo é composto por 6 etapas principais:

1. Registro da ocupação (comercial/operacional)

2. Geração automática dos itens faturáveis

3. Agrupamento em documento financeiro (cobrança/fatura)

4. Envio da cobrança ao anunciante

5. Registro do pagamento

6. Liquidação do item e atualização da disponibilidade

Cada etapa é descrita em detalhes abaixo.

3.1. Etapa 1 — Registro da Ocupação

O início do processo financeiro começa quando um anúncio é criado.

No momento em que o operador seleciona:

• Painel

• Bissemana

• Campanha

• Anunciante

O sistema entende que houve uma locação comercial de espaço publicitário, o que originará uma cobrança.

Essa etapa ocorre na interface:

Módulo → Campanhas → Inserir Painéis

Resultado:

O sistema valida:

• painel ativo

• bissemana existente

• inexistência de conflito de ocupação

• anunciante válido

Se tudo estiver correto, a ocupação é registrada (tabela operacional).

3.2. Etapa 2 — Geração Automática do Item Faturável

Assim que a ocupação é gravada, o sistema cria automaticamente um registro na tabela:

financeiro_itens

Este item representa um valor a ser cobrado.

O sistema preenche automaticamente:

• id_painel

• id_bissemana

• id_campanha

• id_anunciante

• valor_unitario (puxado do catálogo de preços)

• valor_total

• status: pendente

Regras:

• Um item por painel por bissemana.

• Se a campanha usar 5 painéis durante 3 bissemanas → 15 itens faturáveis.

Benefício:

Garante que nenhum centavo seja esquecido.

3.3. Etapa 3 — Agrupamento em Documento Financeiro

O anunciante não recebe 50 boletos diferentes. Ele recebe 1 fatura contendo vários itens.

O responsável financeiro executa:

Financeiro → Gerar Cobrança

O sistema permite:

• agrupar automaticamente todos os itens pendentes do anunciante

• ou selecionar manualmente quais itens incluir na fatura

Resultado:

Uma nova cobrança é criada:

financeiro_cobrancas

Com:

• data de emissão

• data de vencimento

• valor total

• status: pendente

• itens vinculados (via financeiro_cobrancas_itens)

Observação:

Um mesmo anunciante pode ter:

• cobranças abertas

• cobranças atrasadas

• cobranças canceladas

• cobranças emitidas parcialmente

O sistema mantém histórico completo.

3.4. Etapa 4 — Envio da Cobrança ao Cliente

Com a cobrança aberta, o sistema permite:

• gerar PDF da cobrança

• enviar por e-mail (opcional)

• anexar nota fiscal eletrônica (futuro)

• exportar para contabilidade

Informações que constam na cobrança:

• Identificação do anunciante

• Lista de itens (painel + período)

• Total

• Dados bancários

• Histórico da campanha
  – QR Code Pix (opcional na V2)

O envio desencadeia automaticamente:

• registro de que o cliente recebeu

• status permanece: pendente

3.5. Etapa 5 — Registro do Pagamento

O cliente efetua o pagamento.

O operador financeiro acessa:

Financeiro → Registrar Pagamento

Preenche:

• valor pago

• data de pagamento

• forma de pagamento (Pix, boleto, TED, desconto etc.)

• comprovante (upload opcional)

Ao salvar, o sistema cria um registro em:

financeiro_pagamentos

E realiza:

1. Abate do valor da cobrança

2. Atualização automática do status:

   • pago (valor integral)

   • parcialmente pago

   • atrasado (se vencido e sem pagamento)

3.6. Etapa 6 — Liquidação do Item e Liberação da Disponibilidade

Após a cobrança ser considerada paga, o sistema:

• marca todos os itens daquela cobrança como liquidados

• registra data de baixa

• evita qualquer reprocessamento

Além disso:

• atualiza o painel para permitir novo ciclo financeiro

• mantém o histórico para auditoria

Nota:

A liquidação financeira não interfere na disponibilidade operacional, mas pode gerar alertas:

“Painel utilizado e pago — liberar pré-reserva da próxima campanha.”

3.7. Regras de Negócio Importantes

1. Sem item faturável → sem cobrança.
   Nunca existe cobrança sem origem.

2. Uma cobrança pode conter vários itens, mas um item só pertence a uma cobrança.

3. O cancelamento de uma cobrança reabre os itens como pendentes.

4. A exclusão de ocupação de painel exige:

   • item ainda pendente

   • cobrança não emitida

5. Se o pagamento for menor que o total:

   • sistema mantém cobrança como parcialmente paga

   • mantém rastreabilidade

3.8. Fluxo Simplificado

1. Ocupação registrada →
2. Item gerado automaticamente →
3. Itens agrupados → Cobrança →
4. Cliente recebe fatura →
5. Pagamento registrado →
6. Itens liquidados e painel segue para próxima campanha

3.9. Benefícios do Processo

• Nenhuma cobrança fica esquecida

• Redução de erros manuais

• Previsibilidade de receita

• Histórico financeiro completo

• Possibilidade de auditoria e exportação

• Controle claro do que foi usado, faturado e pago