Plataforma EADBOX - Financeiro

Este documento tem como objetivo servir como guia e referência para operações relacionadas a parte financeira da plataforma e ao Pagamentos EADBOX, sendo mais detalhado em relação ao Pagar.me.

1. Campanhas e Cupons

A plataforma EADBOX conta com funcionalidades que possibilitam o responsável pelos produtos realizar promoções com (ou sem) desconto no valor. Essas ferramentas são os cupons e as campanhas.

As campanhas funcionam através de cookies. Isso significa que, no momento que o comprador acessa a página da campanha a nossa aplicação salva um dado no navegador dele que indica que esse usuário possui direito a um desconto. Caso a campanha expire antes da compra, o curso seja removido da campanha ou a campanha seja deletada, esse desconto será removido.

Na hora de criação de uma campanha, você irá notar uma opção "Mostrar no marketplace" caso esteja logado como Admin Config ou a extensão "Marketplace" esteja ativada na plataforma e Pagamentos EADBOX seja o meio de pagamento ativo. Essa feature seria utilizada em um projeto da EADBOX chamado "EADBOX Hub". Basicamente ela define quanto a EADBOX vai receber pela compra caso o comprador tenha realizado a transação por aquele link de campanha. Não há necessidade de utilizar essa funcionalidade pois o projeto do EADBOX Hub não foi pra frente, sendo substituído pelo Afiliados EADBOX.

Cupons são salvos na matrícula de um aluno, ou seja, quando um comprador entra um cupom de desconto na hora do checkout, qualquer cupom que havia salvo anteriormente é destruído e um novo pagamento do tipo Coupon é criado na plataforma.

2. Menu Financeiro

O menu de financeiro da Plataforma EADBOX possui ferramentas que podem auxiliar o administrador da plataforma a gerenciar os recursos adquiridos através da venda de produtos na plataforma.

Informações do Painel de Vendas e da página de Extratos são atualizadas diariamente (não são em tempo real). Apenas as abas de Pagamentos, Planos e Coautores contém dados em tempo real que a plataforma recebe via API do Pagar.me.

2.1. Painel de vendas

O painel de vendas possui um compilado de dados que são importantes para o administrador, como o dinheiro ganho através de vendas em um período específico de tempo, gráficos de vendas mensais, gráficos de conversão e um resumo dos planos, combos e cursos. O painel de vendas é atualizado diariamente por um job que roda de madrugada.

Uma documentação detalhada (e técnica) de como o painel de vendas realiza as contas dos gráficos pode ser analisada aqui.

2.2. Extratos

A tela de extratos possui todas as transações realizadas na plataforma, tenha sido via Pagamentos EADBOX ou qualquer outro meio de pagamento (inclusão manual ou por sala de aula também). As informações aqui são atualizadas diariamente por um job que roda durante a madrugada (portanto podem não estar atualizadas na hora ). O administrador pode exportar uma planilha de extratos, que contém um pouco mais de detalhes em relação aos pagamentos de cada matrícula, como dados da campanha e do cupom utilizado na compra.

Caso o recebedor do Pagamentos EADBOX vinculado à plataforma tenha sido alterado, os extratos antes da data de alteração serão referentes ao recebedor anterior e os extratos que aparecerem depois da data de alteração serão referentes ao novo recebedor. Isso acontece porque os campos da tabela da página de extratos vêm do nosso banco de dados, e não do Pagar.me.

2.3. Pagamentos

A tela de pagamentos contém todas os dados referentes às transações realizadas via Pagamentos EADBOX e o saldo do cliente na plataforma. Os dados contidos nessa tela são vindos da API do Pagar.me, e portanto, são em tempo real.

Cards de saldo

  • Saldo a disponível - saldo disponível para saque;
  • Saldo a receber - saldo a liberar. O saldo não é liberado na hora pois o dinheiro não é recebido na hora pelo Pagar.me. É preciso 31 dias para que cada recebível de uma transação seja recebido, a não ser em casos de pagamento via boleto bancário que o dinheiro vai direto para o saldo disponível.

Planilha de recebíveis*

É possível exportar uma planilha com todos os detalhes das transações e seus recebíveis. Para isso basta clicar em "Exportar" no canto superior direito da tela. Será feito o download de um arquivo que contém três abas de planilha:

  • Recebimentos:
    Essa planilha contém os dados das transações da plataforma. Os valores ali especificados não necessariamente estão no saldo disponível do recebedor devido ao fato de uma transação poder possuir vários recebíveis com diferentes datas de pagamento. Os valores dessa planilha são os mesmos valores utilizados na tela de Pagamentos > Recebimentos e também para calcular os gráficos e acumulados no Painel de Vendas. Essa planilha contém as seguintes colunas:

    • ID da transação - ID identificador da transação no Pagar.me;
    • Estado - status da transação;
    • Origem - usuário que realizou a compra;
    • Data - data em que a transação foi criada;
    • Meio de pagamento - indica se foi realizado o pagamento via cartão de crédito ou boleto bancário;
    • Taxa - taxa total da transação. Consiste na soma da taxa da EADBOX, a taxa de MDR (taxa de processamento da transação do Pagar.me) e possíveis taxas de coautores e afiliados;
    • Valor - Valor líquido que será recebido pela compra. Lembrando que esse valor não necessariamente estará disponível no momento, pois a compra pode ser parcelada (fora o fato de que a primeira parcela demora 31 dias para cair no saldo disponível em transações via cartão de crédito);

  • Transferências:
    Contém os dados das transferências realizadas na plataforma.

  • Recebimentos detalhados (ou planilha de recebíveis):
    Provavelmente a planilha mais importante das três. Através dela é possível realizar todo o fluxo de caixa do cliente. Desde que se leve em consideração as transferências realizadas anteriormente, somar os valores líquidos pagos até o dia de hoje deve fechar o saldo disponível do recebedor. A planilha de recebimentos detalhados (ou planilha de recebíveis) contém as seguintes colunas:

    • ID do recebível - ID identificador do recebível no Pagar.me;
    • ID da transação - ID identificador da transação que aquele recebível pertence;
    • ID da antecipação - ID identificador da antecipação em que aquele recebível foi antecipado, caso ele tenha sido antecipado. Caso contrário, este campo estará vazio;
    • Email do comprador - e-mail do comprador do produto;
    • Data de criação da transação - data em que a transação foi criada;
    • Data de pagamento - data em que o recebível foi/irá para o saldo disponível. Esse campo pode mudar para uma data mais recente caso o recebível seja antecipado;
    • Data original de pagamento - data em que o recebível originalmente iria para o saldo disponível se não tivesse sido antecipado. Caso o recebível não tenha sido antecipado, esse campo estará vazio;
    • Estado - indica se o status do recebível;
    • Meio de pagamento - meio de pagamento da transação. Transações feitas via boleto bancário e em 1x no cartão de crédito só possuem um recebível;
    • Parcela - a qual parcela da transação se refere o recebível;
    • Parcelas - quantas parcelas a transação possui;
    • Taxa - taxa de MDR do Pagar.me em cima deste recebível;
    • Taxa de antecipação - caso o recebível tenha sido antecipado, quanto foi descontado do mesmo em prol da taxa de antecipação;
    • Valor - Valor bruto do recebível. O valor exibido aqui já possui as taxas da EADBOX descontadas. Questões técnicas nos impediram de criar uma coluna chamada "Taxa da EADBOX" e separar esses valores;
    • Valor recebido - Valor líquido do recebível, que foi de fato recebido pelo recebedor da plataforma;
    • Valor total da transação - valor referente à soma de todos os recebíveis da transação.

2.3.1. Aba de recebimentos

Na aba de recebimentos estão listadas todas as transações realizadas através do Pagamentos EADBOX. Na tabela de transações existem diversos dados:

  • Tipo - indica se a transação é referente à um curso, combo ou plano;
  • Título - nome do produto;
  • ID da transação - ID identificador da transação no Pagar.me;
  • Origem - usuário que realizou a compra. Clicando em cima do nome o adminstrador é direcionado para o perfil daquele usuário na plataforma;
  • Meio de pagamento - indica se foi realizado o pagamento via cartão de crédito ou boleto bancário. Clicando em cima do texto será aberto um pop-up com os recebíveis da transação e sua data de pagamento. O valor exibido ali já está descontado de taxas;
  • Taxa - taxa total da transação. Consiste na soma da taxa da EADBOX, a taxa de MDR (taxa de processamento da transação do Pagar.me) e possíveis taxas de coautores e afiliados;
  • Valor - Valor líquido que será recebido pela compra. Lembrando que esse valor não necessariamente estará disponível no momento, pois a compra pode ser parcelada (fora o fato de que a primeira parcela demora 31 dias para cair no saldo disponível em transações via cartão de crédito);
  • Data - data em que a transação foi criada;
  • Estado - status da transação;
  • Ações - quando uma compra estiver com estado pago e tenha sido feita via cartão de crédito um botão de estorno estará disponível nesse campo. O administrador entrará com o valor que deseja ser estornado da transação.

2.3.2. Aba de transferências

A aba de transferências contém dados de saques realizados anteriormente e as opções de realizar uma transferência e antecipação*.

Como funciona a antecipação

É possível antecipar até 90% do saldo a receber na conta virtual do Pagar.me. Os 10% restantes não são antecipáveis como uma margem de garantia de chargeback. O recebedor deverá esperar a data original de pagamento para receber esses 10%.

Importante ressaltar que não é possível "quebrar" recebíveis. Por exemplo, se o saldo a receber for composto por dois recebíveis de 500 reais cada (totalizando R$ 1000,00), apenas será possível antecipar um dos recebíveis (R$ 500,00) pois não é possível quebrar o outro recebível em 400 reais (que totalizaria os 90% = R$ 900,00).

A taxa de recebimento antecipado é calculada a juros simples e aplicada sobre o valor líquido da transação, ou seja, primeiro é deduzida a taxa de MDR (taxa do Pagar.me por transação) e então é aplicada a taxa de recebimento antecipado. A taxa de recebimento antecipado é mensal, mas seu cálculo é feito com taxa diária (taxa mensal/30), uma vez que algumas transações são antecipadas por períodos menores que 30 dias.

A taxa de recebimento antecipado é sempre proporcional ao tempo em que a parcela está sendo antecipada. Supondo uma venda em 3x sem juros - normalmente, a primeira parcela seria recebida pelo lojista em 30 dias, a segunda parcela em 60 dias e a terceira em 90 dias.

Desse modo, para o lojista receber a primeira parcela no dia seguinte da venda, precisamos antecipar, aproximadamente, 1 mês. Logo, a taxa de recebimento antecipado vai incidir uma vez. Já a segunda parcela precisaria ser antecipada em 2 meses, logo, a taxa de recebimento antecipado incide 2x. A terceira parcela seria antecipada em 3 meses, sendo a taxa de recebimento antecipado multiplicada por 3 nessa parcela. A taxa de antecipação para os clientes da Eadbox é de 2,5% ao mês (0,08064516129% ao dia).

O volume de recebíveis disponíveis para o cliente da Eadbox antecipar = {[Total já recebido antecipadamente + total a receber] * 0,9} – Total já recebido antecipadamente

Observar na conta acima que o valor antecipado anteriormente pesa no cálculo.

Um exemplo com números:

Supondo que você faça uma venda de R$ 150,00 a crédito, parcelada em 3x de R$ 50,00 no dia 01/01. O MDR (taxa do Pagar.me) será o padrão de 2,3% para 3 parcelas. O valor recebido será:

01/02: 1ª Parcela = R$ 48,85
01/03: 2ª Parcela = R$ 48,85
01/04: 3ª Parcela = R$ 48,85

Total: R$ 146,55

Solicitando o recebimento antecipado pontual e supondo que a taxa de recebimento antecipado é de 2,5% a.m.; essa venda, com recebimento antecipado, seria recebida nos prazos e valores abaixo:

02/01:

1ª Parcela = R$ 48,85 - [(1 x 0,025) x 48,85] = R$ 47.63
2ª Parcela = R$ 48,85 - [(2 x 0,025) x 48,85] = R$ 46,40
3ª Parcela = R$ 48,85 - [(3 x 0,025) x 48,85] = R$ 45,19

Total: R$ 139,22

2.3.2.1. Transferências*

Para realizar uma transferência, basta clicar no botão "Sacar" no canto superior direito da tela de transferências. O custo é de R$ 3,67 por transferência.

Contas bancárias do 237 - BANCO BRADESCO S.A. são isentas da taxa de transferência.

2.3.2.2. Antecipações

Para realizar uma antecipação, clique no botão "Mais" e selecione "Antecipar". Selecione o dia que deseja que a antecipação caia no saldo disponível e em seguida selecione o valor no slider ou entre com ele manualmente. Verifique as taxas da antecipação e clique em "Efetuar antecipação".

Caso não seja possível antecipar o valor exato (pelo motivo da quebra de recebíveis), o valor mais próximo disponível será colocado para antecipação.

Para consultar as antecipações realizadas anteriormente basta clicar em "Mais" e "Ver antecipações". Nesta tela são exibidas apenas as últimas 10 antecipações realizadas.

O campo "Taxa de antecipação" é composto pela soma das taxas de MDR do Pagar.me para todos os recebíveis que foram antecipados + taxa de antecipação.

2.3.3. Aba de conta bancária

Nesta aba o administrador poderá alterar sua conta bancária. Basta fazer as alteração necessárias nos campos de banco, agência e conta bancária. Os campos de nome/razão social e CPF/CNPJ são bloqueados para edição nesta tela.

É possível realizar a troca do nome/razão social através da criação de uma nova conta bancária (uma conta bancária é diferente de um recebedor).

Mudança de número de documento do recebedor

Caso seja necessário a mudança do número de documento cadastrado na conta bancária, é necessário entrar em contato com o Pagar.me para prevenção de problemas fiscais (não conseguimos realizar essa mudança do nosso lado). Existem algum casos em que a mudança é possível:

  • Número colocado incorretamente:
    Quando o número for colocado incorretamente, o Pagar.me irá verificar se o CNPJ/CPF existe na Receita Federal. Caso ele não exista, a mudança poderá ser realizada;
  • Número de documento é de uma empresa EI (Empresário Individual), MEI, EIRELI, ME ou Produtor Rural: Quando a empresa estiver enquadrada em um desses casos, a mudança de CPF para CNPJ ou CNPJ para CPF ligado ao documento atual poderá ser feita. Para isso será necessária a apresentação de dois documentos ao Pagar.me (até o momento de publicação dessa documentação):
    • Comprovante de MEI, EIRELI, Produtor Rural, ME ou EI (Empresário Individual) na Receita Federal;
    • Comprovante bancário da conta atrelada ao número de documento cadastrado atualmente.

    É preciso desses dois documentos para a troca ser realizada. Isso é uma exigência para o fluxo do Pagar.me.

Em nenhum outro caso é possível a mudança de número de documento. Caso o cliente precise, é possível desvincular o recebedor atual da plataforma e criar um novo. Isso cria uma nova conta do Pagar.me para o indivíduo/empresa. Para realizar essa mudança, entre em Configurações Internas > Deletar recebedor, leia o aviso com atenção e clique no botão de confirmação de ação.

O botão "Deletar recebedor" não deleta o recebedor do Pagar.me, apenas desvincula o id do recebedor antigo da plataforma EADBOX para que seja a possível a criação de um novo com número de documento diferente. Todo o saldo a receber, saldo disponível, extratos, antecipações e saques ainda estarão disponíveis para gerenciamento no sistema do Pagar.me (que o cliente não tem acesso, então caso não seja do interesse dele antecipar todo o saldo a receber, será preciso entrar em contato conosco para solicitar qualquer operação em relação à esse recebedor).

2.4. Planos*

Na interface do administrador, a página de planos permite que os responsáveis façam toda a gestão dos pagamentos recorrentes. Na tela inicial há uma listagem dos planos já existentes, sendo possível publicar ou despublicar o plano, visualizar as assinaturas*, editar, copiar link, acessar e arquivar o mesmo.

2.4.1. Criando um plano

O cliente poderá criar planos a partir do botão "Novo plano" localizado no canto superior direito da tela. Existem diversas funcionalidades interessantes na criação dos planos:

  • Período de testes - número de dias até o customer* ser cobrado pela primeira vez;
  • Habilitar cancelamento automático - número de cobranças que serão feitas antes da assinatura ser automaticamente finalizada. Por exemplo: se o intervalo de cobraça for de 30 dias e o cancelamento automático estiver configurado em 3 cobranças, a assinatura será finalizada em 90 dias (30 dias * 3 cobranças = 90 dias de acesso);
  • Plano não listado - apenas quem tem o link do plano poderá acessa-lo.

2.4.2. Editando um plano

Apenas é possível editar o nome do plano e os dias de trial de um plano. Nenhum outro campo é editavel. Para editar um plano, clique nos três pontinhos no lado direito do plano em questão na tabela e clique em "Editar".

2.4.3. Gerenciar assinaturas de um plano

Para gerenciar assinaturas de um plano, é necessário clicar nos três pontinhos no lado direito do plano em questão na tabela e clicar em "Matrículas". Nesta tela há uma pequena dashboard de informações sobre aquele plano e uma lista de assinaturas no mesmo. A tabela de assinaturas possui as seguintes colunas:

  • Usuário - usuário que assinou aquele plano. Clicando em cima do texto irá redirecionar o administrador para a tela do perfil daquele usuário na plataforma;
  • Plano de ensino - nome do plano;
  • Matrícula - data de criação da assinatura;
  • Período atual - mostra as datas de início e fim do periodo atual da assinatura;
  • Método de pagamento - mostra a integração usada para pagamento da assinatura. Existem dois valores possíveis: Pagamentos EADBOX ou MercadoPago;
  • Situação - se a assinatura está paga (ativa), não paga (inadimplência) e cancelada (não há como reativar);
  • Data de cancelamento - data em que foi feito o cancelamento da assinatura, caso ela esteja nessa situação. Caso contrário o campo estará em branco;
  • Solicitações - essa última coluna refere-se às ações que o administrador pode fazer com essa assinatura em específico. Há a opção de transferir assinatura e cancela-la.

Cancelando uma assinatura

Para cancelar a assinatura é preciso que ela esteja paga (ativa). Nesse caso, basta clicar nos três pontinhos ao lado da assinatura desejada e clicar em "Cancelar assinatura".

Transferindo uma assinatura

Para transferir uma assinatura é preciso que ela esteja ativa. Nesse caso, basta clicar nos três pontinhos ao lado da assinatura desejada e clicar em "Transferir assinatura". Ao transferir uma assinatura, o atributo plan_id no objeto da mesma é alterado para o plan_id relativo ao plano de destino. Essa funcionalidade é útil quando a plataforma trabalha com níveis de plano.

Lembrando que é na estrutura da assinatura que são salvas as split_rules* para pagamento, então não adianta transferir a assinatura para outro plano em casos de mudança de recebedor. O recebimento continuará sendo no recebedor que existia antes da mudança de plano e recebedor.

Um novo fluxo de cobrança será seguido, dependendo do valor do novo plano (em caso de dúvidas com os atributos current_period_start e current_period_end, consultar a documentação do Pagar.me):

Upgrades (plano de destino mais caro)

No upgrade acontece uma cobrança, que é calculada da seguinte maneira:

  • Se o status da assinatura não for paid, uma cobrança com o valor do novo plano é feita.

  • Se o status da assinatura for paid, é feita a seguinte conta:

É obtida a “proporção não usufruída” do plano com: (Dias não usados do plano antigo) / (Dias do plano antigo). Os dias não usados são o número de dias que faltam para chegar no atributo current_period_end (data que acaba o período atual) da assinatura.

É obtido o “valor não usufruído” do plano antigo multiplicando essa “proporção não usufruída” pelo valor do plano antigo.

É subtraído o “valor não usufruído” do valor do plano novo, e esse resultado é cobrado.

Uma transação é criada com esse valor e o current_period_start é alterado para a data do upgrade e o current_period_end alterado para a soma de current_period_start + dias do plano.

Isso ocorre pois não existe motivo para cobrar o valor “não usado” do plano antigo no plano novo.

Downgrade (plano de destino mais barato)

Não há nova cobrança, e a periodicidade é alterada:

  • O current_period_start da assinatura passa a ser a data atual.

  • O current_period_end do novo período é calculado da seguinte maneira:

É obtida a “proporção não usufruída” do plano com: (Dias não usados do plano antigo) / (Dias do plano antigo). Os dias não usados são o número de dias que faltam para chegar no current_period_end da assinatura.

É multiplicada essa “proporção não usufruída” pelo número de dias do novo plano, e o current_period_end da assinatura passa a ser esse número de dias, a partir da data atual.

Isso ocorre para que o tempo mais caro que já foi pago não seja “perdido” pelo cliente. O cliente só volta a ser cobrado depois que a proporção de dias do plano mais caro já tiver sido usufruída, mesmo que no plano mais barato.

Coautores

Para acessar a documentação das funcionalidades de coautores, clique aqui.

Glossário

O glossário tem como objetivo conceituar termos que são essenciais para entendimento deste documento.

  • Antecipação - ato de passar valores do saldo a receber para o saldo disponível antecipadamente mediante pagamento de uma taxa. Uma antecipação não é uma transferência, ela serve apenas para passar o saldo a receber para o saldo disponível. Basicamente uma antecipação é a soma de vários recebíveis que fecham um montante desejado para antecipar;
  • Assinatura - É a relação entre um plano e um customer. Na estrutura de assinatura fica armazenado o plano que deve ser cobrado do aluno, seus dados de pagamento, o customer que deve ser cobrado e as split rules;
  • Customer - cliente do nosso cliente (aluno, na maioria das vezes);
  • Plano - é uma estrutura que contém o intervalo de cobrança da assinatura, o número de cobranças até a assinatura ser finalizada, o número de dias de trial e os métodos de pagamento;
  • Recebedor - entidade que recebe o dinheiro. No caso do Pagamentos EADBOX, um recebedor do nosso marketplace no Pagar.me é um cliente nosso;
  • Recebível - parcela de uma transação. Uma transação pode ter um ou mais recebíveis. Cada recebível de uma transação possui uma data diferente para passagem do saldo a receber para o saldo disponível;
  • Split rule - regra de divisão de valores. A split rule que diz para qual recebedor o dinheiro ou parte do dinheiro deve ir. Uma transação sempre possuirá mais do que uma split rule, pois há a parte do dinheiro que vai para o recebedor da plataforma e a parte que vai para o recebedor da EADBOX. Em alguns casos haverá split rule para o(s) coautor(es) e afiliado(s) também.
  • Taxa de MDR - taxa de merchant discount rate. É a taxa do Pagar.me;
  • Transação - é um pagamento realizado no Pagar.me em seu escopo completo. Uma transação pode ter vários recebíveis.
  • Transferência - ato de enviar valores do saldo disponível para a conta bancária cadastrada.





Autor: Rafael Bisol
Editado por: Rafael Bisol

Editar página
Atualizado em: 2019-12-10 18:03:55