Emissão de Faturas

  • As matrículas são obrigatórias para geração das faturas
  • Todas as faturas geradas na plataforma Educbank, cujo produto seja Inadimplência Zero, precisam existir no sistema como uma fatura única, não podendo haver duplicidade de fatura para o mesmo cliente no mês de referência. O identificador único é o campo [ExternalID].
  • O ExternalId deve ser idêntico ao ID da fatura registrada no sistema do parceiro.
  • Para o ExternalId só será possível ter somente uma fatura com o status de Pending, Expired ou Paid no nosso sistema. Faturas canceladas são exceções, ou seja, pode existir uma fatura com o status de Pending/Expired/Paid e N canceladas
  • Os itens de uma fatura só devem conter um tipo de produto. Caso o cliente tenha um item que deva ser Inadimplência Zero e outro que seja Gateway, será necessário a criação de duas faturas
  • Caso o parceiro não envie os dados referentes a Multas e Juros (PaymentFine) no corpo da requisição e o responsável financeiro pague sem os encargos o Educbank irá fazer os cálculos devidos e descontar da escola os encargos no próximo repasse.
  • Para todo item da fatura, deverá ser informado o atributo itemName, correspondente ao identificador do produto que será associado na Plataforma Educbank. Segue abaixo o conjunto de regras e exemplos que demonstram como o nosso sistema identifica e realiza esta associação:

Cenários

itemName
(enviado no payload)

Identificador do Produto
(Educbank)

A - Equivalência total

"matrícula"

"matrícula"

B - Equivalência parcial
(itemName corresponde ao texto inicial do identificador)

"matrícula 2025 Pedro

"matrícula 2025"

C - Equivalência parcial
(itemName contido no texto do identificador, ou vice-versa)

"Aluno Pedro 2025 lanche pão de queijo"

"lanche"


Para os cenários A e B, são utilizados critérios de priorização (desempate), conforme ilustrado abaixo.

  • Palavras inteiras em comum

itemName
(enviado no payload)

Produtos Cadastrados
(Educbank)

Produto que será associado
ao item da fatura

"PIX: 15% na rematrícula"

Produto A
"matrícula"

Produto B:
"rematrícula"

Produto B


  • Correspondência mais específica

itemName
(enviado no payload)

Produtos Cadastrados
(Educbank)

Produto que será associado
ao item da fatura

"rematrícula 1º ano EM 2025"

Produto A:
"rematrícula"

Produto B:
"rematricula 1º ano"

Produto B


  • Contexto (compatibilidade com o programa/curso da matrícula)

itemName
(enviado no payload)

Produtos Cadastrados
(Educbank)

Produto que será associado
ao item da fatura

"material escolar"

(matrícula do aluno em Educação Infantil)

Produto A:
"material escolar - ensino médio"

Produto B:
"material escolar - educação infantil"

Produto B


  • Produto mais recente (última alteração > criação).

Caso as regras de similaridade retornem mais de um produto, a correspondência será feita para o mais recente

itemName
(enviado no payload)

Produtos Cadastrados
(Educbank)

Produto que será associado
ao item da fatura

"lanche"

Produto A:
"lanche"
Última alteração: 02/01/2024

Produto B:
"lanche"
Última alteração: 10/02/2025

Produto B

"lanche"

Produto A:
"lanche"
Criado em: 20/08/2023

Produto B:
"lanche"
Criado em: 05/03/2024

Produto B


📘

Observações

  • Para uma maior precisão na aplicação das regras acima, os textos são normalizados (remoção de acentos, caracteres maiúsculos)
  • Caso não seja possível definir nenhuma relação entre o itemName enviado pelo ERP Parceiro com algum identificador cadastrado na Plataforma Educbank, o produto não será selecionado.