- 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 Produto B: | 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: Produto B: | 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: Produto B: | 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: Produto B: | Produto B |
| "lanche" | Produto A: Produto B: | 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.