WASViking Docs
⌘K
Partner Console

Faturamento

Faturas mensais consolidadas, anual pré-pago, compromisso mensal, excedente com soft limit. Como o faturamento de parceiros funciona de fato.

O faturamento de parceiros é consolidado no parceiro, não em cada cliente final. Uma única fatura mensal cobre todos os acessos de clientes ativos sob o parceiro.

A fatura mensal

Todo mês, a WASViking® executa a task do Celery partners.monthly_invoice_previews (dia 1º às 06:00 UTC) e gera uma prévia para cada parceiro.

Conteúdo:

  • Linhas por acesso: plano, módulos, pacotes medidos por uso, ajustes pro rata.
  • Excedente com soft limit, se algum acesso ultrapassou a capacidade provisionada.
  • Trials excluídos (acessos de POC nunca são faturados).
  • Acessos no anual pré-pago excluídos (cobrados separadamente).

Disponível em Billing → Invoices como PDF (WeasyPrint) e CSV.

O acesso à fatura é controlado pela capability partner_billing, e toda visualização é auditada.

Excedente com soft limit

A WASViking NÃO aplica um bloqueio rígido no limite. Em vez disso:

  • A capacidade é provisionada por acesso (máximo de alvos, slots de scan, recomendações de IA por mês etc.).
  • O uso acima da capacidade provisionada é excedente faturável, calculado por unidade e somado à próxima fatura mensal.
  • O parceiro vê a projeção de excedente em tempo real na página de detalhe do cliente.

Isso mantém a plataforma operacional nos momentos de pico e fatura o consumo real depois.

Anual pré-pago

Para acessos com annual_billing_mode = prepaid:

  • Uma única cobrança anual é feita na criação ou na renovação do acesso.
  • O acesso fica fora da fatura mensal consolidada.
  • A task diária do Celery partners.annual_renewals (06:15 UTC) cobra novamente e avança o compromisso em 12 meses.

O anual pré-pago é o modelo mais limpo para parceiros que preferem travar a receita e evitar um lançamento contábil todo mês.

Compromisso mensal (12 meses)

Para acessos com annual_billing_mode = monthly_commit:

  • Permanece na fatura mensal consolidada.
  • Trava o acesso por 12 meses a partir do início do compromisso.
  • Está sujeito ao mínimo annual_monthly_commit_min (controlado por guardrail).
  • A elegibilidade é verificada no momento da cotação (annual_commit_eligible).

A revalidação no servidor recusa, no envio, uma seleção de monthly_commit inelegível e recorre ao prepaid com um aviso.

Momento da conversão do trial

O relógio do compromisso começa:

  • Na criação do acesso, para novos acessos pagos.
  • Na conversão, para acessos em trial.

convert_trial_to_paid muda a Subscription para active, redefine current_period, limpa trial_start/trial_end e atualiza renewal_date. A partir desse momento, o cliente é faturado ao parceiro no ciclo mensal normal (sem pro rata da janela de trial).

Exportação da fatura

Formato Observações
PDF WeasyPrint, invoice_pdf.html, com a marca. Melhor para a entrega à contabilidade.
CSV Uma linha por acesso mais linhas de totalização. Melhor para o sistema de faturamento do próprio parceiro.

Os dois formatos são produzidos a partir dos mesmos dados da fatura; a assinatura de ambos está no roadmap.

O que a WASViking NÃO fatura

  • Acessos em trial (durante o trial).
  • Acessos de clientes com a assinatura desativada.
  • Organizações de demonstração (elas não têm linha em PartnerOrganizationAccess; o pipeline de faturamento percorre apenas partner.customers).

O que o parceiro controla

  • A seleção de plano e add-ons por acesso.
  • O modelo de operação por acesso.
  • Anual pré-pago ou compromisso mensal (por acesso).
  • Os dias de trial solicitados por cotação (a WASViking aprova ou reduz dentro do solicitado).

O que a WASViking controla

  • O preço de lista para o cliente.
  • A estrutura de descontos por tier.
  • O piso do guardrail.
  • O modelo de custo interno usado para calcular as margens (nunca exibido ao parceiro).

O que os parceiros não podem fazer

  • Faturamento consolidado PARA o cliente final por meio da WASViking. O parceiro fatura o cliente diretamente; a WASViking fatura o parceiro. Esta é uma decisão de escopo deliberada.
  • Faturas white-label. A fatura leva a marca WASViking por design.

As entradas de preço por trás de cada linha da fatura (desconto por tier, guardrails, escolhas anuais) são fixadas no momento da cotação. Veja Motor de cotação e preços.