> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/configurando-sua-plataforma/gestao-financeira-e-faturamento/relatorio-de-faturamento.md). # Relatório de Faturamento O **Relatório de Faturamento** é a sua central de controle e transparência financeira dentro da plataforma. Esta ferramenta foi projetada exclusivamente para que você, parceiro, tenha total visibilidade sobre a composição dos custos operacionais de cada conta sob sua gestão em um período específico. Ao utilizar este relatório, você garante uma auditoria precisa e justa para o repasse de custos aos seus clientes, pois o sistema consolida, em um único local, o consumo detalhado de: * **Recursos de Equipe:** Quantidade de usuários ativos por faixas de preço. * **Canais de Atendimento:** Conexões de WhatsApp e Instagram. * **Infraestrutura Técnica:** Instâncias de conexão e volume de dados. * **Serviços Adicionais:** Aplicativos de IA, transcrição de áudio e integrações financeiras. {% hint style="success" %} **💡 Por que este relatório é importante?** Diferente de uma fatura estática, este painel permite uma análise dinâmica onde você pode identificar quais contas possuem maior peso no faturamento e validar se o uso de recursos está condizente com o plano contratado pelo seu cliente final. {% endhint %} #### Como Acessar Para visualizar seus dados financeiros atualizados, utilize o caminho abaixo no menu: **Admin > Relatório de Faturamento.** {% hint style="success" %} **Destaques Importantes** * **Filtro por Data:** É possível alterar a "Data de referência" no topo da página para consultar meses anteriores. * **Exportação:** Geralmente, esses dados podem ser utilizados para que o parceiro realize o repasse de cobrança para seus clientes finais de forma justa e auditável. {% endhint %}
### Estrutura da Tela A interface é dividida em quatro áreas principais para facilitar a análise: #### 1. Painel Consolidado Localizado à esquerda, este painel apresenta o resumo financeiro consolidado do parceiro para o período selecionado. Ele serve como o fechamento geral da fatura, somando os custos fixos da parceria aos custos variáveis das contas gerenciadas. * **Período e Parceiro:** Identificação do mês de referência do faturamento e o nome da empresa parceira. * **Aplicativo e Domínio (Opcionais)** Estes campos exibem os valores fixos mensais referentes à personalização visual e técnica da sua plataforma, cobrados apenas se você optar por remover a marca Helena e utilizar sua própria identidade. A composição do custo varia conforme os itens contratados: * **Personalização Completa (App + Domínio):** Caso o parceiro utilize tanto o aplicativo personalizado quanto o domínio próprio, o investimento total é de **R$ 900,00.** * **Somente Aplicativo:** Se a personalização for aplicada exclusivamente ao aplicativo, o custo fixo é de **R$ 800,00.** * **Somente Domínio:** Caso o parceiro opte apenas pela personalização do domínio, o valor mensal é de **R$ 190,00.** {% hint style="info" %} **Observação de Auditoria:** No exemplo visual do painel, os valores aparecem discriminados separadamente para facilitar a conferência de quais serviços estão ativos na sua parceria. {% endhint %} * **Contas:** Refere-se à soma total do faturamento de todas as contas individuais detalhadas na tabela ao lado. * **Custo Instâncias Z-API:** Valor total referente à manutenção das conexões de WhatsApp estáveis utilizadas por todas as contas do parceiro. * **Custo Infraestrutura:** Valor variável relacionado à manutenção técnica e suporte ao volume de dados da plataforma. * **Total:** É a soma final de todos os itens acima, representando o valor total que o parceiro deve quitar no período **(ex: R$ 19.885,33)**. {% hint style="info" %} **Detalhamento do Custo** Para obter uma visão aprofundada e analítica dos valores que compõem o item **Custo Infraestrutura**, você pode acessar o menu **Admin > Custo de infraestrutura**. Por meio deste caminho, é possível extrair o relatório detalhado de consumo técnico da plataforma. {% endhint %}
#### 2. Tabela de Contas Esta seção detalha o faturamento individual de cada conta sob responsabilidade do parceiro. | **Coluna** | **Descrição** | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Início/Fim faturamento** | Define o período exato (intervalo de dias) em que a conta esteve ativa e foi tarifada dentro do mês de referência. | | **Qtde Usuários** | Total de usuários ativos na conta. | | **Usuários Faixa 1** | Quantidade de usuários faturados na primeira faixa (do 4º ao 20º usuário), com custo unitário de **R$ 19,90.** | | **Usuários Faixa 2** | Quantidade de usuários faturados na segunda faixa (do 21º ao 100º usuário), com custo unitário de **R$ 14,90**. | | **Usuários Faixa 3** | Quantidade de usuários faturados na terceira faixa (acima de 100 usuários), com custo unitário de **R$ 12,90**. | | **Qtde Canais** | Total de canais de atendimento (WhatsApp ou Instagram) configurados na conta.. | | **Canais Faixa 1** | Quantidade de canais faturados na primeira faixa (do 2º ao 5º canal), com custo unitário de **R$ 29,90**. | | **Canais Faixa 2** | Quantidade de canais faturados na segunda faixa (acima de 5 canais), com custo unitário de **R$ 19,90**. | | **App (Transcrição Áudio)** | Valor total cobrado pelo uso do serviço de transcrição de áudio, calculado o valor de **R$ 3,99** pelo número total de usuários cadastrados na conta. | | **App (Asaas)** | Custo fixo mensal pela integração ativa com o banco digital Asaas (**R$ 49,50**). | | **App (IA)** | Valor cobrado pelo uso de serviços de Inteligência Artificial (**R$ 50,00**). | | **Total (R$)** | Soma final de todos os itens da conta (Licença Base + Faixas de Usuários/Canais + Apps). | {% hint style="info" %} **Nota sobre a cobrança de Transcrição de Áudio** A tarifação deste serviço é realizada sobre a base total de usuários ativos no sistema, independentemente de terem acessado a plataforma ou utilizado a funcionalidade de transcrição durante o mês (como em casos de férias ou licenças). Estando o usuário habilitado na conta, o custo de R$ 3,99 será aplicado integralmente. {% endhint %}
#### 3. Memória de Cálculo: Entenda a Composição dos Valores O faturamento de cada conta é calculado de forma progressiva, utilizando um modelo de faixas que premia o ganho de escala. Abaixo, detalho a lógica por trás de cada coluna do relatório: {% hint style="warning" %} **Observação** Toda a explicação dos cálculos detalhada neste artigo foi baseada nas diretrizes e valores estabelecidos na tabela de preços de **Dezembro de 2025.** {% endhint %} #### **Licença Base** Antes das faixas, cada conta possui uma Licença Base fixa que dá direito aos recursos iniciais: * **Valor Unitário:** R$ 149,90. * **Inclui:** 1 conta licenciada, 3 usuários e 1 canal (WhatsApp ou Instagram). #### Colunas de Usuários (Faixas 1, 2 e 3) O cálculo de usuários é aplicado apenas sobre os usuários que excedem os 3 inclusos no plano base.
ColunaRegra de QuantidadeRegra de ValorCálculo do Valor
Faixa 1De 4 até 20 usuáriosÉ cobrado o valor de R$ 19,90 por usuário adicional(Quantidade - 3) * R$ 19,90
Faixa 2De 21 até 100 usuáriosAplica-se o valor fixo da Faixa 1 (R$ 338,30) mais R$ 14,90 por usuário acima de 20.R$ 338,30 (fixo da faixa 1) + (Excedente de 20 * R$ 14,90)
Faixa 3Acima de 101 usuáriosAplica-se o valor acumulado das faixas anteriores (R$ 1.530,30) mais R$ 12,90 por usuário acima de 100.R$ 1.530,30 (acumulado 1 e 2) + (Excedente de 100 * R$ 12,90)
#### Colunas de Canais (Faixas 1 e 2) Refere-se a números de WhatsApp ou contas de Instagram adicionais. O primeiro canal é gratuito (plano base).
ColunaRegra de QuantidadeRegra de ValorCálculo do Valor
Faixa 1De 2 até 5 CanaisÉ cobrado o valor de R$ 29,90 por canal adicional.

(Total de Canais - 1)

* R$ 29,90

Faixa 2Acima de 5 CanaisAplica-se um valor fixo pelos primeiros 5 canais, mais uma taxa menor por canal extra.

R$ 119,60 + (Total

de Canais - 5) * R$ 19,90

#### Aplicativos e Serviços Adicionais Estes valores são somados individualmente por conta conforme a ativação do serviço. * **App (Asaas):** Valor fixo de R$ 49,50 pela conexão direta com a conta bancária/digital. * **App (IA - Agentes):** Valor fixo mensal de R$ 50,00 por uso de Inteligência Artificial generativa. * **App (Transcrição de Áudio):** Cobrança por usuário que utiliza o recurso, no valor de R$ 3,99 por usuário. * **Z-API:** Taxa de conexão para canais oficiais/estáveis de R$ 69,90 por instância ativa. {% hint style="info" %} **Exemplo de Cálculo Consolidado** Se uma conta possui 6 usuários e 2 canais, com Asaas ativo: 1. **Plano Base:** R$ 149,90. 2. **Usuários Extra (3):** `3 * R$ 19,90 = R$ 59,70`. 3. **Canais Extra (1):** `1 * R$ 29,90 = R$ 29,90`. 4. **App Asaas:** R$ 49,50. * **Total da Conta:** R$ 289,00 (aproximado conforme regras de arredondamento). {% endhint %} #### 4. Instâncias QRCode Esta tabela registra o custo individual de cada conexão (instância) ativa durante o mês de referência. O sistema aplica uma cobrança proporcional (pro-rata), garantindo que o parceiro pague apenas pelo período em que o serviço esteve disponível para a empresa. {% hint style="warning" %} #### Modelos de Cobrança Z-API **Importante:** O Relatório de Faturamento reflete apenas as instâncias de conexão que são contratadas e gerenciadas diretamente através da nossa plataforma. * **Contratação via Plataforma (R$ 69,90):** Este é o valor fixo utilizado para todos os cálculos de faturamento e exemplos de cobrança proporcional (*pro-rata*) demonstrados neste guia. * **Contratação Direta com a Z-API:** Caso o cliente opte por contratar o serviço de forma independente diretamente com a Z-API **(valor de R$ 99,90)**, a transação financeira ocorre entre o cliente e o provedor externo. Por esse motivo, estas instâncias **não são listadas no nosso relatório** e não compõem o valor total da sua fatura. {% endhint %} #### Uso (Dias) A coluna **Uso (Dias)** indica a quantidade de dias, dentro do mês filtrado, em que a instância permaneceu ativa no sistema. * O cálculo considera o intervalo entre o **Início faturamento** e o **Fim faturamento** (ou a data de cancelamento) que ocorrem dentro do mês selecionado. * Se uma instância permaneceu ativa durante todo o mês de 30 dias, o valor de uso será **30.** #### Valor (R$) - Cálculo Proporcional O custo fixo mensal para cada instância de conexão Z-API é de **R$ 69,90**. Quando a instância não é utilizada durante o mês integral, o sistema realiza o seguinte cálculo:

Valor = \left( \frac{\text{Custo Mensal (R\$ 69,90)}}{\text{Dias do Mês}} \right) \times \text{Dias de Uso}

**Exemplos Práticos do Relatório:** | **Empresa** | **Uso (Dias)** | **Lógica do Cálculo** | **Valor Final (R$)** | | ----------- | -------------- | --------------------------------------------- | -------------------- | | Conta1 | 30 dias | Uso integral do mês (Valor fixo) | R$ 69,90 | | Conta2 | 22 dias | Cálculo proporcional por 22 dias de atividade | R$ 51,26 | | Conta3 | 5 dias | Cálculo proporcional por 5 dias de atividade | R$ 11,65 | | Conta4 | 1 dia | Valor mínimo de uso diário identificado | R$ 2,33 |
{% hint style="warning" %} #### Observações Importantes sobre Tarifação e Prazo * **Encerramento de Conta (Cancelamento):** Caso uma conta seja desativada no decorrer do mês, a coluna Fim faturamento delimita automaticamente o cálculo de dias para que a cobrança seja interrompida. * **Gestão de Instâncias no Cancelamento:** Se houver uma instância Z-API contratada através da nossa plataforma, ela será removida da conta e o custo proporcional cessará na exata data de cancelamento, evitando cobranças residuais. * **Novas Conexões:** Instâncias ativadas após o início do mês seguem rigorosamente a regra de cobrança proporcional (*pro-rata*), baseando-se na data registrada na coluna Início faturamento. * **Corte Imediato:** O sistema garante que, uma vez registrado o desligamento ou ativação, o cálculo de **Uso (Dias)** seja atualizado para refletir apenas o período de disponibilidade real do serviço. {% endhint %} #### 5. Gráfico de Maiores Clientes Uma visualização em formato de pizza que permite identificar rapidamente quais contas possuem maior peso no faturamento total. No exemplo, o cliente "Conta x" representa 7,23% do volume total, enquanto o grupo "Outros" soma 33,95%.
#### 6. Exportação do Relatório #### Como Exportar o Relatório Completo Para obter uma cópia visual de todo o painel de faturamento, incluindo os gráficos e o resumo consolidado, utilize a função de exportação global: * **Localização:** No canto superior direito da tela, acima do painel principal, localize o ícone de nuvem com uma seta. * **Formato:** Ao clicar neste ícone, selecione a opção **"Baixar como PDF"**. * **Resultado:** O sistema gerará um arquivo PDF contendo a visualização exata da tela no momento da exportação, ideal para apresentações ou arquivamento visual.
#### Como Exportar Gráficos e Tabelas Separadamente Caso você precise manipular os dados brutos de uma seção específica (como a **Tabela de Contas** ou **Instâncias QRCode**) em ferramentas como Excel ou Google Sheets, siga estes passos: 1. **Acessar o Menu da Seção:** Passe o mouse sobre a tabela ou gráfico que deseja exportar e clique no ícone de **três pontos (...)** localizado no canto superior direito dessa seção específica. 2. **Selecionar Download:** Clique na opção **"Fazer download de resultados"**. 3. **Escolher o Formato:** Uma janela modal será aberta, oferecendo três formatos de arquivo: * **.csv:** Ideal para importação em sistemas de banco de dados. * **.xlsx:** Recomendado para uso no Microsoft Excel, mantendo a compatibilidade de células. * **.json:** Formato técnico para desenvolvedores ou integração de dados. 4. **Configurações de Formatação:** Marque a caixa **"Mantenha os dados formatados"** se desejar que datas e valores monetários sejam exportados exatamente como aparecem no sistema. 5. **Concluir:** Clique no botão azul **"Baixar"** para iniciar o download. {% hint style="info" %} A exportação individual por seção é a melhor forma de realizar conciliações financeiras, pois permite filtrar e somar os valores das colunas de "Total (R$)" ou "Instâncias" diretamente no Excel. {% endhint %}
{% hint style="info" %} **Quem pode visualizar este relatório?** Por conter informações financeiras estratégicas, o acesso ao **Relatório de Faturamento** é restrito a perfis específicos, como o perfil **Financeiro**, que possui permissão exclusiva para esta aba. Para entender detalhadamente quais são as permissões e restrições de cada nível de acesso (Super Administrador, Financeiro e Suporte), consulte o artigo: [Usuários ADM](https://docs.helena.app/configurando-sua-plataforma/contas-e-planos/usuarios-adm) {% endhint %}