Infoprodutos e renovação

O grão é a parcela ou cobrança. Venda = código de transação distinto com a primeira parcela aprovada (`purchase.recurrency_number` vazio ou 1). As parcelas seguintes são continuação: entram no recebido do mês, nunca como venda nova. Vendas, clientes e reembolsos são contagens distintas e não se somam entre meses, cursos ou canais: recalcule no recorte pedido.

Venda válida = `purchase.status` APPROVED ou COMPLETE: a plataforma passa de APPROVED para COMPLETE ao fim da garantia. Reembolso = REFUNDED e CHARGEBACK. Quando os status chegam em grafias mistas (português e inglês), use flags calculadas uma vez e nunca filtre por literal. A consulta de histórico sem filtro de status devolve só aprovadas e completas: peça os demais status explicitamente para enxergar reembolso e cancelamento. Nunca some valor sem filtro de status.

A classificação vem da tabela de referência de produtos (tipo de compra de cada id de produto) e do número da parcela: parcela seguinte = continuação; primeira parcela de produto de renovação = renovação; produto de taxa inicial = taxa inicial; o resto = compra nova. Primeira compra é a primeira vez daquela pessoa naquele produto, não cliente novo na escola. Um curso pode ter vários ids de produto (à vista, assinatura, 6 e 12 meses): não deduplique por nome.

A plataforma não grava a data do reembolso: o estorno vira status na linha da venda original. Reembolso é contado no mês da venda, e o número de um mês continua crescendo por semanas depois que ele acaba. Compare meses com a mesma idade e diga isso. Para acompanhar a maturação, use fases: aprovada, garantia da plataforma cumprida (`warranty_expire_date`), consolidada pela regra da casa (por exemplo, 30 dias da aprovação) e reembolsada.

Ordem de decisão: 1) afiliado da venda (o cookie, em `hotmart_sales_participants` com papel AFFILIATE) se a conta estiver na referência como comercial, ex-vendedor ou afiliado externo; 2) código de vendedor encontrado no `tracking.source_sck`; 3) senão, marketing, inclusive venda sem sck. Grave o motivo (afiliado, sck, os dois, cookie contra sck) e o vendedor que decidiu. A lista de códigos e contas mora na tabela de referência, nunca no código da transformação. Afiliado fora da lista conta como marketing.

O comercial também vende lançamento e renovação. A oferta de origem (perpétuo, lançamento, webinário, live, renovação, orgânico) é outra coluna, derivada do padrão do sck. No funil, resuma em direta (oferta do próprio funil), indireta (lançamento e eventos), renovação e não identificada. Quando a venda indireta aparece num funil, o custo do lançamento não está na conta desse funil: diga isso.

Bruto = preço da transação convertido para real: BRL direto, EUR pela PTAX do dia, outras moedas pela taxa da plataforma para dólar vezes a PTAX do dólar. Líquido = comissão do produtor (`hotmart_sales_commission`, fonte PRODUCER), o que fica para a escola. Escolha uma régua para faturamento e ROAS e declare. Contratado (preço x parcelas na primeira parcela do parcelamento) é diferente de recebido no mês, e parcelas futuras não estão na base.

Grão: uma linha por assinatura, de todas as contas. Considerar = status ACTIVE, DELAYED ou OVERDUE e produto marcado para considerar. Projetado = soma de `price.value` das assinaturas consideradas por mês de `date_next_charge`, na moeda da assinatura (`price.currency_code`), nunca na moeda da última transação. Churn agendado = não considerar. Declare o denominador: só ativas ou ativas mais atraso. Atraso não é fila de cobrança: DELAYED já tem a próxima cobrança reagendada; a fila real é a próxima cobrança até hoje.

A tabela de previsão é sobrescrita a cada execução: grave a data da foto em coluna. Para série histórica, grave em modo append com a data da foto, e nunca some fotos diferentes. Forecast do mês = realizado até ontem + projetado restante x taxa de conversão (realizado / projetado até ontem). No começo do mês, a taxa de 3 ou 4 dias é instável: use a taxa fechada do mês anterior até por volta do dia 10. Repasse contratado que entra como assinatura fica fora da taxa.

Cancelamento = status CANCELLED_BY_CUSTOMER, CANCELLED_BY_SELLER ou CANCELLED_BY_ADMIN, com a data em `end_accession_date`. Filtre pelo status, nunca por ter data: assinaturas reativadas também trazem a data. Segmente por quem cancelou: um lote cancelado pelo admin é evento operacional, não churn. Contas lidas por duas fontes geram a mesma assinatura e a mesma transação duas vezes: deduplique por código.