Plano de mídia: planilhas e cálculos

A aba Planilhas detalha a compra de mídia por programas e inserções. É o local mais importante para conferir como quantidade, valor unitário, percentuais e datas formam os totais.

O cartão Total do plano, no cabeçalho, mostra o Valor Bruto Cliente consolidado de todas as planilhas.

Na listagem, o rodapé das colunas Valor Bruto Cliente e Valor Bruto Veículo mostra os totais consolidados de todas as planilhas do plano. Os valores permanecem iguais ao trocar de página ou filtrar a listagem; representam o plano inteiro.

Estrutura

Uma planilha possui capa, programas e inserções. A quantidade do programa é a soma das quantidades de suas inserções. As inserções podem ser agrupadas por data para conferência do calendário.

Capa da planilha

Na inclusão e na edição, a capa usa o layout em tabela com duas colunas. O Período recebe uma data inicial completa (dd/mm/aaaa); o término é sempre o último dia desse mês. Se o início for 15/06, a grade de inserções mostra somente os dias de 15/06 a 30/06. Datas fora do período continuam sujeitas às validações da planilha.

Na inclusão, o cliente do plano fornece Faturamento, Comissão e Desconto. A comissão vem de Comissão agência > Percentual Comissão; o desconto vem de Descontos > % desconto no plano de mídia. A comissão usa duas casas decimais e o desconto da capa usa cinco, ambos com símbolo % e limites de 0 a 100.

Na seção Identificação, o campo Meio fica após UF, como último campo do grupo. Ele recebe o meio principal do cadastro do veículo e permite texto livre (até 180 caracteres). Se não houver meio cadastrado, pode ser preenchido manualmente. O texto é salvo na capa e pode ser ajustado na inclusão e na edição.

Ao escolher um veículo, o fornecedor vinculado fornece Meio, Representante, Praça, UF e Prazo de pagamento, quando cadastrados. Os selects de faturamento e prazo de pagamento usam as mesmas opções dos cadastros de origem. Você pode ajustar os valores antes de salvar.

O resumo financeiro do modal aparece desde a abertura da capa, usando os totais salvos da planilha inteira. Carregar ou paginar programas não limita esse resumo à página atual. Alterações confirmadas em programas atualizam também os valores da linha na listagem; ao fechar o modal, o resumo consolidado do plano é atualizado.

Abrir uma capa existente preserva os dados já salvos. Alterar o cadastro de origem posteriormente não muda planilhas existentes. A troca do veículo atualiza os padrões do fornecedor escolhido; respostas antigas não substituem uma seleção mais recente nem alterações manuais feitas durante o carregamento.

O campo Gênero do programa consulta o catálogo em Cadastro > Tabelas Auxiliares > Gêneros, respeitando as descrições personalizadas da empresa.

Cálculo de programas de TV

Para um programa, o sistema calcula o valor unitário ajustado assim:

valor unitário ajustado = valor unitário
  − (valor unitário × desconto / 100)
  + (valor unitário × acréscimo / 100)
  + (valor unitário × acréscimo de cor / 100)

total do programa = valor unitário ajustado × quantidade

O valor unitário e o desconto do programa permitem cinco casas decimais na edição e na gravação, por exemplo 1.234,56789 e 2,54321%. Acréscimos continuam com duas casas e os totais monetários permanecem em centavos.

Os percentuais vêm dos campos de desconto, acréscimo e acréscimo de cor do programa. A quantidade vem das inserções relacionadas. O resultado é arredondado para dinheiro quando salvo.

Desconto e acréscimo são exclusivos: enquanto um estiver maior que zero, o outro fica desabilitado. Zere o percentual em uso antes de trocar. A API também recusa os dois percentuais simultâneos, inclusive em edição parcial e substituição de programas.

Totais da planilha

Na consolidação, o sistema usa as seguintes bases:

valor bruto do veículo = soma(total do programa)
comissão original = valor bruto do veículo × comissão da capa / 100
valor líquido do veículo = valor bruto do veículo − comissão original
comissão efetiva = valor bruto do veículo × (comissão da capa − desconto da capa) / 100
desconto = comissão original − comissão efetiva
valor bruto do cliente = valor líquido do veículo + comissão efetiva
encargos = 0 (cálculo ainda não definido)

Os encargos permanecem zerados. Acréscimo e acréscimo de cor continuam ajustando o valor unitário e o total do programa, sem serem classificados como encargos.

O desconto da capa reduz a comissão em pontos percentuais, limitado à comissão original para não gerar comissão negativa. Com bruto de R$ 1.000,00, comissão de 20% e desconto de 5 pontos, a comissão efetiva é R$ 150,00, o líquido do veículo é R$ 800,00 e o bruto do cliente é R$ 950,00. Sem desconto na capa, a comissão é R$ 200,00 e o bruto do cliente é R$ 1.000,00. Os ajustes do programa já estão incluídos no bruto do veículo; não entram novamente no card de desconto da comissão.

Os nomes acima correspondem aos campos consolidados da planilha. A aplicação arredonda os valores monetários ao salvar. O recálculo ocorre quando programas, inserções, valores, percentuais ou a capa são alterados.

Regras e dependências

Toda planilha começa com a situação Aguardando aprovação. As situações possíveis são Aguardando aprovação, Aprovado, Não aprovado, Suspenso, Liberado para faturamento, Faturado, Concluído, Entregue e Encerrado.
Aprovar uma planilha registra a data informada e altera somente a situação; isso não gera um pedido de inserção. A geração do pedido será uma etapa posterior.
A aprovação e a não aprovação podem ser alternadas. Ao não aprovar uma planilha já aprovada, a data de aprovação existente é preservada.
A quantidade de um programa não deve ser digitada como uma segunda fonte se a tela a calcular a partir das inserções.
Programa, gênero, praça, rede e peça são referências usadas para preencher e identificar linhas; eles não criam valor sem os campos numéricos da linha.
Comissão e desconto da capa impactam o resumo consolidado.
Uma inserção com quantidade zero não contribui para a agregação de quantidade por data.
Revise datas, quantidade e valores antes de aprovar a planilha.

Permissões

Capa, programas, situações e anexos têm controles independentes. Visualizar a planilha não concede acesso aos programas. Só Adicionar permite criar uma planilha em branco; preencher ou alterar a capa exige Editar planilha. Criar, editar, excluir ou reordenar programas exige suas próprias ações. Aprovação e reversão verificam as permissões dos estados de origem e destino.

A aprovação não bloqueia a edição da capa nem dos programas. As permissões de edição continuam obrigatórias; a exclusão de uma planilha aprovada permanece bloqueada.

A coluna Situação da listagem usa uma paleta fixa, mantendo o texto como identificação:

Situação	Cor
Aguardando aprovação	Amarelo
Aprovado	Verde
Não aprovado	Rosa
Suspenso	Laranja
Liberado para faturamento	Azul
Faturado	Violeta
Concluído	Verde-petróleo
Entregue	Índigo
Encerrado	Cinza

No menu da linha, use Editar, Excluir ou Alterar status. Alterar status abre o mesmo formulário dos pedidos de inserção, com as nove situações do sistema, limitado às transições permitidas ao usuário. Aprovar exige a data de aprovação.

A dock de seleção oferece Excluir, Alterar status e Gerar pedido para as planilhas selecionadas. O menu de cada linha também oferece Gerar pedido, logo após Alterar status. A geração pede confirmação, ignora pedidos já existentes e informa os resultados, seguindo as mesmas regras dos pedidos de inserção.