Saldo das contas de anúncio

Classifique cada conta por is_prepay_account. Na pré-paga, a pergunta é saldo disponível. Na pós-paga, é valor devido, guardado como número positivo e mostrado com sinal negativo só na apresentação. Nunca some saldo de pré-paga com valor devido de pós-paga.

Na conta pré-paga, leia o valor do texto 'Saldo disponível (...)' em funding_source_details.display_string. O campo balance não é o saldo da pré-paga, e spend_cap - amount_spent também não: spend_cap é limite de gasto e amount_spent é o gasto acumulado da vida da conta. Se o texto não puder ser lido com segurança (outra moeda, outro idioma), o saldo é nulo, nunca zero. Guarde balance bruto com nome neutro para auditoria.

balance, amount_spent e spend_cap da Meta vêm na menor unidade da moeda: divida por 100. No Google, adjusted_spending_limit_micros e amount_served_micros vêm como texto em micros: converta para número e divida por 1.000.000. Cada conta tem a sua moeda; não some moedas diferentes.

Use a linha de account_budget com status APPROVED e approved_start_date_time mais recente da conta. Saldo = adjusted_spending_limit_micros - amount_served_micros, em reais. O conector não traz recargas individuais: o orçamento é o total aprovado e o consumo acumulado.

Quando a plataforma não expõe o saldo, parta de um saldo de referência conferido na tela num instante conhecido. Saldo atual = referência + recargas confirmadas depois dele (event_type funding_event_successful no log de atividades) - gasto depois dele (insights por hora, a partir da primeira hora cheia após a referência). Refaça a referência sempre que o valor divergir da tela.

Se a recarga por Pix sofre imposto (por exemplo, 12,15%), o saldo líquido é o valor pago x (1 - taxa). Compare o orçamento diário configurado nas campanhas com o saldo líquido, não com o valor que o cliente transferiu.

Gasto médio = média dos últimos 3 dias completos (hoje fica fora, porque o dia está pela metade). Dias até zerar = saldo / gasto médio. Converta para dias úteis, sem fins de semana e feriados, porque o cliente paga em dia útil. Sem gasto médio válido, o status é indeterminado, não infinito.

Crítico quando faltam até 5 dias úteis, o mínimo para pedir, aprovar, pagar e compensar a recarga; baixo com 6 a 7 dias úteis; ok acima disso. A janela é de cada cliente e fica no contexto dele. Mensagem ao cliente e alerta interno são textos diferentes.

A tabela de contas de uma fonte lista tudo o que a credencial enxerga no Business Manager. Filtre pelo account_id oficial do registro. A fonte que trouxe o dado financeiro pode estar na camada de outro cliente: nunca deduza o dono da conta pela camada de origem. Some saldos de contas diferentes só na mesma foto e na mesma moeda.

A tabela atual tem uma linha por cliente e conta e diz quando foi gerada; ela não responde saldo de ontem. Grave em paralelo um histórico diário por anexação. O alerta guarda o último status enviado por conta e só dispara de novo quando o status muda ou piora, com registro de envio.